README
¶
aws-sso-creds
AWS SSO Creds
Table of Contents
About
Opinionated CLI app for AWS SSO made in Golang!
AWS SSO Creds is an AWS SSO creds manager for the shell.
Use it to easily manage entries in ~/.aws/config & ~/.aws/credentials files, so you can focus on your AWS workflows, without the hazzle of manually managing your credentials.
Built With
Installation
Static Releases
Download the binary based on your OS in The releases section
From source
Prerequisites
- Go 1.17+
Run go install github.com/JorgeReus/aws-sso-creds@latest
Usage
Opinionated CLI app for AWS SSO made in Golang!
AWS SSO Creds is an AWS SSO creds manager for the shell.
Use it to easily manage entries in ~/.aws/config & ~/.aws/credentials files, so you can focus on your AWS workflows, without the hazzle of manually managing your credentials.
Usage:
aws-sso-creds [flags] [organization]
aws-sso-creds [command]
Available Commands:
completion Generate the autocompletion script for the specified shell
help Help about any command
open Opens the AWS web console based on your AWS_PROFILE environment variable
select Select your role/credentials in a fuzzy-finder previewer
Flags:
-c, --config string Directory of the .toml config (default "/home/reus/.config/aws-sso-creds.toml")
-f, --forceAuth Force Authentication with AWS SSO
-h, --help help for aws-sso-creds
-b, --noBrowser Do not open in the browser automatically
-p, --populateRoles Populate AWS SSO roles in ~/.aws/config
-t, --temp Create temporary credentials in ~/.aws/credentials
Use "aws-sso-creds [command] --help" for more information about a command.
Configuration
This tool required a toml config file located in ~/.config/aws-sso-creds.toml by default, take a look at the following example:
error_color = "#fa0718"
information_color = "#05fa5f"
warning_color = "#f29830"
focus_color = "#4287f5"
spinner_color = "#42f551"
[organizations.org1]
url = "https://org1.awsapps.com/start"
prefix = "org1"
region = "us-east-1"
[organizations.org2]
url = "https://org2.awsapps.com/start"
prefix = "org2"
region = "us-west-2"
Each organization entry must have:
- url: The awsapps URL to interact with the AWS SSO/Identity Center Org
- prefix: A prefix to identify profiles in the aws local config files
- region: The region of the AWS SSO/Identity Center Org
The color entries must be defined in hex notation
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 MIT License. See LICENSE for more information.
Contact
Jorge Reus - LinkedIn
Acknowledgments
Documentation
¶
There is no documentation for this package.
Source Files
Directories