aws-sso (ALPHA)

AWS credentials using SSO

This is a terminal tool to easly log in in AWS using SSO. Build with❤️in Golang

Table of Contents generated with DocToc

• About
  • Initial requirements
  • Workflow
• Installation
  • Using brew
  • Linux
  • Using go
  • Download the binaries
    • Supported OS
• Usage
• Credits
• Contribution
• License

About

The purpose of this tool is to be able to obtain the credentials accesskey, secretkey, and token of the AWS accounts that your user has access to through SSO.

Initial requirements

• Go (if you decide to install this tool using go install)
• macOS: require Cgo, no dependency
• Linux: require X11 dev package. For instance, install libx11-dev or xorg-dev or libX11-devel to access X window system.

This libraries are necessary for the clipboard package (used in aws-sso profile command).

Workflow

1. Open your browser and log in using your external identity provider configured with AWS SSO (gmail for example if you use google workspaces as external idp)
2. Install the tool using one of the ways described below

Installation

Using brew

$ brew tap nanih98/aws-sso https://github.com/nanih98/aws-sso
$ brew install aws-sso

Linux

Using go

$ go install github.com/nanih98/aws-sso

Remember to put your GOPATH in your PATH variable:

$ echo $GOPATH
$ export PATH=$PATH:$GOPATH/bin # put this in your .bashrc or .zshrc if needed

Download the binaries

Releases

Supported OS

OS	ARM64	AMD64
Mac	√	√
Linux	√	√

Usage

Read usage or type:

$ aws-sso usage

Credits

• Github issue
• Cobra
• Charm
• Go clipboard
• Promptui

Contribution

Pull requests are welcome! Any code refactoring, improvement, implementation...

License

LICENSE