https://github.com/mtchavez/aws-mfa-sts
Generate an AWS Profile for an MFA account with a STS token
https://github.com/mtchavez/aws-mfa-sts
Last synced: about 2 months ago
JSON representation
Generate an AWS Profile for an MFA account with a STS token
- Host: GitHub
- URL: https://github.com/mtchavez/aws-mfa-sts
- Owner: mtchavez
- Created: 2018-03-15T00:48:23.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2018-03-24T15:20:27.000Z (about 7 years ago)
- Last Synced: 2025-02-04T15:32:35.056Z (4 months ago)
- Language: Go
- Size: 15.6 KB
- Stars: 2
- Watchers: 3
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# AWS MFA STS
CLI tool to generate temporary AWS credentials using STS for accounts that
require MFA.
## Installation
`go get github.com/mtchavez/aws-mfa-sts`
or download from the [latest release][releases] files.
## Usage
### Command Flags
```
Usage of aws-mfa-sts:
-device-arn string
MFA Serial Number
-profile string
Profile name (default "default")
-region string
AWS Region (default "us-east-1")
-token string
MFA token
-duration
Time in seconds the token is valid for (max 24 hours e.g. 86400)
```
### Generating a Token
`aws-mfa-sts -token 123456 -device-arn arn:aws:iam::012345678912:mfa/myuser`
Will show the following output if successful:
```
Generating STS Token for default profile
Adding credentials for default-sts to /path/to/.aws/credentials
Use with --profile=default-sts
or set up your environment with
export AWS_DEFAULT_PROFILE=default-sts
export AWS_PROFILE=default-sts
```
### Usage with AWS CLI
Once a new STS profile is generated you can use the `awscli` by passing
the profile in to commands:
`aws --profile=default-sts s3 ls`
Or you can configure your environment `AWS_DEFAULT_PROFILE=default-sts` and
call things as normal `aws s3 ls`
### Using a different profile
If you use the `-profile` command the generated STS profile will be prepended
with the profile name e.g `api-user` will generate `api-user-sts`.
[releases]: https://github.com/mtchavez/aws-mfa-sts/releases