> For the complete documentation index, see [llms.txt](https://ztrust.gitbook.io/ztrust-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ztrust.gitbook.io/ztrust-documentation/user-manual-ztrust-v4.1/4.-admin-manual/4.13-set-up-multi-factor-authentication/4.13.5-qr-code-based-authentication.md).

# 4.13.5 QR Code Based Authentication

*QR code authentication is a process where a user's identity is verified using a unique QR code generated by an authentication system. When a user attempts to log in or access a secure resource, they are presented with a QR code on the screen.*

To configure the QR Code Based Authentication, follow the below steps -

1. Go to the **Authentication** tab in the sidebar.<br>

   <figure><img src="https://1778922777-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3EUK5AUZv0UVaI5S0CTM%2Fuploads%2FT9adyjoiiuEeLvhpfdxI%2FScreenshot%202025-09-08%20221549.png?alt=media&amp;token=72d61e06-724f-4899-bdbe-c6d28f3f921d" alt=""><figcaption><p>Fig. 4.12.5.a: Navingating to Authentication section</p></figcaption></figure>

2. Click on the **kebab menu (three dots)** on the right side of the browser flow. Select **Duplicate**. A popup will appear.<br>

   <figure><img src="https://1778922777-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3EUK5AUZv0UVaI5S0CTM%2Fuploads%2F9cTOhZ0fJXLsqjJMUSP1%2FScreenshot%202025-09-08%20223201.png?alt=media&amp;token=1999d172-3d19-4fd1-baeb-fae3b73a44bf" alt=""><figcaption><p>Fig 4.12.5.b: Duplicating the existing browser flow</p></figcaption></figure>

3. Provide a **Name** for the flow, "QR Flow". Click **Duplicate**. You will be redirected to the new flow configuration.<br>

   <figure><img src="https://1778922777-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3EUK5AUZv0UVaI5S0CTM%2Fuploads%2FE8A9OLlTM5DPRPuzLG38%2Fimage.png?alt=media&amp;token=ad5e7954-6254-43d3-b4f5-dcfecf1408aa" alt=""><figcaption><p>Fig 4.12.5.c: Giving a name to the new browser flow for QR Code login</p></figcaption></figure>

4. Delete everything under **QR Flow forms**.<br>

   <figure><img src="https://1778922777-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3EUK5AUZv0UVaI5S0CTM%2Fuploads%2FrZMIDcyso9Vox1g4QH0C%2Fimage.png?alt=media&amp;token=346c67f5-06e2-4de0-ad61-b01358cd7de1" alt=""><figcaption><p>Fig 4.12.5.d: Duplicated browser flow configuration page for QR Code login</p></figcaption></figure>

5. Click on the **plus** icon on the right side of the **QR Flow** **forms**. Select **Add Execution**. A popup will appear to select an execution.<br>

   <figure><img src="https://1778922777-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3EUK5AUZv0UVaI5S0CTM%2Fuploads%2FCoVky1uHZZEySaDGj4H8%2Fimage.png?alt=media&amp;token=54b88ae0-27f0-4a9a-8c69-d118ac8606ab" alt=""><figcaption><p>Fig 4.12.5.e: Proceeding to add a new execution to QR Code login flow</p></figcaption></figure>

6. Search for **QR Authenticator**, select it and click **Add**.<br>

   <figure><img src="https://1778922777-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3EUK5AUZv0UVaI5S0CTM%2Fuploads%2FqYoIke9hpXnXFK5fyyOo%2Fimage.png?alt=media&amp;token=d4b576e6-c73b-444e-afd9-f3b056f2522b" alt=""><figcaption><p>Fig 4.12.4.f: Select 'QR Authenticator' execution to add</p></figcaption></figure>

7. Click on the **settings menu (gear icon)** on the right side of the **QR Authenticator**. A popup will appear to configure the QR settings.<br>

   <figure><img src="https://1778922777-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3EUK5AUZv0UVaI5S0CTM%2Fuploads%2F3wq0oFMEMLaUwqzEm69R%2Fimage.png?alt=media&amp;token=a032de78-c2fd-488e-8085-88a9c9ede89d" alt=""><figcaption><p>Fig 4.12.5.g: Proceeding to configure QR Code login</p></figcaption></figure>

8. Provide an **Alias**. **Set Expire in seconds** and click **Save**.<br>

   <figure><img src="https://1778922777-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3EUK5AUZv0UVaI5S0CTM%2Fuploads%2FrpVSC1tDNJUB4dhOco8U%2Fimage.png?alt=media&amp;token=37ff57c0-a1dc-4c6e-838e-52be925ed004" alt=""><figcaption><p>Fig 4.12.5.h: Configuring QR Code login</p></figcaption></figure>

9. Change **Requirement** of the QR Authenticator from **Disabled** to **Required**.<br>

   <figure><img src="https://1778922777-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3EUK5AUZv0UVaI5S0CTM%2Fuploads%2FAXPmkyZL8mP5ZNrocSuk%2Fimage.png?alt=media&amp;token=aa9023d1-850e-49b5-b060-7ba705007959" alt=""><figcaption><p>Fig 4.12.5.i: Changing the 'Requirement' of QR Code login</p></figcaption></figure>

10. Click on the **Actions**, on the top right of the page, and then **Bind flow**. A popup will appear.<br>

    <figure><img src="https://1778922777-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3EUK5AUZv0UVaI5S0CTM%2Fuploads%2Fi7N28DJTy35aX8iFPDW4%2Fimage.png?alt=media&amp;token=b4a3039a-6143-4f69-8d46-75495c8534b7" alt=""><figcaption><p>Fig 4.12.5.j: Proceeding to bind the login QR Code login flow</p></figcaption></figure>

11. Select the **Browser flow** as the **binding type** and click **Save**.<br>

    <figure><img src="https://1778922777-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3EUK5AUZv0UVaI5S0CTM%2Fuploads%2FypPpYQ6zRzhmu5Dg3Tuo%2Fimage.png?alt=media&amp;token=494d8070-ea94-47cf-91a6-a1553450fb2c" alt=""><figcaption><p>Fig 4.12.5.j: Selecting a flow to bind QR Code login to</p></figcaption></figure>

The QR Code based Authentication is enabled now.<br>