Published: Oct 27, 2019 by martoc

Using two factor authentication with the AWS CLI is sometimes a pain, you need to get a new token every N minutes then parse the result of this operation and create the corresponding environment variables, I’ve installed the oath-toolkit and configured the AWS CLI to get these OTP dynamically.

Steps

Install oath-toolkit

brew install oath-toolkit

For more information about Homebrew please visit https://brew.sh/

This guide assumes that you have installed the AWS CLI, otherwise please check this documentation https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-install.html.
Configure the MFA for the account https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_mfa_enable_virtual.html, store the OTP key in a file at ~/.aws-mfa.
Configuring MFA-Protected API Access https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_mfa_configure-api-require.html. in my account, my account user is assigned to a group and this group has the following policy

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "*"
      ],
      "Resource": [
        "*"
      ],
      "Condition": {
        "Bool": {
          "aws:MultiFactorAuthPresent": "true"
        }
      }
    }
  ]
}

Create an API access key id and secret key https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html#Using_CreateAccessKey.
Configure the access key id and secret key calling this and follow the instructions.

aws configure

Now to access your API you need to create a new set of credentials calling the AWS STS service, in the following command replace the ACCOUNT_ID and USERNAME.

aws sts get-session-token --region us-east-1 --serial-number arn:aws:iam::<ACCOUNT_ID>:mfa/<USERNAME> --token-code $(oathtool --base32 --totp $(cat ~/.aws-mfa))

The output of the previous command returns a credential for accessing the AWS API.
Install jq.

brew install jq

Add the following function in your ``~/.zshrc`.

aws-login() {
  OUTPUT=$(aws sts get-session-token --region us-east-1 --serial-number arn:aws:iam::<ACCOUNT_ID>:mfa/<USERNAME> --token-code $(oathtool --base32 --totp $(cat ~/.aws-mfa)))
  export AWS_ACCESS_KEY_ID=$(echo $OUTPUT | jq .Credentials.AccessKeyId --raw-output)
  export AWS_SECRET_ACCESS_KEY=$(echo $OUTPUT | jq .Credentials.SecretAccessKey --raw-output)
  export AWS_SESSION_TOKEN=$(echo $OUTPUT | jq .Credentials.SessionToken --raw-output)
  export AWS_SECURITY_TOKEN=$AWS_SESSION_TOKEN
}

You can open a new terminal and execute the following command to authenticate to your account.

aws-login

Share

Using aws-cli and oathtool

Steps