AssumeRoleWithWebIdentity
The AWS STS operation that exchanges a token from a trusted identity provider for temporary credentials of one IAM role.
In more detail
A trust policy for keyless deploys allows only this action. Tools such as the configure-aws-credentials action call it for you, but it can also be done by hand with the AWS CLI.
Example
aws sts assume-role-with-web-identity --role-arn arn:aws:iam::123456789012:role/github-deploy --role-session-name deploy-checkout --web-identity-token "$TOKEN"Related terms
- AWS STS — The AWS Security Token Service, which issues temporary credentials when someone assumes a role.
- trust policy — A JSON document on a cloud role that says who may assume the role and under which conditions.
- IAM role — A cloud identity with permissions but no password, which trusted users or workloads temporarily assume.
- IAM OIDC identity provider — An entry in an AWS account that tells IAM to trust tokens from one OIDC issuer, such as GitHub's token.actions.githubusercontent.com.
- workload identity — An identity for software rather than a person, proven by a signed token from the platform it runs on instead of a stored key.
Taught in
- Keyless Authentication: OIDC to the Cloud — Continuous Integration & Continuous Delivery Pipelines
- Workload Identity Federation: Eliminating Static Keys — Cloud Security & DevSecOps Engineering
- Cross-Account AssumeRole Chains & Temporary STS — Cloud Security & DevSecOps Engineering