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: зробити працюючим soft match

Перше обхідне рішення в гілці полягало в тому, щоб узгодити UPN і proxy-адреси локального користувача з хмарним, видалити дублікат і знову виконати синхронізацію. Learn пише, що soft match оцінюється лише для нових об'єктів і не охоплює те, чи повторно оцінюється об'єкт, який уже пов'язаний, після видалення дубліката. Той, хто ставив питання, зрештою використав Варіант B, тож Варіант A слід вважати неперевіреним.

Варіант B: hard match

  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. Запустіть delta-синхронізацію:

``powershell Start-ADSyncSyncCycle -PolicyType Delta ``

  1. Переконайтеся, що потрібний хмарний користувач тепер має позначку синхронізації, а потім розберіться з дублікатом, що залишився.

Learn не описує порядок очищення для цього конкретного випадку. У відповіді в гілці спочатку задавали ImmutableId, виконували синхронізацію, перевіряли результат і лише потім видаляли дублікат. Перш ніж щось видаляти, перевірте ліцензії та дані поштової скриньки на дублікаті.

Learn описує пов'язану помилку InvalidSoftMatch. Вона виникає, коли hard match нічого не знаходить, soft match знаходить хмарний об'єкт, але цей об'єкт має інший ImmutableId, ніж вхідний sourceAnchor. Це свідчить про те, що хмарний об'єкт був синхронізований з іншим локальним об'єктом. Рішення Learn таке саме, як для AttributeValueMustBeUnique: визначте значення, що дублюється, і об'єкти, яких це стосується, вирішіть, який об'єкт залишає це значення, і видаліть значення в іншому об'єкті в каталозі, де воно походить.

Нові захисні механізми з липня 2026 року

Learn пише, що з 1 липня 2026 року hard match може бути заблоковано, якщо цільовий хмарний обліковий запис:

  • вже має встановлений onPremisesObjectIdentifier,
  • має призначену привілейовану роль Microsoft Entra або
  • має право на привілейовану роль Microsoft Entra.

Хмарні облікові записи, якими керують у хмарі, з увімкненим writeback виключено. Learn пише, що ці захисні механізми не вимикають hard match для безпечних цілей. Він також описує прапорці на рівні клієнта, BlockSoftMatchEnabled і BlockCloudObjectTakeoverThroughHardMatchEnabled, а також тимчасовий обхід, AllowOnPremUpdateOfOnPremisesObjectIdentifierEnabled, який за замовчуванням вимкнено. Learn попереджає, що обхід знижує рівень захисту, тож його слід вимкнути після використання. За замовчуванням Entra також не виконує soft match між локальними користувачами та хмарними користувачами, які мають адміністративну роль, а Microsoft категорично не рекомендує синхронізувати локальні облікові записи з уже наявними адміністративними обліковими записами.

Тож якщо hard match з гілки 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 proxy, що потрапила на карантин, утримується, поки об'єкт створюється або оновлюється.
  • Оскільки експорт завершується успішно, клієнт синхронізації не фіксує помилки і не повторює спробу.

Це узгоджується з тим, що описувалося в обговоренні: жодної видимої помилки, бракує одного значення. Прийнята відповідь згадувала стійкість до дублікатів атрибутів лише загалом, і ніхто не підтвердив, що вона застосовувалася. Тож це правдоподібне пояснення, а не підтверджене.

Як знайти конфлікти

  1. У центрі адміністрування Microsoft Entra відкрийте звіт про помилки синхронізації в 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