Project

awsqr

0.0
Repository is archived
No commit activity in last 3 years
No release in over 3 years
CLI utility to add issuer field to AWS QR Code for IAM MFA
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

~> 1.10
~> 10.0
>= 0

Runtime

~> 0.7
~> 0.19
 Project Readme

awsqr

I suggest you add the QR code given and then use the secret to generate this one, just incase

I have a fair number of AWS accounts. I use it both personally and professionally. I was finding it difficult to add new accounts and keep track of which account / user they were associated in. Most other MFA providers set the issuer field in the QR code which makes life a little easier.

This utility is just really to help set the issuer, i suggest you add an account label (--accountlabel) with the name of the account you want.

Image Showing The Issuer Field Set

Personally I think that's a lot clearer! This is only a cli tool, it doesn't display the QRCode in the terminal as I found that ascii art QRCodes didn't work with the google auth app.

using it

awsqr generate --secret=SECRET --username=USERNAME [--accountlabel=ACCOUNTLABEL --output=OUTPUTIMAGENAME]

output images are png's.

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/aughban/awsqr.