{"id":22683241,"url":"https://github.com/mtchavez/aws-mfa-sts","last_synced_at":"2025-07-02T14:36:09.391Z","repository":{"id":57539098,"uuid":"125292144","full_name":"mtchavez/aws-mfa-sts","owner":"mtchavez","description":"Generate an AWS Profile for an MFA account with a STS token","archived":false,"fork":false,"pushed_at":"2018-03-24T15:20:27.000Z","size":16,"stargazers_count":2,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-06-01T07:14:15.695Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mtchavez.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2018-03-15T00:48:23.000Z","updated_at":"2018-11-21T14:50:25.000Z","dependencies_parsed_at":"2022-09-19T07:31:52.065Z","dependency_job_id":null,"html_url":"https://github.com/mtchavez/aws-mfa-sts","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/mtchavez/aws-mfa-sts","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mtchavez%2Faws-mfa-sts","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mtchavez%2Faws-mfa-sts/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mtchavez%2Faws-mfa-sts/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mtchavez%2Faws-mfa-sts/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mtchavez","download_url":"https://codeload.github.com/mtchavez/aws-mfa-sts/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mtchavez%2Faws-mfa-sts/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":263157314,"owners_count":23422594,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-12-09T21:11:22.654Z","updated_at":"2025-07-02T14:36:09.368Z","avatar_url":"https://github.com/mtchavez.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# AWS MFA STS\n\nCLI tool to generate temporary AWS credentials using STS for accounts that\nrequire MFA.\n\n## Installation\n\n`go get github.com/mtchavez/aws-mfa-sts`\n\nor download from the [latest release][releases] files.\n\n## Usage\n\n### Command Flags\n\n```\nUsage of aws-mfa-sts:\n  -device-arn string\n        MFA Serial Number\n  -profile string\n        Profile name (default \"default\")\n  -region string\n        AWS Region (default \"us-east-1\")\n  -token string\n        MFA token\n  -duration\n        Time in seconds the token is valid for (max 24 hours e.g. 86400)\n```\n\n### Generating a Token\n\n`aws-mfa-sts -token 123456 -device-arn arn:aws:iam::012345678912:mfa/myuser`\n\nWill show the following output if successful:\n\n```\nGenerating STS Token for default profile\nAdding credentials for default-sts to /path/to/.aws/credentials\nUse with --profile=default-sts\n\nor set up your environment with\n\nexport AWS_DEFAULT_PROFILE=default-sts\nexport AWS_PROFILE=default-sts\n```\n\n### Usage with AWS CLI\n\nOnce a new STS profile is generated you can use the `awscli` by passing\nthe profile in to commands:\n\n`aws --profile=default-sts s3 ls`\n\nOr you can configure your environment `AWS_DEFAULT_PROFILE=default-sts` and\ncall things as normal `aws s3 ls`\n\n### Using a different profile\n\nIf you use the `-profile` command the generated STS profile will be prepended\nwith the profile name e.g `api-user` will generate `api-user-sts`.\n\n[releases]: https://github.com/mtchavez/aws-mfa-sts/releases\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmtchavez%2Faws-mfa-sts","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmtchavez%2Faws-mfa-sts","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmtchavez%2Faws-mfa-sts/lists"}