Microsoft Entra ID
De Microsoft Entra ID-integratie verbindt mTime met uw Azure Active Directory-tenant. De integratie synchroniseert medewerkersgegevens via de Microsoft Graph API, zodat uw medewerkerslijst in mTime up-to-date blijft met uw directory.
Wat er gesynchroniseerd wordt
De integratie importeert de volgende gegevens uit Entra ID naar mTime:
- Medewerkers — Volledige naam en e-mailadres
- Actieve status — Of het gebruikersaccount is ingeschakeld of uitgeschakeld in Azure AD
Hoe het werkt
Entra ID stelt gebruikersgegevens beschikbaar via de Microsoft Graph API. mTime maakt verbinding via een Azure AD-appregistratie met de machtiging User.Read.All en haalt alle gebruikers uit uw tenant op. Na de eerste synchronisatie worden alleen wijzigingen verwerkt — medewerkers worden niet gedupliceerd.
De synchronisatie wordt automatisch uitgevoerd volgens een schema. U kunt deze ook handmatig starten via de detailpagina van de integratie.
Attributen toegevoegd door Entra ID
Wanneer de integratie actief is, wordt er een alleen-lezen attribuut toegevoegd aan gesynchroniseerde medewerkers:
| Attribuut | Beschrijving |
|---|---|
| Entra ID-gebruikers-ID | De unieke identificatie van de gebruiker in Microsoft Entra ID |
Dit verschijnt in het gedeelte “Integratieattributen” op de pagina van elke medewerker. Zie Aangepaste attributen voor meer informatie over hoe integratieattributen werken.
Aan de slag
Vereisten
U heeft een Azure AD-appregistratie nodig met het volgende:
- Toepassings-id (client) — te vinden op de overzichtspagina van de appregistratie
- Clientgeheim — aan te maken onder “Certificaten en geheimen”
- Tenant-id — te vinden in de Azure Portal onder Entra ID > Overzicht
- API-machtiging —
User.Read.All(toepassingstype, met beheerdersmachtiging verleend)
De integratie instellen
- Ga naar
- Zoek Microsoft Entra ID in de lijst en klik erop
- Voer uw Tenant-id en Client-id in het configuratiegedeelte in
- Voer uw Clientgeheim in het gedeelte Inloggegevens in
- Klik op Opslaan — mTime test de verbinding voordat de gegevens worden opgeslagen
Zodra de inloggegevens zijn gevalideerd, schakelt u de integratie in om te beginnen met synchroniseren.
Configuratieopties
| Optie | Beschrijving |
|---|---|
| Tenant-id | Uw Azure AD-tenant-id (te vinden in Azure Portal > Entra ID > Overzicht) |
| Client-id | Toepassings-id (client) uit uw appregistratie |
| Domeinfilter | Synchroniseer alleen gebruikers waarvan het e-mailadres eindigt op dit domein (bijv. example.com). Laat leeg om alle gebruikers te synchroniseren |
| Uitgeschakelde gebruikers opnemen | Wanneer ingeschakeld, worden ook gebruikers met uitgeschakelde accounts gesynchroniseerd (zij worden als inactief gemarkeerd in mTime) |
Wat u kunt verwachten na de eerste synchronisatie
Zodra de integratie voor het eerst is uitgevoerd:
- Medewerkers uit uw Azure AD worden aangemaakt in mTime — u kunt ze terugvinden via
- Elke gesynchroniseerde medewerker krijgt het attribuut Entra ID-gebruikers-ID
- Uitgeschakelde gebruikers worden standaard overgeslagen (tenzij “Uitgeschakelde gebruikers opnemen” is ingeschakeld)
- Als er een domeinfilter is ingesteld, worden alleen gebruikers met overeenkomende e-mailadressen geïmporteerd
Probleemoplossing
| Probleem | Oplossing |
|---|---|
| “Verbindingstest mislukt” | Controleer of uw tenant-id, client-id en clientgeheim correct zijn. Zorg ervoor dat beheerdersmachtiging is verleend voor User.Read.All |
| Geen medewerkers gesynchroniseerd | Controleer of er een domeinfilter is ingesteld dat niet overeenkomt met de e-mailadressen van uw gebruikers |
| Ontbrekende medewerkers | Gebruikers zonder e-mailadres of met uitgeschakelde accounts worden standaard overgeslagen. Schakel “Uitgeschakelde gebruikers opnemen” in om hen te importeren |
| “Inloggegevens niet geconfigureerd” | Voer het clientgeheim in en sla het op in het gedeelte Inloggegevens |
Volgende stappen
Zodra de integratie actief is, raadpleegt u Integraties voor informatie over het controleren van de synchronisatiestatus, het handmatig starten van synchronisaties en het oplossen van problemen.