# Assume AWS Role Action

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](https://docs.saml.to/installation), 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
```