Integration overview for the Synergis™ Card Synchronization plugin - Card Synchronization 4.0.0

Synergis™ Card Synchronization Plugin Guide 4.0.0

Product
Card Synchronization
Content type
Guides > Plugin and extension guides
Version
4.0
Release
4.0.0
Language
English
Last updated
2024-02-28

Creating entities in Security Center using cardholder information from an external system consists of a sequence of steps.

The following table lists the tasks required for the integration with Security Center, and how to verify that the integration was successful.
Step Description Where to find more information
Learn about the release
1 Read the release notes. Learn about any known issues, limitations, supported software, and other information about this release of the plugin.
Install the plugin
2 Make sure your Security Center license has a valid certificate for the Card Synchronization plugin.

Your Security Center license must also include a sufficient number of parts to support the desired number of data sources you can add.

From the Config Tool homepage, click About > Certificates to confirm that Card Synchronization is on the list.

3 Make sure the server on which the plugin will be installed meets the recommended system requirements and is running a compatible version of Security Center.
4 On the Security Center server, download the plugin and install it.
5 Grant users the privileges that they need to use the plugin.
  • Required privileges.
  • Administrators need the Add roles, Delete roles, and Plugins privileges.
  • Security Desk operators do not need special privileges to use this plugin.
Configure your data sources
6 Prepare your data for use with the Card Synchronization plugin, and make sure that the data sources from which you want to import entities follow the Card Synchronization schema.
7 Prepare your data for use with data source modules.
Configure Security Center
8 If you have custom fields to import from your data sources, create corresponding custom fields in Security Center.
9 If the credentials in your data sources use custom card formats, create corresponding custom card formats in Security Center.
10 Back up the Directory database, so that you can restore the database if you accidentally merge or duplicate entities during import.
Configure the plugin
11 In Config Tool, create the Card Synchronization plugin role.
12 Configure the synchronization settings.
IMPORTANT: Set the Automatic synchronization option to OFF, so that you do not accidentally import from data sources before you are finished initial configuration.
13 Add one or more data sources to the plugin role.
14 If there are entries in the data source with matching criteria, you can associate them to the same entity by using identifying pieces of information in the fields as a global key.

For example, you want to import a list of employees from the human resources database and a list of cardholders from an access control system.

To learn more about merging entities:

15 Change the priority level of the data sources. When multiple data sources contain the same entity, the values of the merged entity are taken from the highest data source on the list.
16 Synchronize Security Center with the data sources you added.