Best practices for importing entities - Card Synchronization 3.4.0

Card Synchronization Plugin Guide 3.4.0

Applies to
Card Synchronization 3.4.0
Last updated
2023-04-17
Content type
Guides > Plugin and extension guides
Language
English
Product
Card Synchronization
Version
3.4

You can configure your data sources and Security Center to ensure your entities and their configurations are retained if you must recreate the plugin role.

Entity configuration

Create a custom field for each unique ID in your data sources and Security Center before importing entities.

If you delete the plugin, all imported entities remain in Security Center. If you create the plugin again and then add the same data sources to the new plugin, all the imported entities are duplicated.

The duplicate imported entities can then be merged after you add a Security Center data source that uses the unique ID global key for each entity type.

Data source configuration

Before adding data sources to the Card Synchronization plugin, include an additional custom field for each entity type in your data sources.

In a database, the custom fields view should include one row for every entity you will import from that database.
  • Use a descriptive name as the CustomFieldName.
    Example: <ExternalSystemName>UniqueID.
  • The values of EntityUniqueId and of CustomFieldValue are the unique ID of the cardholder, cardholder group, or credential.
In cardholder, cardholder group, and credential files, include an additional column to enter the unique ID of each entity.
NOTE: If you want to manually add cardholders to imported groups, create a parent group and add the cardholders and groups as children of the parent group. Otherwise, the manually added cardholders are removed from the group during synchronization.

Security Center configuration

Create a custom field that uses the text data type for each of the following entity types:
  • Cardholders
  • Cardholder groups
  • Credentials
Use the same name you used in the data source.
Example: <ExternalSystemName>UniqueID.