> For the complete documentation index, see [llms.txt](https://help.security.gallagher.com/knowledge-hub/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.security.gallagher.com/knowledge-hub/configuration-client/integrated-systems/morpho-biometric-integration/qr-code-authentication-mode-at-morpho-readers.md).

# QR Code authentication mode at Morpho Readers

### Introduction

When configured to do so, cardholders can gain access at MorphoWave, VisionPass and VisionPass SP readers using a QR code.

This topic is split into the three parts of this process, as follows:

* Configuration of QR codes in Command Centre Configuration Client
  * Setting QR Code as Authentication Mode
  * Creating a card type with "New QR Code Access Token Object"
  * Configuring the Card Type
* QR Code specification recommendations
* Using QR code for access

**Important:** To ensure the QR code reading is activated, the following firmware versions should be used:

* for VisionPass SP readers version 2.2.1 or 2.2.3
* for VisionPass readers version 2.8.9 (or later)
* for MorphoWave SP readers version 1.2.7 (or later)

### Configuration

#### Setting the QR Code Authentication Mode

1. In Command Centre Configuration Client, click **Configure** from the menu bar, then **Hardware**.

   The **Hardware** List Window opens.
2. **Right click** the MorphoWave or VisionPass reader that you want to support badging of a QR code for access.
3. Click the **Setup** tab.

   ![](https://3000903572-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCvaxj3suxNBzdwQndVT%2Fuploads%2Fgit-blob-9cf50ea0096f214c211b6a10e3b3586f83e1a489%2Fmorphoreader_qrcode.png?alt=media)
4. Tick the **QR Code** checkbox.
5. Click **OK** to exit the reader properties and save your changes.

   A warning message displays advising that QR Code is not a secure method.

   ![](https://3000903572-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCvaxj3suxNBzdwQndVT%2Fuploads%2Fgit-blob-25ab839b646c87306c717ac6fd0960a319fc9a63%2Fqrcode_warningmessage.png?alt=media)
6. Click the **Yes** button.

   The warning message closes and your changes are applied to the reader properties.

#### Creating a Card Type

7. Click **Configure** from the menu bar, then **Card Types**.

   The **Card Type** List Window opens.
8. **Right click** and select **New\...Card Type**.

   By default the **General** tab displays.
9. Enter an appropriate **Name** for this card type, (e.g. QR Code card type).

   ![](https://3000903572-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCvaxj3suxNBzdwQndVT%2Fuploads%2Fgit-blob-92f5efce47c9466a374fc29f68668ad77c904de5%2Fqrcode_cardtype.png?alt=media)
10. Click the **Setup** tab, and enter the correct **Facility Code**.

    **Note:** It is strongly recommended that you use a different Facility Code from the server, and create a separate QR User Group to avoid security vulnerabilities.
11. Click **OK** to save this card type.

#### Configuring the Card Type

12. **Right click** on the newly created **Card Type** and select **Edit Card Layout**.

    The Card Editor window displays.
13. Select **New QR Code Access Token Object** from the drop-down list of objects.

    ![](https://3000903572-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCvaxj3suxNBzdwQndVT%2Fuploads%2Fgit-blob-2c08609c2d49566e260dc337c93f65c1fa89b13e%2Fcardeditor_qrcodeobject.png?alt=media)

    A QR Code image displays with placeholders around it.

    ![](https://3000903572-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCvaxj3suxNBzdwQndVT%2Fuploads%2Fgit-blob-9b11d59c9c03b975b1120b3faf8baa77608392c2%2Fcardeditor_qrcodeaccesstoken.png?alt=media)
14. Click the **OK** button.

    The Card Editor window closes.
15. Assign the new QR Code card type to the cardholders.

    See [Adding a Card to a Cardholder](https://help.security.gallagher.com/knowledge-hub/configuration-client/site-management/cardholders/adding-a-card-to-a-cardholder.md) for the procedure.

### QR Code specification recommendations

* The QR Code data shall contain an UTF-8 string of 24 characters or less.
* The QR Code shall be printed on paper (not plastic) thick enough to ensure proper rigidity: 10 mil (usual business cards), the paper shall be white (no glossy / shiny) and the QR Code printed in black.
* For VisionPass readers, if you are using a mobile phone or tablet, the background shall be white and QR Code black, with brightness set to high.
* If the QR Code is to be used at a MorphoWave reader, to ensure both a good reading performance and a convenient user guidance while positioning the barcode in the scanning area, please make sure the recommended dimensions below are applied:

  **Note:** For VisionPass readers 4cm x 4cm barcode size is recommended.

<figure><img src="https://3000903572-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCvaxj3suxNBzdwQndVT%2Fuploads%2Fgit-blob-297b7d47d7c0661d2bb4d0d01ff0f7d3a4c752e2%2Fqrcode_dimensions.png?alt=media" alt=""><figcaption></figcaption></figure>

**Example: (do NOT resize)**

<figure><img src="https://3000903572-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCvaxj3suxNBzdwQndVT%2Fuploads%2Fgit-blob-889af96ebce33d95f778ea0ad7a39e4237b2859c%2Fqrcodeexample.png?alt=media" alt=""><figcaption></figcaption></figure>

**Important:** If the QR code size is not followed, this might cause some reading issues. For example, double read the QR code or after reading the QR code, MorphoWave reader asks for hand.

### Using QR Code for access

Are you attempting to gain access at a MorphoWave reader or VisionPass reader?

<table><thead><tr><th width="182">If a...</th><th>then...</th></tr></thead><tbody><tr><td>MorphoWave reader,</td><td><p>place the QR code into the reading area.</p><p>If the QR code is valid access is granted. Otherwise, an access denied message will display.</p></td></tr><tr><td>VisionPass reader,</td><td><p>place the QR code between 15cm and 25cm away from the top of the reader.</p><p>If the QR code is valid, and the cardholder is configured correctly with access, access is granted. Otherwise, an access denied message will display.</p></td></tr></tbody></table>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.security.gallagher.com/knowledge-hub/configuration-client/integrated-systems/morpho-biometric-integration/qr-code-authentication-mode-at-morpho-readers.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
