Home
Connecting to other systems
Learn how to connect ClearID to other systems.
Synchronizing identities using One Identity
Use the Genetec ClearID™ One Identity Synchronization Tool to synchronize external system attributes into Genetec ClearID™ identity attributes. These identity attributes in ClearID can then be used to assign people to roles and automate role-based access control.
Installing the One Identity Synchronization Tool
Before you can import identities information from an external system into Genetec ClearID™, you must first install the Genetec ClearID™ One Identity Synchronization Tool.
Upgrading the One Identity Synchronization Tool
Upgrade Genetec ClearID™ One Identity Synchronization Tool to the latest version when it becomes available so that you can use new features.

About ClearID
Learn about the ClearID self-service physical access management solution.
What's new
Check out what's new in the latest update to ClearID.
Deployment preparation
Check your compatibility and deployment requirements.
ClearID plugin
Learn how to download and install the plugin.
Managing identities and users
Learn how to manage identities and users.
Credential synchronization
Managing sites
Learn how to manage sites.
Managing visitors
Learn how to manage visit requests and access requests.
Managing areas
Learn how to manage areas.
Managing visitor watchlists
Learn how to manage visitor access using watchlists.
Role-based access control
Learn about role-based access control.
Connecting to other systems
Learn how to connect ClearID to other systems.
- Authenticating your connection
  Before you can connect with Genetec ClearID™ to synchronize data or issue API commands, you must first authenticate your applications (or API environment) so that your applications or API can communicate with ClearID.
- Setting up data synchronization
  Setting up data synchronization in Genetec ClearID™ involves learning some concepts, configuring the synchronization solution for your identity data, and the webhook integration options that are relevant for your organization.
- Synchronizing identities using Microsoft Entra ID
  To synchronize external system attributes into Genetec ClearID™ identity attributes, you can use the web portal's integrated Microsoft Entra ID synchronization.
- Synchronizing identities using an API
  Use the Genetec ClearID™ API to code your own solutions to automate various functions in ClearID. The primary use for the REST API is synchronizing identities, however many other scenarios are also possible.
- Synchronizing identities using the SCIM integration
  To synchronize external system attributes from a supported identity provider into Genetec ClearID™ identity attributes, you can use the System for Cross-domain Identity Management (SCIM) integration. These identity attributes can then be used in ClearID to assign people to roles and automate role-based access control.
- Synchronizing identities using One Identity
  Use the Genetec ClearID™ One Identity Synchronization Tool to synchronize external system attributes into Genetec ClearID™ identity attributes. These identity attributes in ClearID can then be used to assign people to roles and automate role-based access control.
  - About the One Identity Synchronization Tool
    The Genetec ClearID™ One Identity Synchronization Tool is a Windows service that you can use to import identities information from an external system into Genetec ClearID™.
  - About One Identity Synchronization Tool attribute fields
    When you synchronize an external system with Genetec ClearID™ using the Genetec ClearID™ One Identity Synchronization Tool, your external system attributes are synchronized (imported) into ClearID identity attributes using the field mappings in the One Identity Synchronization Tool.
  - About the Azure web app
    The Azure web app is a web application that is used to connect Genetec ClearID™ One Identity Synchronization Tool to the Azure AD data so that the Active Directory user information can be accessed and synchronized.
  - Installing the One Identity Synchronization Tool
    Before you can import identities information from an external system into Genetec ClearID™, you must first install the Genetec ClearID™ One Identity Synchronization Tool.
    - Uninstalling the One Identity Synchronization Tool
      From time to time, you might want to uninstall the Genetec ClearID™ One Identity Synchronization Tool to fix a problem or install an updated version.
    - Upgrading the One Identity Synchronization Tool
      Upgrade Genetec ClearID™ One Identity Synchronization Tool to the latest version when it becomes available so that you can use new features.
  - Configuring the One Identity Synchronization Tool
    Before you can synchronize an external system with Genetec ClearID™, you must first configure the Genetec ClearID™ One Identity Synchronization Tool.
  - Reviewing synchronization status
    To check that your identity attributes were synchronized into Genetec ClearID™ correctly, you can review the synchronization status in the Genetec ClearID™ One Identity Synchronization Tool or the ClearID web portal.
  - About One Identity Synchronization Tool logs
    The Genetec ClearID™ One Identity Synchronization Tool includes logs that can be used for troubleshooting. The logs can be used to check the status of the configuration tool, the windows service, or review synchronization activities.
  - Viewing One Identity Synchronization Tool logs
    You can use the Genetec ClearID™ One Identity Synchronization Tool logs to check the status of the configuration tool, the windows service, or review synchronization activities.
  - Updating existing identities from an external data source
    When users that have already been created have the same external ID as existing users, you can use Genetec ClearID™ One Identity Synchronization Tool to update the existing identities information from an external data source.
- Synchronizing identities using LDAP
  Use the Genetec ClearID™ LDAP Synchronization Agent to synchronize Active Directory (AD) Lightweight Directory Access Protocol (LDAP) attributes into Genetec ClearID™ identity attributes. These identity attributes in ClearID can then be used to assign people to roles and automate role-based access control.
Visitor management devices
Learn about the ClearID Self-Service Kiosk mobile app that simplifies visitor management and check-in.
Troubleshooting
Troubleshoot common issues that can occur.
Additional resources
Need tech support or product information? Check out these resources.
Glossary

Upgrading the One Identity Synchronization Tool

2023-07-03

Upgrade Genetec ClearID™ One Identity Synchronization Tool to the latest version when it becomes available so that you can use new features.

Before you begin

The Genetec ClearID One Identity Synchronization Tool must be installed.

What you should know

This procedure is for IT or security personnel responsible for external system attributes administration.

Procedure

Back up the configuration folder C:\ProgramData\Genetec\OneIdentity\Configuration.
The folder contains configuration settings. For example, ApiConfiguration.dat, ClearIdEntityMappingFile.xml, Configuration.xml, and SingleCardEntityMapping.xml.
Note:
The .dat or .xml files that you encounter in the configuration folder vary depending on the settings that you configure in the ClearID One Identity Synchronization Tool.
Uninstall ClearID One Identity Synchronization Tool (previous version).
Install ClearID One Identity Synchronization Tool (latest version).
Validate the ClearID One Identity Synchronization Tool is working as expected.

Note:
You should have the same data source configurations as before the upgrade.

The ClearID One Identity Synchronization Tool has now been upgraded.