pwn 0.4.333

data/lib/pwn/aws/sns.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 Notification Service.
+    module SNS
+      @@logger = PWN::Plugins::PWNLogger.create
+
+      # Supported Method Parameters::
+      # PWN::AWS::SNS.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 SNS...')
+        if sts_session_token == ''
+          sns_obj = Aws::SNS::Client.new(
+            region: region,
+            access_key_id: access_key_id,
+            secret_access_key: secret_access_key
+          )
+        else
+          sns_obj = Aws::SNS::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")
+
+        sns_obj
+      rescue StandardError => e
+        raise e
+      end
+
+      # Supported Method Parameters::
+      # PWN::AWS::SNS.disconnect(
+      #   sns_obj: 'required - sns_obj returned from #connect method'
+      # )
+
+      public_class_method def self.disconnect(opts = {})
+        sns_obj = opts[:sns_obj]
+        @@logger.info('Disconnecting...')
+        sns_obj = nil
+        @@logger.info("complete.\n")
+
+        sns_obj
+      rescue StandardError => e
+        raise e
+      end
+
+      # Author(s):: Jacob Hoopes <jake.hoopes@gmail.com>
+
+      public_class_method def self.authors
+        "AUTHOR(S):
+          Jacob Hoopes <jake.hoopes@gmail.com>
+        "
+      end
+
+      # Display Usage for this Module
+
+      public_class_method def self.help
+        puts "USAGE:
+          sns_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 sns_obj.public_methods
+
+          #{self}.disconnect(
+            sns_obj: 'required - sns_obj returned from #connect method'
+          )
+
+          #{self}.authors
+        "
+      end
+    end
+  end
+end

data/lib/pwn/aws/sqs.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 Queue Service.
+    module SQS
+      @@logger = PWN::Plugins::PWNLogger.create
+
+      # Supported Method Parameters::
+      # PWN::AWS::SQS.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 SQS...')
+        if sts_session_token == ''
+          sqs_obj = Aws::SQS::Client.new(
+            region: region,
+            access_key_id: access_key_id,
+            secret_access_key: secret_access_key
+          )
+        else
+          sqs_obj = Aws::SQS::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")
+
+        sqs_obj
+      rescue StandardError => e
+        raise e
+      end
+
+      # Supported Method Parameters::
+      # PWN::AWS::SQS.disconnect(
+      #   sqs_obj: 'required - sqs_obj returned from #connect method'
+      # )
+
+      public_class_method def self.disconnect(opts = {})
+        sqs_obj = opts[:sqs_obj]
+        @@logger.info('Disconnecting...')
+        sqs_obj = nil
+        @@logger.info("complete.\n")
+
+        sqs_obj
+      rescue StandardError => e
+        raise e
+      end
+
+      # Author(s):: Jacob Hoopes <jake.hoopes@gmail.com>
+
+      public_class_method def self.authors
+        "AUTHOR(S):
+          Jacob Hoopes <jake.hoopes@gmail.com>
+        "
+      end
+
+      # Display Usage for this Module
+
+      public_class_method def self.help
+        puts "USAGE:
+          sqs_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 sqs_obj.public_methods
+
+          #{self}.disconnect(
+            sqs_obj: 'required - sqs_obj returned from #connect method'
+          )
+
+          #{self}.authors
+        "
+      end
+    end
+  end
+end

data/lib/pwn/aws/ssm.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 Systems Management Service.
+    module SSM
+      @@logger = PWN::Plugins::PWNLogger.create
+
+      # Supported Method Parameters::
+      # PWN::AWS::SSM.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 SSM...')
+        if sts_session_token == ''
+          ssm_obj = Aws::SSM::Client.new(
+            region: region,
+            access_key_id: access_key_id,
+            secret_access_key: secret_access_key
+          )
+        else
+          ssm_obj = Aws::SSM::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")
+
+        ssm_obj
+      rescue StandardError => e
+        raise e
+      end
+
+      # Supported Method Parameters::
+      # PWN::AWS::SSM.disconnect(
+      #   ssm_obj: 'required - ssm_obj returned from #connect method'
+      # )
+
+      public_class_method def self.disconnect(opts = {})
+        ssm_obj = opts[:ssm_obj]
+        @@logger.info('Disconnecting...')
+        ssm_obj = nil
+        @@logger.info("complete.\n")
+
+        ssm_obj
+      rescue StandardError => e
+        raise e
+      end
+
+      # Author(s):: Jacob Hoopes <jake.hoopes@gmail.com>
+
+      public_class_method def self.authors
+        "AUTHOR(S):
+          Jacob Hoopes <jake.hoopes@gmail.com>
+        "
+      end
+
+      # Display Usage for this Module
+
+      public_class_method def self.help
+        puts "USAGE:
+          ssm_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 ssm_obj.public_methods
+
+          #{self}.disconnect(
+            ssm_obj: 'required - ssm_obj returned from #connect method'
+          )
+
+          #{self}.authors
+        "
+      end
+    end
+  end
+end

data/lib/pwn/aws/states.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 Elastic Compute Cloud.
+    module States
+      @@logger = PWN::Plugins::PWNLogger.create
+
+      # Supported Method Parameters::
+      # PWN::AWS::States.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 States...')
+        if sts_session_token == ''
+          states_obj = Aws::States::Client.new(
+            region: region,
+            access_key_id: access_key_id,
+            secret_access_key: secret_access_key
+          )
+        else
+          states_obj = Aws::States::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")
+
+        states_obj
+      rescue StandardError => e
+        raise e
+      end
+
+      # Supported Method Parameters::
+      # PWN::AWS::States.disconnect(
+      #   states_obj: 'required - states_obj returned from #connect method'
+      # )
+
+      public_class_method def self.disconnect(opts = {})
+        states_obj = opts[:states_obj]
+        @@logger.info('Disconnecting...')
+        states_obj = nil
+        @@logger.info("complete.\n")
+
+        states_obj
+      rescue StandardError => e
+        raise e
+      end
+
+      # Author(s):: Jacob Hoopes <jake.hoopes@gmail.com>
+
+      public_class_method def self.authors
+        "AUTHOR(S):
+          Jacob Hoopes <jake.hoopes@gmail.com>
+        "
+      end
+
+      # Display Usage for this Module
+
+      public_class_method def self.help
+        puts "USAGE:
+          states_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 states_obj.public_methods
+
+          #{self}.disconnect(
+            states_obj: 'required - states_obj returned from #connect method'
+          )
+
+          #{self}.authors
+        "
+      end
+    end
+  end
+end

data/lib/pwn/aws/storage_gateway.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 Storage Gateway.
+    module StorageGateway
+      @@logger = PWN::Plugins::PWNLogger.create
+
+      # Supported Method Parameters::
+      # PWN::AWS::StorageGateway.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 StorageGateway...')
+        if sts_session_token == ''
+          storage_gateway_obj = Aws::StorageGateway::Client.new(
+            region: region,
+            access_key_id: access_key_id,
+            secret_access_key: secret_access_key
+          )
+        else
+          storage_gateway_obj = Aws::StorageGateway::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")
+
+        storage_gateway_obj
+      rescue StandardError => e
+        raise e
+      end
+
+      # Supported Method Parameters::
+      # PWN::AWS::StorageGateway.disconnect(
+      #   storage_gateway_obj: 'required - storage_gateway_obj returned from #connect method'
+      # )
+
+      public_class_method def self.disconnect(opts = {})
+        storage_gateway_obj = opts[:storage_gateway_obj]
+        @@logger.info('Disconnecting...')
+        storage_gateway_obj = nil
+        @@logger.info("complete.\n")
+
+        storage_gateway_obj
+      rescue StandardError => e
+        raise e
+      end
+
+      # Author(s):: Jacob Hoopes <jake.hoopes@gmail.com>
+
+      public_class_method def self.authors
+        "AUTHOR(S):
+          Jacob Hoopes <jake.hoopes@gmail.com>
+        "
+      end
+
+      # Display Usage for this Module
+
+      public_class_method def self.help
+        puts "USAGE:
+          storage_gateway_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 storage_gateway_obj.public_methods
+
+          #{self}.disconnect(
+            storage_gateway_obj: 'required - storage_gateway_obj returned from #connect method'
+          )
+
+          #{self}.authors
+        "
+      end
+    end
+  end
+end

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):: Jacob Hoopes <jake.hoopes@gmail.com>
+
+      public_class_method def self.authors
+        "AUTHOR(S):
+          Jacob Hoopes <jake.hoopes@gmail.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):: Jacob Hoopes <jake.hoopes@gmail.com>
+
+      public_class_method def self.authors
+        "AUTHOR(S):
+          Jacob Hoopes <jake.hoopes@gmail.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