<?xml version="1.0" encoding="utf-8"?><!DOCTYPE article  PUBLIC '-//OASIS//DTD DocBook XML V4.4//EN'  'http://www.docbook.org/xml/4.4/docbookx.dtd'><article><articleinfo><title>MFA/In_browser_authenticator</title><revhistory><revision><revnumber>5</revnumber><date>2024-03-26 08:52:44</date><authorinitials>kputyr</authorinitials></revision><revision><revnumber>4</revnumber><date>2024-03-26 08:51:08</date><authorinitials>kputyr</authorinitials></revision><revision><revnumber>3</revnumber><date>2024-03-26 08:49:34</date><authorinitials>kputyr</authorinitials><revremark>added screenshots and store buttons</revremark></revision><revision><revnumber>2</revnumber><date>2024-03-26 08:17:16</date><authorinitials>kputyr</authorinitials><revremark>Copied the guide from project wiki</revremark></revision><revision><revnumber>1</revnumber><date>2024-03-26 08:00:16</date><authorinitials>kputyr</authorinitials></revision></revhistory></articleinfo><section><title>In-browser authenticator</title><para>This solution is perfect for users without a smart phone. This guide shows how to use it with git.math.uzh.ch, but the steps are the same for other pages. </para><section><title>Install the authenticator extension</title><informaltable><tgroup cols="2"><colspec colname="col_0"/><colspec colname="col_1"/><tbody><row rowsep="1"><entry colsep="1" rowsep="1"><para>Extension name </para></entry><entry colsep="1" rowsep="1"><para><emphasis role="strong">authenticator.cc</emphasis> </para></entry></row><row rowsep="1"><entry align="left" colsep="1" morerows="3" nameend="col_0" namest="col_0" rowsep="1" valign="top"><para>Available for  </para></entry><entry colsep="1" rowsep="1"><para> <ulink url="https://addons.mozilla.org/en-US/firefox/addon/auth-helper?src=external-github"><inlinemediaobject><imageobject><imagedata depth="48" fileref="https://wiki.math.uzh.ch/public/FrontPage?action=AttachFile&amp;do=get&amp;target=firefox-add-ons.png"/></imageobject><textobject><phrase>Firefox</phrase></textobject></inlinemediaobject></ulink> </para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para> <ulink url="https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai"><inlinemediaobject><imageobject><imagedata depth="48" fileref="https://wiki.math.uzh.ch/public/FrontPage?action=AttachFile&amp;do=get&amp;target=chrome-web-store.png"/></imageobject><textobject><phrase>Google Chome</phrase></textobject></inlinemediaobject></ulink> </para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para> <ulink url="https://microsoftedge.microsoft.com/addons/detail/ocglkepbibnalbgmbachknglpdipeoio"><inlinemediaobject><imageobject><imagedata depth="48" fileref="https://wiki.math.uzh.ch/public/FrontPage?action=AttachFile&amp;do=get&amp;target=microsoft-store.png"/></imageobject><textobject><phrase>MS Edge</phrase></textobject></inlinemediaobject></ulink> </para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para> <ulink url="https://apps.apple.com/us/app/authen/id1602945200?mt=12"><!--transclusion is not implemented in DocBook formatter-->Safari<!--transclusion is not implemented in DocBook formatter--></ulink> </para></entry></row></tbody></tgroup><!--Width 10em not supported--></informaltable><para>Install the extension from the appropriate store using the above links. The most up-to-date links are provided on the official github page of the extension: </para><itemizedlist><listitem override="none"><para><ulink url="https://github.com/Authenticator-Extension/Authenticator?tab=readme-ov-file#available-for-chrome-firefox-microsoft-edge-and-safari"/> </para></listitem></itemizedlist></section><section><title>Register the extension for MFA with a QR code</title><orderedlist numeration="arabic"><listitem><para>Scan the QR code with the extension by pressing the scan icon </para><itemizedlist><listitem override="none"><para><inlinemediaobject><imageobject><imagedata fileref="https://wiki.math.uzh.ch/public/MFA/In_browser_authenticator?action=AttachFile&amp;do=get&amp;target=in-browser-mfa-reg-1.png"/></imageobject><textobject><phrase>in-browser-mfa-reg-1.png</phrase></textobject></inlinemediaobject> </para></listitem></itemizedlist></listitem><listitem><para>Select the area of the page with the QR code </para><itemizedlist><listitem override="none"><para><inlinemediaobject><imageobject><imagedata fileref="https://wiki.math.uzh.ch/public/MFA/In_browser_authenticator?action=AttachFile&amp;do=get&amp;target=in-browser-mfa-reg-2.png"/></imageobject><textobject><phrase>in-browser-mfa-reg-2.png</phrase></textobject></inlinemediaobject> </para></listitem></itemizedlist></listitem><listitem><para>The page will ask you for a code generated by the authenticator app - see below how to get the code </para><itemizedlist><listitem override="none"><para><inlinemediaobject><imageobject><imagedata fileref="https://wiki.math.uzh.ch/public/MFA/In_browser_authenticator?action=AttachFile&amp;do=get&amp;target=in-browser-mfa-reg-3.png"/></imageobject><textobject><phrase>in-browser-mfa-reg-3.png</phrase></textobject></inlinemediaobject> </para></listitem></itemizedlist></listitem></orderedlist><para><emphasis role="strong">Note</emphasis>: If you want to use the extension in several places (e.g. both <ulink url="https://wiki.math.uzh.ch/public/MFA/In_browser_authenticator/public/FireFox#">FireFox</ulink> in a <ulink url="https://wiki.math.uzh.ch/public/MFA/In_browser_authenticator/public/ThinLink#">ThinLink</ulink> session and an authenticator app on you smart phone or a browser on your personal laptop), please save the secret key provided along with the QR code. You can use the code to configure the extension in other places. <emphasis role="strong">The code is saved nowhere and once you close the page (or provide the code as in the last step above) it is not possible to access it again</emphasis>. </para></section><section><title>Usage</title><orderedlist numeration="arabic"><listitem><para>Provide login credentials on the page. </para><itemizedlist><listitem override="none"><para><inlinemediaobject><imageobject><imagedata fileref="https://wiki.math.uzh.ch/public/MFA/In_browser_authenticator?action=AttachFile&amp;do=get&amp;target=in-browser-mfa-usage-1.png"/></imageobject><textobject><phrase>in-browser-mfa-usage-1.png</phrase></textobject></inlinemediaobject> </para></listitem></itemizedlist></listitem><listitem><para>When asked for the token: </para><orderedlist numeration="arabic"><listitem><para>Open the authenticator extension and click on the proper entry to copy the code to the clipboard. You should see &quot;Copied&quot; displayed over this entry. </para><itemizedlist><listitem override="none"><para><inlinemediaobject><imageobject><imagedata fileref="https://wiki.math.uzh.ch/public/MFA/In_browser_authenticator?action=AttachFile&amp;do=get&amp;target=in-browser-mfa-usage-2.png"/></imageobject><textobject><phrase>in-browser-mfa-usage-2.png</phrase></textobject></inlinemediaobject> </para></listitem></itemizedlist></listitem><listitem><para>Paste the code on the page (e.g. with Ctrl+V). </para><itemizedlist><listitem override="none"><para><inlinemediaobject><imageobject><imagedata fileref="https://wiki.math.uzh.ch/public/MFA/In_browser_authenticator?action=AttachFile&amp;do=get&amp;target=in-browser-mfa-usage-3.png"/></imageobject><textobject><phrase>in-browser-mfa-usage-3.png</phrase></textobject></inlinemediaobject> </para></listitem></itemizedlist></listitem></orderedlist></listitem></orderedlist><para><emphasis role="strong">Note</emphasis>: On the first time the browser will ask you to permit the extension to use the clipboard - please allow it. If you choose otherwise, you can still copy the code manually (select then press Ctrl+C) or enter it manually on the page. </para></section><section><title>Remove an app from the extension</title><orderedlist numeration="arabic"><listitem><para>Click on the extension icon, then the pen icon </para><itemizedlist><listitem override="none"><para><inlinemediaobject><imageobject><imagedata fileref="https://wiki.math.uzh.ch/public/MFA/In_browser_authenticator?action=AttachFile&amp;do=get&amp;target=in-browser-mfa-edit-1.png"/></imageobject><textobject><phrase>in-browser-mfa-edit-1.png</phrase></textobject></inlinemediaobject> </para></listitem></itemizedlist></listitem><listitem><para>Edit app properties and save by clicking the tick icon or remove the app by click the red disk icon </para><itemizedlist><listitem override="none"><para><inlinemediaobject><imageobject><imagedata fileref="https://wiki.math.uzh.ch/public/MFA/In_browser_authenticator?action=AttachFile&amp;do=get&amp;target=in-browser-mfa-edit-2.png"/></imageobject><textobject><phrase>in-browser-mfa-edit-2.png</phrase></textobject></inlinemediaobject> </para></listitem></itemizedlist></listitem></orderedlist></section></section></article>