1
1
# setup-new-aws-user
2
2
3
- This tool is used to grant programmatic access to AWS account(s) that aren't
4
- backed by SAML federation or SSO. It works by taking a temporary set of AWS
5
- access keys for a new IAM user. It then generates a virtual MFA device and permanent
6
- set of access keys. Finally, it removes the temporary access keys.
3
+ This tool is used to grant programmatic access to AWS account(s) using
4
+ [ aws-vault] ( https://github.com/99designs/aws-vault ) . It works by taking a
5
+ temporary set of AWS access keys for a new IAM user. It then generates a
6
+ virtual MFA device and permanent set of access keys. Finally, it removes
7
+ the temporary access keys.
7
8
8
9
## Installation
9
10
@@ -18,6 +19,12 @@ brew install setup-new-aws-user
18
19
19
20
### Prerequisites
20
21
22
+ #### Dependencies
23
+
24
+ ``` shell
25
+ brew cask install aws-vault
26
+ ```
27
+
21
28
Before running this tool, you will need to following pieces of information
22
29
23
30
* IAM role - This is the IAM Role with permissions allowing access to AWS APIs
@@ -35,14 +42,14 @@ Before running this tool, you will need to following pieces of information
35
42
36
43
1 . Run the setup-new-user - ` setup-new-aws-user --role <IAM_ROLE> --iam_user <USER> --profile=<AWS_PROFILE> --account-id=<AWS_ACCOUNT_ID> `
37
44
2 . Enter the access keys generated when prompted.
38
- 3 . The script will display a QR code for an MFA device at some point.
39
- 4 . Create an entry in your 1Password account with a One Time Password (OTP)
40
- field and be ready to scan it with the 1Password app.
41
-
45
+ 3 . The script will open a window with a QR code, which you will use to configure
46
+ a temporary one time password (TOTP).
47
+ 4 . Create an entry in your 1Password account field and be ready to scan it with the 1Password app.
42
48
** NOTE** You will be asked for your MFA (TOTP) tokens three times while
43
49
validating the new virtual MFA device and rotating your access keys.
44
50
** Take care not to use the same token
45
51
more than once** , as this will cause the process to fail.
52
+ 5 . Once the tool has completed, you should be able to access the AWS account. You can run the following
46
53
47
54
## Development setup
48
55
0 commit comments