https://github.com/robusta-dev/mr-m
Need to easily assume AWS IAM roles? Mr. M has your back!
https://github.com/robusta-dev/mr-m
Last synced: 7 months ago
JSON representation
Need to easily assume AWS IAM roles? Mr. M has your back!
- Host: GitHub
- URL: https://github.com/robusta-dev/mr-m
- Owner: robusta-dev
- Created: 2021-12-15T12:20:42.000Z (about 4 years ago)
- Default Branch: master
- Last Pushed: 2021-12-27T17:53:39.000Z (about 4 years ago)
- Last Synced: 2025-06-22T03:52:45.965Z (7 months ago)
- Language: Python
- Homepage:
- Size: 4.88 KB
- Stars: 18
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-opensource-israel - Mr. M - Need to easily assume AWS IAM roles? Mr. M has your back!   (Projects by main language / Old Projects)
README
# Intro
Need to easily assume AWS IAM roles? Mr. M has your back!
Features:
1. Assume IAM roles
2. Spawn a bash shell with preconfigured environment variables for the new role
3. Open the AWS web console for an assumed role
4. Supports cross-account roles
5. Supports multi-factor authentication
**If you use Kubernetes, also check out [Robusta](https://github.com/robusta-dev/robusta/)**
# Usage
Installation:
```
pip install git+https://github.com/robusta-dev/mr-m
```
Assume a role and open a preconfigured bash-shell:
```
mr-m shell \
--clean \
--role-arn="arn:aws:iam::RoleGoesHere" \
--external-id="external-id-goes-here" \
--mfa-serial="arn:aws:iam::mfa-arn-goes-here" \
--mfa-token=
```
Assume a role and generate a link for logging in to the AWS Web Console with that role
```
mr-m web \
--role-arn="arn:aws:iam::RoleGoesHere" \
--external-id="external-id-goes-here" \
--mfa-serial="arn:aws:iam::mfa-arn-goes-here" \
--mfa-token=
```
# FAQ
## What's up with the name?
When I was in fifth grade I had a teacher named Mr. M. He was a wonderful teacher, but all I remember from his classes is one sentence he said often:
You should never assume, because when you assume you make an ASS of U and ME.
I assume that Mr. M taught me many other things, but this is all I remember from fifth grade.