Metadata-Version: 2.0
Name: qrmr
Version: 0.4.2
Summary: Terminal login toolkit for Amazon Web Services (AWS) enforcing and simplifying use of Multi-Factor Authentication (MFA).
Home-page: https://gitlab.com/qrmr/qrmr
Author: Alexander L. de Goeij
Author-email: mail@aldg.nl
License: NO_LICENSE_YET
Description-Content-Type: UNKNOWN
Keywords: cloud aws cli login mfa otp session token
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Environment :: MacOS X
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Topic :: Software Development
Classifier: Topic :: Utilities
Requires-Dist: future
Requires-Dist: colorlog
Requires-Dist: boto3
Requires-Dist: configparser
Requires-Dist: requests

QRMR, AWS terminal login tool
=============================================

    Work secure using MFA according to best practices, and efficiently
    with AWS terminal tools like ``aws`` cli, ``aws-shell``,
    ``terraform``, etc.

Highly opinionated Amazon Web Services (AWS) terminal login toolkit, focused on
enforcing and simplifying AWS Multi-Factor Authentication (MFA).

Written in Python 3, backwards compatible with Python 2, thanks to ``futures``!

Currently being heavily tested in production against AWS multi-account setup (Well-Architected Framework) on macOS High Sierra.

Feels most at home using `virtualenv`, of course.

**How it works:**

* Stores your AWS IAM credential profile in ``~/.qrmr/credentials.ini``;
* Prompts for MFA OTP code;
* Uses AWS STS to retrieve and store fresh SessionToken and temporary Access Key ID and Secret Access Key using your credential profile.

**Near future:**

* Manage ``~/.aws/credentials`` and ``~/.aws/config`` files
* Unit Tests :)

Because you probably just want to start using it:

**Installation of QRMR:**

``pip install qrmr``

**Setup of AWS Credentials:**

``qrmr setup``

**Refreshing your SessionToken and temporary keys:**

``qrmr refresh``

**Be cool:**

``aws s3 ls``


**REMEMBER:** set environment variable AWS_PROFILE in your shell or virtualenv to
make life easier:

``export AWS_PROFILE=iam_user_name``

Find out more features by running:

``qrmr --help``

Find us on: https://gitlab.com/qrmr/qrmr

Resources:
----------

- https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html


License / Copyright / Disclaimer:
---------------------------------

(c)Copyright 2017 - 2018, all rights reserved by QRMR / ALDG / Alexander L. de Goeij.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS “AS
IS” AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED
TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.


