Interface AssumeRoleWithSamlResponse.Builder
-
- All Superinterfaces:
AwsResponse.Builder,Buildable,CopyableBuilder<AssumeRoleWithSamlResponse.Builder,AssumeRoleWithSamlResponse>,SdkBuilder<AssumeRoleWithSamlResponse.Builder,AssumeRoleWithSamlResponse>,SdkPojo,SdkResponse.Builder,StsResponse.Builder
- Enclosing class:
- AssumeRoleWithSamlResponse
@Mutable @NotThreadSafe public static interface AssumeRoleWithSamlResponse.Builder extends StsResponse.Builder, SdkPojo, CopyableBuilder<AssumeRoleWithSamlResponse.Builder,AssumeRoleWithSamlResponse>
-
-
Method Summary
All Methods Instance Methods Abstract Methods Default Methods Modifier and Type Method Description default AssumeRoleWithSamlResponse.BuilderassumedRoleUser(Consumer<AssumedRoleUser.Builder> assumedRoleUser)The identifiers for the temporary security credentials that the operation returns.AssumeRoleWithSamlResponse.BuilderassumedRoleUser(AssumedRoleUser assumedRoleUser)The identifiers for the temporary security credentials that the operation returns.AssumeRoleWithSamlResponse.Builderaudience(String audience)The value of theRecipientattribute of theSubjectConfirmationDataelement of the SAML assertion.default AssumeRoleWithSamlResponse.Buildercredentials(Consumer<Credentials.Builder> credentials)The temporary security credentials, which include an access key ID, a secret access key, and a security (or session) token.AssumeRoleWithSamlResponse.Buildercredentials(Credentials credentials)The temporary security credentials, which include an access key ID, a secret access key, and a security (or session) token.AssumeRoleWithSamlResponse.Builderissuer(String issuer)The value of theIssuerelement of the SAML assertion.AssumeRoleWithSamlResponse.BuildernameQualifier(String nameQualifier)A hash value based on the concatenation of the following:AssumeRoleWithSamlResponse.BuilderpackedPolicySize(Integer packedPolicySize)A percentage value that indicates the packed size of the session policies and session tags combined passed in the request.AssumeRoleWithSamlResponse.BuildersourceIdentity(String sourceIdentity)The value in theSourceIdentityattribute in the SAML assertion.AssumeRoleWithSamlResponse.Buildersubject(String subject)The value of theNameIDelement in theSubjectelement of the SAML assertion.AssumeRoleWithSamlResponse.BuildersubjectType(String subjectType)The format of the name ID, as defined by theFormatattribute in theNameIDelement of the SAML assertion.-
Methods inherited from interface software.amazon.awssdk.utils.builder.CopyableBuilder
copy
-
Methods inherited from interface software.amazon.awssdk.utils.builder.SdkBuilder
applyMutation, build
-
Methods inherited from interface software.amazon.awssdk.core.SdkPojo
equalsBySdkFields, sdkFieldNameToField, sdkFields
-
Methods inherited from interface software.amazon.awssdk.core.SdkResponse.Builder
sdkHttpResponse, sdkHttpResponse
-
Methods inherited from interface software.amazon.awssdk.services.sts.model.StsResponse.Builder
build, responseMetadata, responseMetadata
-
-
-
-
Method Detail
-
credentials
AssumeRoleWithSamlResponse.Builder credentials(Credentials credentials)
The temporary security credentials, which include an access key ID, a secret access key, and a security (or session) token.
The size of the security token that STS API operations return is not fixed. We strongly recommend that you make no assumptions about the maximum size.
- Parameters:
credentials- The temporary security credentials, which include an access key ID, a secret access key, and a security (or session) token.The size of the security token that STS API operations return is not fixed. We strongly recommend that you make no assumptions about the maximum size.
- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
credentials
default AssumeRoleWithSamlResponse.Builder credentials(Consumer<Credentials.Builder> credentials)
The temporary security credentials, which include an access key ID, a secret access key, and a security (or session) token.
This is a convenience method that creates an instance of theThe size of the security token that STS API operations return is not fixed. We strongly recommend that you make no assumptions about the maximum size.
Credentials.Builderavoiding the need to create one manually viaCredentials.builder().When the
Consumercompletes,SdkBuilder.build()is called immediately and its result is passed tocredentials(Credentials).- Parameters:
credentials- a consumer that will call methods onCredentials.Builder- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
credentials(Credentials)
-
assumedRoleUser
AssumeRoleWithSamlResponse.Builder assumedRoleUser(AssumedRoleUser assumedRoleUser)
The identifiers for the temporary security credentials that the operation returns.
- Parameters:
assumedRoleUser- The identifiers for the temporary security credentials that the operation returns.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
assumedRoleUser
default AssumeRoleWithSamlResponse.Builder assumedRoleUser(Consumer<AssumedRoleUser.Builder> assumedRoleUser)
The identifiers for the temporary security credentials that the operation returns.
This is a convenience method that creates an instance of theAssumedRoleUser.Builderavoiding the need to create one manually viaAssumedRoleUser.builder().When the
Consumercompletes,SdkBuilder.build()is called immediately and its result is passed toassumedRoleUser(AssumedRoleUser).- Parameters:
assumedRoleUser- a consumer that will call methods onAssumedRoleUser.Builder- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
assumedRoleUser(AssumedRoleUser)
-
packedPolicySize
AssumeRoleWithSamlResponse.Builder packedPolicySize(Integer packedPolicySize)
A percentage value that indicates the packed size of the session policies and session tags combined passed in the request. The request fails if the packed size is greater than 100 percent, which means the policies and tags exceeded the allowed space.
- Parameters:
packedPolicySize- A percentage value that indicates the packed size of the session policies and session tags combined passed in the request. The request fails if the packed size is greater than 100 percent, which means the policies and tags exceeded the allowed space.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
subject
AssumeRoleWithSamlResponse.Builder subject(String subject)
The value of the
NameIDelement in theSubjectelement of the SAML assertion.- Parameters:
subject- The value of theNameIDelement in theSubjectelement of the SAML assertion.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
subjectType
AssumeRoleWithSamlResponse.Builder subjectType(String subjectType)
The format of the name ID, as defined by the
Formatattribute in theNameIDelement of the SAML assertion. Typical examples of the format aretransientorpersistent.If the format includes the prefix
urn:oasis:names:tc:SAML:2.0:nameid-format, that prefix is removed. For example,urn:oasis:names:tc:SAML:2.0:nameid-format:transientis returned astransient. If the format includes any other prefix, the format is returned with no modifications.- Parameters:
subjectType- The format of the name ID, as defined by theFormatattribute in theNameIDelement of the SAML assertion. Typical examples of the format aretransientorpersistent.If the format includes the prefix
urn:oasis:names:tc:SAML:2.0:nameid-format, that prefix is removed. For example,urn:oasis:names:tc:SAML:2.0:nameid-format:transientis returned astransient. If the format includes any other prefix, the format is returned with no modifications.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
issuer
AssumeRoleWithSamlResponse.Builder issuer(String issuer)
The value of the
Issuerelement of the SAML assertion.- Parameters:
issuer- The value of theIssuerelement of the SAML assertion.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
audience
AssumeRoleWithSamlResponse.Builder audience(String audience)
The value of the
Recipientattribute of theSubjectConfirmationDataelement of the SAML assertion.- Parameters:
audience- The value of theRecipientattribute of theSubjectConfirmationDataelement of the SAML assertion.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
nameQualifier
AssumeRoleWithSamlResponse.Builder nameQualifier(String nameQualifier)
A hash value based on the concatenation of the following:
-
The
Issuerresponse value. -
The Amazon Web Services account ID.
-
The friendly name (the last part of the ARN) of the SAML provider in IAM.
The combination of
NameQualifierandSubjectcan be used to uniquely identify a user.The following pseudocode shows how the hash value is calculated:
BASE64 ( SHA1 ( "https://example.com/saml" + "123456789012" + "/MySAMLIdP" ) )- Parameters:
nameQualifier- A hash value based on the concatenation of the following:-
The
Issuerresponse value. -
The Amazon Web Services account ID.
-
The friendly name (the last part of the ARN) of the SAML provider in IAM.
The combination of
NameQualifierandSubjectcan be used to uniquely identify a user.The following pseudocode shows how the hash value is calculated:
BASE64 ( SHA1 ( "https://example.com/saml" + "123456789012" + "/MySAMLIdP" ) )-
- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
-
sourceIdentity
AssumeRoleWithSamlResponse.Builder sourceIdentity(String sourceIdentity)
The value in the
SourceIdentityattribute in the SAML assertion. The source identity value persists across chained role sessions.You can require users to set a source identity value when they assume a role. You do this by using the
sts:SourceIdentitycondition key in a role trust policy. That way, actions that are taken with the role are associated with that user. After the source identity is set, the value cannot be changed. It is present in the request for all actions that are taken by the role and persists across chained role sessions. You can configure your SAML identity provider to use an attribute associated with your users, like user name or email, as the source identity when callingAssumeRoleWithSAML. You do this by adding an attribute to the SAML assertion. For more information about using source identity, see Monitor and control actions taken with assumed roles in the IAM User Guide.The regex used to validate this parameter is a string of characters consisting of upper- and lower-case alphanumeric characters with no spaces. You can also include underscores or any of the following characters: =,.@-
- Parameters:
sourceIdentity- The value in theSourceIdentityattribute in the SAML assertion. The source identity value persists across chained role sessions.You can require users to set a source identity value when they assume a role. You do this by using the
sts:SourceIdentitycondition key in a role trust policy. That way, actions that are taken with the role are associated with that user. After the source identity is set, the value cannot be changed. It is present in the request for all actions that are taken by the role and persists across chained role sessions. You can configure your SAML identity provider to use an attribute associated with your users, like user name or email, as the source identity when callingAssumeRoleWithSAML. You do this by adding an attribute to the SAML assertion. For more information about using source identity, see Monitor and control actions taken with assumed roles in the IAM User Guide.The regex used to validate this parameter is a string of characters consisting of upper- and lower-case alphanumeric characters with no spaces. You can also include underscores or any of the following characters: =,.@-
- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
-