{"id":37193195,"url":"https://github.com/tim-rodgers/awsassume","last_synced_at":"2026-01-14T22:25:34.912Z","repository":{"id":64307062,"uuid":"165820745","full_name":"tim-rodgers/awsassume","owner":"tim-rodgers","description":"A tool for running commands with temporary AWS credentials","archived":false,"fork":false,"pushed_at":"2020-01-28T21:08:42.000Z","size":35,"stargazers_count":8,"open_issues_count":0,"forks_count":4,"subscribers_count":4,"default_branch":"master","last_synced_at":"2024-06-20T05:22:02.996Z","etag":null,"topics":["aws","go","sts-credentials"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tim-rodgers.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-01-15T09:16:11.000Z","updated_at":"2024-06-20T05:22:02.996Z","dependencies_parsed_at":"2022-12-06T08:16:34.531Z","dependency_job_id":null,"html_url":"https://github.com/tim-rodgers/awsassume","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/tim-rodgers/awsassume","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tim-rodgers%2Fawsassume","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tim-rodgers%2Fawsassume/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tim-rodgers%2Fawsassume/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tim-rodgers%2Fawsassume/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tim-rodgers","download_url":"https://codeload.github.com/tim-rodgers/awsassume/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tim-rodgers%2Fawsassume/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28436313,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-14T21:32:52.117Z","status":"ssl_error","status_checked_at":"2026-01-14T21:32:33.442Z","response_time":107,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["aws","go","sts-credentials"],"created_at":"2026-01-14T22:25:33.983Z","updated_at":"2026-01-14T22:25:34.904Z","avatar_url":"https://github.com/tim-rodgers.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"A tool for running commands with temporary AWS credentials. awsassume makes working with the AWS AssumeRole API easier and more convenient.\n\n# Features\n\n- Run single commands or start a new shell session with profile configuration set in environment\n- Supports MFA tokens and ExternalID field\n- Stores temporary credentials in the `~/.aws/credentials file` with expiration time\n- Supports AWS CLI configuration env vars\n\n# Getting started\n\nawsassume has two main commands `run` and `shell`.\n\nThe `run` command takes a command as input and will assume the role in the shell you specify (defaults to `$SHELL`):\n\n```\nawsassume run --profile prod aws sts get-caller-identity\n```\n\nIf you want to run several commands you can start a new shell session with credentials set using the `shell command:\n\n```\nawsassume shell --profile prod --duration 60\n```\n\nAgain, the shell launched is sourced from the `$SHELL` env var. For both commands, the shell to use can be set manually with the `--command` flag.\n\nRun `awsassume help` to get help.\n\n# Configuration\n\nawsassume uses your AWS CLI `~/.aws/config` and `~/.aws/credentials` files to retrieve and store temporary credentials from the AWS STS service and run commands.\n\nExample `~/.aws/config` file:\n\n```\n[default]\nregion = us-east-1\n\n[profile prod]\nregion=eu-west-1\nsource_profile=default\nrole_arn=arn:aws:iam::123456789012:role/RoleName\nmfa_serial=arn:aws:iam::456789101112:mfa/user\nregion=eu-west-1\n```\n\nExample `~/.aws/credentials` file:\n\n```\n[default]\naws_access_key_id=AKIAIOSFODNN7EXAMPLE\naws_secret_access_key=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY\n```\n\nSeveral environment variables are also recognised:\n\n```\nAWS_CONFIG_FILE\nAWS_SHARED_CREDENTIALS_FILE\nAWS_DEFAULT_REGION\nAWS_PROFILE\nAWSASSUME_DURATION\n```\n\nWhen looking for configuration settings, order of precedence is:\n\n1. Environment variables\n1. Command line flags\n1. AWS CLI config file\n\n# Logging\n\nSupported values for the `--log-level` flag are:\n\n- trace\n- debug\n- info\n- warn\n- error\n- fatal\n- panic\n\nOnly messages of the severity selected or above will be displayed\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftim-rodgers%2Fawsassume","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftim-rodgers%2Fawsassume","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftim-rodgers%2Fawsassume/lists"}