aws-sdk-securityagent 1.16.0 → 1.17.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: dbcaf8dcdbb8741c7abbb334bcb971e8f686fca4eabc3f4753389c4608e7e391
-  data.tar.gz: 8ee954386902a661bd173cafac4e6e011030e1db17a75c3e0326bd356d570625
+  metadata.gz: eae54b3ba11b0f4836327afe62abb61f3d33265830f4bb7bc7cf3fac15a0214a
+  data.tar.gz: 106cf10c9d45280f1bbd077c6404473fe8da4f1b5d5c70d988b195f20a13a040
 SHA512:
-  metadata.gz: 16b9bcb025ee64fa3b3ccf5c3e6b7e8e3b1bce39c330b8723f9624ec7c96f5470b00209d852f38752c75e95ae2afbee9081a264ed32f384fb96523df62365e51
-  data.tar.gz: 1cd2e65a40bc59a29e91cee64991cb7b7cc4496da5df667c87d9f362504cba9a536864ce8ed9646284e8d7fdea558816b94c1a3f2e5084dbff7808b6f8796486
+  metadata.gz: 05c7848d97e76e9f73cd3b888bb639395544d063caf72d8eb35397dae8bcacd17267030620b0a4f30fad1b338e0ce63de58ee0155289e8ee28c7caa8bbbddcd3
+  data.tar.gz: dd495fb1528cff93bc75bcfef765e293198d25a0f0d6bbddbda43364439b8bc909b4f76f1286b7dcaec50837adeb0dd4eca09c78ddfad2067b45c60d47809e5c

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.17.0 (2026-09-25)
+------------------
+
+* Feature - This release adds the ListActorMessages operation, which returns the multi-factor authentication messages received at an actor's server-generated email address
+
 1.16.0 (2026-09-24)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.16.0
+1.17.0

data/lib/aws-sdk-securityagent/client.rb

@@ -3609,6 +3609,63 @@ module Aws::SecurityAgent
       req.send_request(options)
     end
 
+    # Returns a paginated list of the email MFA messages received for an
+    # actor at its server-generated email address, most recent first.
+    #
+    # @option params [Integer] :max_results
+    #   The maximum number of results to return in a single call.
+    #
+    # @option params [String] :next_token
+    #   A token to use for paginating results that are returned in the
+    #   response. Set the value of this parameter to null for the first
+    #   request. For subsequent calls, use the nextToken value returned from
+    #   the previous request.
+    #
+    # @option params [required, String] :agent_space_id
+    #   The unique identifier of the agent space that owns the pentest.
+    #
+    # @option params [required, String] :pentest_id
+    #   The unique identifier of the pentest that the actor belongs to.
+    #
+    # @option params [required, String] :actor_identifier
+    #   The identifier of the actor whose messages to list. The identifier is
+    #   case-insensitive.
+    #
+    # @return [Types::ListActorMessagesOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::ListActorMessagesOutput#messages #messages} => Array<Types::ActorMessage>
+    #   * {Types::ListActorMessagesOutput#next_token #next_token} => String
+    #
+    # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.list_actor_messages({
+    #     max_results: 1,
+    #     next_token: "NextToken",
+    #     agent_space_id: "String", # required
+    #     pentest_id: "String", # required
+    #     actor_identifier: "String", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.messages #=> Array
+    #   resp.messages[0].sender #=> String
+    #   resp.messages[0].subject #=> String
+    #   resp.messages[0].body #=> String
+    #   resp.messages[0].received_at #=> Time
+    #   resp.next_token #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/securityagent-2025-09-06/ListActorMessages AWS API Documentation
+    #
+    # @overload list_actor_messages(params = {})
+    # @param [Hash] params ({})
+    def list_actor_messages(params = {}, options = {})
+      req = build_request(:list_actor_messages, params)
+      req.send_request(options)
+    end
+
     # Returns a paginated list of agent space summaries in your account.
     #
     # @option params [String] :next_token
@@ -6427,7 +6484,7 @@ module Aws::SecurityAgent
         tracer: tracer
       )
       context[:gem_name] = 'aws-sdk-securityagent'
-      context[:gem_version] = '1.16.0'
+      context[:gem_version] = '1.17.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

data/lib/aws-sdk-securityagent/client_api.rb

@@ -20,6 +20,8 @@ module Aws::SecurityAgent
     AccessType = Shapes::StringShape.new(name: 'AccessType')
     Actor = Shapes::StructureShape.new(name: 'Actor')
     ActorList = Shapes::ListShape.new(name: 'ActorList')
+    ActorMessage = Shapes::StructureShape.new(name: 'ActorMessage')
+    ActorMessageList = Shapes::ListShape.new(name: 'ActorMessageList')
     AddArtifactInput = Shapes::StructureShape.new(name: 'AddArtifactInput')
     AddArtifactOutput = Shapes::StructureShape.new(name: 'AddArtifactOutput')
     AgentName = Shapes::StringShape.new(name: 'AgentName')
@@ -264,6 +266,8 @@ module Aws::SecurityAgent
     KmsKeyId = Shapes::StringShape.new(name: 'KmsKeyId')
     LambdaFunctionArn = Shapes::StringShape.new(name: 'LambdaFunctionArn')
     LambdaFunctionArns = Shapes::ListShape.new(name: 'LambdaFunctionArns')
+    ListActorMessagesInput = Shapes::StructureShape.new(name: 'ListActorMessagesInput')
+    ListActorMessagesOutput = Shapes::StructureShape.new(name: 'ListActorMessagesOutput')
     ListAgentSpacesInput = Shapes::StructureShape.new(name: 'ListAgentSpacesInput')
     ListAgentSpacesOutput = Shapes::StructureShape.new(name: 'ListAgentSpacesOutput')
     ListApplicationsRequest = Shapes::StructureShape.new(name: 'ListApplicationsRequest')
@@ -401,6 +405,9 @@ module Aws::SecurityAgent
     SelfManagedInput = Shapes::StructureShape.new(name: 'SelfManagedInput')
     SensitiveEmail = Shapes::StringShape.new(name: 'SensitiveEmail')
     SensitiveEmailAddress = Shapes::StringShape.new(name: 'SensitiveEmailAddress')
+    SensitiveMessageBody = Shapes::StringShape.new(name: 'SensitiveMessageBody')
+    SensitiveMessageSender = Shapes::StringShape.new(name: 'SensitiveMessageSender')
+    SensitiveMessageSubject = Shapes::StringShape.new(name: 'SensitiveMessageSubject')
     ServiceManagedInput = Shapes::StructureShape.new(name: 'ServiceManagedInput')
     ServiceQuotaExceededException = Shapes::StructureShape.new(name: 'ServiceQuotaExceededException')
     ServiceRole = Shapes::StringShape.new(name: 'ServiceRole')
@@ -548,6 +555,14 @@ module Aws::SecurityAgent
 
     ActorList.member = Shapes::ShapeRef.new(shape: Actor)
 
+    ActorMessage.add_member(:sender, Shapes::ShapeRef.new(shape: SensitiveMessageSender, location_name: "sender"))
+    ActorMessage.add_member(:subject, Shapes::ShapeRef.new(shape: SensitiveMessageSubject, location_name: "subject"))
+    ActorMessage.add_member(:body, Shapes::ShapeRef.new(shape: SensitiveMessageBody, location_name: "body"))
+    ActorMessage.add_member(:received_at, Shapes::ShapeRef.new(shape: SyntheticTimestamp_date_time, location_name: "receivedAt"))
+    ActorMessage.struct_class = Types::ActorMessage
+
+    ActorMessageList.member = Shapes::ShapeRef.new(shape: ActorMessage)
+
     AddArtifactInput.add_member(:agent_space_id, Shapes::ShapeRef.new(shape: AgentSpaceId, required: true, location_name: "agentSpaceId"))
     AddArtifactInput.add_member(:artifact_content, Shapes::ShapeRef.new(shape: Blob, required: true, location_name: "artifactContent"))
     AddArtifactInput.add_member(:artifact_type, Shapes::ShapeRef.new(shape: ArtifactType, required: true, location_name: "artifactType"))
@@ -1611,6 +1626,17 @@ module Aws::SecurityAgent
 
     LambdaFunctionArns.member = Shapes::ShapeRef.new(shape: LambdaFunctionArn)
 
+    ListActorMessagesInput.add_member(:max_results, Shapes::ShapeRef.new(shape: MaxResults, location_name: "maxResults"))
+    ListActorMessagesInput.add_member(:next_token, Shapes::ShapeRef.new(shape: NextToken, location_name: "nextToken"))
+    ListActorMessagesInput.add_member(:agent_space_id, Shapes::ShapeRef.new(shape: String, required: true, location_name: "agentSpaceId"))
+    ListActorMessagesInput.add_member(:pentest_id, Shapes::ShapeRef.new(shape: String, required: true, location_name: "pentestId"))
+    ListActorMessagesInput.add_member(:actor_identifier, Shapes::ShapeRef.new(shape: String, required: true, location_name: "actorIdentifier"))
+    ListActorMessagesInput.struct_class = Types::ListActorMessagesInput
+
+    ListActorMessagesOutput.add_member(:messages, Shapes::ShapeRef.new(shape: ActorMessageList, location_name: "messages"))
+    ListActorMessagesOutput.add_member(:next_token, Shapes::ShapeRef.new(shape: NextToken, location_name: "nextToken"))
+    ListActorMessagesOutput.struct_class = Types::ListActorMessagesOutput
+
     ListAgentSpacesInput.add_member(:next_token, Shapes::ShapeRef.new(shape: NextToken, location_name: "nextToken"))
     ListAgentSpacesInput.add_member(:max_results, Shapes::ShapeRef.new(shape: MaxResults, location_name: "maxResults"))
     ListAgentSpacesInput.struct_class = Types::ListAgentSpacesInput
@@ -3191,6 +3217,20 @@ module Aws::SecurityAgent
         o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException)
       end)
 
+      api.add_operation(:list_actor_messages, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "ListActorMessages"
+        o.http_method = "POST"
+        o.http_request_uri = "/ListActorMessages"
+        o.input = Shapes::ShapeRef.new(shape: ListActorMessagesInput)
+        o.output = Shapes::ShapeRef.new(shape: ListActorMessagesOutput)
+        o[:pager] = Aws::Pager.new(
+          limit_key: "max_results",
+          tokens: {
+            "next_token" => "next_token"
+          }
+        )
+      end)
+
       api.add_operation(:list_agent_spaces, Seahorse::Model::Operation.new.tap do |o|
         o.name = "ListAgentSpaces"
         o.http_method = "POST"

data/lib/aws-sdk-securityagent/types.rb

@@ -109,6 +109,36 @@ module Aws::SecurityAgent
       include Aws::Structure
     end
 
+    # A message received at an actor's server-generated email MFA address.
+    #
+    # @!attribute [rw] sender
+    #   The address the message was sent from.
+    #   @return [String]
+    #
+    # @!attribute [rw] subject
+    #   The subject line of the message.
+    #   @return [String]
+    #
+    # @!attribute [rw] body
+    #   The plain-text body of the message, containing the MFA code or
+    #   verification link.
+    #   @return [String]
+    #
+    # @!attribute [rw] received_at
+    #   The time the message was received.
+    #   @return [Time]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/securityagent-2025-09-06/ActorMessage AWS API Documentation
+    #
+    class ActorMessage < Struct.new(
+      :sender,
+      :subject,
+      :body,
+      :received_at)
+      SENSITIVE = [:sender, :subject, :body]
+      include Aws::Structure
+    end
+
     # @!attribute [rw] agent_space_id
     #   The unique identifier of the agent space to add the artifact to.
     #   @return [String]
@@ -4875,6 +4905,62 @@ module Aws::SecurityAgent
       include Aws::Structure
     end
 
+    # @!attribute [rw] max_results
+    #   The maximum number of results to return in a single call.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] next_token
+    #   A token to use for paginating results that are returned in the
+    #   response. Set the value of this parameter to null for the first
+    #   request. For subsequent calls, use the nextToken value returned from
+    #   the previous request.
+    #   @return [String]
+    #
+    # @!attribute [rw] agent_space_id
+    #   The unique identifier of the agent space that owns the pentest.
+    #   @return [String]
+    #
+    # @!attribute [rw] pentest_id
+    #   The unique identifier of the pentest that the actor belongs to.
+    #   @return [String]
+    #
+    # @!attribute [rw] actor_identifier
+    #   The identifier of the actor whose messages to list. The identifier
+    #   is case-insensitive.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/securityagent-2025-09-06/ListActorMessagesInput AWS API Documentation
+    #
+    class ListActorMessagesInput < Struct.new(
+      :max_results,
+      :next_token,
+      :agent_space_id,
+      :pentest_id,
+      :actor_identifier)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] messages
+    #   The list of messages received for the actor, most recent first.
+    #   @return [Array<Types::ActorMessage>]
+    #
+    # @!attribute [rw] next_token
+    #   A token to use for paginating results that are returned in the
+    #   response. Set the value of this parameter to null for the first
+    #   request. For subsequent calls, use the nextToken value returned from
+    #   the previous request.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/securityagent-2025-09-06/ListActorMessagesOutput AWS API Documentation
+    #
+    class ListActorMessagesOutput < Struct.new(
+      :messages,
+      :next_token)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # Input for listing agent spaces.
     #
     # @!attribute [rw] next_token

data/lib/aws-sdk-securityagent.rb

@@ -55,7 +55,7 @@ module Aws::SecurityAgent
   autoload :EndpointProvider, 'aws-sdk-securityagent/endpoint_provider'
   autoload :Endpoints, 'aws-sdk-securityagent/endpoints'
 
-  GEM_VERSION = '1.16.0'
+  GEM_VERSION = '1.17.0'
 
 end
 

data/sig/client.rbs

@@ -903,6 +903,21 @@ module Aws
                                           ) -> _InitiateProviderRegistrationResponseSuccess
                                         | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _InitiateProviderRegistrationResponseSuccess
 
+      interface _ListActorMessagesResponseSuccess
+        include ::Seahorse::Client::_ResponseSuccess[Types::ListActorMessagesOutput]
+        def messages: () -> ::Array[Types::ActorMessage]
+        def next_token: () -> ::String
+      end
+      # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/SecurityAgent/Client.html#list_actor_messages-instance_method
+      def list_actor_messages: (
+                                 ?max_results: ::Integer,
+                                 ?next_token: ::String,
+                                 agent_space_id: ::String,
+                                 pentest_id: ::String,
+                                 actor_identifier: ::String
+                               ) -> _ListActorMessagesResponseSuccess
+                             | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _ListActorMessagesResponseSuccess
+
       interface _ListAgentSpacesResponseSuccess
         include ::Seahorse::Client::_ResponseSuccess[Types::ListAgentSpacesOutput]
         def agent_space_summaries: () -> ::Array[Types::AgentSpaceSummary]

data/sig/types.rbs

@@ -33,6 +33,14 @@ module Aws::SecurityAgent
       SENSITIVE: [:mfa_forwarding_address]
     end
 
+    class ActorMessage
+      attr_accessor sender: ::String
+      attr_accessor subject: ::String
+      attr_accessor body: ::String
+      attr_accessor received_at: ::Time
+      SENSITIVE: [:sender, :subject, :body]
+    end
+
     class AddArtifactInput
       attr_accessor agent_space_id: ::String
       attr_accessor artifact_content: ::String
@@ -1360,6 +1368,21 @@ module Aws::SecurityAgent
       SENSITIVE: []
     end
 
+    class ListActorMessagesInput
+      attr_accessor max_results: ::Integer
+      attr_accessor next_token: ::String
+      attr_accessor agent_space_id: ::String
+      attr_accessor pentest_id: ::String
+      attr_accessor actor_identifier: ::String
+      SENSITIVE: []
+    end
+
+    class ListActorMessagesOutput
+      attr_accessor messages: ::Array[Types::ActorMessage]
+      attr_accessor next_token: ::String
+      SENSITIVE: []
+    end
+
     class ListAgentSpacesInput
       attr_accessor next_token: ::String
       attr_accessor max_results: ::Integer

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-securityagent
 version: !ruby/object:Gem::Version
-  version: 1.16.0
+  version: 1.17.0
 platform: ruby
 authors:
 - Amazon Web Services