pwn 0.5.509 → 0.5.510

data/lib/pwn/aws/sts.rb

@@ -0,0 +1,63 @@
+# frozen_string_literal: true
+
+require 'aws-sdk'
+
+module PWN
+  module AWS
+    # This module provides a client for making API requests to AWS Security Token Service.
+    module STS
+      @@logger = PWN::Plugins::PWNLogger.create
+
+      # Supported Method Parameters::
+      # PWN::AWS::STS.get_temp_credentials(
+      #   region: 'required - region name to connect (eu-west-1, ap-southeast-1, ap-southeast-2, eu-central-1, ap-northeast-2, ap-northeast-1, us-east-1, sa-east-1, us-west-1, us-west-2)',
+      #   role_arn: 'required - role arn for instance profile to be used',
+      #   role_session_name: 'required - the name of the instance profile role',
+      #   duration_seconds: 'required - seconds in which sts credentials will expire'
+      # )
+
+      public_class_method def self.get_temp_credentials(opts = {})
+        region = opts[:region].to_s.scrub.chomp.strip
+        role_arn = opts[:role_arn].to_s.scrub.chomp.strip
+        role_session_name = opts[:role_session_name].to_s.scrub.chomp.strip
+        duration_seconds = opts[:duration_seconds].to_i
+
+        @@logger.info('Retrieving AWS STS Credentials...')
+        sts_client = Aws::STS::Client.new(region: region)
+        sts_session = sts_client.assume_role(
+          role_arn: role_arn,
+          role_session_name: role_session_name,
+          duration_seconds: duration_seconds
+        )
+        @@logger.info("complete.\n")
+
+        sts_session.credentials
+      rescue StandardError => e
+        raise e
+      end
+
+      # Author(s):: 0day Inc. <support@0dayinc.com>
+
+      public_class_method def self.authors
+        "AUTHOR(S):
+          0day Inc. <support@0dayinc.com>
+        "
+      end
+
+      # Display Usage for this Module
+
+      public_class_method def self.help
+        puts "USAGE:
+          credentials = #{self}.get_temp_credentials(
+            region: 'required - region name to connect (eu-west-1, ap-southeast-1, ap-southeast-2, eu-central-1, ap-northeast-2, ap-northeast-1, us-east-1, sa-east-1, us-west-1, us-west-2)',
+            role_arn: 'required - role arn for instance profile to be used',
+            role_session_name: 'required - the name of the instance profile role',
+            duration_seconds: 'required - seconds in which sts credentials will expire'
+          )
+
+          #{self}.authors
+        "
+      end
+    end
+  end
+end

data/lib/pwn/aws/support.rb

@@ -0,0 +1,92 @@
+# frozen_string_literal: true
+
+require 'aws-sdk'
+
+module PWN
+  module AWS
+    # This module provides a client for making API requests to AWS Support.
+    module Support
+      @@logger = PWN::Plugins::PWNLogger.create
+
+      # Supported Method Parameters::
+      # PWN::AWS::Support.connect(
+      #   region: 'required - region name to connect (eu-west-1, ap-southeast-1, ap-southeast-2, eu-central-1, ap-northeast-2, ap-northeast-1, us-east-1, sa-east-1, us-west-1, us-west-2)',
+      #   access_key_id: 'required - Use AWS STS for best privacy (i.e. temporary access key id)',
+      #   secret_access_key: 'required - Use AWS STS for best privacy (i.e. temporary secret access key',
+      #   sts_session_token: 'optional - Temporary token returned by STS client for best privacy'
+      # )
+
+      public_class_method def self.connect(opts = {})
+        region = opts[:region].to_s.scrub.chomp.strip
+        access_key_id = opts[:access_key_id].to_s.scrub.chomp.strip
+        secret_access_key = opts[:secret_access_key].to_s.scrub.chomp.strip
+        sts_session_token = opts[:sts_session_token].to_s.scrub.chomp.strip
+
+        @@logger.info('Connecting to AWS Support...')
+        if sts_session_token == ''
+          support_obj = Aws::Support::Client.new(
+            region: region,
+            access_key_id: access_key_id,
+            secret_access_key: secret_access_key
+          )
+        else
+          support_obj = Aws::Support::Client.new(
+            region: region,
+            access_key_id: access_key_id,
+            secret_access_key: secret_access_key,
+            session_token: sts_session_token
+          )
+        end
+        @@logger.info("complete.\n")
+
+        support_obj
+      rescue StandardError => e
+        raise e
+      end
+
+      # Supported Method Parameters::
+      # PWN::AWS::Support.disconnect(
+      #   support_obj: 'required - support_obj returned from #connect method'
+      # )
+
+      public_class_method def self.disconnect(opts = {})
+        support_obj = opts[:support_obj]
+        @@logger.info('Disconnecting...')
+        support_obj = nil
+        @@logger.info("complete.\n")
+
+        support_obj
+      rescue StandardError => e
+        raise e
+      end
+
+      # Author(s):: 0day Inc. <support@0dayinc.com>
+
+      public_class_method def self.authors
+        "AUTHOR(S):
+          0day Inc. <support@0dayinc.com>
+        "
+      end
+
+      # Display Usage for this Module
+
+      public_class_method def self.help
+        puts "USAGE:
+          support_obj = #{self}.connect(
+            region: 'required - region name to connect (eu-west-1, ap-southeast-1, ap-southeast-2, eu-central-1, ap-northeast-2, ap-northeast-1, us-east-1, sa-east-1, us-west-1, us-west-2)',
+            access_key_id: 'required - Use AWS STS for best privacy (i.e. temporary access key id)',
+            secret_access_key: 'required - Use AWS STS for best privacy (i.e. temporary secret access key',
+            sts_session_token: 'optional - Temporary token returned by STS client for best privacy'
+          )
+          puts support_obj.public_methods
+
+          #{self}.disconnect(
+            support_obj: 'required - support_obj returned from #connect method'
+          )
+
+          #{self}.authors
+        "
+      end
+    end
+  end
+end

data/lib/pwn/aws/swf.rb

@@ -0,0 +1,92 @@
+# frozen_string_literal: true
+
+require 'aws-sdk'
+
+module PWN
+  module AWS
+    # This module provides a client for making API requests to Amazon Simple Workflow Service.
+    module SWF
+      @@logger = PWN::Plugins::PWNLogger.create
+
+      # Supported Method Parameters::
+      # PWN::AWS::SWF.connect(
+      #   region: 'required - region name to connect (eu-west-1, ap-southeast-1, ap-southeast-2, eu-central-1, ap-northeast-2, ap-northeast-1, us-east-1, sa-east-1, us-west-1, us-west-2)',
+      #   access_key_id: 'required - Use AWS STS for best privacy (i.e. temporary access key id)',
+      #   secret_access_key: 'required - Use AWS STS for best privacy (i.e. temporary secret access key',
+      #   sts_session_token: 'optional - Temporary token returned by STS client for best privacy'
+      # )
+
+      public_class_method def self.connect(opts = {})
+        region = opts[:region].to_s.scrub.chomp.strip
+        access_key_id = opts[:access_key_id].to_s.scrub.chomp.strip
+        secret_access_key = opts[:secret_access_key].to_s.scrub.chomp.strip
+        sts_session_token = opts[:sts_session_token].to_s.scrub.chomp.strip
+
+        @@logger.info('Connecting to AWS SWF...')
+        if sts_session_token == ''
+          swf_obj = Aws::SWF::Client.new(
+            region: region,
+            access_key_id: access_key_id,
+            secret_access_key: secret_access_key
+          )
+        else
+          swf_obj = Aws::SWF::Client.new(
+            region: region,
+            access_key_id: access_key_id,
+            secret_access_key: secret_access_key,
+            session_token: sts_session_token
+          )
+        end
+        @@logger.info("complete.\n")
+
+        swf_obj
+      rescue StandardError => e
+        raise e
+      end
+
+      # Supported Method Parameters::
+      # PWN::AWS::SWF.disconnect(
+      #   swf_obj: 'required - swf_obj returned from #connect method'
+      # )
+
+      public_class_method def self.disconnect(opts = {})
+        swf_obj = opts[:swf_obj]
+        @@logger.info('Disconnecting...')
+        swf_obj = nil
+        @@logger.info("complete.\n")
+
+        swf_obj
+      rescue StandardError => e
+        raise e
+      end
+
+      # Author(s):: 0day Inc. <support@0dayinc.com>
+
+      public_class_method def self.authors
+        "AUTHOR(S):
+          0day Inc. <support@0dayinc.com>
+        "
+      end
+
+      # Display Usage for this Module
+
+      public_class_method def self.help
+        puts "USAGE:
+          swf_obj = #{self}.connect(
+            region: 'required - region name to connect (eu-west-1, ap-southeast-1, ap-southeast-2, eu-central-1, ap-northeast-2, ap-northeast-1, us-east-1, sa-east-1, us-west-1, us-west-2)',
+            access_key_id: 'required - Use AWS STS for best privacy (i.e. temporary access key id)',
+            secret_access_key: 'required - Use AWS STS for best privacy (i.e. temporary secret access key',
+            sts_session_token: 'optional - Temporary token returned by STS client for best privacy'
+          )
+          puts swf_obj.public_methods
+
+          #{self}.disconnect(
+            swf_obj: 'required - swf_obj returned from #connect method'
+          )
+
+          #{self}.authors
+        "
+      end
+    end
+  end
+end

data/lib/pwn/aws/waf.rb

@@ -0,0 +1,92 @@
+# frozen_string_literal: true
+
+require 'aws-sdk'
+
+module PWN
+  module AWS
+    # This module provides a client for making API requests to AWS WAF.
+    module WAF
+      @@logger = PWN::Plugins::PWNLogger.create
+
+      # Supported Method Parameters::
+      # PWN::AWS::WAF.connect(
+      #   region: 'required - region name to connect (eu-west-1, ap-southeast-1, ap-southeast-2, eu-central-1, ap-northeast-2, ap-northeast-1, us-east-1, sa-east-1, us-west-1, us-west-2)',
+      #   access_key_id: 'required - Use AWS STS for best privacy (i.e. temporary access key id)',
+      #   secret_access_key: 'required - Use AWS STS for best privacy (i.e. temporary secret access key',
+      #   sts_session_token: 'optional - Temporary token returned by STS client for best privacy'
+      # )
+
+      public_class_method def self.connect(opts = {})
+        region = opts[:region].to_s.scrub.chomp.strip
+        access_key_id = opts[:access_key_id].to_s.scrub.chomp.strip
+        secret_access_key = opts[:secret_access_key].to_s.scrub.chomp.strip
+        sts_session_token = opts[:sts_session_token].to_s.scrub.chomp.strip
+
+        @@logger.info('Connecting to AWS WAF...')
+        if sts_session_token == ''
+          waf_obj = Aws::WAF::Client.new(
+            region: region,
+            access_key_id: access_key_id,
+            secret_access_key: secret_access_key
+          )
+        else
+          waf_obj = Aws::WAF::Client.new(
+            region: region,
+            access_key_id: access_key_id,
+            secret_access_key: secret_access_key,
+            session_token: sts_session_token
+          )
+        end
+        @@logger.info("complete.\n")
+
+        waf_obj
+      rescue StandardError => e
+        raise e
+      end
+
+      # Supported Method Parameters::
+      # PWN::AWS::WAF.disconnect(
+      #   waf_obj: 'required - waf_obj returned from #connect method'
+      # )
+
+      public_class_method def self.disconnect(opts = {})
+        waf_obj = opts[:waf_obj]
+        @@logger.info('Disconnecting...')
+        waf_obj = nil
+        @@logger.info("complete.\n")
+
+        waf_obj
+      rescue StandardError => e
+        raise e
+      end
+
+      # Author(s):: 0day Inc. <support@0dayinc.com>
+
+      public_class_method def self.authors
+        "AUTHOR(S):
+          0day Inc. <support@0dayinc.com>
+        "
+      end
+
+      # Display Usage for this Module
+
+      public_class_method def self.help
+        puts "USAGE:
+          waf_obj = #{self}.connect(
+            region: 'required - region name to connect (eu-west-1, ap-southeast-1, ap-southeast-2, eu-central-1, ap-northeast-2, ap-northeast-1, us-east-1, sa-east-1, us-west-1, us-west-2)',
+            access_key_id: 'required - Use AWS STS for best privacy (i.e. temporary access key id)',
+            secret_access_key: 'required - Use AWS STS for best privacy (i.e. temporary secret access key',
+            sts_session_token: 'optional - Temporary token returned by STS client for best privacy'
+          )
+          puts waf_obj.public_methods
+
+          #{self}.disconnect(
+            waf_obj: 'required - waf_obj returned from #connect method'
+          )
+
+          #{self}.authors
+        "
+      end
+    end
+  end
+end

data/lib/pwn/aws/waf_regional.rb

@@ -0,0 +1,92 @@
+# frozen_string_literal: true
+
+require 'aws-sdk'
+
+module PWN
+  module AWS
+    # This module provides a client for making API requests to AWS WAF Regional.
+    module WAFRegional
+      @@logger = PWN::Plugins::PWNLogger.create
+
+      # Supported Method Parameters::
+      # PWN::AWS::WAFRegional.connect(
+      #   region: 'required - region name to connect (eu-west-1, ap-southeast-1, ap-southeast-2, eu-central-1, ap-northeast-2, ap-northeast-1, us-east-1, sa-east-1, us-west-1, us-west-2)',
+      #   access_key_id: 'required - Use AWS STS for best privacy (i.e. temporary access key id)',
+      #   secret_access_key: 'required - Use AWS STS for best privacy (i.e. temporary secret access key',
+      #   sts_session_token: 'optional - Temporary token returned by STS client for best privacy'
+      # )
+
+      public_class_method def self.connect(opts = {})
+        region = opts[:region].to_s.scrub.chomp.strip
+        access_key_id = opts[:access_key_id].to_s.scrub.chomp.strip
+        secret_access_key = opts[:secret_access_key].to_s.scrub.chomp.strip
+        sts_session_token = opts[:sts_session_token].to_s.scrub.chomp.strip
+
+        @@logger.info('Connecting to AWS WAFRegional...')
+        if sts_session_token == ''
+          waf_regional_obj = Aws::WAFRegional::Client.new(
+            region: region,
+            access_key_id: access_key_id,
+            secret_access_key: secret_access_key
+          )
+        else
+          waf_regional_obj = Aws::WAFRegional::Client.new(
+            region: region,
+            access_key_id: access_key_id,
+            secret_access_key: secret_access_key,
+            session_token: sts_session_token
+          )
+        end
+        @@logger.info("complete.\n")
+
+        waf_regional_obj
+      rescue StandardError => e
+        raise e
+      end
+
+      # Supported Method Parameters::
+      # PWN::AWS::WAFRegional.disconnect(
+      #   waf_regional_obj: 'required - waf_regional_obj returned from #connect method'
+      # )
+
+      public_class_method def self.disconnect(opts = {})
+        waf_regional_obj = opts[:waf_regional_obj]
+        @@logger.info('Disconnecting...')
+        waf_regional_obj = nil
+        @@logger.info("complete.\n")
+
+        waf_regional_obj
+      rescue StandardError => e
+        raise e
+      end
+
+      # Author(s):: 0day Inc. <support@0dayinc.com>
+
+      public_class_method def self.authors
+        "AUTHOR(S):
+          0day Inc. <support@0dayinc.com>
+        "
+      end
+
+      # Display Usage for this Module
+
+      public_class_method def self.help
+        puts "USAGE:
+          waf_regional_obj = #{self}.connect(
+            region: 'required - region name to connect (eu-west-1, ap-southeast-1, ap-southeast-2, eu-central-1, ap-northeast-2, ap-northeast-1, us-east-1, sa-east-1, us-west-1, us-west-2)',
+            access_key_id: 'required - Use AWS STS for best privacy (i.e. temporary access key id)',
+            secret_access_key: 'required - Use AWS STS for best privacy (i.e. temporary secret access key',
+            sts_session_token: 'optional - Temporary token returned by STS client for best privacy'
+          )
+          puts waf_regional_obj.public_methods
+
+          #{self}.disconnect(
+            waf_regional_obj: 'required - waf_regional_obj returned from #connect method'
+          )
+
+          #{self}.authors
+        "
+      end
+    end
+  end
+end

data/lib/pwn/aws/workspaces.rb

@@ -0,0 +1,92 @@
+# frozen_string_literal: true
+
+require 'aws-sdk'
+
+module PWN
+  module AWS
+    # This module provides a client for making API requests to Amazon WorkSpaces.
+    module Workspaces
+      @@logger = PWN::Plugins::PWNLogger.create
+
+      # Supported Method Parameters::
+      # PWN::AWS::Workspaces.connect(
+      #   region: 'required - region name to connect (eu-west-1, ap-southeast-1, ap-southeast-2, eu-central-1, ap-northeast-2, ap-northeast-1, us-east-1, sa-east-1, us-west-1, us-west-2)',
+      #   access_key_id: 'required - Use AWS STS for best privacy (i.e. temporary access key id)',
+      #   secret_access_key: 'required - Use AWS STS for best privacy (i.e. temporary secret access key',
+      #   sts_session_token: 'optional - Temporary token returned by STS client for best privacy'
+      # )
+
+      public_class_method def self.connect(opts = {})
+        region = opts[:region].to_s.scrub.chomp.strip
+        access_key_id = opts[:access_key_id].to_s.scrub.chomp.strip
+        secret_access_key = opts[:secret_access_key].to_s.scrub.chomp.strip
+        sts_session_token = opts[:sts_session_token].to_s.scrub.chomp.strip
+
+        @@logger.info('Connecting to AWS Workspaces...')
+        if sts_session_token == ''
+          workspaces_obj = Aws::Workspaces::Client.new(
+            region: region,
+            access_key_id: access_key_id,
+            secret_access_key: secret_access_key
+          )
+        else
+          workspaces_obj = Aws::Workspaces::Client.new(
+            region: region,
+            access_key_id: access_key_id,
+            secret_access_key: secret_access_key,
+            session_token: sts_session_token
+          )
+        end
+        @@logger.info("complete.\n")
+
+        workspaces_obj
+      rescue StandardError => e
+        raise e
+      end
+
+      # Supported Method Parameters::
+      # PWN::AWS::Workspaces.disconnect(
+      #   workspaces_obj: 'required - workspaces_obj returned from #connect method'
+      # )
+
+      public_class_method def self.disconnect(opts = {})
+        workspaces_obj = opts[:workspaces_obj]
+        @@logger.info('Disconnecting...')
+        workspaces_obj = nil
+        @@logger.info("complete.\n")
+
+        workspaces_obj
+      rescue StandardError => e
+        raise e
+      end
+
+      # Author(s):: 0day Inc. <support@0dayinc.com>
+
+      public_class_method def self.authors
+        "AUTHOR(S):
+          0day Inc. <support@0dayinc.com>
+        "
+      end
+
+      # Display Usage for this Module
+
+      public_class_method def self.help
+        puts "USAGE:
+          workspaces_obj = #{self}.connect(
+            region: 'required - region name to connect (eu-west-1, ap-southeast-1, ap-southeast-2, eu-central-1, ap-northeast-2, ap-northeast-1, us-east-1, sa-east-1, us-west-1, us-west-2)',
+            access_key_id: 'required - Use AWS STS for best privacy (i.e. temporary access key id)',
+            secret_access_key: 'required - Use AWS STS for best privacy (i.e. temporary secret access key',
+            sts_session_token: 'optional - Temporary token returned by STS client for best privacy'
+          )
+          puts workspaces_obj.public_methods
+
+          #{self}.disconnect(
+            workspaces_obj: 'required - workspaces_obj returned from #connect method'
+          )
+
+          #{self}.authors
+        "
+      end
+    end
+  end
+end

data/lib/pwn/aws/x_ray.rb

@@ -0,0 +1,92 @@
+# frozen_string_literal: true
+
+require 'aws-sdk'
+
+module PWN
+  module AWS
+    # This module provides a client for making API requests to AWS X-Ray.
+    module XRay
+      @@logger = PWN::Plugins::PWNLogger.create
+
+      # Supported Method Parameters::
+      # PWN::AWS::XRay.connect(
+      #   region: 'required - region name to connect (eu-west-1, ap-southeast-1, ap-southeast-2, eu-central-1, ap-northeast-2, ap-northeast-1, us-east-1, sa-east-1, us-west-1, us-west-2)',
+      #   access_key_id: 'required - Use AWS STS for best privacy (i.e. temporary access key id)',
+      #   secret_access_key: 'required - Use AWS STS for best privacy (i.e. temporary secret access key',
+      #   sts_session_token: 'optional - Temporary token returned by STS client for best privacy'
+      # )
+
+      public_class_method def self.connect(opts = {})
+        region = opts[:region].to_s.scrub.chomp.strip
+        access_key_id = opts[:access_key_id].to_s.scrub.chomp.strip
+        secret_access_key = opts[:secret_access_key].to_s.scrub.chomp.strip
+        sts_session_token = opts[:sts_session_token].to_s.scrub.chomp.strip
+
+        @@logger.info('Connecting to AWS XRay...')
+        if sts_session_token == ''
+          x_ray_obj = Aws::XRay::Client.new(
+            region: region,
+            access_key_id: access_key_id,
+            secret_access_key: secret_access_key
+          )
+        else
+          x_ray_obj = Aws::XRay::Client.new(
+            region: region,
+            access_key_id: access_key_id,
+            secret_access_key: secret_access_key,
+            session_token: sts_session_token
+          )
+        end
+        @@logger.info("complete.\n")
+
+        x_ray_obj
+      rescue StandardError => e
+        raise e
+      end
+
+      # Supported Method Parameters::
+      # PWN::AWS::XRay.disconnect(
+      #   x_ray_obj: 'required - x_ray_obj returned from #connect method'
+      # )
+
+      public_class_method def self.disconnect(opts = {})
+        x_ray_obj = opts[:x_ray_obj]
+        @@logger.info('Disconnecting...')
+        x_ray_obj = nil
+        @@logger.info("complete.\n")
+
+        x_ray_obj
+      rescue StandardError => e
+        raise e
+      end
+
+      # Author(s):: 0day Inc. <support@0dayinc.com>
+
+      public_class_method def self.authors
+        "AUTHOR(S):
+          0day Inc. <support@0dayinc.com>
+        "
+      end
+
+      # Display Usage for this Module
+
+      public_class_method def self.help
+        puts "USAGE:
+          x_ray_obj = #{self}.connect(
+            region: 'required - region name to connect (eu-west-1, ap-southeast-1, ap-southeast-2, eu-central-1, ap-northeast-2, ap-northeast-1, us-east-1, sa-east-1, us-west-1, us-west-2)',
+            access_key_id: 'required - Use AWS STS for best privacy (i.e. temporary access key id)',
+            secret_access_key: 'required - Use AWS STS for best privacy (i.e. temporary secret access key',
+            sts_session_token: 'optional - Temporary token returned by STS client for best privacy'
+          )
+          puts x_ray_obj.public_methods
+
+          #{self}.disconnect(
+            x_ray_obj: 'required - x_ray_obj returned from #connect method'
+          )
+
+          #{self}.authors
+        "
+      end
+    end
+  end
+end