{ "info": { "author": "finklabs", "author_email": "mark@finklabs.de", "bugtrack_url": null, "classifiers": [ "Environment :: Console", "Intended Audience :: Developers", "License :: OSI Approved :: MIT License", "Natural Language :: English", "Programming Language :: Python :: 2.7", "Programming Language :: Python :: 3.6" ], "description": "|Documentation| |License| |GitHub issues|\n\nnote: use with caution! this is untested code in an experimental stage!\n\nPlugin for fink\n===============\n\nfink: https://github.com/finklabs/fink\n\nThis plugin makes it easy to manage your AWS SDK Security Credentials\nwhen Multi-Factor Authentication (MFA) is enforced on your AWS account.\nIt automates the process of obtaining temporary credentials from the AWS\nSecurity Token Service and updating your AWS Credentials file (located\nat ~/.aws/credentials).\n\nFeatures include:\n\n- create temporary credentials to access an AWS account\n- switch between accounts\n- allow fink to check remaining time until expired\n- renew credentials as part of the fink lifecycle\n\nInstalling the plugin\n---------------------\n\nAdd the following entry to the ``requirements_fink.txt`` file:\n\n.. code:: text\n\n fink.awsume\n\nIf you have not not activate the venv, please do so:\n\n.. code:: bash\n\n $ source ./venv/bin/activate\n\nAnd the installation step itself:\n\n.. code:: bash\n\n $ pip install -r -U requirements_fink.txt\n\nInitial setup\n-------------\n\n**Set ENV variable AWS\\_DEFAULT\\_PROFILE or script will use \"default\"\nprofile**\n\n.. code:: bash\n\n $ export AWS_DEFAULT_PROFILE=\n\nCredentials File Setup\n----------------------\n\nIn a typical AWS credentials file (located at ~/.aws/credentials),\ncredentials are stored in sections, denoted by a pair of brackets: [].\nThe [default] section stores your default credentials. You can store\nmultiple sets of credentials using different profile names. If no\nprofile is specified, the [default] section is always used.\n\nLong term credential sections are identified by the convention\n[-long-term]. Short term credentials are identified by the typical\nconvention: []. The following illustrates how you would configure you\ncredentials file using this script:\n\n.. code:: text\n\n [-long-term]\n aws_access_key_id = YOUR_LONGTERM_KEY_ID\n aws_secret_access_key = YOUR_LONGTERM_ACCESS_KEY\n\nAfter running the awsume command, your credentials file would read:\n\n.. code:: text\n\n [-long-term]\n aws_access_key_id = YOUR_LONGTERM_KEY_ID\n aws_secret_access_key = YOUR_LONGTERM_ACCESS_KEY\n\n []\n aws_access_key_id = \n aws_secret_access_key = \n aws_security_token = \n\nUsage\n-----\n\n.. code:: text\n\n Usage:\n awsume\n awsume renew\n awsume switch \n awsume set [--profile=] [--username=]\n awsume list\n awsume clean\n awsume version\n\n -h --help show this\n\nUsage example\n-------------\n\nIf you don't know the account and access what you need you can use:\n\n.. code:: text\n\n $ awsume list\n\nTo create a configuration for another account:\n\n.. code:: text\n\n $ awsume set infra-dev arn:aws:iam::420189626185:role/7f-managed/infra-dev-TeamisFullaccess-MZSLXQ718GX6\n\nFor first time users create a configuration for an account:\n\n.. code:: text\n\n $ awsume set infra-dev arn:aws:iam::420189626185:role/7f-managed/infra-dev-TeamisFullaccess-MZSLXQ718GX6 --profile=finklabs --username=first.last\n\nOr use switch to another account:\n\n.. code:: text\n\n $ awsume switch infra-prod\n\nMost of the time you just want to renew the last used session:\n\n.. code:: text\n\n $ awsume renew\n\nAlso you can clean the cached account configurations:\n\n.. code:: text\n\n $ awsume clean\n\nRunning tests\n-------------\n\nPlease make sure to have good test coverage for your plugin so we can\nalways make sure your plugin runs with the upcoming fink version.\n\nRun tests like so:\n\n.. code:: bash\n\n $ python -m pytest -vv --cov-report term-missing tests/test_*\n\nLicense\n-------\n\nCopyright (c) 2017 finklabs and others. fink and plugins are released\nunder the MIT License (see LICENSE).\n\n.. |Documentation| image:: https://readthedocs.org/projects/fink/badge/?version=latest\n :target: http://fink.readthedocs.io/en/latest/\n.. |License| image:: http://img.shields.io/badge/license-MIT-yellowgreen.svg\n :target: LICENSE\n.. |GitHub issues| image:: https://img.shields.io/github/issues/finklabs/fink.svg?maxAge=2592000\n :target: https://github.com/finklabs/fink/issues\n", "description_content_type": null, "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "", "keywords": "", "license": "MIT", "maintainer": "", "maintainer_email": "", "name": "fink.awsume", "package_url": "https://pypi.org/project/fink.awsume/", "platform": "", "project_url": "https://pypi.org/project/fink.awsume/", "project_urls": null, "release_url": "https://pypi.org/project/fink.awsume/1.0.7/", "requires_dist": null, "requires_python": "", "summary": "Plugin (fink.awsume) for fink", "version": "1.0.7" }, "last_serial": 3382929, "releases": { "1.0.7": [ { "comment_text": "", "digests": { "md5": "f2aedbf56e404239bdb8a31c3380c06c", "sha256": "c17c3171c8d3e66fe11f4823d2e323d82cdf345f676cb2151cbe9341071efab5" }, "downloads": -1, "filename": "fink.awsume-1.0.7.tar.gz", "has_sig": false, "md5_digest": "f2aedbf56e404239bdb8a31c3380c06c", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 11863, "upload_time": "2017-12-02T18:03:26", "url": "https://files.pythonhosted.org/packages/2b/a2/686340ff450329155c98feb78b0d1da0ae9b5e0eba89539d438d2d40f2f2/fink.awsume-1.0.7.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "f2aedbf56e404239bdb8a31c3380c06c", "sha256": "c17c3171c8d3e66fe11f4823d2e323d82cdf345f676cb2151cbe9341071efab5" }, "downloads": -1, "filename": "fink.awsume-1.0.7.tar.gz", "has_sig": false, "md5_digest": "f2aedbf56e404239bdb8a31c3380c06c", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 11863, "upload_time": "2017-12-02T18:03:26", "url": "https://files.pythonhosted.org/packages/2b/a2/686340ff450329155c98feb78b0d1da0ae9b5e0eba89539d438d2d40f2f2/fink.awsume-1.0.7.tar.gz" } ] }