pwn 0.4.333

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

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

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

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

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

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

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