Entra Connect creó un usuario duplicado u omitió un atributo: coincidencia flexible, coincidencia exacta y valores duplicados
Por Mirko Peters ·
Un nuevo usuario local creó una segunda cuenta en la nube con un UPN onmicrosoft.com, o la dirección de correo nunca se actualizó. Aprende cómo funciona la coincidencia, cómo interpretar los errores y cómo volver a vincular las cuentas de forma segura.
Traducido automáticamente con IA a partir de la publicación original. Lee el original en inglés
Hay dos situaciones que llevan a la gente a revisar las reglas de coincidencia de Entra Connect. En la primera, un nuevo usuario local aparece dos veces en la nube: la cuenta que querías, más una cuenta nueva sincronizada con un nombre de inicio de sesión .onmicrosoft.com. En la segunda, la sincronización se ejecuta sin errores, pero el mail o los proxyAddresses de un usuario en Entra ID siguen mostrando la dirección antigua.
Puntos clave
- Entra intenta primero una coincidencia exacta de sourceAnchor con ImmutableId, después una coincidencia flexible por userPrincipalName o por la dirección SMTP principal, y si no encuentra nada, crea un objeto nuevo.
- Si el sufijo UPN local no está verificado en el inquilino, Entra construye un UPN nuevo a partir de mailNickName y del dominio inicial onmicrosoft.com.
- La resistencia a valores duplicados pone en cuarentena un valor conflictivo de proxyAddresses o de UPN en lugar de fallar, por lo que la sincronización puede parecer correcta mientras falta un valor.
- Desde el 1 de julio de 2026, Learn indica que la coincidencia exacta puede bloquearse para cuentas en la nube que ya tengan onPremisesObjectIdentifier establecido, o que tengan o puedan tener un rol con privilegios.
Ambos casos aparecieron en hilos de Microsoft Q&A, uno de enero de 2025 y otro de octubre de 2025. En cada uno, quien preguntó indicó qué lo solucionó. He contrastado los fundamentos técnicos con las páginas actuales de Microsoft Learn. Esto es una guía de solución de problemas, no un procedimiento oficial de Microsoft. Prueba cualquier cambio primero con un solo usuario.
Cómo hace Entra la coincidencia de objetos
Learn describe este orden para un objeto nuevo que llega desde AD:
- Coincidencia exacta. Entra compara el
sourceAnchorcon elImmutableIdde los objetos existentes en la nube. ElsourceAnchorpredeterminado es la forma Base64 demS-Ds-ConsistencyGUIDo deObjectGUID, según la configuración. - Coincidencia flexible. Si no hay coincidencia exacta, Entra compara el
userPrincipalNameo el valorSMTP:principal deproxyAddresses. - Objeto nuevo. Si ninguno coincide, Entra crea un objeto nuevo.
Learn añade dos limitaciones. La coincidencia flexible solo se evalúa para objetos nuevos. Y en una coincidencia flexible, Entra toma el control del objeto en la nube y sobrescribe todos los atributos que tengan valor en local. Los atributos existentes solo en la nube pueden perderse y, con la sincronización de hash de contraseña, el hash de contraseña en la nube se reemplaza por el local.
Escenario 1: un segundo usuario con un UPN onmicrosoft.com
Lo que reportó el hilo. Un administrador creó un usuario en AD local. Entra Connect creó un segundo usuario de Entra con un UPN .onmicrosoft.com y la marca de sincronización local. El usuario de la nube previsto no tenía la marca de sincronización. La respuesta aceptada describió tanto la coincidencia flexible como la exacta. Quien preguntó escribió después que el enfoque de coincidencia exacta resolvió el problema.
Por qué pudo fallar la coincidencia
El hilo no explicaba el motivo. Learn documenta una razón concreta para el nombre onmicrosoft.com: si el sufijo UPN local no está verificado en el inquilino, Entra calcula un nuevo UPN a partir de MailNickName y del dominio inicial. Eso también significa que el UPN no puede coincidir con el usuario en la nube. Esto es una pista, no un diagnóstico. Compara estos datos en ambas cuentas:
- Sufijo UPN y si es un dominio verificado en tu inquilino
- Dirección SMTP principal (la entrada
SMTP:enproxyAddresses) - Si el usuario en la nube ya muestra un vínculo con el entorno local
Opción A: hacer que funcione la coincidencia suave
La primera solución del hilo consistía en hacer que el UPN local y las direcciones proxy coincidieran con el usuario en la nube, eliminar el duplicado y sincronizar de nuevo. Learn indica que la coincidencia suave solo se evalúa para objetos nuevos, y no cubre si un objeto que ya está vinculado vuelve a evaluarse después de eliminar el duplicado. La persona que hizo la pregunta acabó usando la Opción B, así que trata la Opción A como no probada.
Opción B: coincidencia física
- Averigua qué atributo usa tu Entra Connect como
sourceAnchor. Learn mencionamS-Ds-ConsistencyGUIDoObjectGUID. - Convierte el GUID local a Base64. La respuesta del hilo usaba este patrón:
``powershell $guid = (Get-ADUser <sam-account-name>).ObjectGuid [System.Convert]::ToBase64String($guid.ToByteArray()) ``
- Asigna el resultado como
ImmutableIddel usuario en la nube. La respuesta del hilo usabaSet-MsolUser, que pertenece al módulo MSOnline, más antiguo. Las páginas actuales de Learn usan Microsoft Graph PowerShell. La página deUpdate-MgUserdocumenta el parámetro-OnPremisesImmutableIde indica que solo ciertos roles de administrador con privilegios pueden actualizarlo. Revisa las notas del parámetro en esa página antes de ejecutarlo. - Ejecuta una sincronización delta:
``powershell Start-ADSyncSyncCycle -PolicyType Delta ``
- Confirma que el usuario de la nube previsto ya muestra la marca de sincronización y, después, ocúpate del duplicado que quede.
Learn no describe el orden de limpieza para este caso concreto. La respuesta del hilo primero asignó el ImmutableId, sincronizó, comprobó y eliminó el duplicado después. Antes de borrar nada, revisa las licencias y los datos del buzón del duplicado.
Learn documenta un error relacionado, InvalidSoftMatch. Se produce cuando la coincidencia física no encuentra nada, la coincidencia suave encuentra un objeto en la nube, pero ese objeto tiene un ImmutableId distinto del sourceAnchor entrante. Esto sugiere que el objeto en la nube se sincronizó desde otro objeto local. La solución de Learn es la misma que para AttributeValueMustBeUnique: identifica el valor duplicado y los objetos implicados, decide qué objeto lo conserva y elimina el valor del otro objeto en el directorio donde se origina.
Nuevas protecciones desde julio de 2026
Learn indica que, a partir del 1 de julio de 2026, una coincidencia física puede bloquearse cuando la cuenta de destino en la nube:
- ya tiene
onPremisesObjectIdentifierestablecido, - tiene asignado un rol privilegiado de Microsoft Entra, o
- es apta para un rol privilegiado de Microsoft Entra.
Las cuentas administradas en la nube con escritura diferida habilitada quedan excluidas. Learn indica que estas protecciones no desactivan la coincidencia física para destinos seguros. También describe las marcas de todo el inquilino, BlockSoftMatchEnabled y BlockCloudObjectTakeoverThroughHardMatchEnabled, y una excepción temporal, AllowOnPremUpdateOfOnPremisesObjectIdentifierEnabled, que está desactivada de forma predeterminada. Learn advierte de que la excepción reduce la protección y debe desactivarse después. De forma predeterminada, Entra tampoco realiza coincidencias suaves entre usuarios locales y usuarios en la nube que tengan un rol de administrador, y Microsoft recomienda encarecidamente no sincronizar cuentas locales con cuentas de administrador preexistentes.
Así que, si la coincidencia física del hilo de 2025 falla hoy, una de estas protecciones puede ser el motivo.
Escenario 2: la sincronización no da errores, pero la dirección nunca cambia
Lo que informó el hilo. Los contratistas necesitaban sus propias direcciones de correo externas en lugar de la dirección de la empresa. Los usuarios locales mostraban las direcciones correctas en ADUC, pero mail y proxyAddresses en Entra seguían conteniendo la dirección de la empresa. Quien preguntó encontró la causa por su cuenta: las cuentas de invitado solo en la nube, creadas para el acceso a SharePoint, usaban las mismas direcciones externas que las nuevas cuentas locales. La persona escribió que esto era el conflicto.
Ten en cuenta que la respuesta aceptada en ese hilo era genérica, y el diagnóstico lo aportó quien hizo la pregunta.
Lo que añade Learn
- Entra ID necesita valores únicos para
mail,proxyAddresses,signInNameyuserPrincipalName. Añadir o actualizar un valor que ya tiene otro objeto provocaAttributeValueMustBeUnique. - La resistencia a atributos duplicados es el comportamiento predeterminado y no se puede desactivar. Solo gestiona los valores de UPN y de
proxyAddressesSMTP: Entra pone en cuarentena el valor duplicado en lugar de hacer fallar la exportación. No corrige los datos, y la página de Learn no incluyemailentre los atributos que cubre. - En el caso de un UPN duplicado se asigna un marcador de posición con este formato:
<OriginalPrefix>+<4DigitNumber>@<InitialTenantDomain>.onmicrosoft.com. Una dirección proxy SMTP en cuarentena se retiene mientras el objeto sigue creándose o actualizándose. - Como la exportación se completa correctamente, el cliente de sincronización no registra ningún error y no vuelve a intentarlo.
Esto coincide con lo que describía el hilo: ningún fallo visible y un valor que falta. La respuesta aceptada mencionaba la resistencia a atributos duplicados solo en términos generales, y nadie confirmó que se aplicara. Es una explicación plausible, pero no confirmada.
Cómo encontrar los conflictos
- En el Centro de administración de Microsoft Entra, abre el informe Errores de sincronización de Microsoft Entra Connect Health. Learn indica que se actualiza aproximadamente cada 30 minutos y muestra los errores del último intento de sincronización.
- En el caso de los valores en cuarentena, Learn muestra:
``powershell Connect-Entra Get-EntraDirectoryObjectOnPremisesProvisioningError | Where-Object PropertyCausingError -eq 'ProxyAddresses' ``
- La solución que indica Learn es la misma para
AttributeValueMustBeUniqueeInvalidSoftMatch: identifica el valor duplicado y los objetos implicados, decide qué objeto lo conserva, elimínalo del otro objeto en el directorio donde se origina ese objeto y, a continuación, deja que Entra Connect sincronice. En algunos casos, puede que tengas que eliminar uno de los objetos en conflicto. - Un trabajo en segundo plano elimina los atributos en cuarentena una vez resuelto el conflicto. Learn indica que se ejecuta cada hora.
En el caso de los invitados, eso significa cambiar o eliminar la dirección del invitado solo en la nube y esperar a la siguiente sincronización.
Verificar
- Busca el usuario en Entra ID y compara
mail,proxyAddressesy el UPN con AD. - Ejecuta
Start-ADSyncSyncCycle -PolicyType Deltay vuelve a comprobarlo. - Comprueba que el informe de errores ya no muestra el objeto.
Para cambios masivos, el artículo de Learn sobre el servidor de almacenamiento intermedio (staging) describe cómo previsualizar las exportaciones pendientes con csexport y CSExportAnalyzer antes de cambiar al modo activo.
Limitaciones
- Los hilos no demuestran qué paso resolvió tu caso.
- Los comandos de coincidencia completa (hard match) del hilo usan un módulo más antiguo. Consulta la guía actual de Learn.
- Learn no documenta el orden de limpieza tras un duplicado creado por error. Prueba primero con un solo usuario.
Relacionado
Fuentes
- Microsoft Learn: Coincidencia suave (soft match) frente a coincidencia completa (hard match), Entra Connect para un inquilino existente
- Microsoft Learn: Solucionar errores durante la sincronización
- Microsoft Learn: Sincronización de identidades y resistencia a atributos duplicados
- Microsoft Learn: Planificar UserPrincipalName e identificador de inicio de sesión alternativo
- Microsoft Learn: Servidor de almacenamiento intermedio (staging)
- Microsoft Learn: Update-MgUser
- Microsoft Q&A: Entra Connect Sync ha creado un segundo usuario con un dominio onmicrosoft.com (octubre de 2025)
- Microsoft Q&A: sincronización de AD Connect, mail y proxyAddresses no actualizados (enero de 2025)