Metadata-Version: 2.0
Name: aws-role-credentials
Version: 0.2.0
Summary: Generates AWS credentials for roles using STS
Home-page: https://github.com/petergillardmoss/aws_role_credentials
Author: Peter Gillard-Moss
Author-email: pgillard@thoughtworks.com
License: ISCL
Keywords: aws_role_credentials
Platform: UNKNOWN
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: ISC License (ISCL)
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Requires-Dist: boto
Requires-Dist: argparse

===============================
AWS Role Credentials
===============================

.. image:: https://img.shields.io/pypi/v/aws_role_credentials.svg
        :target: https://pypi.python.org/pypi/aws_role_credentials


Generates AWS credentials for roles using STS and writes them to ```~/.aws/credentials```

Usage
=====

Simply pipe a SAML assertion into awssaml

    # create credentials from saml assertion

    $ oktaauth -u joebloggs | aws_role_credentials saml --profile dev


Or for assuming a role using an IAM user:

    # create credentials from an iam user

    $ aws_role_credentials user arn:aws:iam::111111:role/dev joebloggs-session --profile dev


Options
=======

    --profile          Use a specific profile in your credential file (e.g. Development).  Defaults to sts.
    --region           The region to use. Overrides config/env settings.  Defaults to us-east-1.


Thanks
======

Thanks to Quint Van Deman of AWS for demonstrating how to do this. https://blogs.aws.amazon.com/security/post/Tx1LDN0UBGJJ26Q/How-to-Implement-Federated-API-and-CLI-Access-Using-SAML-2-0-and-AD-FS


Authors
=======

* Peter Gillard-Moss




History
-------

0.1.0 (2015-01-11)
---------------------

* First release on PyPI.


