extaws
v0.0.15-alpha.0
Published
Extend Okta Aws Authentication
Downloads
16
Readme
extaws
Typescript package that attempts to solve the problem of getting AWS CLI credentials when using Okta/AWS Saml integration.
It was written to be used as both a stand alone CLI for simple use cases or as a utility to build more complex/custom use cases.
Configuration and credentials are stored using the keytar package which abstracts Windows(Credential Vault)/Mac(Keychain)/Linux(libsecret) secret storage systems.
Usage
Before you can use this tooling you will need both your Okta organization name(->YourOrgName<-.okta.com) as well as the Okta Saml URL. It'll look something like: home/amazon_aws/01234abcde9876549/123
###CLI
extaws login
- Main command for logging in. Will prompt for config and user information if none is present
extaws init
- Sets up the necessary configuration(Okta organization name, Okta SAML url, etc)
extaws clear
- Clears local creds and/or configuration
###Direct implementation
Setting up configuration
const config = await ExtAws.promptForConfig()
await ExtAws.setConfig(config)
Logging in
const extaws = new ExtAws()
extaws.login()
Clearing configuration
const config = true
const credentials = true
await ExtAws.clearCredentials({ config, credentials })
Example Execution
$ extaws login
? Okta Organization Name: whatsnew
? Okta SAML Url: app/amazon_aws/abcdef1234567/sso/saml
? Store Okta Credentials Yes
? AWS Profile to store credentials: default
? AWS Region: us-east-1
? Okta Username [email protected]
? Okta Password [hidden]
? Please select MFA factor ONEPLUS A6010
? Please select the role to assume super_admin