sts:AssumeRoleWithSAML

Write

sts:AssumeRoleWithSAML is a Write access-level action in the sts service. Grants permission to obtain a set of temporary security credentials for users who have been authenticated via a SAML authentication response

Resource types

ARNs that sts:AssumeRoleWithSAML can be scoped to in an IAM policy.

arn:${Partition}:iam::${Account}:role/${RoleNameWithPath} required
role

Condition keys

Keys you can use in the Condition block of a policy that grants sts:AssumeRoleWithSAML.

aws:RequestTag/${TagKey} String

Filters access by the tags that are passed in the request

aws:TagKeys ArrayOfString

Filters access by the tag keys that are passed in the request

saml:aud String

Filters access by the endpoint URL to which SAML assertions are presented

saml:cn ArrayOfString

Filters access by the eduOrg attribute

saml:commonName String

Filters access by the commonName attribute

saml:doc String

Filters access by on the principal that was used to assume the role

saml:eduorghomepageuri ArrayOfString

Filters access by the eduOrg attribute

saml:eduorgidentityauthnpolicyuri ArrayOfString

Filters access by the eduOrg attribute

saml:eduorglegalname ArrayOfString

Filters access by the eduOrg attribute

saml:eduorgsuperioruri ArrayOfString

Filters access by the eduOrg attribute

saml:eduorgwhitepagesuri ArrayOfString

Filters access by the eduOrg attribute

saml:edupersonaffiliation ArrayOfString

Filters access by the eduPerson attribute

saml:edupersonassurance ArrayOfString

Filters access by the eduPerson attribute

saml:edupersonentitlement ArrayOfString

Filters access by the eduPerson attribute

saml:edupersonnickname ArrayOfString

Filters access by the eduPerson attribute

saml:edupersonorgdn String

Filters access by the eduPerson attribute

saml:edupersonorgunitdn ArrayOfString

Filters access by the eduPerson attribute

saml:edupersonprimaryaffiliation String

Filters access by the eduPerson attribute

saml:edupersonprimaryorgunitdn String

Filters access by the eduPerson attribute

saml:edupersonprincipalname String

Filters access by the eduPerson attribute

saml:edupersonscopedaffiliation ArrayOfString

Filters access by the eduPerson attribute

saml:edupersontargetedid ArrayOfString

Filters access by the eduPerson attribute

saml:givenName String

Filters access by the givenName attribute

saml:iss String

Filters access by on the issuer, which is represented by a URN

saml:mail String

Filters access by the mail attribute

saml:name String

Filters access by the name attribute

saml:namequalifier String

Filters access by the hash value of the issuer, account ID, and friendly name

saml:organizationStatus String

Filters access by the organizationStatus attribute

saml:primaryGroupSID String

Filters access by the primaryGroupSID attribute

saml:sub String

Filters access by the subject of the claim (the SAML user ID)

saml:sub_type String

Filters access by the value persistent, transient, or the full Format URI

saml:surname String

Filters access by the surname attribute

saml:uid String

Filters access by the uid attribute

saml:x500UniqueIdentifier String

Filters access by the uid attribute

sts:RoleSessionName String

Filters access by the role session name required when you assume a role

sts:SourceIdentity String

Filters access by the source identity that is passed in the request

sts:TransitiveTagKeys ArrayOfString

Filters access by the transitive tag keys that are passed in the request

aws:ResourceTag/${TagKey} String

Filters access by the tags associated with the resource

iam:ResourceTag/${TagKey} String

Filters access by the tags that are attached to the role that is being assumed

Example IAM policy

A minimal policy that allows sts:AssumeRoleWithSAML. Replace "Resource": "*" with a specific ARN to follow least privilege.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "AllowStsAssumeRoleWithSAML",
      "Effect": "Allow",
      "Action": "sts:AssumeRoleWithSAML",
      "Resource": "*"
    }
  ]
}

Related actions in sts

View all sts actions →