M365Con 2027 – konferensi online gratis · 11–22 Jan 2027 · 120 sessions→ m365con.net

Blog · Mirko Peters

Memperbaiki Timeout Agen Entra Cloud Sync: Daftar Periksa Jaringan dan Sertifikat

By ·

Agen Entra Cloud Sync terpasang dengan baik tetapi tidak pernah menyinkronkan data, dan portal menampilkan HybridIdentityServiceAgentTimeout? Telusuri DNS, aturan firewall, inspeksi TLS, dan kepercayaan sertifikat sesuai urutan ini.

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

Agen terpasang tanpa error. Layanannya berjalan. Server memiliki akses internet. Namun, sinkronisasi pertama tidak pernah dimulai, dan pusat admin Microsoft Entra menampilkan HybridIdentityServiceAgentTimeout.

Poin Penting

  • Dalam kasus yang dilaporkan, HybridIdentityServiceAgentTimeout berarti terdapat masalah koneksi antara agen dan layanan cloud, bukan agen yang rusak. Learn mengaitkan timeout agen dengan kegagalan koneksi.
  • Periksa DNS terlebih dahulu, lalu TCP 443 keluar ke *.msappproxy.net dan *.servicebus.windows.net, kemudian port 80 untuk daftar pencabutan sertifikat.
  • Aturan firewall harus mengikuti nama domain, bukan alamat IP tetap, dan inspeksi TLS sebaiknya dilewati untuk alur ini.
  • Kumpulkan trace agen dan bundel log AADCloudSyncTools sebelum membuka kasus dukungan.

Pola ini muncul dalam dua utas komunitas Microsoft yang terpisah pada 2026. Pada keduanya, agen itu sendiri tampak baik-baik saja, dan masalah yang diduga berada di antara server dan layanan cloud. Artikel ini menyajikan pelajaran bersama tersebut dalam bentuk daftar periksa yang dapat Anda ikuti secara berurutan. Ini adalah panduan pemecahan masalah, bukan prosedur resmi Microsoft, jadi pastikan setiap persyaratan dengan prasyarat cloud sync di Microsoft Learn yang terbaru.

Seperti apa gejalanya

Laporan yang ada menunjukkan campuran tanda-tanda berikut:

  • Di pusat admin Entra, status agen menampilkan HybridIdentityServiceAgentTimeout.
  • Folder trace agen, C:\ProgramData\Microsoft\Azure AD Connect Provisioning Agent\Trace, berisi baris seperti Web socket failed to connect.
  • Log peristiwa menunjukkan bahwa registrasi ulang agen gagal karena permintaan pembaruan kepercayaan ke alamat msappproxy.net melewati batas waktu.
  • Pembaruan agen tidak dapat me-resolve nama seperti autoupdate.msappproxy.net.
  • Log CAPI2 melaporkan rantai sertifikat yang berakhir pada sertifikat root yang tidak tepercaya.

Satu baris trace, Unable to initialize performance counters, juga muncul. Dalam jawaban yang diterima pada salah satu utas, hal ini dianggap sebagai masalah sampingan. Error koneksilah petunjuk yang sebenarnya.

Langkah 1: Pastikan agen dan layanan

Pertama, singkirkan penyebab sederhana terlebih dahulu.

  1. Di pusat admin Microsoft Entra, buka Entra ID, lalu Entra Connect, lalu Cloud sync, dan pastikan agen tercantum di sana.
  2. Di server, buka services.msc dan pastikan Microsoft Entra Connect Agent Updater dan Microsoft Entra Provisioning Agent berjalan.
  3. Periksa dasar-dasarnya sesuai persyaratan Microsoft: server yang sudah tergabung ke domain (Windows Server Core tidak didukung), .NET Framework 4.7.1 atau yang lebih baru, serta kebijakan eksekusi PowerShell Undefined atau RemoteSigned.

Jika semua ini sudah benar, lanjutkan. Agen bukan penyebab masalahnya.

Langkah 2: Uji resolusi nama

Jawaban yang diterima di utas pertama mengarahkan ke DNS terlebih dahulu, dan balasan di utas kedua juga meminta pengujian resolusi nama. Jalankan perintah berikut dari server agen:

`` nslookup autoupdate.msappproxy.net nslookup login.microsoftonline.com nslookup <your-servicebus-namespace>.servicebus.windows.net ``

Jika nama msappproxy.net tidak dapat di-resolve, tidak ada hal lain yang akan berfungsi. Salah satu penulis menggunakan domain controller sebagai server DNS tanpa forwarder dan hanya mengandalkan root hints. Konfigurasi seperti itu berpotensi menimbulkan masalah, jadi pastikan jalur DNS Anda dapat me-resolve nama publik secara andal.

Langkah 3: Uji TCP 443 ke tujuan yang tepat

Jangan berhenti pada login.microsoftonline.com. Di salah satu utas, endpoint sign-in dan autoupdate.msappproxy.net merespons pada port 443, tetapi servicebus.windows.net tidak. Agen membutuhkan kedua kelompok tujuan tersebut.

Dari Microsoft Learn, persyaratan koneksi keluar untuk cloud publik mencakup:

| Tujuan | Alasan | |---|---| | .msappproxy.net, .servicebus.windows.net | Komunikasi dengan layanan cloud | | .microsoftonline.com, .microsoft.com, .msappproxy.com, .windowsazure.com | Komunikasi dengan layanan cloud | | login.windows.net, login.live.com, aadcdn.msauth.net, aadcdn.msftauth.net | Registrasi | | mscrl.microsoft.com:80, crl.microsoft.com:80, ocsp.msocsp.com:80, www.microsoft.com:80 | Pemeriksaan sertifikat |

Uji port dengan PowerShell:

``powershell Test-NetConnection autoupdate.msappproxy.net -Port 443 Test-NetConnection <your-servicebus-namespace>.servicebus.windows.net -Port 443 Test-NetConnection crl.microsoft.com -Port 80 ``

Layanan tidak berjalan atas nama Anda. Microsoft mencatat bahwa jika firewall Anda menerapkan aturan berdasarkan pengguna asal, Anda harus membuka port untuk layanan Windows yang berjalan sebagai network service. Pengujian yang berhasil di sesi admin interaktif Anda tetap bisa gagal untuk layanan. Balasan di utas kedua menegaskan hal yang sama: uji dari konteks akun layanan, bukan hanya dari sesi admin.

Langkah 4: Tulis aturan firewall berdasarkan nama, bukan alamat IP

Kedua jawaban memperingatkan terhadap aturan berbasis IP. Endpoint berada di balik nama wildcard, dan alamatnya bisa berubah.

  • Izinkan TCP 443 ke semua tujuan yang di-resolve oleh kedua domain wildcard tersebut, termasuk rantai CNAME.
  • Izinkan port 80 untuk host certificate revocation list dan OCSP.
  • Firewall dengan "tanpa pemfilteran" tetap dapat merusak koneksi WebSocket berumur panjang. Periksa log deny dan TLS, bukan hanya daftar aturan.

Langkah 5: Keluarkan alur ini dari inspeksi TLS

Halaman pemecahan masalah cloud sync di Learn menyatakan agar menghindari segala bentuk inspeksi dan terminasi inline pada TLS keluar antara konektor jaringan privat Microsoft Entra dan layanan cloud Application Proxy. Agen berkomunikasi dengan endpoint msappproxy.net, dan balasan di utas September 2026 menyarankan untuk mengecualikan .msappproxy.net dan .servicebus.windows.net dari inspeksi TLS, substitusi sertifikat, autentikasi, dan application proxying. Di salah satu utas, perubahan firewall direncanakan dengan pengecualian inspeksi untuk kedua domain. Penulisnya tetap melaporkan kegagalan setelahnya, jadi lanjutkan juga ke langkah berikutnya alih-alih menganggap firewall sebagai satu-satunya penyebab.

Langkah 6: Periksa rantai sertifikat

Error sertifikat seperti "terminated in a root certificate which is not trusted" dapat merusak TLS. Hasilnya tampak seperti kegagalan web socket atau timeout selama RenewTrustCertificate. Periksa poin-poin berikut:

  1. Buka log operasional CAPI2 dan cari error pembangunan rantai sertifikat di sekitar waktu kegagalan.
  2. Pastikan server dapat terhubung ke host daftar kepercayaan sertifikat Windows Update ctldl.windowsupdate.com, agar sertifikat root dapat diperbarui. Tips ini berasal dari jawaban komunitas, bukan dari halaman prasyarat Learn.
  3. Pastikan port 80 terbuka untuk host CRL dan OCSP di atas.

Langkah 7: Periksa pengaturan TLS dan proxy

Microsoft mewajibkan TLS 1.2 pada server agen sebelum instalasi. Pada server yang lebih lama, TLS 1.2 dan kriptografi yang kuat untuk .NET harus diaktifkan. Halaman Learn menampilkan pengaturan registry, termasuk SchUseStrongCrypto untuk .NET Framework. Microsoft memperingatkan bahwa perubahan pengaturan TLS berdampak pada seluruh forest, jadi rencanakan perubahannya dengan matang.

Jika Anda harus menggunakan proxy keluar, Learn menjelaskan cara menambahkan bagian defaultProxy ke AADConnectProvisioningAgent.exe.config. Pastikan proxy mendukung setidaknya HTTP 1.1 dengan chunked encoding. Kedua penulis melaporkan bahwa tidak ada proxy yang digunakan. Meski begitu, tetap pastikan tidak ada proxy WinHTTP yang diatur.

Langkah 8: Kumpulkan bukti

Jika semua pemeriksaan lolos tetapi agen tetap mengalami timeout, kumpulkan data sebelum menunggu atau menginstal ulang:

  1. Instal modul AADCloudSyncTools.
  2. Reproduksi kegagalannya, lalu jalankan Export-AADCloudSyncToolsLogs. Pengambilan data default berjalan selama tiga menit.
  3. Salin file dari folder trace.
  4. Catat waktu UTC yang tepat saat timeout terjadi.
  5. Ambil log deny dan TLS dari firewall Anda untuk waktu yang sama.

Berikan paket ini kepada Microsoft Support. Kasus dukungan dengan stempel waktu UTC dan log firewall jauh lebih mudah ditangani.

Apa yang terjadi di kedua thread

  • Di thread pertama, seorang administrator mencoba pengaturan proxy, meninjau log firewall, mengubah TLS, membangun ulang certificate store, dan menjalankan perintah perbaikan. Sebuah jawaban kemudian menunjuk ke DNS dan rantai sertifikat. Penulis membuat skrip dengan pemeriksaan yang disarankan. Semua tes lolos dan sinkronisasi kemudian berhasil. Penulis tidak menemukan satu penyebab yang jelas dan menduga ada perubahan di sisi cloud.
  • Di thread kedua, servicebus.windows.net gagal pada TCP 443 sementara endpoint lain berfungsi. Perubahan firewall sudah disiapkan, tetapi tidak ada perbaikan final yang dilaporkan.

Jadi, perlakukan daftar periksa ini sebagai cara untuk menemukan masalah jaringan, bukan sebagai obat yang pasti berhasil. Jika semua pemeriksaan lolos dan statusnya tidak pulih setelah beberapa waktu, buka kasus dukungan.

Terkait

Sumber

Ikuti podcastSpotify

Entities in this article

Microsoft Entra Cloud Sync Microsoft Entra Connect

Related articles

RSS