search

avikrao / duo-extension

Browser extension for generating HOTP passcodes for Duo Security Multi-Factor Authentication
16 stars 2 forks source link

readme

duo-extension

Browser extension for generating HOTP passcodes for Duo Security multi-factor authentication.

Compatible with Firefox and Chromium-based browsers (Chrome, Edge, etc.)

Credits

Setup

  1. Once you've installed the extension, sign in to your service and navigate to your Duo multi-factor authentication portal/page.

enter image description here

  1. Select "Add a new device".

enter image description here

  1. Authenticate as your normally would, if prompted.
  2. Select "Tablet" from the list of devices.

enter image description here

  1. Select "Android" from the list.

enter image description here

  1. Press "I have Duo Mobile installed" if prompted.

enter image description here

  1. You will reach a screen with a QR code on it. At this point, open the extension from your browser's toolbar and press "Scan Page for Duo QR".

enter image description here

enter image description here

  1. If you followed the steps correctly, the extension will notify you that scanning is complete. If it does not, please report an issue on the GitHub repository. At this point, setup is complete!

enter image description here

Usage

  1. Using the extension after setup is very simple. Sign in to your intended service and navigate to your multi-factor authentication portal when you wish to log in.

enter image description here

  1. Click the extension's icon in your browser's toolbar. It should automatically log you in from there!

enter image description here

Alternative

  1. If the extension fails to automatically log you in by now, you can try pasting in your HOTP code manually. Click on the extension icon and copy the code displayed. Clicking it will automatically copy to clipboard.

enter image description here

  1. Paste the code into the Passcode authentication option and press "Log In".

enter image description here

  1. If this does not work, you can try generating a new code ("Generate new code" option in extension), reinstalling the extension and setting it up as a new device, or submitting an issue to the GitHub repository.