Microsoft Entra ID

L'intégration Microsoft Entra ID (anciennement Azure AD) crée et met à jour automatiquement vos utilisateurs ECARD à partir de votre annuaire Microsoft. Une fois en place, l'arrivée d'un collaborateur dans votre annuaire crée son utilisateur ECARD, et un changement de poste met sa fiche à jour — sans saisie manuelle.

Ce qu'elle permet

Synchroniser les utilisateurs depuis Entra (création automatique des utilisateurs ECARD).
Synchroniser les groupes (optionnel) et n'importer que certains groupes.
Filtrer les utilisateurs par attributs (département, poste, site…).
Mapper les champs Entra vers les champs / attributs personnalisés ECARD, y compris vos attributs d'extension.
Attribuer des groupes / tags automatiquement selon les valeurs Entra.
Synchroniser les photos de profil.
Choisir un mode d'import par champ : à quel point Entra fait autorité sur les cartes existantes (voir Mode d'import, champ par champ).

Mettre en place

Ouvrez Intégrations → Microsoft Entra ID.
Connectez votre annuaire Microsoft (une autorisation administrateur côté Microsoft est requise).
Choisissez les groupes et les filtres à synchroniser (par département, poste ou site).
Configurez le mapping des champs et l'attribution de groupes/tags.
Lancez une première synchronisation complète.

Après cette première synchronisation complète, les mises à jour peuvent se faire en temps réel. L'historique et les erreurs de synchronisation sont consultables directement dans l'intégration.

Exemple

Vous ne voulez synchroniser que le service commercial : sélectionnez le groupe Entra « Sales » et ajoutez un filtre sur le département. Seuls ces utilisateurs sont créés dans ECARD, avec le tag « Commercial » attribué automatiquement.

Mapping des champs

Chaque ligne du mapping relie un attribut Entra (la source) à un champ ECARD ou à un attribut personnalisé (la cible). La liste des sources est organisée en trois familles.

Champs Entra ID — les propriétés standard de l'annuaire : nom, prénom, e-mail, poste, société, téléphones, adresse, service, bureau.
Attributs d'extension on-premises — extensionAttribute1 à extensionAttribute15, hérités de votre Active Directory et remontés par Entra Connect. C'est là que se trouvent le plus souvent le matricule, l'agence ou l'entité juridique.
Extensions d'annuaire — les attributs créés dans votre tenant, de la forme extension_{identifiant d'application}_{nom}. La liste ne s'affiche qu'une fois la détection lancée (voir ci-dessous).

Pour mapper un attribut vers un attribut personnalisé, utilisez le bouton Ajouter un attribut personnalisé en bas du tableau — voir Groupes, tags & entités. Si votre espace n'en contient encore aucun, vous pouvez le créer directement depuis ce tableau : le bouton Créer un premier attribut personnalisé ouvre le formulaire, et la ligne de mapping est renseignée automatiquement une fois l'attribut créé. Sur une ligne existante, l'entrée Créer un attribut personnalisé… en bas de la liste des cibles fait la même chose. Cette fonctionnalité nécessite l'option Attributs personnalisés.

Détecter les attributs d'extension

Les 15 attributs d'extension existent dans tous les annuaires, mais la plupart sont vides. Le bouton Détecter les attributs d'extension analyse jusqu'à 100 utilisateurs de votre tenant et vous indique :

lesquels contiennent réellement des données, avec une valeur d'exemple et le nombre d'utilisateurs concernés ;
les extensions d'annuaire déclarées dans votre tenant.

Les valeurs d'exemple s'affichent ensuite à droite de chaque entrée de la liste déroulante, ce qui évite de mapper un attribut vide. Relancez la détection après avoir créé une nouvelle extension d'annuaire côté Microsoft.

Le bouton se trouve en haut de l'onglet Mapping : une seule détection alimente à la fois le mapping des champs et l'attribution de groupes et de tags décrite ci-dessous. Les extensions détectées sont mémorisées, elles restent donc proposées au rechargement de la page sans relancer l'analyse.

Une capture d'écran du panneau de résultats de la détection aiderait à visualiser cette étape.

Attribuer des groupes et des tags

Toujours dans l'onglet Mapping, la section Mapping groupes & tags permet de choisir un attribut Entra qui alimente les groupes ECARD et un attribut qui alimente les tags. La valeur de l'attribut devient le nom du groupe ou du tag : un utilisateur dont le service vaut « Commercial » rejoint le groupe « Commercial », créé s'il n'existe pas.

Les sources proposées sont exactement les mêmes que pour le mapping des champs — champs standard, attributs d'extension on-premises et extensions d'annuaire détectées — plus deux entrées particulières :

Aucun — désactive l'attribution pour cette cible ;
Groupes Entra — reprend les groupes Entra sélectionnés eux-mêmes, au lieu d'un attribut.

L'attribution suit la valeur dans le temps : si le service d'un utilisateur change côté Entra, il quitte l'ancien groupe et rejoint le nouveau. Les groupes et tags que vous avez attribués manuellement ne sont jamais touchés.

Choisissez un attribut à faible cardinalité (service, agence, entité juridique). Un attribut unique par personne — matricule, e-mail — créerait un groupe par utilisateur.

Un attribut absent de la réponse Entra est traité comme « pas d'information » : le groupe ou le tag déjà attribué est conservé. Seule une valeur explicitement vide côté Entra retire l'attribution.

Relancez une synchronisation complète pour appliquer un nouveau mapping aux membres déjà importés.

Mode d'import, champ par champ

Chaque ligne du mapping porte son propre mode, choisi dans la liste déroulante de la colonne « Mode d'import ». Chaque option rappelle son effet, de sorte que les trois comportements se comparent d'un coup d'œil.

Mode	Sur une carte existante	Champ verrouillé
Toujours écraser	Le champ est repris d'Entra à chaque synchronisation, et vidé si la valeur y disparaît.	Oui
Compléter si vide	Le champ n'est renseigné que tant qu'il est vide dans ECARD. Une valeur saisie n'est jamais écrasée, ni vidée.	Non
Ne pas importer	Le champ n'est pas repris du tout.	Non

Vous pouvez donc laisser Entra faire autorité sur le poste et le service, tout en laissant vos utilisateurs maîtres de leur téléphone mobile.

Une carte nouvellement créée est toujours renseignée pour tout champ importé, quel que soit son mode : sur une carte neuve, « Toujours écraser » et « Compléter si vide » reviennent au même. Le mode ne départage que les synchronisations suivantes.

Une capture d'écran de la liste déroulante Mode d'import ouverte, montrant les trois options et leur description, aiderait à visualiser ce choix.

Champs verrouillés

Un champ en Toujours écraser devient non modifiable dans ECARD : cadenas dans la fiche de l'utilisateur et champ en lecture seule sur le lien de modification, avec la mention « Certains champs sont gérés par Microsoft Entra ID et verrouillés ici. » C'est volontaire : sans ce verrou, une correction saisie à la main serait écrasée à la synchronisation suivante, sans prévenir.

Les champs en Compléter si vide et Ne pas importer ne sont jamais verrouillés — la synchronisation ne touche pas à une valeur déjà renseignée, il n'y a donc rien à protéger. Pour rendre un champ modifiable, il suffit de le passer en « Compléter si vide ».

Connecteurs déjà en place

Si votre connecteur existait avant l'arrivée du mode par champ, il a été repris automatiquement, sans action de votre part : chaque champ importé hérite du mode de réécriture global que vous aviez choisi, et chaque champ décoché devient « Ne pas importer ». Le mode global disparaît de l'onglet Réglages.

Une seule nuance : l'ancien mode global « Désactivé » (les cartes existantes n'étaient jamais mises à jour, mais les nouvelles cartes étaient renseignées) n'a pas d'équivalent exact. Ces champs passent en Compléter si vide, le plus proche : les nouvelles cartes restent renseignées, rien n'est jamais écrasé ni verrouillé, et les champs restés vides sur d'anciennes cartes se remplissent à la prochaine synchronisation.

Dépannage

Les mauvaises personnes remontent (ou aucune). Vérifiez les groupes sélectionnés et les filtres ; relancez une synchronisation complète après toute modification des filtres.
Un champ reste vide. Contrôlez le mapping (un attribut vide côté Entra reste vide côté ECARD), puis le mode d'import de cette ligne : en « Ne pas importer », rien n'est jamais écrit.
Une valeur saisie dans ECARD est écrasée à chaque synchronisation. Ce champ est en Toujours écraser. Passez-le en Compléter si vide si vos utilisateurs doivent pouvoir corriger cette information.
Impossible de modifier un champ (cadenas). Il est en Toujours écraser. Passez-le en Compléter si vide pour le rendre modifiable.
Un attribut d'extension n'apparaît pas dans la liste. Lancez Détecter les attributs d'extension : les extensions d'annuaire ne sont proposées qu'une fois détectées. La même détection alimente le mapping des champs et celui des groupes et tags.
Un groupe ou un tag automatique ne se met pas à jour. Vérifiez que l'attribut source est bien renseigné côté Entra : un attribut absent de la réponse est volontairement traité comme « pas d'information » et ne retire jamais une attribution existante.
Les nouveautés n'apparaissent pas. Consultez l'historique de synchronisation pour repérer une éventuelle erreur.

Plus de détails : Synchronisation & import.

Bon à savoir

Cette configuration nécessite un rôle Administrateur côté ECARD et des droits d'administration côté Microsoft Entra.
Les attributs personnalisés ECARD peuvent recevoir des valeurs Entra via le mapping — voir Groupes, tags & entités.
Pour la définition des termes, voir le Glossaire.

Sur cette page