Synchroniser les personnes depuis Microsoft Entra ID

Connectez Microsoft Entra ID comme source de personnes et Polzy lit les utilisateurs de votre annuaire via Microsoft Graph, selon un calendrier. Les nouveaux utilisateurs deviennent membres de cet espace de travail avec leur intitulé de poste, leur service, leur site et leur manager ; les changements suivent à la synchronisation suivante ; et les comptes que vous désactivez ou supprimez ne reçoivent plus d’enquêtes.

Synchronisation, SCIM ou authentification unique ?

Polzy se connecte à Microsoft Entra ID de trois façons, pour trois usages différents :

• Synchronisation d’annuaire (cet article). Polzy lit les utilisateurs d’Entra ID dans un espace de travail selon un calendrier, avec les attributs selon lesquels vous regroupez les résultats — service, site, intitulé de poste, manager. À partir de Team, configurée par un administrateur de l’espace de travail.
• Provisionnement SCIM. Entra ID envoie les membres à votre organisation dès qu’ils changent, et les place dans des espaces de travail selon leurs groupes. Enterprise, configuré par le propriétaire — voir SCIM.
• Authentification unique. Les personnes se connectent à Polzy avec leur compte Microsoft au lieu d’un mot de passe. Elle décide comment on se connecte, pas qui fait partie d’un espace de travail. Enterprise, configurée par le propriétaire — voir Authentification unique.

L’authentification unique fonctionne avec l’une ou l’autre des deux premières. La synchronisation d’annuaire et SCIM ne peuvent pas coexister dans la même organisation : tant qu’elle a un jeton SCIM, aucun espace de travail ne peut connecter une source de personnes.

Avant de commencer

Il vous faut :

• Être administrateur de l’espace de travail Polzy, sur Team ou plus, avec Synchronisation des personnes activé sous Paramètres → Général → Ce que fait cet espace de travail.
• Dans Microsoft Entra ID, un rôle qui permet d’inscrire des applications, et quelqu’un qui peut accorder le consentement administrateur, comme un Cloud Application Administrator.
• Les champs selon lesquels vous voulez regrouper les résultats déjà ajoutés dans Polzy, comme Service ou Site.

Un espace de travail se synchronise depuis une seule source à la fois. Si une autre source est connectée, déconnectez-la d’abord.

Inscrire une application dans Microsoft Entra ID

1. Dans le centre d’administration Microsoft Entra, allez dans Entra ID → App registrations et choisissez New registration.
2. Nommez-la Polzy, choisissez Single tenant only sous Supported account types, puis choisissez Register. Aucune adresse de redirection n’est nécessaire.
3. Sur la page Overview de l’application, copiez l’Application (client) ID et le Directory (tenant) ID.
4. Ouvrez API permissions, choisissez Add a permission → Microsoft Graph → Application permissions, sélectionnez User.Read.All et choisissez Add permissions.
5. Choisissez Grant admin consent for votre organisation, et confirmez. Le statut de l’autorisation passe à accordé.
6. Ouvrez Certificates & secrets → Client secrets → New client secret. Donnez-lui une description et une expiration, puis choisissez Add.
7. Copiez tout de suite la Value du secret — pas son Secret ID. Microsoft ne l’affiche plus jamais.

Un secret dure deux ans au maximum. Notez un rappel dans votre agenda quelques semaines avant son expiration : quand il expire, la synchronisation s’arrête jusqu’à ce que vous colliez un nouveau secret. Voir Microsoft : Register an application, Microsoft : Add an application permission and grant admin consent et Microsoft : Add a client secret.

Connecter Entra ID dans Polzy

1. Ouvrez Contacts → Synchro et champs.
2. Sous Sources disponibles, trouvez Microsoft Entra ID et choisissez Connecter. Un panneau s’ouvre avec trois étapes : Connexion, Paramètres de synchro et Correspondance des champs.
3. Collez le Tenant ID (l’ID de l’annuaire), l’Application (Client) ID et la valeur du Client Secret.
4. Choisissez Tester la connexion. Un message qui commence par Successfully connected to Entra ID signifie que Polzy a pu lire votre annuaire.
5. Choisissez Suivant, vérifiez les paramètres de synchronisation (voir plus bas), puis choisissez de nouveau Suivant.
6. À l’étape Correspondance des champs, gardez la correspondance par défaut ou activez Correspondance personnalisée des champs (voir plus bas), puis choisissez Connecter.

Synchro des personnes

Connecter Microsoft Entra ID

Les clés sont chiffrées et utilisées uniquement en votre nom.

3 sur 3 obligatoires

ConnexionParamètres de synchroCorrespondance des champs

Tenant IDRequis

Application (Client) IDRequis

Client SecretRequis

Chiffré au reposAnnulerTester la connexionSuivant

Le secret est stocké chiffré et ne sert qu’à lire votre annuaire. Polzy le vérifie de nouveau quand vous choisissez Connecter : si Microsoft le refuse, rien n’est enregistré.

Paramètres de synchronisation

Un filtre que vous écrivez remplace celui qui exclut les invités. Pour continuer à les exclure, ajoutez-le vous-même : userType eq 'Member' and department eq 'Sales'. Polzy transmet le filtre tel quel : utilisez les filtres simples que Microsoft Graph accepte sur les utilisateurs sans requêtes avancées, comme eq, in et startswith. Voir Microsoft : Use the $filter query parameter.

Associer les champs

La correspondance par défaut remplit :

Si vos collaborateurs se connectent avec un nom qui n’est pas leur adresse e-mail, activez Correspondance personnalisée des champs et associez plutôt E-mail à mail. Chaque ligne a aussi une valeur Si vide, utiliser, écrite quand Entra ID n’a rien pour cette personne — une valeur qu’il envoie n’est jamais écrasée. Polzy lit ces attributs de chaque utilisateur : userPrincipalName, mail, givenName, surname, displayName, jobTitle, department, officeLocation, mobilePhone, employeeId, accountEnabled et le manager.

Synchro des personnes

Connecter Microsoft Entra ID

Les clés sont chiffrées et utilisées uniquement en votre nom.

ConnexionParamètres de synchroCorrespondance des champs

Correspondance personnalisée des champs

Correspondance personnalisée active Choisissez quel champ de votre système RH alimente chaque champ de participant.

Champs de base

Champ du participantDepuis la sourceSi vide, utiliser

EmailRequis

Exemple: anouk@acme.com, rahul@acme.com

PrénomRequis

Exemple: Anouk, Rahul

Nom de familleRequis

Exemple: Jansen, Mehta

Champs de l'espace de travail

Champ du participantDepuis la sourceSi vide, utiliser

Service

Exemple: Ventes, Opérations

Chiffré au reposRetourConnecter

Quelques points à connaître :

• Seuls les champs de votre espace de travail sont remplis. Le service ou le site ne sont conservés que si votre espace de travail a un champ de ce nom. Ajoutez-en un avec Ajouter un champ sur Synchro et champs, puis associez-le.
• Groupes. Pour comparer les résultats selon un champ, faites-en un champ Liste et activez Groupes à côté de lui dans le tableau Correspondance des champs. Les valeurs d’Entra ID sont rapprochées des options du champ.
• De vrais exemples. Une fois connecté, choisissez Paramètres sur Synchro et champs et rouvrez Correspondance des champs : la liste vient alors de cinq vrais utilisateurs, chacun avec un Exemple.
• Managers. Le manager est lié quand il est lui aussi dans Polzy. S’il n’y est pas encore, le lien se fait lors d’une synchronisation ultérieure. Les managers demandent que Lignes hiérarchiques soit activé dans l’espace de travail.

Prévisualiser et lancer la première synchronisation

1. Sur Synchro et champs, choisissez Prévisualiser une synchro sous Historique de synchro. Polzy calcule ce qu’une synchronisation ajouterait, mettrait à jour et désactiverait, sans rien changer, et ouvre le journal où le résultat apparaît comme Aperçu.
2. Vérifiez l’aperçu. Si les mauvaises personnes arriveraient, ajustez la Requête de filtrage sous Paramètres et prévisualisez de nouveau.
3. Choisissez Synchroniser maintenant. Le résultat apparaît dans Historique de synchro.

Synchro et champs

Microsoft Entra IDConnectéDernière synchro il y a 5 minutes · s’exécute toutes les heures · 431 personnes · 16 groupesParamètresSynchroniser maintenant

Historique de synchroPrévisualiser une synchro

Aujourd’hui, 09:12Réussi2 ajoutés · 5 mis à jour

Aujourd’hui, 08:10Partiel1 mis à jour · 3 ignorés

Hier, 16:40Aperçu431 ajoutés

Les personnes sont rapprochées par leur ID d’objet Entra ID, puis par adresse e-mail : une personne que vous aviez déjà invitée à la main est mise à jour au lieu d’être ajoutée une seconde fois.

Calendrier et historique de synchronisation

Après la première synchronisation, Polzy tourne tout seul, à la fréquence choisie, à quelques minutes près. Quand Microsoft demande à Polzy de ralentir, il attend le temps indiqué puis continue. Historique de synchro liste les cinq dernières exécutions — Réussi, Partiel (certaines personnes ont été ignorées ou ont échoué), Échec ou Aperçu — et Journal complet ouvre chaque exécution, avec chaque modification qu’elle a faite.

Si une synchronisation échoue, Polzy réessaie plus tard, en attendant un peu plus à chaque fois. Après trois échecs d’affilée, ou immédiatement quand Microsoft refuse les identifiants — un secret expiré, ou un consentement retiré —, la source affiche Nécessite une action et les administrateurs sont prévenus. Synchroniser maintenant fonctionne de nouveau une fois la source reconnectée : collez un nouveau secret sous Paramètres et enregistrez.

Quand quelqu’un part

• Compte désactivé. Un utilisateur dont le compte est désactivé dans Entra ID est désactivé à la synchronisation suivante. Les personnes désactivées ne reçoivent aucune enquête et n’occupent aucune place ; leurs réponses passées restent.
• Supprimé, ou hors du filtre. Avec Désactiver les utilisateurs supprimés activé, une personne qui n’apparaît plus dans ce que lit Polzy — supprimée, ou qui ne correspond plus à votre filtre — est elle aussi désactivée.
• Bloqué dans Polzy. Une personne qu’un administrateur a bloquée dans Polzy reste bloquée, quoi que dise Entra ID.

Une synchronisation ne supprime jamais personne.

Dépannage

Bon à savoir

• Des membres, pas des contacts. Toutes les personnes venues d’Entra ID sont des membres : elles peuvent se connecter et chacune occupe une place. Une synchronisation qui dépasserait vos places importe les personnes qui tiennent, s’arrête là et prévient les administrateurs — voir Utilisation et limites.
• Pas de mise à jour instantanée. Les changements arrivent à la prochaine synchronisation planifiée, ou quand vous choisissez Synchroniser maintenant. Pour des changements dès qu’ils se produisent, utilisez SCIM.
• Déconnecter ou supprimer. Sous Paramètres, Déconnecter arrête la synchronisation et garde les paramètres et l’historique, pour reconnecter plus tard ; Supprimer efface la connexion. Dans les deux cas, les personnes déjà synchronisées restent dans Polzy et ne sont plus mises à jour.
• Besoin d’aide ? Le lien Demander à Polzy du panneau de connexion explique où trouver chaque valeur dans le centre d’administration Microsoft Entra.

Liens utiles

• Microsoft : Register an application — l’inscription de l’application, et où trouver ses ID.
• Microsoft : Add an application permission and grant admin consent — User.Read.All et le bouton de consentement.
• Microsoft : Add a client secret — créer le secret et copier sa valeur.
• Microsoft : Find your tenant ID — si vous avez de nouveau besoin de l’ID de locataire.
• Microsoft : Use the $filter query parameter — écrire une requête de filtrage.