Entra Connect создал дубликат пользователя или пропустил атрибут: мягкое сопоставление, жёсткое сопоставление и повторяющиеся значения
By Mirko Peters ·
Новый локальный пользователь создал второй облачный аккаунт с 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:
- Жёсткое сопоставление. Entra сравнивает
sourceAnchorсImmutableIdсуществующих облачных объектов. По умолчаниюsourceAnchor— это форма Base64 отmS-Ds-ConsistencyGUIDилиObjectGUID, в зависимости от конфигурации. - Мягкое сопоставление. Если жёсткого совпадения нет, Entra сравнивает
userPrincipalNameили основное значениеSMTP:изproxyAddresses. - Новый объект. Если ни одно сопоставление не сработало, 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: жёсткое сопоставление
- Выясните, какой атрибут использует ваш Entra Connect в качестве
sourceAnchor. В Learn называютсяmS-Ds-ConsistencyGUIDилиObjectGUID. - Преобразуйте GUID локальной среды в Base64. В ответе из ветки использовался такой шаблон:
``powershell $guid = (Get-ADUser <sam-account-name>).ObjectGuid [System.Convert]::ToBase64String($guid.ToByteArray()) ``
- Задайте полученное значение как
ImmutableIdоблачного пользователя. В ответе из ветки использовалсяSet-MsolUserиз устаревшего модуля MSOnline. Актуальные страницы Learn описывают Microsoft Graph PowerShell. На страницеUpdate-MgUserописан параметр-OnPremisesImmutableIdи указано, что обновлять его могут только определённые привилегированные роли администратора. Перед запуском проверьте примечания к параметрам на этой странице. - Выполните дельта-синхронизацию:
``powershell Start-ADSyncSyncCycle -PolicyType Delta ``
- Убедитесь, что нужный облачный пользователь теперь показывает признак синхронизации, и только после этого займитесь оставшимся дубликатом.
В 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-прокси, помещённый в карантин, удерживается, пока объект всё ещё создаётся или обновляется. - Поскольку экспорт завершается успешно, клиент синхронизации не записывает ошибку и не повторяет попытку.
Это соответствует тому, что описывалось в обсуждении: видимой ошибки нет, одно значение отсутствует. Принятый ответ упоминал устойчивость к дублирующимся атрибутам лишь в общих чертах, и никто не подтвердил, что она применялась. Поэтому это правдоподобное объяснение, но не подтверждённое.
Как найти конфликты
- В центре администрирования Microsoft Entra откройте отчёт «Synchronization Errors» в Microsoft Entra Connect Health. По данным Learn, он обновляется примерно каждые 30 минут и показывает ошибки последней попытки синхронизации.
- Для значений в карантине Learn показывает:
``powershell Connect-Entra Get-EntraDirectoryObjectOnPremisesProvisioningError | Where-Object PropertyCausingError -eq 'ProxyAddresses' ``
- Рекомендация Learn одинакова для
AttributeValueMustBeUniqueиInvalidSoftMatch: определите дублирующееся значение и затронутые объекты, решите, какой объект его сохранит, удалите значение у другого объекта в каталоге, где этот объект синхронизируется, а затем дайте Entra Connect выполнить синхронизацию. В некоторых случаях может потребоваться удалить один из конфликтующих объектов. - Фоновое задание удаляет атрибуты из карантина, как только конфликт устранён. По данным Learn, оно запускается каждый час.
В случае с гостевой учётной записью это означает изменение или удаление адреса у гостевой учётной записи, существующей только в облаке, и ожидание следующей синхронизации.
Проверка
- Найдите пользователя в Entra ID и сравните
mail,proxyAddressesи UPN с AD. - Выполните
Start-ADSyncSyncCycle -PolicyType Delta, затем проверьте снова. - Убедитесь, что в отчёте об ошибках объект больше не отображается.
Для массовых изменений в статье Learn о промежуточном сервере описан способ предварительного просмотра ожидающих экспортов с помощью csexport и CSExportAnalyzer перед переключением в активный режим.
Ограничения
- Обсуждения не доказывают, какой шаг устранил проблему в вашем случае.
- Команды сопоставления по жёсткому совпадению из обсуждения используют старый модуль. Ориентируйтесь на актуальные рекомендации Learn.
- Learn не описывает порядок очистки после ошибочно созданного дубликата. Проверьте на одном пользователе.
Связанные материалы
Источники
- Microsoft Learn: мягкое и жёсткое сопоставление, Entra Connect для существующего клиента
- Microsoft Learn: Устранение ошибок при синхронизации
- Microsoft Learn: Синхронизация удостоверений и устойчивость к дублирующимся атрибутам
- Microsoft Learn: Планирование UserPrincipalName и альтернативного идентификатора входа
- Microsoft Learn: Промежуточный сервер
- Microsoft Learn: Update-MgUser
- Microsoft Q&A: Entra Connect Sync создал второго пользователя с доменом onmicrosoft.com (октябрь 2025)
- Microsoft Q&A: синхронизация AD Connect, атрибуты mail и proxyAddresses не обновляются (январь 2025)