EasyMFA is a command line application that gets AWS credentials given a MFA token and serial number and saves it to a specified profile in the AWS credential file.

Install

npm install -g @easymfa/easymfa-cli

Usage

easymfa --profile string --serial-number string --token number [--duration number]

Help

easymfa --help

Usage: easymfa --profile string --serial-number string --token number [--duration number]

EasyMFA is a command line application that gets AWS credentials given a MFA
token and serial number and saves it to a specified profile in the AWS
credential file.

Options:
  --help               Show help                                       [boolean]
  --version            Show version number                             [boolean]
  --token, -t          The value provided by the MFA device. [number] [required]
  --serial-number, -s  The identification number of the MFA device that is
                       associated with the IAM user. The value is either the
                       serial number for a hardware device (such as
                       GAHT12345678) or an Amazon Resource Name (ARN) for a
                       virtual device (such as
                       arn:aws:iam::123456789012:mfa/user).  [string] [required]
  --profile, -p        The profile name to update in the AWS credentials file.
                                                             [string] [required]
  --duration, -d       The duration, in seconds, that the credentials should
                       remain valid. Acceptable durations for IAM user sessions
                       range from 900 seconds (15 minutes) to 129600 seconds (36
                       hours), with 43200 seconds (12 hours) as the default.
                       Sessions for AWS account owners are restricted to a
                       maximum of 3600 seconds (one hour). If the duration is
                       longer than one hour, the session for AWS account owners
                       defaults to one hour.                            [number]

Issues

Pleases log any 🐛s on Github. Thanks!