> For the complete documentation index, see [llms.txt](https://docs.saml.to/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.saml.to/usage/github-actions/assume-aws-role-action.md).

# Assume AWS Role Action

https\://github.com/marketplace/actions/saml-to-assume-aws-role

The Assume AWS Role action is the GitHub action that can be used in various repositories to assume a role with configured with SAML.to.

See the [Assume AWS Role Action](https://github.com/marketplace/actions/saml-to-assume-aws-role) on GitHub for more information!

Assuming you have already [Installed SAML.to](/installation.md), the Assume AWS Role Action can be used in GitHub Actions. For example:

```
   jobs:
     prerelease:
       runs-on: ubuntu-latest
       steps:
         - uses: saml-to/assume-aws-role-action@v1
           env:
             GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
           with:
             role: "THE_DESIRED_ROLE_ARN"
         - run: aws ec2 describe-instances
```