Overview
This guide explains how to configure the KONE 1000 Elevator Integration on the Integriti system. This high-level (HL) integration provides a secure connection to the KONE Access 1000 system, enabling user management, lift floor access control, and live event reporting from KONE terminals into Integriti review.
The integration has three major components:
- User Permissions and Permission Groups — KONE Profiles, Access Rights, and Public Access Rights determine what floors users can access.
- User Synchronization — One-way sync of Integriti users and their credentials to the KONE Access 1000 API.
- Review Logging — MQTT-based live event reporting from KONE terminals into Integriti review.
The integration uses the KONE AK-API (RESTful web interface, tested against v1.1.5) and MQTT protocol.
Important: User records should not be created directly in the KONE lift system. All user management should be done through Integriti.
Prerequisites
- Integriti System Designer with installer-level access.
- KONE Access Codes (Company Name, Client ID, Access Code, Certificate Thumbprint) provided by KONE.
- KONE AK-API host URL or IP address.
- MQTT Event Port and Client ID provided by KONE.
- Both the KONE server and Integriti server configured to the same NTP server for accurate event timestamps.
- License: 996933 — Elevator Management Integration (Lift HLI).
Step-by-Step
1. Create the KONE Communications Handler
- In Integriti System Designer, open the Communications panel from the Design tab.
- Click the Add New button to create a new communications handler.
- Choose a Handler Type of KONE 1000 Elevator Integration.
- Give the handler a name (e.g., “KONE 1000 Elevator”) and set the Run Mode to Disabled (you will change this later).
2. Configure Basic Connection Settings
- Expand Basic Configuration.
- Enter the Host URL or IP Address of the KONE AK-API interface provided by KONE.
- Enter the MQTT Event Port and Client ID provided by KONE.
- Use the Activation Code information provided by KONE to establish a connection (see the Certificates section below).
3. Generate Certificates
- Ensure the Communications Handler has its Run Mode set to Disabled.
- Click the Certificate Configuration button.
- Enter the following values as provided in the KONE Access Codes:
- Company Name — the company name from the KONE Access Codes.
- Client ID — the Client ID that identifies the installing client.
- Access Code — the six-character access code provided by KONE (valid for 24 hours only).
- Certificate Thumbprint — the expected thumbprint of the certificate from KONE.
- Click the Generate Certificate button. If successful, the Integriti logs will show the certificate details including Expiry Date, Client ID, and Thumbprint.
Note: KONE 1000 Certificates expire two months after creation. The Communications Handler automatically renews certificates that expire within two weeks on startup. You can also manually renew by clicking Renew Current Certificate — no new Activation Code is required.
4. Retrieve KONE Groups and Assign Controllers
- Once the certificate is generated and active, click Retrieve KONE Groups.
- Expand KONE Associated Objects Configuration.
- For each item in KONE Groups and KONE Access Blocks, assign the same 3rd Party Controller.
- Save and close the Communications Handler.
5. Configure KONE Custom Fields
- Expand KONE Custom Fields in the Communications Handler settings.
- Click the New button next to each custom field dropdown to create the required fields. The Name, Item Type, Field Type, Notes, and Category Name are automatically populated by the integration.
- Configure the following required custom fields:
| Custom Field | Item Type | Field Type | Purpose |
|---|---|---|---|
| KONE Media Type (Required) | Card Template | Editable Drop Down Box | Determines the KONE Media Type (e.g., RFID, QR Code, Bluetooth) for credentials using this card template. |
| KONE Company Code (Required) | User | Editable Drop Down Box | Specifies the KONE Company Code sent with API requests. |
| KONE Lift Deck Level (Required) | Lift Car | Text | Indicates whether a Lift Car is an Upper or Lower Lift Deck in KONE. |
| KONE Terminal ID (Required) | Lift Car | Text | The Terminal ID in KONE associated with the Lift Car. |
| KONE Group ID (Required) | Lift Car | Text | The Group ID in KONE associated with the Lift Car. |
| KONE 1000 Permission Type | Permission Group | Drop Down Box | Defines whether a Permission Group is a Profile, Access Right, or Public Access Right. |
| KONE 1000 Access Right Actions | Permission Group | Drop Down Box | Sets the Action type for permitted objects (e.g., Normal destination call). |
| KONE 1000 Access Right Direct Call Flag | Permission Group | Check Box | Marks the Access Right as able to make Direct calls. |
| KONE 1000 Access Right Group Call Flag | Permission Group | Check Box | Marks the Access Right as able to make Group calls. |
| KONE Profile Validity Time | Permission Group | Entity Link (Time Period) | Assigns a validity time for the KONE Profile. |
| KONE Person Phone Number | User | Text | The user’s phone number synced to KONE. |
| KONE Person Email Address | User | Text | The user’s email address synced to KONE. |
| KONE Person Home Floor | User | Entity Link (Lift Floor) | The user’s home floor in KONE. |
| KONE Mobile Experience Enabled | User | Check Box | Enables KONE Mobile Experience for the user. Requires Phone Number and Email fields populated. |
| KONE Language | User | Drop Down Box | The primary language for the user in KONE. |
- For each custom field, click Save and close the editor window.
6. Configure User Synchronization
- Expand User Sync Configuration.
- Check the Enabled option.
- Optionally check Sync User PIN if you want the user’s Security PIN synced to KONE. If enabled, each Integriti user must have a Security PIN configured.
- The Card Codec field should only be configured by Inner Range. Contact lift.support@innerrange.com for assistance.
7. Configure Review Logger (Live Event Reporting)
- Expand Review Logger Configuration.
- Check the Enabled option.
- Before enabling, verify with the KONE technician onsite that the correct Client ID/Name exists on their side.
8. Set Run Mode and Save
- Change the Run Mode to Automatically Run on Any Single Server.
- Save changes and close the Communications Handler.
After saving, the system will automatically retrieve KONE’s configuration and populate Lift Cars, Lift Floors, and other entities. The Communications Handler status will indicate when this is complete.
9. Configure Card Templates for KONE
- Navigate to Access Control > Card Templates.
- For each card template whose credentials should be imported into KONE, set the KONE Media Type custom field to the appropriate media type (e.g., RFID, QR Code, Bluetooth).
- Any active credential using that card template will be imported into KONE with the selected media type.
Discuss with KONE beforehand which card templates and media types will be used onsite so they can update their programming accordingly.
10. Configure Users for KONE
- Navigate to Home > Users.
- For each Integriti user that should be synced to KONE, set the following custom fields:
- KONE Person Phone Number — the user’s phone number.
- KONE Person Email Address — the user’s email address.
- KONE Person Home Floor — select the corresponding Lift Floor entity.
- KONE Mobile Experience Enabled — check to enable (requires Phone and Email filled).
- KONE Company Code — select from the dropdown.
11. Build Permissions (KONE Profiles, Access Rights, Public Access Rights)
- Create Permission Groups and assign them the appropriate KONE 1000 Permission Type:
- Profile — the top-level KONE permission. Users must be assigned a KONE Profile.
- Access Right — nested within a Profile, defines what floors users can access. Select Normal destination call (2) from the Actions dropdown. Assign a Floor list with one or many Floor permissions.
- Public Access Right — for public/visitor access. Users must not be assigned Permission Groups marked as Public Access Right.
- Assign the KONE Profile Validity Time custom field to link a Time Period for the Profile’s validity window.
- Users must be assigned to a Permission Group marked as a KONE Profile to trigger synchronization.
12. Configure Holidays (Optional)
- Holidays or Special Days are synced to KONE when they are added to a Time Period mapped to the KONE Profile Validity Time property on a KONE Access Right or Public Access Right Permission Group.
- For overlapping holidays, create a single holiday covering the overlapping period, then separate holidays for any additional days outside that period.
Verification
- After saving the Communications Handler, check that its status shows a successful connection to KONE.
- In the Integriti review, verify Access Session Opened, Access Session Closed, Access Event — Access Granted, and Access Event — Access Denied events appear from KONE terminals.
- Navigate to the Lifts tab and verify Lift Cars and Lift Floors have been automatically created.
- Assign a test user to a KONE Profile with an Access Right. Present the user’s credential at a KONE terminal — the event should appear in Integriti review.
- Verify the user appears in the KONE system with the correct credentials and permissions.
Troubleshooting
| Problem | Resolution |
|---|---|
| Certificate generation fails | Verify the Access Code is still valid (codes expire after 24 hours). Ensure all fields (Company Name, Client ID, Access Code, Thumbprint) match exactly what KONE provided. |
| Communications Handler shows disconnected | Check the host URL/IP and MQTT port are correct. Verify network connectivity between the Integriti server and the KONE AK-API. Ensure the Run Mode is set to Automatically Run on Any Single Server. |
| Users not syncing to KONE | Verify the User Sync Configuration is enabled. Ensure users are assigned to a Permission Group marked as a KONE Profile. Check that the Card Template has a KONE Media Type set. |
| COP Lift Deck marked as DOP Lift Car | This occurs when the lift deck has no assigned terminals in the KONE system. Ensure the lift deck has an assigned COP Terminal in the KONE system. |
| Missed events during disconnection | Integriti fetches missed events on reconnection (maximum 1 day’s worth, even if disconnected longer). Verify NTP synchronization between KONE and Integriti servers. |
| Review events have incorrect timestamps | Ensure both the KONE server and Integriti server are configured to the same NTP server. |
| Custom field presets not populating | Set the Communications Handler Run Mode to Disabled, save, expand Service Data, tick Populate Custom Fields, then set Run Mode back to Automatic and save. |