This article explains how to enable and use QR code login for the Senso iOS Client (Login V2). This allows users to sign in quickly by scanning a QR code containing their first and last name.

Applies To

  • Senso iOS Client (Login V2)
  • iOS devices

Step 1 – Enable Custom Sign-In

  1. In your MDM configuration (or configuration file), set the following key:
    senso:enabled_custom_sign_in (or EnableCustomSignIn) = true
  2. (Optional) To automatically launch the QR scanner on login:
    defaultQRCodeSignIn = true

Note: Refer to the iOS Client Installation Guide for full configuration details.

Step 2 – Generate QR Codes

  1. Use a QR code generator (any free online tool can be used).
    For bulk creation, search for: bulk QR code generator free
  2. Enter user data in the following JSON format within the QR code generator (one user per line):

{"FirstName": "David", "LastName": "Jones"}
{"FirstName": "Jane", "LastName": "Doe"}

  1. Generate and distribute the QR codes to users.

Important:

  • First and last names must contain letters only
  • Do not use numbers, symbols, or special characters

Step 3 – Login Using QR Code

  1. Open the Senso app on the iOS device
  2. Enable the camera by toggling the switch on the right
  3. Point the camera at the QR code
  4. Ensure the red marker aligns with the QR code

The application will automatically scan the code and log the user in.

Troubleshooting

Issue: Invalid QR Code

Possible causes:

  • First/Last name contains invalid characters
  • Incorrect JSON format
  • QR code generated incorrectly

Resolution:

  • Ensure names contain letters only
  • Validate JSON structure
  • Regenerate the QR code

Issue: Camera Not Working

Resolution:

  1. Navigate to Settings > Apps > Senso Mobile v2
  2. Ensure Camera permissions are enabled

Additional Notes

  • Each QR code is unique per user
  • QR codes must follow the exact JSON structure
  • Bulk generation tools can simplify large deployments