Guide de configuration SCIM 2.0 Entra ID

Cet article fournit des instructions étape par étape pour configurer la connexion SCIM entre Microsoft Entra ID et deskbird, permettant la synchronisation transparente des données des utilisateurs et des groupes.

💡 Remarque : Après avoir configuré SCIM, la première synchronisation peut prendre 1 à 2 heures. Merci de patienter et de vérifier à nouveau plus tard.

⚠️ Les objets à provisionner doivent uniquement inclure les utilisateurs et/ou groupes qui ont besoin d’un accès à deskbird. Tous les objets inclus dans la synchronisation seront automatiquement provisionnés.

1. Créer le jeton SCIM dans deskbird
2. Configurer l’application SCIM
3. Étapes pour provisionner les objets sélectionnés

1. Créer le jeton SCIM dans deskbird

1. Va dans Admin > Entreprise : Clés API.
2. Clique sur Générer une clé, saisis un Nom et sélectionne SCIM.

3. Choisis ton fournisseur SCIM et génère ton jeton (il n’y a qu’un seul jeton par entreprise)

4. Copie ton jeton SCIM et colle-le dans un endroit sécurisé (le jeton ne sera plus visible dans l’interface)

5. Tu peux toujours révoquer une clé existante et en générer une nouvelle

Tu as maintenant tout ce qu’il te faut pour continuer la configuration de ton application SCIM

2. Configurer l’application SCIM

1. Va sur https://entra.microsoft.com/ et clique sur Applications d’entreprise

2. Clique sur Nouvelle application

3. Clique sur Créer votre propre application

4. Donne-lui un nom et assure-toi que Intégrer toute autre application que vous ne trouvez pas dans la galerie (Hors galerie) est coché :

5. Clique sur Créer

6. Tu devrais maintenant être redirigé vers la nouvelle application créée

7. Va dans Provisioning

8. Clique sur Commencer

9. Sélectionne Automatique dans le menu déroulant

10. Dans le champ Tenant URL, insère l’URL suivante : https://api.deskbird.app/v2/scim
11. Dans le champ Secret Token, saisis le jeton SCIM de l’entreprise que tu as généré à la première étape
12. Clique sur Tester la connexion

Si tout fonctionne comme prévu, tu verras une fenêtre de confirmation.

13. Clique sur Enregistrer

14. Clique sur Provisionner les Utilisateurs Microsoft Entra ID sous Mappings

15. Descends en bas de la page et supprime l’attribut mailNickname

16. En bas de la page, clique sur Ajouter un nouveau mapping

17. Va dans l’attribut Source et sélectionne objectId dans le menu déroulant

18. Va dans l’attribut Cible et sélectionne externalId dans le menu déroulant

19. Clique sur Enregistrer

20. Tu devrais maintenant voir le mapping ajouté dans la liste :

21. Clique sur Provisionner les Utilisateurs Microsoft Entra ID sous Mappings

💡 Vérification recommandée pour le provisioning basé sur les groupes :
Si tu utilises le provisionnement SCIM basé sur les groupes, nous te recommandons vivement de vérifier les mappings d’attributs de groupe pour t’assurer que les utilisateurs sont bien désactivés dans deskbird lorsqu’ils sont retirés d’un groupe Entra ID.

1. Dans la section Mappings, sélectionne Provisionner les Groupes Microsoft Entra ID dans le menu déroulant.
2. Descends en bas et clique sur Afficher les options avancées.
3. Repère l’attribut dont l’attribut cible est members.

Assure-toi de la configuration suivante :

• ❌ urn:ietf:params:scim:schemas:core:2.0:Group n’est pas sélectionné
• ✅ urn:ietf:params:scim:schemas:extension:enterprise:2.0:User reste sélectionné

Enregistre les modifications et attends quelques minutes pour que Microsoft Entra ID les applique. Avec cette configuration, les utilisateurs retirés des groupes Entra ID seront bien mis sur Inactif dans deskbird lors du prochain cycle de provisioning.

22. Va dans Applications d’entreprise et sélectionne Utilisateurs et Groupes

23. Clique sur Ajouter un utilisateur/groupe

24. Clique sur Aucun sélectionné

25. Recherche et choisis le(s) groupe(s)/utilisateur(s) que tu veux provisionner. Clique sur Sélectionner

26. Clique sur Attribuer

Tout devrait maintenant être configuré !

3. Étapes pour provisionner les objets sélectionnés

1. Va dans ton application SCIM et clique sur Provisioning

2. Va dans Démarrer le provisioning

3. Le processus va démarrer en arrière-plan. Une fois terminé, cela devrait ressembler à ceci :

💡 Remarque : Après avoir configuré SCIM, la première synchronisation peut prendre 1 à 2 heures. Merci de patienter et de vérifier à nouveau plus tard. Après la configuration initiale, une synchronisation aura lieu toutes les 40 minutes.