Entra Connect a créé un utilisateur en double ou ignoré un attribut : correspondance souple, correspondance stricte et valeurs en double
Par Mirko Peters ·
Un nouvel utilisateur local a créé un second compte cloud avec un UPN en onmicrosoft.com, ou l’adresse de messagerie n’a jamais été mise à jour. Découvrez le fonctionnement de la correspondance, comment lire les erreurs et comment relier les comptes en toute sécurité.
Traduit automatiquement par IA à partir de l'article original. Lire l'original en anglais
Deux situations amènent à s’intéresser aux règles de correspondance d’Entra Connect. Dans la première, un nouvel utilisateur local apparaît deux fois dans le cloud : le compte souhaité, ainsi qu’un nouveau compte synchronisé portant un nom d’ouverture de session .onmicrosoft.com. Dans la seconde, la synchronisation s’exécute sans erreur, mais les valeurs mail ou proxyAddresses d’un utilisateur dans Entra ID affichent toujours l’ancienne adresse.
Points clés
- Entra tente d’abord une correspondance stricte sur sourceAnchor avec ImmutableId, puis une correspondance souple sur userPrincipalName ou l’adresse SMTP principale, et crée sinon un nouvel objet.
- Si le suffixe UPN local n’est pas vérifié dans le locataire, Entra construit un nouvel UPN à partir de mailNickName et du domaine initial onmicrosoft.com.
- La résilience aux attributs en double met en quarantaine une valeur conflictuelle de proxyAddresses ou d’UPN au lieu d’échouer. La synchronisation peut donc paraître saine alors qu’une valeur manque.
- Depuis le 1er juillet 2026, Learn indique que la correspondance stricte peut être bloquée pour les comptes cloud dont onPremisesObjectIdentifier est déjà défini, ou qui détiennent un rôle privilégié ou sont éligibles à un tel rôle.
Ces deux cas ont été évoqués dans des fils de discussion Microsoft Q&A, l’un de janvier 2025 et l’autre d’octobre 2025. Dans chacun, la personne ayant posé la question a indiqué ce qui a résolu le problème. J’ai vérifié les bases techniques par rapport aux pages Microsoft Learn actuelles. Il s’agit d’un guide de dépannage, et non d’une procédure officielle de Microsoft. Testez chaque modification sur un seul utilisateur d’abord.
Comment Entra fait correspondre les objets
Learn décrit cet ordre pour un nouvel objet provenant d’AD :
- Correspondance stricte. Entra compare le
sourceAnchoravec l’ImmutableIddes objets cloud existants. LesourceAnchorpar défaut est la forme Base64 demS-Ds-ConsistencyGUID, ou deObjectGUID, selon la configuration. - Correspondance souple. En l’absence de correspondance stricte, Entra compare le
userPrincipalNameou la valeurSMTP:principale deproxyAddresses. - Nouvel objet. Si aucune correspondance n’est trouvée, Entra crée un nouvel objet.
Learn ajoute deux limites. La correspondance souple n’est évaluée que pour les nouveaux objets. Et lors d’une correspondance souple, Entra prend le contrôle de l’objet cloud et écrase chaque attribut ayant une valeur en local. Les attributs propres au cloud peuvent être perdus et, avec la synchronisation des hachages de mots de passe, le hachage du mot de passe cloud est remplacé par celui du système local.
Scénario 1 : un second utilisateur avec un UPN en onmicrosoft.com
Ce que rapporte le fil de discussion. Un administrateur a créé un utilisateur dans AD local. Entra Connect a créé un second utilisateur Entra avec un UPN en .onmicrosoft.com et l’indicateur de synchronisation locale. L’utilisateur cloud visé ne portait pas cet indicateur. La réponse retenue décrivait à la fois la correspondance souple et la correspondance stricte. La personne ayant posé la question a indiqué par la suite que l’approche par correspondance stricte avait résolu le problème.
Pourquoi la correspondance a pu échouer
Le fil de discussion ne disait pas pourquoi. Learn documente une seule raison au nom onmicrosoft.com : si le suffixe UPN local n’est pas vérifié dans le locataire, Entra calcule un nouvel UPN à partir de MailNickName et du domaine initial. Cela signifie aussi que l’UPN ne peut pas correspondre à l’utilisateur cloud. Il s’agit d’une piste, pas d’un diagnostic. Comparez les éléments suivants sur les deux comptes :
- suffixe UPN et indication de savoir s’il s’agit d’un domaine vérifié dans votre locataire
- adresse SMTP principale (l’entrée
SMTP:dansproxyAddresses) - indication de savoir si l’utilisateur cloud présente déjà un lien avec l’annuaire local
Option A : faire fonctionner la correspondance souple
La première solution de contournement du fil consistait à aligner l’UPN local et les adresses proxy sur l’utilisateur cloud, à supprimer le doublon, puis à resynchroniser. Learn indique que la correspondance souple n’est évaluée que pour les nouveaux objets, et ne précise pas si un objet déjà lié est réévalué après la suppression du doublon. La personne qui posait la question a finalement utilisé l’option B : considérez donc l’option A comme non éprouvée.
Option B : correspondance forte
- Déterminez l’attribut que votre Entra Connect utilise comme
sourceAnchor. Learn citemS-Ds-ConsistencyGUIDouObjectGUID. - Convertissez le GUID local en Base64. La réponse du fil utilisait ce modèle :
``powershell $guid = (Get-ADUser <sam-account-name>).ObjectGuid [System.Convert]::ToBase64String($guid.ToByteArray()) ``
- Affectez le résultat comme
ImmutableIdde l’utilisateur cloud. La réponse du fil utilisaitSet-MsolUser, issu de l’ancien module MSOnline. Les pages actuelles de Learn utilisent Microsoft Graph PowerShell. La pageUpdate-MgUserdocumente le paramètre-OnPremisesImmutableIdet indique que seuls certains rôles d’administrateur privilégiés peuvent le modifier. Vérifiez les remarques relatives à ce paramètre sur cette page avant de l’exécuter. - Lancez une synchronisation delta :
``powershell Start-ADSyncSyncCycle -PolicyType Delta ``
- Vérifiez que l’utilisateur cloud visé affiche désormais l’indicateur de synchronisation, puis traitez le doublon restant.
Learn ne décrit pas l’ordre de nettoyage pour ce cas précis. La réponse du fil a d’abord défini l’ImmutableId, synchronisé et vérifié, puis supprimé le doublon. Avant de supprimer quoi que ce soit, vérifiez les licences et les données de boîte aux lettres du doublon.
Learn documente une erreur apparentée, InvalidSoftMatch. Elle survient lorsque la correspondance forte ne trouve rien, que la correspondance souple trouve un objet cloud, mais que cet objet possède un ImmutableId différent du sourceAnchor entrant. Cela suggère que l’objet cloud a été synchronisé à partir d’un autre objet local. La solution de Learn est la même que pour AttributeValueMustBeUnique : identifier la valeur dupliquée et les objets concernés, décider lequel conserve cette valeur, puis supprimer la valeur de l’autre objet dans l’annuaire source.
Nouvelles protections depuis juillet 2026
Learn indique qu’à partir du 1er juillet 2026, une correspondance forte peut être bloquée lorsque le compte cloud cible :
- possède déjà
onPremisesObjectIdentifierdéfini, - dispose d’un rôle privilégié Microsoft Entra attribué, ou
- est éligible à un rôle privilégié Microsoft Entra.
Les comptes gérés dans le cloud dont l’écriture différée est activée sont exclus. Learn précise que ces protections ne désactivent pas la correspondance forte pour les cibles sûres. La documentation décrit aussi les indicateurs à l’échelle du locataire, BlockSoftMatchEnabled et BlockCloudObjectTakeoverThroughHardMatchEnabled, ainsi qu’un contournement temporaire, AllowOnPremUpdateOfOnPremisesObjectIdentifierEnabled, désactivé par défaut. Learn avertit que ce contournement réduit la protection et doit être désactivé ensuite. Par défaut, Entra n’effectue pas non plus de correspondance souple entre les utilisateurs locaux et les utilisateurs cloud qui détiennent un rôle d’administrateur, et Microsoft déconseille fortement de synchroniser des comptes locaux avec des comptes d’administration préexistants.
Si la correspondance forte du fil de 2025 échoue aujourd’hui, l’une de ces protections peut en être la raison.
Scénario 2 : la synchronisation ne signale rien, mais l’adresse ne change jamais
Ce que signalait le fil. Des prestataires avaient besoin de leurs propres adresses e-mail externes au lieu de l’adresse de l’entreprise. Les comptes locaux affichaient les bonnes adresses dans ADUC, mais mail et proxyAddresses dans Entra contenaient toujours l’adresse de l’entreprise. Le demandeur a trouvé seul la cause : des comptes invités cloud uniquement, créés pour l’accès à SharePoint, utilisaient les mêmes adresses externes que les nouveaux comptes locaux. Le demandeur a écrit que c’était là le conflit.
Notez que la réponse acceptée dans ce fil était générique, et que le diagnostic venait de la personne qui posait la question.
Ce que Learn ajoute
- Entra ID exige des valeurs uniques pour
mail,proxyAddresses,signInNameetuserPrincipalName. Ajouter ou mettre à jour une valeur déjà détenue par un autre objet provoqueAttributeValueMustBeUnique. - La résilience aux attributs en double est le comportement par défaut et ne peut pas être désactivée. Elle ne gère que les valeurs UPN et les
proxyAddressesSMTP : Entra met en quarantaine une valeur en double au lieu de faire échouer l’exportation. Elle ne corrige pas les données, et la page de Learn ne mentionne pasmailparmi les attributs couverts. - Pour un UPN en double, un espace réservé est attribué, sous la forme
<OriginalPrefix>+<4DigitNumber>@<InitialTenantDomain>.onmicrosoft.com. Une adresse proxy SMTP mise en quarantaine est retenue pendant que l’objet continue d’être créé ou mis à jour. - L’exportation réussissant, le client de synchronisation n’enregistre aucune erreur et ne réessaie pas.
Cela correspond à ce que décrivait le fil de discussion : aucune défaillance visible, une valeur manquante. La réponse retenue ne mentionnait la résilience aux attributs en double que de manière générale, et personne n’a confirmé qu’elle s’appliquait. C’est donc une explication plausible, mais non confirmée.
Comment trouver les conflits
- Dans le centre d’administration Microsoft Entra, ouvrez le rapport Erreurs de synchronisation dans Microsoft Entra Connect Health. Learn indique qu’il est actualisé environ toutes les 30 minutes et qu’il affiche les erreurs de la dernière tentative de synchronisation.
- Pour les valeurs en quarantaine, Learn affiche :
``powershell Connect-Entra Get-EntraDirectoryObjectOnPremisesProvisioningError | Where-Object PropertyCausingError -eq 'ProxyAddresses' ``
- La solution proposée par Learn est la même pour
AttributeValueMustBeUniqueetInvalidSoftMatch: identifiez la valeur dupliquée et les objets concernés, décidez quel objet la conserve, supprimez-la de l’autre objet dans l’annuaire où cet objet est source, puis laissez Entra Connect synchroniser. Dans certains cas, il peut être nécessaire de supprimer l’un des objets en conflit. - Une tâche en arrière-plan supprime les attributs en quarantaine une fois le conflit résolu. Learn indique qu’elle s’exécute toutes les heures.
Dans le cas d’un invité, il faut donc modifier ou supprimer l’adresse sur l’invité créé uniquement dans le cloud, puis attendre la synchronisation suivante.
Vérification
- Recherchez l’utilisateur dans Entra ID et comparez
mail,proxyAddresseset l’UPN avec AD. - Exécutez
Start-ADSyncSyncCycle -PolicyType Delta, puis vérifiez à nouveau. - Vérifiez que le rapport d’erreurs ne répertorie plus l’objet.
Pour les modifications en masse, l’article de Learn sur le serveur de préproduction (staging) décrit une méthode permettant de prévisualiser les exportations en attente avec csexport et CSExportAnalyzer avant de passer en mode actif.
Limites
- Les fils de discussion ne permettent pas de savoir quelle étape a résolu votre cas.
- Les commandes de correspondance forcée (hard match) du fil utilisent un module plus ancien. Suivez les recommandations actuelles de Learn.
- Learn ne documente pas l’ordre de nettoyage après la création erronée d’un doublon. Testez sur un seul utilisateur.
Liens connexes
Sources
- Microsoft Learn : Soft match vs hard match, Entra Connect pour un locataire existant
- Microsoft Learn : Résolution des erreurs pendant la synchronisation
- Microsoft Learn : Synchronisation des identités et résilience aux attributs en double
- Microsoft Learn : Planifier UserPrincipalName et l’identifiant de connexion alternatif
- Microsoft Learn : Serveur de préproduction (staging)
- Microsoft Learn : Update-MgUser
- Microsoft Q&A : Entra Connect Sync a créé un second utilisateur avec un domaine onmicrosoft.com (octobre 2025)
- Microsoft Q&A : synchronisation AD Connect, mail et proxyAddresses non mis à jour (janvier 2025)