This article describes how to configure the Demo service that functions as a PACS simulator with Smart ID Physical Access component in Smart ID Identity Manager.
If Physical Access is being used with the Demo service, all administration of Users, Access Tokens and Entitlements (besides defining them) should be done in Identity Manager.
The Demo service is used to import entitlements (or access groups) from the AccessGroups.json file and export persons, cards and entitlement assignments from Physical Access to the Users.json file. For details on how data can be imported and exported from the demo access control system, see About import and export to Physical Access.
Prerequisites
Configure Demo service data fields
The Demo service data is configured in the configuration table in the Physical Access database. All configuration is cached when the service starts so any configuration changes will require the service to be restarted in order to take effect.
To connect to a PACS system:
- Log in to Physical Access admin panel as an admin user.
All configured PACS connector services are listed, as well as Generic configurations to define the messaging queue. - Click on a system to do updates.
All database entries are listed. - To update an entry, click on the icon
. Edit as needed and then click Update. - To create an entry, click on +Create. Select Group, enter Key, Value and Index, and then click Create.
group: messagingqueue
| key | Data type | Required or Optional | Description |
|---|---|---|---|
| server | string | Required | IP Address of Message Queue Server. If it is installed on the local server then we can use localhost. If we are accessing this server remotely then need to mention IP address. |
| username | string | Required | Username of message queue server. Default value: “guest” |
| password | string | Required | Password of message queue server. Default value: “guest” |
| system | string | Required | Defines which messaging queue to be used, either "rabbitmq" or "azureservicebus". Default value: "rabbitmq" |
group: general
| key | Data type | Required or Optional | Description |
|---|---|---|---|
| deleteUserOnNoEntitlement | string | Optional | Defines if the user shall be deleted if no active entitlement assignment are present for that user. Valid values: Default: |
| deleteUserOnNoAccessToken | string | Optional | Defines if the user shall be deleted if no active access tokens are present for that user. Valid values: Default: |
heartbeatInterval | int | Optional | Heartbeat interval is the time difference between two successive heartbeats, and it is used to know if the system is in active (running) or in inactive (stopped) state. Default value and minimum value: 60 seconds. If it is set less than 60 seconds, it will be considered as 60 seconds to update the status. |
group: export
| key | Data type | Required or Optional | Description | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| userfieldmappings | string | Optional |
User column fields can be sent by adding the configuration The following table shows sample configuration for
|
group: demo.card.mapping.default
This group defines how to export card numbers by default, when a card’s layout does not have a specific mapping.
| key | Data type | Required or Optional | Description |
|---|---|---|---|
| layoutIdentifier | string | Required | The name of the card layout to match (case insensitive) for this mapping. Each layout may only be mapped once. |
cardNumberIdentifier | string | Optional | The default identifier type to read card numbers. Default: |
format | string | Optional | The format that the card number should be converted into before exporting it to the Demo service. Valid values: Default: |
length | int | Optional | The length that the card number should be trimmed (leading digits) or padded (with leading zeroes) to after converting it. Default: 9 |
group: demo.card.mapping
This group contains compound configuration elements using the config_index column. For each unique config_index value in this group, each key defined below must be defined exactly once. Note that this group is not required as a whole, and should only be used if you have specific requirements for one or more card layouts.
| key | Data type | Required or Optional | Description |
|---|---|---|---|
layout | string | Optional | The name of the card layout to match (case insensitive) for this mapping. Each layout may only be mapped once. |
cardNumberIdentifier | string | Optional | This indicates the identifier for card number. |
format | string | Optional | The format that the card number should be converted into before exporting it to the Demo Service. Valid values: |
| length | int | Optional | The length that the card number should be trimmed (leading digits) or padded (with leading zeroes) to after converting it. |
Example
Example configuration for card mapping settings:
system | key | value | group | index |
|---|---|---|---|---|
| DEMO | layout | Linear | demo.card.mapping | 1 |
| DEMO | cardNumberIdentifier | mifare | demo.card.mapping | 1 |
| DEMO | length | 9 | demo.card.mapping | 1 |
| DEMO | format | Linear | demo.card.mapping | 1 |
| DEMO | layout | skip | demo.card.mapping | 2 |
| DEMO | cardNumberIdentifier | mifare | demo.card.mapping | 2 |
| DEMO | length | 9 | demo.card.mapping | 2 |
| DEMO | format | skip | demo.card.mapping | 2 |
Restart service
This article is valid for Smart ID 21.04 and later.