ECARD Help Center
IntégrationsMicrosoft Entra ID

Paramètres

Dans l'onglet Paramètres, deux options contrôlent la synchronisation des comptes :

OptionDescriptionDéfaut
Réécriture des donnéesActive la mise à jour automatique de tous les champs utilisateur depuis Microsoft 365. Les champs se synchronisent automatiquement lors de modifications dans Entra ID ou lors d'une synchronisation manuelleActif
Nouveaux utilisateurs actifs par défautDéfinit si un nouvel utilisateur importé depuis Entra ID est créé automatiquement dans ECARD s'il n'existe pasActif

Filtres

L'onglet Filtres permet de limiter l'import aux membres de certains groupes Office 365 :

  • Groupes : l'administrateur sélectionne les groupes dont les membres doivent être importés. Seuls les utilisateurs appartenant à ces groupes seront ajoutés dans ECARD.

Il est recommandé de créer un groupe spécifique à ECARD dans votre annuaire Entra ID pour assurer que la synchronisation importe uniquement les bons utilisateurs.

Mapping des champs

L'onglet Mapping autorise l'association de chaque champ Microsoft 365 avec un champ ECARD, permettant d'adapter la synchronisation aux attributs spécifiques de votre organisation.

Le mapping est organisé en deux sections :

Segmentation

Ces champs permettent de structurer automatiquement l'arborescence de votre organisation dans ECARD.

Champ ECARDChamp Microsoft 365 par défautDescription
EntreprisecompanyNameRattache l'utilisateur à une entité (terme de taxonomie). Si l'entité n'existe pas, elle est créée automatiquement.
DossierdepartmentRattache l'utilisateur à un groupe/dossier au sein de l'entité. Si le dossier n'existe pas, il est créé automatiquement.

Attributs des utilisateurs

Ces champs définissent les données de profil synchronisées pour chaque utilisateur.

Champ ECARDChamp M365 par défautObligatoireDescription
Email principaluserPrincipalNameOuiIdentifiant unique de l'utilisateur dans ECARD. Sert de clé de correspondance lors de la synchronisation.
PrénomgivenNameOuiPrénom de l'utilisateur.
NomsurnameOuiNom de famille de l'utilisateur.
FonctionjobTitleNonIntitulé de poste.
EntreprisecompanyNameNonNom de l'entreprise (champ texte du profil, distinct de la segmentation).
Autres emailsotherMailsNonAdresses email secondaires (champ répéteur).
Téléphone 1mobilePhoneNonPremier numéro de téléphone. Le libellé (portable/bureau) est déterminé automatiquement selon la source choisie.
Téléphone 2businessPhonesNonDeuxième numéro de téléphone.
RuestreetAddressNonAdresse postale (rue).
VillecityNonVille.
Code PostalpostalCodeNonCode postal.
PayscountryNonPays.
État/RégionstateNonÉtat ou région.

Champs personnalisés via les Extension Attributes

Chaque champ ECARD peut également être associé à l'un des 15 attributs d'extension Active Directory (onPremisesExtensionAttributes.extensionAttribute1 à extensionAttribute15). Ces attributs sont des champs personnalisés configurés dans votre Active Directory on-premises et synchronisés vers Entra ID. Ils permettent de mapper des données métier spécifiques à votre organisation (matricule, centre de coût, code site, etc.).

Fonctionnement

  • La liste déroulante de chaque ligne affiche les champs Microsoft 365 disponibles, accompagnés d'une valeur d'exemple issue du premier utilisateur de votre annuaire (ex : givenName (Jean)).
  • Les champs obligatoires (marqués "Oui") doivent impérativement être mappés pour que la synchronisation fonctionne.
  • Les champs non obligatoires peuvent être laissés sur "-- Sélectionner --" pour ne pas être synchronisés.
  • Les modifications de mapping sont enregistrées en cliquant sur le bouton Appliquer en haut de page.
  • Si la connexion à l'API Microsoft 365 échoue lors du chargement de l'onglet, un message d'avertissement s'affiche et les sélecteurs restent désactivés avec les valeurs actuellement configurées.

Exemples de mapping

  • Segmentation / Entreprise ECARD -- companyName (crée automatiquement des entités et organise les utilisateurs)
  • Dossier (organisation interne) -- Sous-objet d'une entreprise pour segmenter les utilisateurs
  • Email principal -- userPrincipalName ou Mail
  • Fonction -- jobTitle
  • Nom -- surname
  • Entreprise -- companyName
  • Téléphone 1 -- mobilePhone
  • Téléphone 2 -- businessPhones
  • Adresse -- streetAddress, city, postalCode, country, state

Chaque menu déroulant présente tous les attributs disponibles via Microsoft Graph (id, displayName, givenName, mail, etc.).

Comportement important

Un champ non relié (valeur : "Aucun") ne modifiera pas les données ECARD existantes. En revanche, un champ relié mais vide dans Entra ID supprimera le contenu correspondant dans ECARD.

Exemple :

  • Si Fonction n'est pas reliée et qu'un utilisateur possède déjà une fonction dans ECARD, cette information n'est pas modifiée lors des synchronisations.
  • Si Fonction est reliée à jobTitle mais vide dans Entra ID, la synchronisation effacera la fonction existante dans ECARD.