pwn 0.4.333

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

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

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

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

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

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

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