README

https://img.shields.io/badge/release-v0.3.7-blue.svg https://img.shields.io/jenkins/s/https/jenkins.qa.ubuntu.com/view/Precise/view/All%20Precise/job/precise-desktop-amd64_default.svg https://img.shields.io/readthedocs/pip.svg https://img.shields.io/badge/python-3.5%2C%203.6-blue.svg https://img.shields.io/badge/dependencies-boto3%2C%20awscli%2C%20pytz-yellow.svg https://img.shields.io/badge/License-GPL%20v3-blue.svg

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:

Download: Available via download in the formats below

Getting Started

Before starting, read the following to understand stslib key concepts and use cases:

Current Release:

See v0.3.7 Release Notes

Previous Releases


Use

Note

stslib is available via pip in the official python registry
and is licensed under the General Public License v3

Contact

Author: Blake Huber
Github: [github_user](https://github.com/fstab50)

( Table Of Contents )