In order to be able to generate the 2-factor-authentication codes, the extension needs access to your secret key. This is a requirement for using the extension, and without this secret key the extension cannot work.

Please note that this will reset your old authenticator key, meaning that you will have to re-insert the authenticator key in your phone. Please have your phone with the authenticator app on hand.

Even though the risks involved with this setup are small, I am not responsible for any loss of access/information/physical property that may occur during this procedure.

To allow the extension access to this secret key, do the following:

1. Generate a new QR code

Do you already have an image of your QR code from when you set it up? Then you can skip to section 2.

• Go to https://mfa.rug.nl/.

• Log in with your employee/student number and password.

• A code will be sent to your private email address. Follow the instructions on the screen and enter the code you have received.

• After this, you will see a box titled Google Authenticator in the bottom of the page. Click on Modify.

• Read the on-screen instructions and press Next.

• You will see a QR code on screen. Do not close this tab.

• Important: Take a screenshot of the code:

  • Windows: press ⊞ Win + Shift + S and then drag a box around the QR code.
    It will be automatically saved in C:\Users\<your username>\Pictures\Screenshots.

• On your mobile phone, reset the authenticator using the new QR code:

  • Google Authenticator

    • Enter the Google Authenticator app

    • Long-press on the box titled RUG (WORKSPACE\S0000000)

    • Press on the 🗑️ garbage bin icon (top-right) and then on Remove account.

    • Press on the plus icon (bottom left) and then Scan a QR code. Scan the QR code on the opened tab.

• Return to the browser tab with the QR code open. Press Next.

• Input a code from the authenticator app on your phone.

2. Upload the QR code into the extension

Chromium (Chrome, Edge, Brave etc.)

• In your Chromium-based browser, install the browser extension.

• Click on the 🧩 Extensions icon to the right of the search bar, then click on RUG Authentication Assistant.

• Click on Upload QR code, then select the file with the QR code you saved earlier
  (it should be in C:\Users\<your username>\Pictures\Screenshots on Windows)

• You can now test the extension: enter https://brightspace.rug.nl (log out if you were already logged in), and, when logging in, you should see that the 2FA code is filled automatically.

• For purposes of security, you may want to consider deleting the screenshot of the generated QR code from your computer.

Firefox

• Install the browser extension

• The sidebar will open upon the extension being installed. Click on Upload QR code, then select the file with the QR code you saved earlier (it should be in C:\Users\<your username>\Pictures\Screenshots on Windows)

• Before using the extension for the first time, you have to allow it access to pages in the *://rug.nl domain. Press on the 🧩 Extensions icon to the right of the search bar, then on the ⚙️ Manage icon to the right of the extension name, then on Manage Extension. On the page that just opened, switch to the Permissions tab under the extension name and activate the permission under Optional permissions for added functionality.

• You can now test the extension: enter https://brightspace.rug.nl (log out if you were already logged in), and, when logging in, you should see that the 2FA code is filled automatically.

• For purposes of security, you may want to consider deleting the screenshot of the generated QR code from your computer.