Entra Connect Membuat Pengguna Duplikat atau Melewati Atribut: Soft Match, Hard Match, dan Nilai Duplikat
By Mirko Peters ·
Pengguna on-premises baru membuat akun cloud kedua dengan UPN onmicrosoft.com, atau alamat email tidak pernah diperbarui. Pelajari cara kerja pencocokan, cara membaca galat, dan cara menautkan kembali dengan aman.
Automatically translated with AI from the original post. Read the English original
Ada dua situasi yang membuat orang mencari aturan pencocokan Entra Connect. Pada situasi pertama, pengguna on-premises baru muncul dua kali di cloud: akun yang Anda inginkan, ditambah akun tersinkronisasi baru dengan nama masuk .onmicrosoft.com. Pada situasi kedua, sinkronisasi berjalan tanpa galat, tetapi mail atau proxyAddresses pengguna di Entra ID masih menampilkan alamat lama.
Poin Penting
- Entra mencoba hard match pada sourceAnchor terhadap ImmutableId terlebih dahulu, kemudian soft match pada userPrincipalName atau alamat SMTP utama, dan jika keduanya tidak cocok, Entra membuat objek baru.
- Jika sufiks UPN on-premises belum diverifikasi di penyewa, Entra membuat UPN baru dari mailNickName dan domain awal onmicrosoft.com.
- Resiliensi nilai atribut duplikat mengkarantina nilai proxyAddresses atau UPN yang bertentangan alih-alih menggagalkan sinkronisasi, sehingga sinkronisasi tampak sehat padahal satu nilai hilang.
- Sejak 1 Juli 2026, Learn menyebutkan bahwa hard match dapat diblokir untuk akun cloud yang sudah memiliki onPremisesObjectIdentifier, atau yang memegang atau memenuhi syarat untuk peran istimewa.
Kedua kasus ini muncul di utas Microsoft Q&A, satu dari Januari 2025 dan satu dari Oktober 2025. Pada masing-masing utas, penanya melaporkan apa yang menyelesaikan masalahnya. Saya telah memeriksa latar belakang teknisnya terhadap halaman Microsoft Learn terkini. Ini adalah panduan pemecahan masalah, bukan prosedur resmi Microsoft. Uji setiap perubahan pada satu pengguna terlebih dahulu.
Cara Entra mencocokkan objek
Learn menjelaskan urutan berikut untuk objek baru yang masuk dari AD:
- Hard match. Entra membandingkan
sourceAnchordenganImmutableIddari objek cloud yang sudah ada.sourceAnchordefault adalah bentuk Base64 darimS-Ds-ConsistencyGUID, atau dariObjectGUID, tergantung konfigurasi. - Soft match. Jika tidak ada hard match, Entra membandingkan
userPrincipalNameatau nilaiSMTP:utama dariproxyAddresses. - Objek baru. Jika tidak ada yang cocok, Entra membuat objek baru.
Learn menambahkan dua batasan. Soft match hanya dievaluasi untuk objek baru. Dan pada soft match, Entra mengambil alih objek cloud dan menimpa setiap atribut yang memiliki nilai di on-premises. Atribut yang hanya ada di cloud dapat hilang, dan dengan password hash sync, hash kata sandi cloud diganti dengan hash dari on-premises.
Skenario 1: pengguna kedua dengan UPN onmicrosoft.com
Yang dilaporkan utas tersebut. Seorang administrator membuat pengguna di AD on-premises. Entra Connect membuat pengguna Entra kedua dengan UPN .onmicrosoft.com dan tanda sinkronisasi on-premises. Pengguna cloud yang dimaksud tidak memiliki tanda sinkronisasi. Balasan yang diterima menjelaskan soft match dan hard match. Penanya kemudian menulis bahwa pendekatan hard match menyelesaikan masalahnya.
Mengapa pencocokan mungkin gagal
Utasan tersebut tidak menjelaskan alasannya. Learn memberikan satu alasan yang terdokumentasi untuk nama onmicrosoft.com: jika sufiks UPN on-premises tidak diverifikasi di penyewa, Entra menghitung UPN baru dari MailNickName dan domain awal. Artinya, UPN juga tidak dapat cocok dengan pengguna cloud. Ini hanyalah petunjuk, bukan diagnosis. Bandingkan hal-hal berikut pada kedua akun:
- Sufiks UPN dan apakah itu domain terverifikasi di penyewa Anda
- alamat SMTP utama (entri
SMTP:diproxyAddresses) - apakah pengguna cloud sudah menunjukkan tautan on-premises
Opsi A: membuat soft match berfungsi
Solusi sementara pertama dalam utasan tersebut adalah menyamakan UPN on-premises dan proxy address dengan pengguna cloud, menghapus duplikat, lalu melakukan sinkronisasi ulang. Learn menyatakan bahwa soft match hanya dievaluasi untuk objek baru, dan tidak mencakup apakah objek yang sudah tertaut dievaluasi ulang setelah duplikat dihapus. Penanya akhirnya menggunakan Opsi B, jadi anggaplah Opsi A belum terbukti.
Opsi B: hard match
- Cari tahu atribut mana yang digunakan Entra Connect Anda sebagai
sourceAnchor. Learn menyebutkanmS-Ds-ConsistencyGUIDatauObjectGUID. - Konversikan GUID on-premises ke Base64. Balasan dalam utasan tersebut menggunakan pola berikut:
``powershell $guid = (Get-ADUser <sam-account-name>).ObjectGuid [System.Convert]::ToBase64String($guid.ToByteArray()) ``
- Setel hasilnya sebagai
ImmutableIdpengguna cloud. Balasan dalam utasan tersebut menggunakanSet-MsolUser, yang berasal dari modul MSOnline versi lama. Halaman Learn saat ini menggunakan Microsoft Graph PowerShell. HalamanUpdate-MgUsermendokumentasikan parameter-OnPremisesImmutableIddan menyatakan bahwa hanya peran administrator istimewa tertentu yang dapat memperbaruinya. Periksa catatan parameter di halaman tersebut sebelum menjalankannya. - Jalankan sinkronisasi delta:
``powershell Start-ADSyncSyncCycle -PolicyType Delta ``
- Pastikan pengguna cloud yang dituju sekarang menampilkan tanda sinkronisasi, lalu tangani duplikat yang tersisa.
Learn tidak menjelaskan urutan pembersihan untuk kasus persis ini. Balasan dalam utasan tersebut menyetel ImmutableId terlebih dahulu, melakukan sinkronisasi, memeriksa, dan baru kemudian menghapus duplikat. Sebelum menghapus apa pun, periksa lisensi dan data kotak surat pada duplikat tersebut.
Learn mendokumentasikan kesalahan terkait, InvalidSoftMatch. Kesalahan ini terjadi ketika hard match tidak menemukan apa pun, soft match menemukan objek cloud, tetapi objek tersebut memiliki ImmutableId yang berbeda dari sourceAnchor yang masuk. Ini menunjukkan bahwa objek cloud tersebut disinkronkan dari objek on-premises lain. Perbaikan dari Learn sama dengan untuk AttributeValueMustBeUnique: identifikasi nilai yang duplikat dan objek yang terlibat, tentukan objek mana yang mempertahankannya, lalu hapus nilai tersebut dari objek lain di direktori tempat nilai itu bersumber.
Perlindungan baru sejak Juli 2026
Learn menyatakan bahwa mulai 1 Juli 2026, hard match dapat diblokir ketika akun cloud target:
- sudah memiliki
onPremisesObjectIdentifieryang disetel, - memiliki peran Microsoft Entra istimewa yang ditetapkan, atau
- memenuhi syarat untuk peran Microsoft Entra istimewa.
Akun yang dikelola di cloud dengan writeback yang diaktifkan dikecualikan. Learn menyatakan bahwa perlindungan ini tidak menonaktifkan hard match untuk target yang aman. Learn juga menjelaskan flag tingkat penyewa, BlockSoftMatchEnabled dan BlockCloudObjectTakeoverThroughHardMatchEnabled, serta bypass sementara, AllowOnPremUpdateOfOnPremisesObjectIdentifierEnabled, yang nonaktif secara default. Learn memperingatkan bahwa bypass ini mengurangi perlindungan dan sebaiknya dinonaktifkan setelah digunakan. Secara default, Entra juga tidak melakukan soft match dari pengguna on-premises ke pengguna cloud yang memegang peran admin, dan Microsoft sangat menyarankan agar akun on-premises tidak disinkronkan dengan akun admin yang sudah ada.
Jadi, jika hard match dari utasan 2025 gagal hari ini, salah satu perlindungan ini mungkin menjadi penyebabnya.
Skenario 2: sinkronisasi tidak bermasalah, tetapi alamat tidak pernah berubah
Yang dilaporkan dalam utasan. Kontraktor memerlukan alamat email eksternal mereka sendiri, bukan alamat perusahaan. Akun on-premises menampilkan alamat yang benar di ADUC, tetapi mail dan proxyAddresses di Entra masih menyimpan alamat perusahaan. Penanya menemukan penyebabnya sendiri: akun tamu khusus cloud, yang dibuat untuk akses SharePoint, menggunakan alamat eksternal yang sama dengan akun on-premises baru. Penanya menulis bahwa inilah konfliknya.
Perhatikan bahwa balasan yang diterima dalam utasan tersebut bersifat umum, dan diagnosisnya berasal dari penanya.
Yang ditambahkan Learn
- Entra ID memerlukan nilai yang unik untuk
mail,proxyAddresses,signInName, danuserPrincipalName. Menambahkan atau memperbarui nilai yang sudah dimiliki objek lain menyebabkanAttributeValueMustBeUnique. - Ketahanan atribut duplikat adalah perilaku default dan tidak dapat dinonaktifkan. Fitur ini hanya menangani nilai UPN dan
proxyAddressesSMTP: Entra mengkarantina nilai duplikat alih-alih menggagalkan ekspor. Fitur ini tidak memperbaiki data, dan halaman Learn tidak mencantumkanmaildi antara atribut yang dicakupnya. - Untuk UPN duplikat, sebuah placeholder ditetapkan dengan format
<OriginalPrefix>+<4DigitNumber>@<InitialTenantDomain>.onmicrosoft.com. Alamat proxy SMTP yang dikarantina ditahan selama objek tetap dibuat atau diperbarui. - Karena ekspor berhasil, klien sinkronisasi tidak mencatat kesalahan dan tidak mencoba ulang.
Hal ini sesuai dengan yang dijelaskan dalam utas diskusi: tidak ada kegagalan yang terlihat, dan satu nilai hilang. Balasan yang diterima hanya menyebutkan ketahanan atribut duplikat secara umum, dan tidak ada yang memastikan bahwa fitur tersebut berlaku. Jadi ini adalah penjelasan yang masuk akal, bukan penjelasan yang sudah dikonfirmasi.
Cara menemukan konflik
- Di pusat admin Microsoft Entra, buka laporan Synchronization Errors di Microsoft Entra Connect Health. Learn menyebutkan laporan ini diperbarui sekitar setiap 30 menit dan menampilkan kesalahan dari percobaan sinkronisasi terbaru.
- Untuk nilai yang dikarantina, Learn menampilkan:
``powershell Connect-Entra Get-EntraDirectoryObjectOnPremisesProvisioningError | Where-Object PropertyCausingError -eq 'ProxyAddresses' ``
- Solusi Learn sama untuk
AttributeValueMustBeUniquedanInvalidSoftMatch: identifikasi nilai yang duplikat dan objek yang terlibat, tentukan objek mana yang akan mempertahankannya, hapus dari objek lain di direktori tempat objek tersebut bersumber, lalu biarkan Entra Connect melakukan sinkronisasi. Dalam beberapa kasus, Anda mungkin perlu menghapus salah satu objek yang berkonflik. - Sebuah tugas latar belakang akan menghapus atribut yang dikarantina setelah konflik teratasi. Learn menyebutkan tugas ini berjalan setiap jam.
Dalam kasus tamu, itu berarti mengubah atau menghapus alamat pada akun tamu yang hanya ada di cloud, lalu menunggu sinkronisasi berikutnya.
Verifikasi
- Cari pengguna di Entra ID dan bandingkan
mail,proxyAddresses, dan UPN dengan AD. - Jalankan
Start-ADSyncSyncCycle -PolicyType Delta, lalu periksa kembali. - Pastikan laporan kesalahan tidak lagi mencantumkan objek tersebut.
Untuk perubahan massal, artikel Learn tentang staging server menjelaskan cara meninjau ekspor yang tertunda dengan csexport dan CSExportAnalyzer sebelum Anda beralih ke mode aktif.
Batasan
- Utas diskusi tidak membuktikan langkah mana yang memperbaiki kasus Anda.
- Perintah hard-match dalam utas diskusi menggunakan modul versi lama. Gunakan panduan Learn terbaru.
- Learn tidak mendokumentasikan urutan pembersihan setelah duplikat yang terlanjur dibuat. Uji dengan satu pengguna terlebih dahulu.
Terkait
Sumber
- Microsoft Learn: Soft match vs hard match, Entra Connect untuk penyewa yang sudah ada
- Microsoft Learn: Troubleshoot errors during synchronization
- Microsoft Learn: Sinkronisasi identitas dan ketahanan atribut duplikat
- Microsoft Learn: Merencanakan UserPrincipalName dan Alternate login ID
- Microsoft Learn: Staging server
- Microsoft Learn: Update-MgUser
- Microsoft Q&A: Entra Connect Sync membuat pengguna kedua dengan domain onmicrosoft.com (Oktober 2025)
- Microsoft Q&A: Sinkronisasi AD Connect, mail dan proxyAddresses tidak diperbarui (Januari 2025)