AWS Authorization for REST requests (#4623)

* AWS Authentication For Rest

* Docs Update

* Coding Space Update

* Code Review Updates

* Method exists Update

* Code Review Updates

Author: bnpatel1990

src/Codeception/Module/REST.php

@@ -1,6 +1,7 @@
 <?php
 namespace Codeception\Module;
 
+use Codeception\Exception\ConfigurationException;
 use Codeception\Exception\ModuleException;
 use Codeception\Lib\Interfaces\ConflictsWithModule;
 use Codeception\Module as CodeceptionModule;
@@ -57,7 +58,8 @@
 class REST extends CodeceptionModule implements DependsOnModule, PartedModule, API, ConflictsWithModule
 {
     protected $config = [
-        'url' => ''
+        'url' => '',
+        'aws' => ''
     ];
 
     protected $dependencyMessage = <<<EOF
@@ -332,6 +334,51 @@ public function amNTLMAuthenticated($username, $password)
         $this->client->setAuth($username, $password, 'ntlm');
     }
 
+    /**
+     * Allows to send REST request using AWS Authorization
+     * Only works with PhpBrowser
+     * Example
+     * Config -
+     *
+     * modules:
+     *      enabled:
+     *          - REST:
+     *              aws:
+     *                  key: accessKey
+     *                  secret: accessSecret
+     *                  service: awsService
+     *                  region: awsRegion
+     *
+     * ```php
+     * <?php
+     * $I->amAWSAuthenticated();
+     * ?>
+     * ```
+     * @param array $additionalAWSConfig
+     * @throws ModuleException
+     */
+    public function amAWSAuthenticated($additionalAWSConfig = [])
+    {
+        if (method_exists($this->client, 'setAwsAuth')) {
+            $config = array_merge($this->config['aws'], $additionalAWSConfig);
+
+            if (!isset($this->config['key'])) {
+                throw new ConfigurationException('AWS Key is not set');
+            }
+            if (!isset($this->config['secret'])) {
+                throw new ConfigurationException('AWS Secret is not set');
+            }
+            if (!isset($this->config['service'])) {
+                throw new ConfigurationException('AWS Service is not set');
+            }
+            if (!isset($this->config['region'])) {
+                throw new ConfigurationException('AWS Region is not set');
+            }
+
+            $this->client->setAwsAuth($config);
+        }
+    }
+
     /**
      * Sends a POST request to given uri. Parameters and files can be provided separately.
      *