M365Con 2027 – бесплатная онлайн-конференция · 11–22 Jan 2027 · 120 sessions→ m365con.net

Блог · Mirko Peters

Entra Connect создал дубликат пользователя или пропустил атрибут: мягкое сопоставление, жёсткое сопоставление и повторяющиеся значения

By ·

Новый локальный пользователь создал второй облачный аккаунт с UPN в домене onmicrosoft.com, либо адрес почты так и не обновился. Разберём, как работает сопоставление, как читать ошибки и как безопасно связать объекты заново.

Automatically translated with AI from the original post. Read the English original

К правилам сопоставления Entra Connect обычно обращаются в двух ситуациях. В первой новый локальный пользователь появляется в облаке дважды: нужный вам аккаунт и новый синхронизированный аккаунт с именем входа .onmicrosoft.com. Во второй синхронизация проходит без ошибок, но атрибут mail или proxyAddresses пользователя в Entra ID по-прежнему показывает старый адрес.

Ключевые выводы

  • Entra сначала пробует жёсткое сопоставление по sourceAnchor и ImmutableId, затем мягкое по userPrincipalName или основному адресу SMTP, а если совпадений нет, создаёт новый объект.
  • Если суффикс UPN в локальной среде не подтверждён в клиенте, Entra формирует новый UPN из mailNickName и начального домена onmicrosoft.com.
  • Механизм устойчивости к повторяющимся атрибутам помещает конфликтующее значение proxyAddresses или UPN в карантин вместо ошибки, поэтому синхронизация может выглядеть исправной, хотя одного значения не хватает.
  • По данным Learn, начиная с 1 июля 2026 года жёсткое сопоставление может быть заблокировано для облачных аккаунтов, у которых уже задан onPremisesObjectIdentifier, или которые имеют привилегированную роль либо могут её получить.

Оба случая встречались в обсуждениях Microsoft Q&A: одно от января 2025 года, другое от октября 2025 года. В каждом авторы вопроса сообщали, что помогло. Я сверил техническую основу с актуальными страницами Microsoft Learn. Это руководство по устранению неполадок, а не официальная процедура Microsoft. Любое изменение сначала проверяйте на одном пользователе.

Как Entra сопоставляет объекты

Learn описывает следующий порядок для нового объекта, поступающего из AD:

  1. Жёсткое сопоставление. Entra сравнивает sourceAnchor с ImmutableId существующих облачных объектов. По умолчанию sourceAnchor — это форма Base64 от mS-Ds-ConsistencyGUID или ObjectGUID, в зависимости от конфигурации.
  2. Мягкое сопоставление. Если жёсткого совпадения нет, Entra сравнивает userPrincipalName или основное значение SMTP: из proxyAddresses.
  3. Новый объект. Если ни одно сопоставление не сработало, Entra создаёт новый объект.

Learn добавляет два ограничения. Мягкое сопоставление применяется только к новым объектам. Кроме того, при мягком сопоставлении Entra берёт облачный объект под управление и перезаписывает каждый атрибут, у которого есть значение в локальной среде. Атрибуты, существующие только в облаке, могут быть потеряны, а при синхронизации хешей паролей облачный хеш пароля заменяется локальным.

Сценарий 1: второй пользователь с UPN в домене onmicrosoft.com

Что сообщалось в обсуждении. Администратор создал пользователя в локальном AD. Entra Connect создал второго пользователя Entra с UPN в домене .onmicrosoft.com и с признаком синхронизации из локальной среды. У задуманного облачного пользователя признака синхронизации не было. Принятый ответ описывал и мягкое, и жёсткое сопоставление. Автор вопроса позже написал, что проблему решил подход с жёстким сопоставлением.

Почему сопоставление могло не сработать

В ветке не объяснялось, почему так произошло. В Learn приводится одна задокументированная причина для имени onmicrosoft.com: если суффикс UPN локальной среды не подтверждён в клиенте, Entra вычисляет новый UPN на основе MailNickName и начального домена. Это также означает, что UPN не может совпадать с облачным пользователем. Это зацепка, а не диагноз. Сравните следующее для обеих учётных записей:

  • суффикс UPN и то, является ли он подтверждённым доменом в вашем клиенте
  • основной адрес SMTP (запись SMTP: в proxyAddresses)
  • есть ли у облачного пользователя уже признак связи с локальной средой

Вариант A: добиться мягкого сопоставления

Первым обходным решением в ветке было привести UPN локальной среды и proxy-адреса в соответствие с облачным пользователем, удалить дубликат и выполнить синхронизацию заново. В Learn сказано, что мягкое сопоставление выполняется только для новых объектов и не охватывает случай, когда уже связанный объект повторно проверяется после удаления дубликата. Автор вопроса в итоге использовал Вариант B, поэтому Вариант A следует считать недоказанным.

Вариант B: жёсткое сопоставление

  1. Выясните, какой атрибут использует ваш Entra Connect в качестве sourceAnchor. В Learn называются mS-Ds-ConsistencyGUID или ObjectGUID.
  2. Преобразуйте GUID локальной среды в Base64. В ответе из ветки использовался такой шаблон:

``powershell $guid = (Get-ADUser <sam-account-name>).ObjectGuid [System.Convert]::ToBase64String($guid.ToByteArray()) ``

  1. Задайте полученное значение как ImmutableId облачного пользователя. В ответе из ветки использовался Set-MsolUser из устаревшего модуля MSOnline. Актуальные страницы Learn описывают Microsoft Graph PowerShell. На странице Update-MgUser описан параметр -OnPremisesImmutableId и указано, что обновлять его могут только определённые привилегированные роли администратора. Перед запуском проверьте примечания к параметрам на этой странице.
  2. Выполните дельта-синхронизацию:

``powershell Start-ADSyncSyncCycle -PolicyType Delta ``

  1. Убедитесь, что нужный облачный пользователь теперь показывает признак синхронизации, и только после этого займитесь оставшимся дубликатом.

В Learn не описан порядок очистки для этого конкретного случая. В ответе из ветки сначала задали ImmutableId, выполнили синхронизацию, проверили результат и только потом удалили дубликат. Прежде чем что-либо удалять, проверьте лицензии и данные почтового ящика на дубликате.

В Learn описана связанная ошибка InvalidSoftMatch. Она возникает, когда жёсткое сопоставление ничего не находит, мягкое сопоставление находит облачный объект, но у этого объекта другой ImmutableId, чем у входящего sourceAnchor. Это указывает на то, что облачный объект был синхронизирован из другого объекта локальной среды. Решение в Learn такое же, как для AttributeValueMustBeUnique: определите дублирующееся значение и задействованные объекты, решите, какой объект его сохранит, и удалите значение у другого объекта в каталоге, где оно синхронизируется.

Новые защитные механизмы с июля 2026 года

В Learn сказано, что с 1 июля 2026 года жёсткое сопоставление может быть заблокировано, если целевая облачная учётная запись:

  • уже имеет заданное значение onPremisesObjectIdentifier,
  • имеет назначенную привилегированную роль Microsoft Entra или
  • может получить привилегированную роль Microsoft Entra.

Облачные учётные записи с включённой обратной записью (writeback) исключены. В Learn сказано, что эти защитные механизмы не отключают жёсткое сопоставление для безопасных целей. Там также описаны флаги уровня клиента BlockSoftMatchEnabled и BlockCloudObjectTakeoverThroughHardMatchEnabled, а также временный обход AllowOnPremUpdateOfOnPremisesObjectIdentifierEnabled, который по умолчанию отключён. В Learn предупреждается, что обход снижает уровень защиты и после использования его нужно выключить. По умолчанию Entra также не выполняет мягкое сопоставление локальных пользователей с облачными пользователями, имеющими роль администратора, а Microsoft настоятельно не рекомендует синхронизировать локальные учётные записи с уже существующими учётными записями администраторов.

Поэтому, если жёсткое сопоставление из ветки 2025 года сегодня не срабатывает, причиной может быть один из этих защитных механизмов.

Сценарий 2: синхронизация проходит без ошибок, но адрес не меняется

Что сообщалось в ветке. Подрядчикам нужны были собственные внешние адреса электронной почты вместо адреса компании. В ADUC у локальных учётных записей были правильные адреса, но mail и proxyAddresses в Entra по-прежнему содержали адрес компании. Автор вопроса сам нашёл причину: облачные гостевые учётные записи, созданные для доступа к SharePoint, использовали те же внешние адреса, что и новые локальные учётные записи. Автор написал, что именно это и был конфликт.

Обратите внимание, что принятый ответ в этой ветке был общим, а диагноз поставил сам автор вопроса.

Что добавляет Learn

  • Entra ID требует уникальных значений для mail, proxyAddresses, signInName и userPrincipalName. Добавление или обновление значения, которое уже принадлежит другому объекту, вызывает AttributeValueMustBeUnique.
  • Устойчивость к дублирующимся атрибутам — поведение по умолчанию, и его нельзя отключить. Она обрабатывает только значения UPN и SMTP в proxyAddresses: Entra помещает дублирующееся значение в карантин вместо того, чтобы завершить экспорт с ошибкой. Данные она не исправляет, а на странице Learn атрибут mail среди тех, которые она охватывает, не упомянут.
  • Для дублирующегося UPN назначается заглушка вида <OriginalPrefix>+<4DigitNumber>@<InitialTenantDomain>.onmicrosoft.com. Адрес SMTP-прокси, помещённый в карантин, удерживается, пока объект всё ещё создаётся или обновляется.
  • Поскольку экспорт завершается успешно, клиент синхронизации не записывает ошибку и не повторяет попытку.

Это соответствует тому, что описывалось в обсуждении: видимой ошибки нет, одно значение отсутствует. Принятый ответ упоминал устойчивость к дублирующимся атрибутам лишь в общих чертах, и никто не подтвердил, что она применялась. Поэтому это правдоподобное объяснение, но не подтверждённое.

Как найти конфликты

  1. В центре администрирования Microsoft Entra откройте отчёт «Synchronization Errors» в Microsoft Entra Connect Health. По данным Learn, он обновляется примерно каждые 30 минут и показывает ошибки последней попытки синхронизации.
  2. Для значений в карантине Learn показывает:

``powershell Connect-Entra Get-EntraDirectoryObjectOnPremisesProvisioningError | Where-Object PropertyCausingError -eq 'ProxyAddresses' ``

  1. Рекомендация Learn одинакова для AttributeValueMustBeUnique и InvalidSoftMatch: определите дублирующееся значение и затронутые объекты, решите, какой объект его сохранит, удалите значение у другого объекта в каталоге, где этот объект синхронизируется, а затем дайте Entra Connect выполнить синхронизацию. В некоторых случаях может потребоваться удалить один из конфликтующих объектов.
  2. Фоновое задание удаляет атрибуты из карантина, как только конфликт устранён. По данным Learn, оно запускается каждый час.

В случае с гостевой учётной записью это означает изменение или удаление адреса у гостевой учётной записи, существующей только в облаке, и ожидание следующей синхронизации.

Проверка

  1. Найдите пользователя в Entra ID и сравните mail, proxyAddresses и UPN с AD.
  2. Выполните Start-ADSyncSyncCycle -PolicyType Delta, затем проверьте снова.
  3. Убедитесь, что в отчёте об ошибках объект больше не отображается.

Для массовых изменений в статье Learn о промежуточном сервере описан способ предварительного просмотра ожидающих экспортов с помощью csexport и CSExportAnalyzer перед переключением в активный режим.

Ограничения

  • Обсуждения не доказывают, какой шаг устранил проблему в вашем случае.
  • Команды сопоставления по жёсткому совпадению из обсуждения используют старый модуль. Ориентируйтесь на актуальные рекомендации Learn.
  • Learn не описывает порядок очистки после ошибочно созданного дубликата. Проверьте на одном пользователе.

Связанные материалы

Источники

Подписаться на подкастSpotify

Entities in this article

Microsoft Entra Connect Microsoft Entra ID Microsoft Entra Connect Health Microsoft Graph PowerShell

Related articles

RSS