QR Code Credentials
Overview
QR Code Credentials provide a contactless, software-generated alternative to physical smart cards and fobs. This technology is primarily used for visitor management, contractor access, and temporary permissions, allowing a secure credential to be sent via email or SMS and scanned at a compatible door reader.
Technical Details
How it Works
A QR code functions as a visual representation of a standard card number and site code.
- Generation: Credentials are generated within the Integriti or Inception software. The system embeds the unique user data into a QR image.
- Encoding: Supports multiple compaction modes (Numeric, Alphanumeric, or Byte) and configurable error correction levels to ensure reliable scanning even from phone screens.
- Reader Hardware: Requires a specialized QR code reader connected to the host controller (ISC/IAC or Inception) via Wiegand or OSDP. The reader scans the code and transmits the embedded card data to the controller for an access decision.
Infrastructure Requirements
- Licensing: Requires an Integriti/Infiniti Professional, Business, or Corporate license (for Integriti systems).
- Minimum Version: Compatible with Integriti Pro or Infiniti V22.1 or higher.
- Delivery: The QR image can be sent as an email attachment (requiring a configured Email Sender Handler) or as a text string via SMS.
Configuration (Integriti)
Plugin Details
- Plugin Version: v1.0
- Licensing: Requires Integriti/Infiniti Professional, Business, or Corporate Software Edition.
- Minimum Integriti Version: v22.1 or higher.
Integration Module Setup
- Add the QR Code Credential Integration module.
- Configure the following parameters:
General Configuration
| Parameter | Description |
|---|---|
| Generation Card Template | Card Template used for QR Code credentials. Determines how card data is stored. Use Wiegand Site (Complex) format. Required. Refreshing the device auto-creates a “QR Code Credential” template. |
| Email Custom Field | Custom Field specifying the user’s email address for sending emails. |
| Mobile Number Custom Field | Custom Field specifying the user’s mobile number for sending SMS. |
QR Code Settings
| Parameter | Description |
|---|---|
| Compaction Mode | Encoding mode: Numeric, Alphanumeric, or Byte. |
| Error Correction Level | Redundancy level built into the barcode to compensate for reading errors. |
| QR Code Version | Resulting barcode size. |
| Data Included In QR Code | Data encoded into the QR Code. When Card Number & Site Code is selected, site code and card number sizes are determined by the Generation Card Template settings. |
Logging
| Parameter | Description |
|---|---|
| Log Verbosity | Only logs at or above the selected level are written. |
Credential Generation
| Parameter | Description |
|---|---|
| Card Start Point | Starting card number for auto-generated credentials. |
| Card End Point | End point for auto-generated card numbers (defines the valid range). |
| Random Card Numbers | When enabled, random card numbers are used between Start/End points. When disabled, sequential generation starting at Card Start Point. |
| Auto-Generate Credential User Filter | User filter determining which users get auto-generated QR credentials. Users who already have one or match the Auto-Revoke filter are excluded. |
| Auto-Revoke Credential User Filter | User filter for auto-revoking QR credentials. Users matching both filters have their credential revoked (or not generated). |
Credential Sending
| Parameter | Description |
|---|---|
| Email Sender Handler | Communication Handler used for sending emails. Leave blank to skip email sending. |
| Email Body Format | Format string for email body. Supports user and credential placeholders. |
| Email Subject Format | Format string for email subject. Supports user and credential placeholders. |
| Attach Credential Image To Email | When enabled, the QR Code image is attached to emails. |
| SMS Sender Handler | Communication Handler used for sending SMS. |
| SMS Format | Format string for SMS body. Supports user and credential placeholders. |
Note: The QR Code image can only be sent as an attachment via email. SMS can only send text representing the credential.
Site Code & Card Template Settings
When using Card Number & Site Code, the Generation Card Template’s format settings are critical:
- Use Wiegand Site (Complex) format to simplify interaction between reader data output and Integriti card storage.
- Site Code Length and Card Number Length in the template determine the bit sizes.
- For 26-bit Wiegand (24 data bits + 2 parity bits), configure Site Code Offset and Card Number Offset so they don’t overlap with parity bits.
Generating QR Code Credentials
Manual Generation
- Open a User’s Acquire Card dialog.
- Switch to the QR Code Image Credential tab.
- Click Generate Credential.
- Select the card number (auto-generated, from existing credentials, or manually entered).
- Click Select Card to generate the QR Code.
- Click Save Credential to add it to the user.
Automatic Generation
- Configure the Auto-Generate Credential User Filter in the Integration Module.
- Enable the persisted connection for the integration module.
- All users matching the filter automatically receive a QR Code credential. Card numbers follow the Credential Generation settings.
Automatic sending occurs for both manual and auto-generated credentials via the configured Email/SMS handlers at the time of generation/save.
Use Cases
- Visitor Management: Send a one-day access pass to a visitor’s smartphone before they arrive on-site.
- Contractor Access: Issue time-limited credentials that automatically expire after a scheduled maintenance window.
- Gyms/Member Clubs: Provide members with a digital “card” within their own membership app.