Configuring Visionline Mobile Credentials
Learn how to configure Visionline mobile credentials.
In the ASSA ABLOY Visionline Access Management System, the locks are standalone and battery-powered. All access permissions and scheduling details are contained within the key cards and mobile credentials, characterizing these systems as "data-on-card" systems. This guide describes how to issue credentials on the Visionline system.
Seam currently only supports issuing guest mobile credentials. We will extend support to plastic card and staff credentials in the future.
Visionline Mobile Credential Restrictions
When creating a Seam mobile key for a Visionline ACS, you must set is_multi_phone_sync_credential
to true
.
Granting Users Access to Entrances
Your ACS type determines the method that you use to grant users access to entrances. When managing mobile credentials for a Visionline ACS, grant access by creating credentials. For details, see Managing Credentials.
Guest Mobile Credential Properties
When issuing a guest mobile credential, you can use the following relevant properties:
Property | Type | Description |
---|---|---|
|
|
For guest cards, generally itβs
|
|
| Indicates whether this credential invalidates any previously-issued credentials for overlapping entrances. |
|
| List of ACS entrance IDs to which you want to grant the specified ACS user access. |
|
| List of credential IDs with which the current credential shares entrance access. When |
|
| "Label" field data for mobile credentials. This field may contain plain text, as well as predefined placeholders. The placeholders are surrounded by percentage signs ( |
| ISO 8601 format Optional | Start date and time stamp for credential activation. |
| ISO 8601 format Required | End date and time stamp for credential expiration. |
For more information about Visionline-specific credential properties, see Visionline Credential Metadata.
Label Placeholders
The label
field provides "label" field data for mobile credentials. This field may contain plain text, as well as predefined placeholders. The placeholders are surrounded by percentage signs (%
). Visionline replaces these placeholders with the actual values before issuing mobile keys. The final text is truncated to 32 characters. The valid placeholders are as follows:
%ROOMNUM%
: Replaced with main guest room number or name.%ROOMLIST%
: Replaced with comma-separated list of guest rooms.%ROOMRANGE%
: Replaced with hyphen-separated room range. Alternately, if some rooms do not fit into any range, then they are added as a comma-separated list.%SITENAME%
: Name of the property.%CARDNUM%
: Credential ID.%UUID%
: BLE UUID.%USERID%
: Value passed in the UI field.
Issue the First Credential for a Reservation
When issuing guest credentials, hotels need to guarantee that all previous access to guest room entrances is revoked. You accomplish this by issuing an override credential, which overrides any existing credentials that previously granted access to the same guest room entrances.
Issue Subsequent Credentials for a Reservation
For reservations involving multiple parties, hotels often need to provide credentials to additional guests. This is facilitated through the issuance of a "joiner credential." This type of credential allows shared access with any existing credentials that already grant entry to the same guest room entrances. To issue a joiner credential, you must specify the credentials with which to associate the new joiner credential. For instructions on how to retrieve credentials that have overlapping access, see List all valid credentials for a set of guest entrances to add as joiners.
Retrieve Guest and Common Entrances
To differentiate between guest and common entrances, you can look at the door_category
attribute within the visionline_metadata
property for an entrance.
Fetch Guest Entrances
To fetch only guest entrances, filter entrances to include only those with a visionline_metadata.properties.door_category
of guest
.
Fetch Common Entrances
To fetch only common entrances, filter entrances to include only those with a visionline_metadata.properties.door_category
of common
or common (PMS)
.
List All Valid Credentials for a Set of Guest Entrances to Add as Joiners
Use the seam.acs.entrances.list_credentials_with_access
endpoint to fetch a list of credentials. Provide the list of acs_entrance_id
s for the guest entrances, and set include_if
to ["visionline_metadata.is_valid"]
to filter for valid credentials.
Check if a User Identity Has a Phone That Is Set up for a Credential Manager
To issue an override credential to an app user, the app user must first set up their phone. If you want to disable the "override" option where it's not available, you can use the following check before allowing a user to configure an override credential:
Example of Disabling the Override Option When it Is Not Available
Last updated