pwn 0.4.333

data/lib/pwn/aws/directory_service.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 Directory Service.
+    module DirectoryService
+      @@logger = PWN::Plugins::PWNLogger.create
+
+      # Supported Method Parameters::
+      # PWN::AWS::DirectoryService.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 DirectoryService...')
+        if sts_session_token == ''
+          directory_service_obj = Aws::DirectoryService::Client.new(
+            region: region,
+            access_key_id: access_key_id,
+            secret_access_key: secret_access_key
+          )
+        else
+          directory_service_obj = Aws::DirectoryService::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")
+
+        directory_service_obj
+      rescue StandardError => e
+        raise e
+      end
+
+      # Supported Method Parameters::
+      # PWN::AWS::DirectoryService.disconnect(
+      #   directory_service_obj: 'required - directory_service_obj returned from #connect method'
+      # )
+
+      public_class_method def self.disconnect(opts = {})
+        directory_service_obj = opts[:directory_service_obj]
+        @@logger.info('Disconnecting...')
+        directory_service_obj = nil
+        @@logger.info("complete.\n")
+
+        directory_service_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:
+          directory_service_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 directory_service_obj.public_methods
+
+          #{self}.disconnect(
+            directory_service_obj: 'required - directory_service_obj returned from #connect method'
+          )
+
+          #{self}.authors
+        "
+      end
+    end
+  end
+end

data/lib/pwn/aws/dynamo_db.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 DynamoDB.
+    module DynamoDB
+      @@logger = PWN::Plugins::PWNLogger.create
+
+      # Supported Method Parameters::
+      # PWN::AWS::DynamoDB.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 DynamoDB...')
+        if sts_session_token == ''
+          dynamo_db_obj = Aws::DynamoDB::Client.new(
+            region: region,
+            access_key_id: access_key_id,
+            secret_access_key: secret_access_key
+          )
+        else
+          dynamo_db_obj = Aws::DynamoDB::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")
+
+        dynamo_db_obj
+      rescue StandardError => e
+        raise e
+      end
+
+      # Supported Method Parameters::
+      # PWN::AWS::DynamoDB.disconnect(
+      #   dynamo_db_obj: 'required - dynamo_db_obj returned from #connect method'
+      # )
+
+      public_class_method def self.disconnect(opts = {})
+        dynamo_db_obj = opts[:dynamo_db_obj]
+        @@logger.info('Disconnecting...')
+        dynamo_db_obj = nil
+        @@logger.info("complete.\n")
+
+        dynamo_db_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:
+          dynamo_db_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 dynamo_db_obj.public_methods
+
+          #{self}.disconnect(
+            dynamo_db_obj: 'required - dynamo_db_obj returned from #connect method'
+          )
+
+          #{self}.authors
+        "
+      end
+    end
+  end
+end

data/lib/pwn/aws/dynamo_db_streams.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 DynamoDB Streams.
+    module DynamoDBStreams
+      @@logger = PWN::Plugins::PWNLogger.create
+
+      # Supported Method Parameters::
+      # PWN::AWS::DynamoDBStreams.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 DynamoDBStreams...')
+        if sts_session_token == ''
+          dynamo_db_streams_obj = Aws::DynamoDBStreams::Client.new(
+            region: region,
+            access_key_id: access_key_id,
+            secret_access_key: secret_access_key
+          )
+        else
+          dynamo_db_streams_obj = Aws::DynamoDBStreams::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")
+
+        dynamo_db_streams_obj
+      rescue StandardError => e
+        raise e
+      end
+
+      # Supported Method Parameters::
+      # PWN::AWS::DynamoDBStreams.disconnect(
+      #   dynamo_db_streams_obj: 'required - dynamo_db_streams_obj returned from #connect method'
+      # )
+
+      public_class_method def self.disconnect(opts = {})
+        dynamo_db_streams_obj = opts[:dynamo_db_streams_obj]
+        @@logger.info('Disconnecting...')
+        dynamo_db_streams_obj = nil
+        @@logger.info("complete.\n")
+
+        dynamo_db_streams_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:
+          dynamo_db_streams_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 dynamo_db_streams_obj.public_methods
+
+          #{self}.disconnect(
+            dynamo_db_streams_obj: 'required - dynamo_db_streams_obj returned from #connect method'
+          )
+
+          #{self}.authors
+        "
+      end
+    end
+  end
+end

data/lib/pwn/aws/ec2.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 EC2
+      @@logger = PWN::Plugins::PWNLogger.create
+
+      # Supported Method Parameters::
+      # PWN::AWS::EC2.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 EC2...')
+        if sts_session_token == ''
+          ec2_obj = Aws::EC2::Client.new(
+            region: region,
+            access_key_id: access_key_id,
+            secret_access_key: secret_access_key
+          )
+        else
+          ec2_obj = Aws::EC2::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")
+
+        ec2_obj
+      rescue StandardError => e
+        raise e
+      end
+
+      # Supported Method Parameters::
+      # PWN::AWS::EC2.disconnect(
+      #   ec2_obj: 'required - ec2_obj returned from #connect method'
+      # )
+
+      public_class_method def self.disconnect(opts = {})
+        ec2_obj = opts[:ec2_obj]
+        @@logger.info('Disconnecting...')
+        ec2_obj = nil
+        @@logger.info("complete.\n")
+
+        ec2_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:
+          ec2_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 ec2_obj.public_methods
+
+          #{self}.disconnect(
+            ec2_obj: 'required - ec2_obj returned from #connect method'
+          )
+
+          #{self}.authors
+        "
+      end
+    end
+  end
+end

data/lib/pwn/aws/ecr.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 EC2 Container Registry.
+    module ECR
+      @@logger = PWN::Plugins::PWNLogger.create
+
+      # Supported Method Parameters::
+      # PWN::AWS::ECR.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 ECR...')
+        if sts_session_token == ''
+          ecr_obj = Aws::ECR::Client.new(
+            region: region,
+            access_key_id: access_key_id,
+            secret_access_key: secret_access_key
+          )
+        else
+          ecr_obj = Aws::ECR::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")
+
+        ecr_obj
+      rescue StandardError => e
+        raise e
+      end
+
+      # Supported Method Parameters::
+      # PWN::AWS::ECR.disconnect(
+      #   ecr_obj: 'required - ecr_obj returned from #connect method'
+      # )
+
+      public_class_method def self.disconnect(opts = {})
+        ecr_obj = opts[:ecr_obj]
+        @@logger.info('Disconnecting...')
+        ecr_obj = nil
+        @@logger.info("complete.\n")
+
+        ecr_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:
+          ecr_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 ecr_obj.public_methods
+
+          #{self}.disconnect(
+            ecr_obj: 'required - ecr_obj returned from #connect method'
+          )
+
+          #{self}.authors
+        "
+      end
+    end
+  end
+end

data/lib/pwn/aws/ecs.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 EC2 Container Service.
+    module ECS
+      @@logger = PWN::Plugins::PWNLogger.create
+
+      # Supported Method Parameters::
+      # PWN::AWS::ECS.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 ECS...')
+        if sts_session_token == ''
+          ecs_obj = Aws::ECS::Client.new(
+            region: region,
+            access_key_id: access_key_id,
+            secret_access_key: secret_access_key
+          )
+        else
+          ecs_obj = Aws::ECS::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")
+
+        ecs_obj
+      rescue StandardError => e
+        raise e
+      end
+
+      # Supported Method Parameters::
+      # PWN::AWS::ECS.disconnect(
+      #   ecs_obj: 'required - ecs_obj returned from #connect method'
+      # )
+
+      public_class_method def self.disconnect(opts = {})
+        ecs_obj = opts[:ecs_obj]
+        @@logger.info('Disconnecting...')
+        ecs_obj = nil
+        @@logger.info("complete.\n")
+
+        ecs_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:
+          ecs_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 ecs_obj.public_methods
+
+          #{self}.disconnect(
+            ecs_obj: 'required - ecs_obj returned from #connect method'
+          )
+
+          #{self}.authors
+        "
+      end
+    end
+  end
+end

data/lib/pwn/aws/efs.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 File System.
+    module EFS
+      @@logger = PWN::Plugins::PWNLogger.create
+
+      # Supported Method Parameters::
+      # PWN::AWS::EFS.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 EFS...')
+        if sts_session_token == ''
+          efs_obj = Aws::EFS::Client.new(
+            region: region,
+            access_key_id: access_key_id,
+            secret_access_key: secret_access_key
+          )
+        else
+          efs_obj = Aws::EFS::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")
+
+        efs_obj
+      rescue StandardError => e
+        raise e
+      end
+
+      # Supported Method Parameters::
+      # PWN::AWS::EFS.disconnect(
+      #   efs_obj: 'required - efs_obj returned from #connect method'
+      # )
+
+      public_class_method def self.disconnect(opts = {})
+        efs_obj = opts[:efs_obj]
+        @@logger.info('Disconnecting...')
+        efs_obj = nil
+        @@logger.info("complete.\n")
+
+        efs_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:
+          efs_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 efs_obj.public_methods
+
+          #{self}.disconnect(
+            efs_obj: 'required - efs_obj returned from #connect method'
+          )
+
+          #{self}.authors
+        "
+      end
+    end
+  end
+end