AWS credential management tool
Project description
AWSX
A powerful command-line tool for quickly and easily switching between AWS credentials.
About The Project
awsx-cli
is a command-line tool that helps you switch quickly and easily between Amazon Web Services (AWS) credentials. This tool is designed to streamline your tasks when you need to use multiple AWS credentials. You can use it to manage your AWS credentials, switch between them, and update Multi-Factor Authentication (MFA) sessions.
Key Features:
Manage and store your AWS credentials Switch between different AWS credentials Update Multi-Factor Authentication (MFA) sessions Easy and fast to use
Getting Started
Step 1: Installation
You can install awsx-cli using pip. If you don't have pip installed, you can follow the instructions here to install it.
pip install awsx-cli
Step 2: Basic Usage
Once awsx-cli is installed, you can start using it to manage your AWS credentials. Here are some basic commands to get you started:
-
To list your stored credentials:
❯ awsx aws01 aws04 * aws02
or
❯ awsx -l aws01 aws03 * aws02
-
To switch to a different set of credentials:
❯ awsx aws02 Credentials changed to 'aws02'
-
To add new credentials:
❯ awsx -a aws04 Stored 'aws04' credentials succesfully
-
To both switch to a different set of credentials and update the MFA session:
❯ awsx aws02 -mfa your-mfa-code aws02 session is updated with MFA code
-
To update an MFA session:
❯ awsx -mfa your-mfa-code aws05 session is updated with MFA code
-
To remove credentials:
❯ awsx -r aws03 Removed 'aws03' credentials successfully
-
To get help:
❯ awsx --help usage: awsx [-h] [-a ADD] [-r REMOVE] [-l] [-p ADD_PROMPT] [-mfa UPDATE_MFA] [change] positional arguments: change Example: awsx foo , awsx bar optional arguments: -h, --help show this help message and exit -a ADD, --add ADD add your credentials to awsx -r REMOVE, --remove REMOVE remove your credentials from awsx -l, --list list your credentials from awsx -p ADD_PROMPT, --add-prompt ADD_PROMPT you can create creds from prompt -mfa UPDATE_MFA, --update-mfa UPDATE_MFA update your mfa session
Now you're ready to start using awsx-cli to manage your AWS credentials efficiently!
Contributing
Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.
If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!
- Fork the Project
- Create your Feature Branch (
git checkout -b feature/AmazingFeature
) - Commit your Changes (
git commit -m 'Add some AmazingFeature'
) - Push to the Branch (
git push origin feature/AmazingFeature
) - Open a Pull Request
License
Distributed under the APACHE-2.0 License. See LICENSE.txt
for more information.
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.