SCIM 2.0 Entra ID Setup guide

Dit artikel geeft stapsgewijze instructies om de SCIM-verbinding tussen Microsoft Entra ID en deskbird op te zetten, zodat gebruikers- en groepgegevens naadloos gesynchroniseerd worden.

💡 Let op: Na het instellen van SCIM kan de eerste synchronisatie 1–2 uur duren. Wacht even en controleer het later opnieuw.

⚠️ Bij het provisionen mogen alleen gebruikers en/of groepen worden opgenomen die toegang tot deskbird nodig hebben. Alle objecten die in de synchronisatie zijn opgenomen, worden automatisch geprovisioned.

1. Maak het SCIM-token aan in deskbird
2. De SCIM-applicatie instellen
3. Stappen om de geselecteerde objecten te provisionen

1. Maak het SCIM-token aan in deskbird

1. Ga naar Admin > Bedrijf: API sleutels.
2. Klik op Generate key, vul een Naam in en selecteer SCIM.

3. Kies je SCIM-provider en genereer je token (er is maar één token per bedrijf)

4. Kopieer je SCIM-token en plak het op een veilige plek (het token is niet zichtbaar in de UI)

5. Je kunt altijd een bestaande sleutel intrekken en een nieuwe aanmaken

Nu heb je alles wat je nodig hebt om verder te gaan met het instellen van je SCIM-applicatie

2. De SCIM-applicatie instellen

1. Ga naar https://entra.microsoft.com/ en klik op Enterprise applications

2. Klik op New application

3. Klik op Create your own application

4. Geef het een naam en zorg dat Integrate any other application you don't find in the gallery (Non-gallery) is aangevinkt:

5. Klik op Create

6. Je wordt nu doorgestuurd naar de zojuist aangemaakte applicatie

7. Ga naar Provisioning

8. Klik op Get started

9. Selecteer Automatic in het dropdownmenu

10. Vul in het veld Tenant URL de volgende URL in: https://api.deskbird.app/v2/scim
11. Vul in het veld Secret Token het bedrijf SCIM-token in dat je in de eerste stap hebt aangemaakt
12. Klik op Test Connection

Als alles goed werkt, zie je een bevestigingspop-up.

13. Klik op Save

14. Klik op Provision Microsoft Entra ID Users onder Mappings

15. Scroll naar beneden en verwijder het mailNickname-attribuut

16. Klik onderaan de pagina op Add New Mapping

17. Ga naar Source attribute en selecteer objectId in het dropdownmenu

18. Ga naar Target attribute en selecteer externalId in het dropdownmenu

19. Klik op Save

20. Je ziet nu de toegevoegde mapping in de lijst:

21. Klik op Provision Microsoft Entra ID Users onder Mappings

💡 Aanbevolen controle voor provisioning op basis van groepen:
Als je SCIM-provisioning op basis van groepen gebruikt, raden we sterk aan om de groep-attribuutmappings te controleren zodat gebruikers correct gedeactiveerd worden in deskbird wanneer ze uit een Entra ID-groep worden verwijderd.

1. Selecteer in het gedeelte Mappings de optie Provision Microsoft Entra ID Groups in het dropdownmenu.
2. Scroll naar beneden en klik op Show advanced options.
3. Zoek het attribuut met als target attribute members.

Zorg voor de volgende configuratie:

• ❌ urn:ietf:params:scim:schemas:core:2.0:Group is niet geselecteerd
• ✅ urn:ietf:params:scim:schemas:extension:enterprise:2.0:User blijft geselecteerd

Sla de wijzigingen op en wacht een paar minuten tot Microsoft Entra ID ze heeft toegepast. Met deze configuratie worden gebruikers die uit Entra ID-groepen zijn verwijderd, bij de volgende provisioning-cyclus correct op Inactief gezet in deskbird.

22. Ga naar Enterprise Applications en selecteer Users and Groups

23. Klik op Add user/group

24. Klik op None selected

25. Zoek en kies de groep(en)/gebruiker(s) die je wilt provisionen. Klik op Select

26. Klik op Assign

Alles zou nu goed ingesteld moeten zijn!

3. Stappen om de geselecteerde objecten te provisionen

1. Ga naar je SCIM-applicatie en klik op Provisioning

2. Ga naar Start provisioning

3. Het proces wordt op de achtergrond gestart. Als het klaar is, ziet het er zo uit:

💡 Let op: Na het instellen van SCIM kan de eerste synchronisatie 1–2 uur duren. Wacht even en controleer het later opnieuw. Na de eerste setup vindt er elke 40 minuten een synchronisatie plaats.