README¶
Purpose¶
stslib (pronounced s-t-s aay-val), is a python3 library that requests and manages temporary credentials from Amazon’s Security Token Service (STS) on your behalf. stslib generates temporary credentials against roles that reside in any number of AWS accounts.
The stslib library is commonly used in python applications that generate temporary access credentials for automation tools which need to bypass multi-factor authentication enabled on Amazon APIs. Temporary credentials of this type are are required authenticate to Amazon Web Services (AWS) when automation tooling is used to deploy to tens or even hundreds of AWS accounts simultaneously.
stslib is appropriate for authentication to AWS Services both from within AWS as well by automation tooling runs in an environment external to AWS such as an on-prem datacenter or local machine. local machine.
stslib manages temporary credentials generates credentials in memory for applications that need access to iam roles at AWS. If temporary credentials are needed for extended periods (> 1 hour), stslib will automatically renew sts credentials before expiration.
Documentation¶
Online:
- Complete html documentation available at http://stslib.readthedocs.io.
Download: Available via download in the formats below
- pdf format
- Amazon Kindle (epub) format
Getting Started¶
Before starting, read the following to understand stslib key concepts and use cases:
- Frequently Asked Questions (FAQ)
- Credential Format Overview – A primer on the dual credential formats supported by stslib
- Code Examples
Current Release:
Previous Releases
Use¶
Note