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 to take advantage of the latest features and enhancements.

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.
Account configuration
Learn how to configure and customize the ClearID portal.
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 your applications can communicate with Genetec ClearID™, to synchronize data or issue API commands, they must be authenticated.
- 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 Cloud CSV
  To synchronize attributes from CSV files into Genetec ClearID™ identity attributes, you can use the web portal's Cloud CSV 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 to take advantage of the latest features and enhancements.
  - 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 help you troubleshoot issues and monitor system activity. You can use these logs to check the status of the Configuration Tool, review the Windows service's performance, and investigate 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, monitor the windows service Windows service, or review synchronization activities.
  - Updating existing identities from an external data source
    You can use the Genetec ClearID™ One Identity Synchronization Tool to update identity information from an external data source when existing ClearID identities share the same external ID.
- 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

2026-02-02

Upgrade Genetec ClearID™ One Identity Synchronization Tool to the latest version when it becomes available to take advantage of the latest features and enhancements.

What you should know

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

Procedure

Navigate to C:\ProgramData\Genetec\OneIdentity\Configuration and back up the folder.
The folder contains configuration settings. For example:
- ApiConfiguration.dat
- ClearIdEntityMappingFile.xml
- Configuration.xml
- SingleCardEntityMapping.xml
Note:
The .dat or .xml files that you see might vary depending on the settings that you configure in the ClearID One Identity Synchronization Tool.
Uninstall the previous version of the ClearID One Identity Synchronization Tool.
Install the latest version of the ClearID One Identity Synchronization Tool.
Validate the tool is working as expected.

Note:
Your data source configurations should remain the same after the upgrade.

The ClearID One Identity Synchronization Tool has now been upgraded.