Entra Connect utworzył duplikat użytkownika lub pominął atrybut: dopasowanie miękkie, dopasowanie twarde i zduplikowane wartości
By Mirko Peters ·
Nowy użytkownik lokalny utworzył drugie konto w chmurze z UPN w domenie onmicrosoft.com, albo adres e-mail nigdy się nie zaktualizował. Sprawdź, jak działa dopasowanie, jak odczytywać błędy i jak bezpiecznie ponownie powiązać konta.
Automatically translated with AI from the original post. Read the English original
Do reguł dopasowania Entra Connect prowadzą zwykle dwie sytuacje. W pierwszej nowy użytkownik lokalny pojawia się w chmurze dwukrotnie: konto, którego oczekiwano, oraz nowe zsynchronizowane konto z nazwą logowania .onmicrosoft.com. W drugiej synchronizacja przebiega bez błędów, ale atrybut mail lub proxyAddresses użytkownika w Entra ID nadal pokazuje stary adres.
Najważniejsze wnioski
- Entra najpierw próbuje dopasowania twardego na podstawie sourceAnchor względem ImmutableId, potem dopasowania miękkiego na podstawie userPrincipalName lub głównego adresu SMTP, a w przeciwnym razie tworzy nowy obiekt.
- Jeśli sufiks UPN z lokalnego AD nie jest zweryfikowany w dzierżawie, Entra buduje nowy UPN na podstawie mailNickName i początkowej domeny onmicrosoft.com.
- Odporność na zduplikowane atrybuty przenosi konfliktujące wartości proxyAddresses lub UPN do kwarantanny zamiast zgłaszać błąd, więc synchronizacja może wyglądać na poprawną, mimo że jedna wartość brakuje.
- Według Learn od 1 lipca 2026 r. dopasowanie twarde może być zablokowane dla kont w chmurze, które mają już ustawiony atrybut onPremisesObjectIdentifier, lub które posiadają albo kwalifikują się do roli uprzywilejowanej.
Oba przypadki pojawiły się w wątkach Q&A serwisu Microsoft, jeden z stycznia 2025 r., drugi z października 2025 r. W każdym z nich osoba pytająca podała, co rozwiązało problem. Techniczne podstawy sprawdziłem na aktualnych stronach Microsoft Learn. To przewodnik po rozwiązywaniu problemów, a nie oficjalna procedura Microsoft. Każdą zmianę przetestuj najpierw na jednym użytkowniku.
Jak Entra dopasowuje obiekty
Learn opisuje następującą kolejność dla nowego obiektu przychodzącego z AD:
- Dopasowanie twarde. Entra porównuje
sourceAnchorzImmutableIdistniejących obiektów w chmurze. DomyślnysourceAnchorto postać Base64 atrybutumS-Ds-ConsistencyGUIDlubObjectGUID, zależnie od konfiguracji. - Dopasowanie miękkie. Jeśli nie ma dopasowania twardego, Entra porównuje
userPrincipalNamelub główną wartośćSMTP:zproxyAddresses. - Nowy obiekt. Jeśli żadne z dopasowań nie zadziała, Entra tworzy nowy obiekt.
Learn podaje dwa ograniczenia. Dopasowanie miękkie jest oceniane wyłącznie dla nowych obiektów. Ponadto przy dopasowaniu miękkim Entra przejmuje obiekt w chmurze i nadpisuje każdy atrybut, który ma wartość lokalnie. Atrybuty istniejące tylko w chmurze mogą zostać utracone, a przy synchronizacji hashy haseł hash hasła w chmurze zostaje zastąpiony hashem z lokalnego środowiska.
Scenariusz 1: drugi użytkownik z UPN w domenie onmicrosoft.com
Co zgłosił wątek. Administrator utworzył użytkownika w lokalnym AD. Entra Connect utworzył drugiego użytkownika Entra z UPN w domenie .onmicrosoft.com i z flagą synchronizacji lokalnej. Zamierzony użytkownik w chmurze nie miał flagi synchronizacji. Zaakceptowana odpowiedź opisywała zarówno dopasowanie miękkie, jak i twarde. Osoba pytająca później napisała, że podejście oparte na dopasowaniu twardym rozwiązało problem.
Dlaczego dopasowanie mogło się nie powieść
Wątek nie podawał powodu. Learn podaje jeden udokumentowany powód dla nazwy onmicrosoft.com: jeśli sufiks UPN lokalnego katalogu nie jest zweryfikowany w dzierżawie, Entra oblicza nowy UPN na podstawie MailNickName i domeny początkowej. Oznacza to także, że UPN nie może być zgodny z kontem użytkownika w chmurze. To jest trop, a nie diagnoza. Porównaj następujące elementy w obu kontach:
- sufiks UPN oraz to, czy jest to zweryfikowana domena w Twojej dzierżawie
- główny adres SMTP (wpis
SMTP:wproxyAddresses) - to, czy konto użytkownika w chmurze już wskazuje na powiązanie z katalogiem lokalnym
Opcja A: próba dopasowania miękkiego
Pierwsze obejście proponowane w wątku polegało na tym, by dopasować lokalny UPN i adresy proxy do konta w chmurze, usunąć duplikat i ponownie uruchomić synchronizację. Learn podaje, że dopasowanie miękkie jest oceniane tylko dla nowych obiektów i nie obejmuje ponownej oceny obiektu, który jest już powiązany, po usunięciu duplikatu. Osoba zadająca pytanie ostatecznie zastosowała opcję B, więc opcję A traktuj jako niepotwierdzoną.
Opcja B: dopasowanie twarde
- Ustal, którego atrybutu Entra Connect używa jako
sourceAnchor. Learn wymieniamS-Ds-ConsistencyGUIDlubObjectGUID. - Przekonwertuj lokalny GUID na Base64. Odpowiedź w wątku używała następującego wzorca:
``powershell $guid = (Get-ADUser <sam-account-name>).ObjectGuid [System.Convert]::ToBase64String($guid.ToByteArray()) ``
- Ustaw wynik jako
ImmutableIdkonta użytkownika w chmurze. Odpowiedź w wątku używała poleceniaSet-MsolUser, które pochodzi ze starszego modułu MSOnline. Aktualne strony Learn korzystają z Microsoft Graph PowerShell. StronaUpdate-MgUserdokumentuje parametr-OnPremisesImmutableIdi informuje, że tylko określone uprzywilejowane role administratora mogą go aktualizować. Przed uruchomieniem sprawdź uwagi dotyczące parametrów na tej stronie. - Uruchom synchronizację deltą:
``powershell Start-ADSyncSyncCycle -PolicyType Delta ``
- Potwierdź, że docelowe konto użytkownika w chmurze pokazuje teraz flagę synchronizacji, a następnie zajmij się pozostałym duplikatem.
Learn nie opisuje kolejności czynności porządkowych dla tego dokładnego przypadku. Odpowiedź w wątku najpierw ustawiła ImmutableId, potem wykonała synchronizację i sprawdzenie, a dopiero na końcu usunęła duplikat. Przed usunięciem czegokolwiek sprawdź licencje i dane skrzynki pocztowej na duplikacie.
Learn dokumentuje powiązany błąd InvalidSoftMatch. Pojawia się on wtedy, gdy dopasowanie twarde nic nie znajduje, dopasowanie miękkie znajduje obiekt w chmurze, ale ten obiekt ma inny ImmutableId niż przychodzący sourceAnchor. Sugeruje to, że obiekt w chmurze został zsynchronizowany z innym obiektem lokalnym. Rozwiązanie podane przez Learn jest takie samo jak dla AttributeValueMustBeUnique: zidentyfikuj zduplikowaną wartość oraz powiązane obiekty, zdecyduj, który obiekt ją zachowa, a następnie usuń wartość z drugiego obiektu w katalogu, w którym jest ona pochodzi.
Nowe zabezpieczenia od lipca 2026 roku
Learn podaje, że od 1 lipca 2026 roku dopasowanie twarde może zostać zablokowane, gdy docelowe konto w chmurze:
- ma już ustawiony
onPremisesObjectIdentifier, - ma przypisaną uprzywilejowaną rolę Microsoft Entra lub
- kwalifikuje się do uprzywilejowanej roli Microsoft Entra.
Konta zarządzane w chmurze z włączonym zapisem zwrotnym są wyłączone spod tych zasad. Learn podaje, że te zabezpieczenia nie wyłączają dopasowania twardego dla bezpiecznych celów. Opisuje też flagi obejmujące całą dzierżawę, BlockSoftMatchEnabled i BlockCloudObjectTakeoverThroughHardMatchEnabled, oraz tymczasowe obejście, AllowOnPremUpdateOfOnPremisesObjectIdentifierEnabled, które domyślnie jest wyłączone. Learn ostrzega, że obejście osłabia ochronę i po jego użyciu należy je wyłączyć. Domyślnie Entra nie dokonuje też dopasowania miękkiego użytkowników lokalnych do kont w chmurze, które mają rolę administratora, a Microsoft zdecydowanie odradza synchronizowanie kont lokalnych z istniejącymi kontami administracyjnymi.
Jeśli więc dopasowanie twarde z wątku z 2025 roku dziś się nie udaje, przyczyną może być jedno z tych zabezpieczeń.
Scenariusz 2: synchronizacja działa, ale adres się nie zmienia
Co zgłoszono w wątku. Współpracownicy zewnętrzni potrzebowali własnych zewnętrznych adresów e-mail zamiast adresu firmowego. Konta lokalne pokazywały właściwe adresy w ADUC, ale mail i proxyAddresses w Entra nadal zawierały adres firmowy. Osoba zadająca pytanie sama znalazła przyczynę: konta gości utworzone wyłącznie w chmurze, założone na potrzeby dostępu do SharePoint, używały tych samych zewnętrznych adresów co nowe konta lokalne. Autor napisał, że to właśnie był konflikt.
Zwróć uwagę, że zaakceptowana odpowiedź w tym wątku była ogólna, a diagnozę postawiła osoba zadająca pytanie.
Co dodaje Learn
- Entra ID wymaga unikalnych wartości dla
mail,proxyAddresses,signInNameiuserPrincipalName. Dodanie lub aktualizacja wartości, którą już posiada inny obiekt, powoduje błądAttributeValueMustBeUnique. - Odporność na zduplikowane atrybuty to domyślne zachowanie, którego nie można wyłączyć. Obejmuje ona wyłącznie wartości UPN oraz SMTP w
proxyAddresses: Entra umieszcza zduplikowaną wartość w kwarantannie zamiast przerywać eksport. Nie naprawia ona danych, a strona Learn nie wymieniamailwśród atrybutów, które obejmuje. - W przypadku zduplikowanego UPN przypisywany jest symbol zastępczy o postaci
<OriginalPrefix>+<4DigitNumber>@<InitialTenantDomain>.onmicrosoft.com. Adres proxy SMTP objęty kwarantanną jest wstrzymywany, a obiekt mimo to zostaje utworzony lub zaktualizowany. - Ponieważ eksport kończy się sukcesem, klient synchronizacji nie zapisuje żadnego błędu i nie ponawia próby.
To zgadza się z tym, co opisano w wątku: brak widocznego błędu i jedna brakująca wartość. Zaakceptowana odpowiedź wspominała o odporności na zduplikowane atrybuty tylko ogólnie, a nikt nie potwierdził, że miała ona zastosowanie. Jest to więc prawdopodobne wyjaśnienie, ale nie potwierdzone.
Jak znaleźć konflikty
- W centrum administracyjnym Microsoft Entra otwórz raport Błędy synchronizacji w usłudze Microsoft Entra Connect Health. Według Learn raport odświeża się mniej więcej co 30 minut i pokazuje błędy z ostatniej próby synchronizacji.
- W przypadku wartości objętych kwarantanną Learn pokazuje:
``powershell Connect-Entra Get-EntraDirectoryObjectOnPremisesProvisioningError | Where-Object PropertyCausingError -eq 'ProxyAddresses' ``
- Rozwiązanie wskazane przez Learn jest takie samo dla
AttributeValueMustBeUniqueiInvalidSoftMatch: ustal zduplikowaną wartość i zaangażowane obiekty, zdecyduj, który obiekt ją zachowa, usuń ją z drugiego obiektu w katalogu, z którego ten obiekt pochodzi, a następnie pozwól programowi Entra Connect przeprowadzić synchronizację. W niektórych przypadkach może być konieczne usunięcie jednego z konfliktujących obiektów. - Zadanie w tle usuwa atrybuty objęte kwarantanną, gdy konflikt zostanie usunięty. Według Learn działa ono co godzinę.
W przypadku gościa oznacza to zmianę lub usunięcie adresu w koncie gościa istniejącym wyłącznie w chmurze, a następnie oczekiwanie na kolejną synchronizację.
Weryfikacja
- Wyszukaj użytkownika w usłudze Entra ID i porównaj
mail,proxyAddressesoraz UPN z AD. - Uruchom
Start-ADSyncSyncCycle -PolicyType Delta, a następnie sprawdź ponownie. - Upewnij się, że raport błędów nie wymienia już tego obiektu.
W przypadku zmian zbiorczych artykuł Learn o serwerze przejściowym opisuje sposób podglądu oczekujących eksportów za pomocą csexport i CSExportAnalyzer, zanim przełączysz się w tryb aktywny.
Ograniczenia
- Wątki nie dowodzą, który krok rozwiązał Twój przypadek.
- Polecenia dopasowania twardego (hard match) z wątku używają starszego modułu. Stosuj aktualne wskazówki Learn.
- Learn nie dokumentuje kolejności czyszczenia po błędnie utworzonym duplikacie. Przetestuj to na jednym użytkowniku.
Powiązane
Źródła
- Microsoft Learn: Miękkie a twarde dopasowanie, Entra Connect dla istniejącej dzierżawy
- Microsoft Learn: Rozwiązywanie błędów podczas synchronizacji
- Microsoft Learn: Synchronizacja tożsamości a odporność na zduplikowane atrybuty
- Microsoft Learn: Planowanie UserPrincipalName i alternatywnego identyfikatora logowania
- Microsoft Learn: Serwer przejściowy (staging server)
- Microsoft Learn: Update-MgUser
- Microsoft Q&A: Entra Connect Sync utworzył drugiego użytkownika z domeną onmicrosoft.com (październik 2025)
- Microsoft Q&A: AD Connect sync, atrybuty mail i proxyAddresses nie zostały zaktualizowane (styczeń 2025)