Skip to content

Commit

Permalink
Merge pull request #1061 from synfinatic/update-faq
Browse files Browse the repository at this point in the history
update FAQ for auto-refresh
  • Loading branch information
synfinatic authored Sep 27, 2024
2 parents 1044ef0 + 3071784 commit f07199e
Showing 1 changed file with 14 additions and 0 deletions.
14 changes: 14 additions & 0 deletions docs/FAQ.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,20 @@
Your credentials will expire based on how long your administrator allows. To
see how long your credentials have until they expire, see the [list command](commands.md#list).

### Can aws-sso auto-refresh my IAM role credentials?

If your AWS administrator [configured the IAM role session timeout](
https://docs.aws.amazon.com/singlesignon/latest/userguide/howtosessionduration.html) to a short
duration (default is 1hr), then `aws-sso` will need to reguarly fetch new IAM credentials
when they expire. Sadly, there is no good way to automatically update your shell environment
variables with the new values every time they expire.

However, if you use [aws-sso setup profiles](commands.md#setup-profiles) and then set your
`AWS_PROFILE` environment variable to the name of the profile you'd like to use, then `aws-sso`
can auto-refresh your credentials in the background for as long as your [AWS Identity Center
session](https://docs.aws.amazon.com/singlesignon/latest/userguide/configure-user-session.html)
is valid (default is 8hrs).

### Why can't aws-sso find my new role?

Most likely, this is because the aws-sso [cache](config.md#CacheRefresh) is out of
Expand Down

0 comments on commit f07199e

Please sign in to comment.