Over de One Identity Synchronization Tool

2025-09-23Laatst bijgewerkt

De Genetec ClearID™ One Identity Synchronization Tool is een Windows-service waarmee u identiteitsinformatie uit een extern systeem kunt importeren in Genetec ClearID™.

Dialoogvenster Genetec ClearID™ One Identity Synchronization Tool met verbindingsinformatie, gegevensbronneninformatie en synchronisatie-instellingen.
De ClearID One Identity Synchronization Tool bevat de volgende onderdelen:
  • Genetec.ClearID.OneIdentity.SynchronizationTool is de gebruikersinterfacecomponent (OneIdentityConfigurationTool.exe) van de Windows-toepassing die wordt gebruikt om de Synchronization Tool te configureren.
  • Genetec.ClearID.OneIdentity.SynchronizationService is het Windows-serviceonderdeel (OneIdentityService.exe) van de toepassing dat automatisch op de achtergrond externe systeemattributen voor synchronisatie van ClearID-identiteitsattributen uitvoert met intervallen die zijn opgegeven in het synchronisatieprogramma.

Gegevensbronnen

U kunt een of meer gegevensbronnen selecteren die u wilt synchroniseren vanuit een extern systeem. Met behulp van het dialoogvenster Gegevensbronconfiguratie configureert u de gegevensbronnen en wijst u de One Identity-attributen toe aan de bijbehorende externe systeemattributen.
Architectuurdiagram van de gegevenssynchronisatie van de ClearID One Identity Synchronization Tool die plaatsvindt tussen de ClearID-webapplicatie en de gegevensbronnen die informatie over externe identiteitsattributen bevatten.
Azure Active Directory
De Azure AD (Microsoft Entra ID) gegevensbron is een Azure Active Directory waaruit u identiteitgegevens kunt importeren. Denk hierbij aan het importeren van identiteiten, credentials en foto's in ClearID.
Database
De databasegegevensbron kan een Microsoft SQL Server-database, een Oracle-database of een ODBC-compatibele database zijn die de toewijzing van één identiteitsattribuut volgt. De database moet toegankelijk zijn vanaf de server waarop de ClearID One Identity Synchronization Tool is geïnstalleerd. Een database kan één tabel of weergave voor identiteiteninformatie bevatten.
Bestand
De bestandsgegevensbron is een tekstbestand met scheidingstekens. Bijvoorbeeld een CSV-bestand dat de toewijzing van één identiteitsattribuut volgt en toegankelijk moet zijn vanaf de server waarop de ClearID One Identity Synchronization Tool is geïnstalleerd. Elk bestand bevat informatie over identiteiten.

Synchronisatie

Identiteiten in ClearID kunnen afkomstig zijn uit verschillende gegevensbronnen (databases, HR, externe bronnen) en kunnen worden gesynchroniseerd met behulp van verschillende tools (Genetec ClearID™ API of Genetec ClearID™ One Identity Synchronization Tool).
  • API wordt meestal gebruikt voor  realtime updates. Bijvoorbeeld om mensen snel te verwijderen. Deze API-synchronisatieoptie is het meest flexibel, maar is duur. 
  • One Identity wordt meestal gebruikt voor HR-systemen. Bijvoorbeeld om alle medewerkers elke dag of elke 4 uur te synchroniseren. De ClearID One Identity Synchronization Tool is geconfigureerd om met dezelfde frequentie te synchroniseren.

Synchronisatie van One Identity-gegevens

De volgende informatie beschrijft One Identity-synchronisatie:
  • Synchronisatie van externe systeemattributen met ClearID-identiteitsattributen is alleen INKOMEND.
    LET OP!:
    Wijzigingen die alleen in ClearID aan identiteiten worden aangebracht, kunnen bij de volgende synchronisatie vanuit het externe systeem worden overschreven.
  • Synchronisatie kan handmatig worden uitgevoerd met behulp van de optie Nu synchroniseren (), of automatisch met de automatische synchronisatie-intervallen die zijn opgegeven in de One Identity Synchronization Tool.
    • Voor elk One Identity-veld dat wordt geconfigureerd, wordt een gebruikerspecifieke toewijzing aan het externe veld in het externe systeem aangemaakt. Deze toewijzing zorgt ervoor dat de externe systeemattributen kunnen worden gesynchroniseerd met de One Identity-attribuutvelden.
Het volgende diagram illustreert een Azure AD-gegevenssynchronisatie:
Diagram van een Azure AD-gegevenssynchronisatie in de ClearID One Identity Synchronization Tool met de workflowstappen die gegevens synchroniseren tussen de Azure AD-gegevensbron en de ClearID-webtoepassing.
De synchronisatieworkflow is in principe hetzelfde voor alle gegevensbronnen:
  1. Er wordt om gegevensbroninformatie gevraagd.
  2. Gegevensbroninformatie wordt geretourneerd.
  3. Eventuele informatiewijzigingen worden verwerkt en gedetecteerd.
  4. De informatie over de gegevensbron wordt naar de ClearID-webapplicatie gepusht.

SQL-voorbeeldbestanden

Voor de optie Databasegegevensbron worden voorbeeld SQL-scriptbestanden bij de tool geleverd en deze zijn hier te vinden:
C:\Program Files (x86)\Genetec ClearID One Identity Synchronization Service
  • Identities_Oracle.sql
  • Identities_SqlServer.sql
De voorbeeld SQL-scriptbestanden kunnen worden gebruikt om de oplossing van de databasegegevensbron te testen of om u te helpen de SQL-gegevensindeling te begrijpen.

CSV-voorbeeldbestanden

Voor de optie Bestandsgegevensbron wordt een CSV-voorbeeldbestand bij de tool geleverd, dat u hier kunt vinden:
C:\Program Files (x86)\Genetec ClearID One Identity Synchronization Service
  • Identities.csv
De CSV-voorbeeldbestanden kunnen worden gebruikt om de oplossing voor bestandsgegevensbronnen te testen of om u te helpen de CSV-gegevensindeling te begrijpen.