{"id":21199013,"url":"https://github.com/devsecops/assumer","last_synced_at":"2025-07-10T06:30:52.953Z","repository":{"id":62553647,"uuid":"55817167","full_name":"devsecops/assumer","owner":"devsecops","description":"An AWS cross-account tool to support human access with MFA for the CLI and GUI.","archived":false,"fork":false,"pushed_at":"2018-10-16T14:24:53.000Z","size":26,"stargazers_count":18,"open_issues_count":3,"forks_count":7,"subscribers_count":16,"default_branch":"master","last_synced_at":"2024-11-07T14:44:52.471Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Ruby","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/devsecops.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":"2016-04-09T00:13:36.000Z","updated_at":"2023-07-26T13:10:45.000Z","dependencies_parsed_at":"2022-11-03T04:30:40.766Z","dependency_job_id":null,"html_url":"https://github.com/devsecops/assumer","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devsecops%2Fassumer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devsecops%2Fassumer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devsecops%2Fassumer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devsecops%2Fassumer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/devsecops","download_url":"https://codeload.github.com/devsecops/assumer/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225622901,"owners_count":17498168,"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-11-20T19:55:23.019Z","updated_at":"2024-11-20T19:55:25.430Z","avatar_url":"https://github.com/devsecops.png","language":"Ruby","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Assumer #\n\n## Overview ##\nThe Assumer gem is an interface allowing the user to assume role into an account.  Credentials can be loaded anywhere the AWS STS Client knows to load credentials from (ENV, profile, etc.)\n\n## Content ##\nAssumer will assume-role on a target account and generate temporary API keys for that account.  It can optionally drop you into a pry session or load the AWS console in the context of the role assumed in the target account depending on how Assumer was called.\n\n## Installation ##\n\nAssumer requires a Ruby version \u003e= 2.1\n\nInstall with `gem install assumer`\n\n### Build from Source ###\n\n1. Clone the repository\n1. Change directory into the newly-cloned repository\n  * `cd assumer`\n1. Change directory into the `source` folder, where the gem's source code lives\n  * `cd source`\n1. Build the gem\n  * `gem build assumer.gemspec`\n1. Install the gem\n  * `gem install assumer-0.4.2.gem`\n\n## Usage ##\n\n**Having trouble running Assumer on Windows?  Please see our [document](/docs/Windows.md) with some troubleshooting steps.**\n\nYou can use the gem on the command line.  For an in-depth explanation of options, see [this file](/docs/Options.md); what follows is a simplistic overview.\n\nTo see help text:\n  * `assumer -h` To see help text\n\nStandard usage:\n  * `assumer -a 123456789012 -r \"target/role-name\" -A 987654321098 -R \"control/role-name\" `\n\nTo request a console, pass the `-g` flag:\n  * `assumer -a 123456789012 -r \"target_role/target_path\" -A 987654321098 -R \"control_role/control_path\" -g`\n\nTo request a pry console, pass the `-p` flag:\n  * `assumer -a 123456789012 -r \"target_role/target_path\" -A 987654321098 -R \"control_role/control_path\" -p`\n\nWhy not both?\n  * `assumer -a 123456789012 -r \"target_role/target_path\" -A 987654321098 -R \"control_role/control_path\" -p -g`\n\nOr use the gem in your code:\n```ruby\nrequire 'assumer'\n# First Jump\ncontrol_creds = Assumer::Assumer.new(\n  region: aws_region,\n  account: control_plane_account_number,\n  role: control_plane_role,\n  serial_number: serial_number, # if you are using MFA, this will be the ARN for the device\n  profile: credential_profile_name # if you don't want to use environment variables or the default credentials in your ~/.aws/credentials file\n)\n# Second jump\ntarget_creds = Assumer::Assumer.new(\n  region: aws_region,\n  account: target_plane_account_number,\n  role: target_account_role,\n  credentials: control_creds\n)\n```\n\n\n## Notes ##\n 1. To be able to use this utility you will need to have permission to assume-role against the role you specify!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdevsecops%2Fassumer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdevsecops%2Fassumer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdevsecops%2Fassumer/lists"}