To connect LivionKey to the iLOQ locking system, you will need the following four pieces of data:
Service code
Service address
API user name
API user password
The following sections will help you find and create the necessary information.
Once you have gathered this data, please review this article for instructions on completing the LivionKey initial configuration.
Ensure that API access is enabled in iLOQ Manager. For more information, see this article.
1. Finding the service code and service address
Configuring API communication to LivionKey requires the locking system service code and service address, which are your ILOQ manager environment identifiers. If you have already logged in to the iLOQ manager, log out to find the needed information.
Open the iLOQ S5 manager login screen and press the settings icon.
You will find the service code and service address.
2. Creating an iLOQ API user
An API user is needed to communicate with LivionKey and the ILOQ system.
2.1 Create a new user
Go to the Administration tab and select “Add user”
2.2 Select “Add userID”
2.3 Select “Add new person with user ID”
2.4 Provide a first name and last name
The name does not matter, but you should give one that is easy to recognize, such as First name: KeyAutomat and Last name: API
2.5 Provide a User ID and a Password
Try to give a User ID that is easy to recognize, such as “api.keyautomat”.
Please create a strong enough password and don't set a password expiration; otherwise, the integration will stop working.
2.6 Select usage rights
Below are the needed usage rights. LivionKey will check that the API user has needed usage rights when connecting LivionKey to the iLOQ manager
iLOQ manager | Needed for |
Right to browse keys | View keys |
Right to browse locks | View locks |
Right to login in to system | View RealEstates |
Right to administrate locking system | View, Edit, Delete Webhook related data or Network modules |
Right to order keys | Ordering keys |
Right to edit keys | Edit keys |
Right to browse access rights | Access rights that can be given to a key |
Right to edit access rights of the keys | To modify key access |
Right to manage code-access groups | To sync pin codes to online readers |
Right to edit door calendar controls | To sync pin codes to online readers |
Right to browse person roles | To sync pin codes to online readers |
Right to edit person groups | To sync pin codes to online readers |