IR WIKI

Integriti Communication Handlers

4 min read

Integriti Communication Handlers

Overview

Communication Handlers act as the bridge between the Integriti Server and external clients, interfaces, or field hardware. They facilitate specific protocols and services, such as providing a cut-down web interface for operators or enabling the Inner Range Mobile Reader app for security personnel to verify credentials and manage emergency mustering.

Technical Details

Web Interface Communication Handler

The Web Interface handler provides a simple, browser-based version of the Integriti System Designer.

  • Licensing: Requires a Business or higher license and consumes one available client seat per running instance.
  • Browser Support: Requires modern HTML5-compliant browsers (Google Chrome, Mozilla Firefox, Opera).
  • Security: HTTPS/SSL is highly recommended and requires a valid SSL Certificate and Private Key registered using the ‘Certificates’ Snap-In of the Windows MMC.
  • Session Protection: By default, an operator can only be logged in from one web frontend. Pre-existing sessions are invalidated by new logins unless “Disable Session Protection” is checked.

Mobile Reader Communications Handler

The Mobile Reader Handler uses a REST/XML Web Service to interface between the Integriti system and the Inner Range Mobile Reader Android app. The app uses NFC to read MIFARE DESFire EV1 & EV2 cards (SIFER and HID DESFire).

  • Licensing: Requires one IR-996927 interface license for each Mobile Device running the app.
  • Hardware: Requires a SIFER Card Enrolment Station (IR-994751AU) to initially enroll cards into the Integriti system so they can be recognized by the Mobile Reader app.
  • Features: Live user identification (photo, location, status), immediate card suspension, and Emergency Muster capabilities (using the phone as a “check-in” reader at an assembly point).

Configuration / Programming

Setting up the Web Interface Handler

  1. Navigate to the Administration tab and open the Communication Handlers panel.
  2. Click Add New and select Web Interface as the Handler Type.
  3. Configure the Port Number and Custom Prefix (e.g., WebClient without spaces).
  4. Check Use HTTPS if SSL certificates are bound to the port.
  5. The URL will take the form: http(s)://[server_ip]:[server_port]/[custom_prefix].

Inactivity Timeout Configuration: Inactivity timeouts are configured per Operator Type to prevent security vulnerabilities from unattended sessions.

  1. Open Operator Types from the Administration tab.
  2. Under the Features tab, expand Software Modules.
  3. Set Client Timeout Mode to “Auto-logout after no system activity for the ‘Inactive Timeout’” and specify the duration.

Setting up the Mobile Reader Handler (REST/XML)

  1. In the Communication Handlers panel, click Add New and select REST/XML Web Service as the Handler Type.
  2. Check Use Security and select an Operator. Integriti will validate that the app user matches these authenticated credentials and apply their permissions.
  3. Set Security Type to HTTPS (recommended) or Basic.
  4. Under Mobile Reader settings:
    • Summary Format: Defines the fields displayed on the app (e.g., Name>{User.Name} or Employee ID>UI-{User.cf_EmployeeID}).
    • Auto Register: Enable this to automatically register new mobile devices to a “Licensed” state until the maximum license count is reached.

Mobile Muster Configuration

To use the Mobile Reader app for emergency mustering:

  1. Navigate to the Access Control tab and open the Locations panel.
  2. Create a specific Location (e.g., “Fire Assembly Area”) and enable Muster point under the General settings.
  3. Open the Location List panel and create a new list. Add the areas/buildings that need to be evacuated to this list. Note: The Location List must not contain the muster locations themselves, only the areas being evacuated.

Troubleshooting

  • Mobile App Cannot Connect: Ensure the IP Address, Port, and Operator credentials entered in the app exactly match the Integriti Server and Comms Handler configuration. Verify that network firewalls allow traffic on the designated port.
  • Cards Not Recognized by Mobile App: Ensure all site cards have been enrolled into the Integriti software using the desktop SIFER Card Enrolment Station. Cards not enrolled natively into the database will not return user information when scanned by the app.
  • Web Interface Disconnects Unexpectedly: Check the Inactivity Timeout settings on the Operator Type. The user should receive a “Your session is about to expire” warning prior to logout.

Graph View

Backlinks