diff --git a/docs/security/multifactor-authentication.md b/docs/security/multifactor-authentication.md index 16fa16b..f8e084f 100644 --- a/docs/security/multifactor-authentication.md +++ b/docs/security/multifactor-authentication.md @@ -171,6 +171,44 @@ is largely the same. For a more complete list of compatible services, see [here][usage]. +Alternative - zbar & pass-otp +------------------- + +As an alternative, one can download a QR code, scan it with zbar and use the scan to create one time passwords with pass-otp. + +Install the required tools. The following has been tested on a Fedora 36 template: + +``` +sudo dnf install -y zbar pass pass-otp +``` + +If you don't have a GPG key, generate one now. You can skip this step if you have one - that is if OTP codes will be generated in the same Qube that is used for split-gpg. Nevertheless you may want to accomplish this in a Qube dedicated to something else, so we'll cover this scenario with: + +``` +gpg --full-gen-key +``` + +Initialize the `pass` store (`~/.password-store/`) + +``` +pass init +``` + +Then scan a downloaded QR code with zbar + +``` +zbarimg -q QR.png +``` + +Now we're ready to add it to `pass`. As an example let's assume we're trying to use it as an alternative to GitHub Authenticator app. + +``` +pass otp add github +``` + +You'll be prompted to enter the `otpauth://` URI. Copy it from the `zbarimg` output and paste. + +You can now use the command `pass otp github` to get your one-time password. Depending on your GPG configuration, you may get prompted to enter a passphrase to unlock your OpenPGP secret key first. [YubiKey]: https://www.qubes-os.org/doc/YubiKey/ [MFA]: https://en.wikipedia.org/wiki/Multi-factor_authentication