Ce guide vous aidera à configurer une application dans Microsoft Azure/Entra AD permettant à RESPONSUM de récupérer les informations des utilisateurs depuis l’AD et de créer des comptes utilisateur pour ces utilisateurs dans RESPONSUM. Cette synchronisation peut être configurée et exécutée automatiquement à intervalles définis ou manuellement depuis le sous-menu de synchronisation AD.
REMARQUE : Ce flux de synchronisation fonctionne uniquement avec des configurations Azure/Entra AD. Les installations Active Directory sur site ne sont pas prises en charge par RESPONSUM.
REMARQUE : Si aucun filtre/type de filtre n’est défini dans RESPONSUM, cette intégration importera tous les utilisateurs connus dans votre Active Directory, y compris les comptes externes ayant accès via vos services et donc connus de votre AD. Soyez prudent lors de l’utilisation de cette intégration, car elle peut importer plus d’utilisateurs que prévu ; vérifiez au préalable avec votre administrateur informatique.
REMARQUE : RESPONSUM archivera, lors de la prochaine synchronisation AD, les utilisateurs précédemment ajoutés via la synchronisation AD s’ils ne sont plus présents dans l’Active Directory.
Voir en action
Prérequis pour commencer
- Autorisations sur le sous-module spécifique « User Management » ou « AD sync configuration » en tant que responsable
- Connaissance de votre environnement Azure/Entra ID et un compte disposant de droits élevés vous permettant d’effectuer un « App registration »
- Une idée des utilisateurs/groupes que vous souhaitez importer dans RESPONSUM afin de limiter l’ensemble des utilisateurs à ceux requis pour la connexion à RESPONSUM.
La voie rapide vers l’excellence
- Sélectionnez le menu « Settings » dans la barre de menu principale (icône d’engrenage)
- Survolez la sous-section « User management »
- Sélectionnez « AD sync configuration »
- Donnez un nom à votre configuration
- Définissez un type de filtre : « Users » (filtres Graph appliqués sur l’endpoint users) ou « Groups » (filtres Graph appliqués sur l’endpoint groups)
- Remarque : Vous n’avez pas besoin d’inclure d’instruction « $select » dans la requête
- Définissez une instruction de filtre en utilisant la structure de filtre Microsoft Graph (plus d’infos ici)
- Choisissez si vous souhaitez planifier les exécutions de synchronisation AD ou les déclencher manuellement
- Créez un enregistrement d’application (app registration) avec Microsoft Entra afin d’obtenir les informations nécessaires (plus de détails sur la création de l’application ci-dessous)
- Renseignez l’ID client, le secret client et l’ID d’annuaire (tenant) obtenus depuis l’application enregistrée
- Commencez à mapper les propriétés des utilisateurs Azure/Entra AD vers les champs « User » dans RESPONSUM
- Vous pouvez ajouter autant de lignes de mapping que nécessaire pour mapper tous les détails
- Vous pouvez sélectionner n’importe quelle propriété personnalisée dans l’AD en choisissant « Set Custom field » dans la colonne AD de gauche
- Vous pouvez créer des champs personnalisés dans RESPONSUM vers lesquels mapper des propriétés en utilisant le bouton « + » dans la colonne des champs RESPONSUM à droite
- Définissez les propriétés initiales
- Si, dans les propriétés initiales, vous indiquez que les utilisateurs ne doivent pas être ajoutés en tant que « Guest users », ils deviendront des « Promoted users ». Dans la section suivante, vous pourrez définir les « Default permissions » à attribuer à tous les utilisateurs ajoutés via cette configuration de synchronisation AD.
- Enregistrez la configuration
- Si vous avez sélectionné une planification, la configuration AD s’exécutera désormais selon l’intervalle défini ; en mode « Manual », cliquez sur « Start a manual sync » pour synchroniser les utilisateurs vers RESPONSUM.




Guide étape par étape
Configuration de l’« App registration » Azure/Entra AD
- Créez une nouvelle application Active Directory via la section « App registration » du portail Azure ou du portail Entra (les étapes seront similaires ; le portail Azure est illustré dans les captures d’écran ci-dessous)
- Cette application peut être nommée comme vous le souhaitez (p. ex. « RESPONSUM AD Sync »). Sélectionnez l’option « Accounts in this organizational directory only » pour « Supported account types », puis cliquez sur « Register » pour enregistrer l’application.


- On the overview page of the newly created application, you will see following two parameters:
- ID d’application (client)
- ID d’annuaire (tenant)
- Notez-les ou repérez leur emplacement, car vous devrez les saisir dans RESPONSUM ultérieurement.
- Next thing to be created is a Client Secret that RESPONSUM can use to access the API and get user/group info. This can be done from the same overview page by clicking “Add a certificate or secret”. On the newly opened “Certificates & Secrets” page, select “New Client Secret” to create the new secret. Give the secret a description (e.g. “RESPONSUM App secret”) and keep the default expiration date or choose your own.
- REMARQUE : Pensez à renouveler ce secret en fonction de la date d’expiration définie afin que la synchronisation reste opérationnelle
- Copiez et stockez temporairement ce secret quelque part, car il ne sera affiché qu’une seule fois après sa création. Il devra être saisi dans RESPONSUM ultérieurement.




- L’étape suivante consiste à accorder à RESPONSUM les autorisations appropriées pour utiliser l’API afin de récupérer les informations utilisateurs/groupes depuis votre AD. Cela se fait dans la sous-section API Permissions de l’application créée. Par défaut, l’API Microsoft Graph et l’autorisation « User.Read » seront présentes.
- Cette autorisation doit être étendue avec « User.Read.All » et « Group.Read.All ». Vous pouvez les ajouter en cliquant sur « Add a permission », puis sur « Microsoft Graph » >> « Application permissions ». Vous pouvez ensuite rechercher « User », puis « Group » afin de trouver les autorisations spécifiques aux utilisateurs et aux groupes :





- Once the permissions are set, you need to Grant admin consent for your organization for us to be able to use the new permissions. This can be done by pressing “Grant Admin consent for <Organization name>”:
- REMARQUE : Assurez-vous d’utiliser un compte disposant des autorisations suffisantes pour pouvoir accorder cet accès.



Configurer l’« AD sync configuration » dans l’interface RESPONSUM
- Sélectionnez le menu « Settings » dans la barre de menu principale (icône d’engrenage)
- Survolez la sous-section « User management »
- Sélectionnez « AD sync configuration »
- Donnez un nom à votre configuration (il peut s’agir du même nom que votre application dans Azure/Entra AD)
- Définissez un type de filtre : « Users » (filtres Graph appliqués sur l’endpoint users) ou « Groups » (filtres Graph appliqués sur l’endpoint groups)
- Remarque : Vous n’avez pas besoin d’inclure d’instruction « $select » dans la requête
- Définissez une instruction de filtre en utilisant la structure de filtre Microsoft Graph (plus d’infos ici)
- Choisissez si vous souhaitez planifier les exécutions de synchronisation AD ou les déclencher manuellement
- Renseignez l’ID client, le secret client et l’ID d’annuaire (tenant) obtenus depuis l’application enregistrée dans Azure/Entra AD (voir l’étape précédente)
- Commencez à mapper les propriétés des utilisateurs Azure/Entra AD vers les champs « User » dans RESPONSUM
- Vous pouvez ajouter autant de lignes de mapping que nécessaire pour mapper tous les détails
- Vous pouvez sélectionner n’importe quelle propriété personnalisée dans l’AD en choisissant « Set Custom field » dans la colonne AD de gauche
- Vous pouvez créer des champs personnalisés dans RESPONSUM vers lesquels mapper des propriétés en utilisant le bouton « + » dans la colonne des champs RESPONSUM à droite
- Définissez les propriétés initiales
- Si, dans les propriétés initiales, vous indiquez que les utilisateurs ne doivent pas être ajoutés en tant que « Guest users », ils deviendront des « Promoted users ». Dans la section suivante, vous pourrez définir les « Default permissions » à attribuer à tous les utilisateurs ajoutés via cette configuration de synchronisation AD.
- Enregistrez la configuration
- Si vous avez sélectionné une planification, la configuration AD s’exécutera désormais selon l’intervalle défini ; en mode « Manual », cliquez sur « Start a manual sync » pour synchroniser les utilisateurs vers RESPONSUM.
Si vous avez des questions concernant ce guide ou la méthode de travail, veuillez contacter support@responsum.eu pour obtenir de l’aide.