Naprawianie limitów czasu agenta Entra Cloud Sync: lista kontrolna sieci i certyfikatów
By Mirko Peters ·
Agent Entra Cloud Sync instaluje się bez problemu, ale nigdy nie synchronizuje, a portal pokazuje HybridIdentityServiceAgentTimeout? Sprawdź po kolei: DNS, reguły zapory, inspekcję TLS i zaufanie certyfikatów.
Automatically translated with AI from the original post. Read the English original
Agent instaluje się bez błędu. Usługi są uruchomione. Serwer ma dostęp do internetu. Mimo to pierwsza synchronizacja nigdy się nie rozpoczyna, a centrum administracyjne Microsoft Entra pokazuje HybridIdentityServiceAgentTimeout.
Najważniejsze wnioski
- W zgłaszanych przypadkach HybridIdentityServiceAgentTimeout oznaczał problem z połączeniem między agentem a usługą w chmurze, a nie uszkodzonego agenta. Learn wiąże przekroczenia limitu czasu agenta z nieudanymi połączeniami.
- Najpierw sprawdź DNS, następnie wychodzący protokół TCP 443 do .msappproxy.net i .servicebus.windows.net, a na końcu port 80 dla list unieważnionych certyfikatów.
- Reguły zapory muszą opierać się na nazwach domen, a nie na stałych adresach IP, a inspekcja TLS powinna być pomijana dla tych przepływów.
- Przed otwarciem zgłoszenia do pomocy technicznej zbierz ślad agenta i pakiet dziennika AADCloudSyncTools.
Ten schemat pojawił się w dwóch osobnych wątkach społeczności Microsoft w 2026 roku. W obu agent sam w sobie wyglądał dobrze, a podejrzewany problem leżał między serwerem a usługą w chmurze. Ten artykuł przekłada wspólne wnioski na listę kontrolną, którą możesz wykonać po kolei. To przewodnik po rozwiązywaniu problemów, a nie oficjalna procedura Microsoft, dlatego potwierdź każde wymaganie w aktualnych wymaganiach wstępnych Microsoft Learn dotyczących synchronizacji w chmurze.
Jak wyglądają objawy
Zgłoszenia pokazywały mieszankę następujących sygnałów:
- W centrum administracyjnym Microsoft Entra stan agenta pokazuje
HybridIdentityServiceAgentTimeout. - Folder śladów agenta,
C:\ProgramData\Microsoft\Azure AD Connect Provisioning Agent\Trace, zawiera wiersze takie jakWeb socket failed to connect. - Dziennik zdarzeń pokazuje, że ponowna rejestracja agenta nie powiodła się, ponieważ żądanie odnowienia zaufania do adresu
msappproxy.netprzekroczyło limit czasu. - Aktualizator agenta nie może rozwiązać nazwy, takiej jak
autoupdate.msappproxy.net. - Dziennik CAPI2 zgłasza łańcuch certyfikatów, który kończy się certyfikatem głównym, który nie jest zaufany.
Pojawił się też jeden wiersz śladu: Unable to initialize performance counters. W zaakceptowanej odpowiedzi w jednym wątku potraktowano to jako poboczny problem. Prawdziwą wskazówką były błędy połączenia.
Krok 1: Potwierdź agenta i usługi
Najpierw wyklucz proste przyczyny.
- W centrum administracyjnym Microsoft Entra otwórz Entra ID, następnie Entra Connect, potem Synchronizacja w chmurze i sprawdź, czy agent jest na liście.
- Na serwerze otwórz
services.msci sprawdź, czy usługi Microsoft Entra Connect Agent Updater oraz Microsoft Entra Provisioning Agent są uruchomione. - Sprawdź podstawowe wymagania z dokumentacji Microsoft: serwer dołączony do domeny (Windows Server Core nie jest obsługiwany), .NET Framework 4.7.1 lub nowszy oraz zasady wykonywania PowerShell ustawione na
UndefinedlubRemoteSigned.
Jeśli wszystko jest w porządku, przejdź dalej. Agent nie jest problemem.
Krok 2: Test rozpoznawania nazw
Zaakceptowana odpowiedź w pierwszym wątku wskazuje najpierw na DNS, a odpowiedź w drugim wątku również zachęca do testów rozpoznawania nazw. Uruchom je z serwera agenta:
`` nslookup autoupdate.msappproxy.net nslookup login.microsoftonline.com nslookup <your-servicebus-namespace>.servicebus.windows.net ``
Jeśli nazwy msappproxy.net nie są rozpoznawane, żadna inna część nie zadziała. Jeden z autorów wpisów używał kontrolerów domeny jako serwerów DNS bez przekaźników (forwarders), polegając na root hints. Taka konfiguracja może sprawiać problemy, dlatego sprawdź, czy ścieżka DNS niezawodnie rozpoznaje nazwy publiczne.
Krok 3: Test połączeń TCP 443 do właściwych miejsc docelowych
Nie poprzestawaj na login.microsoftonline.com. W jednym wątku punkty logowania i autoupdate.msappproxy.net odpowiadały na porcie 443, ale servicebus.windows.net już nie. Agent potrzebuje obu grup miejsc docelowych.
Z dokumentacji Microsoft Learn wynika, że wymagania dotyczące ruchu wychodzącego dla chmury publicznej obejmują:
| Miejsce docelowe | Przeznaczenie | |---|---| | .msappproxy.net, .servicebus.windows.net | Komunikacja z usługą w chmurze | | .microsoftonline.com, .microsoft.com, .msappproxy.com, .windowsazure.com | Komunikacja z usługą w chmurze | | login.windows.net, login.live.com, aadcdn.msauth.net, aadcdn.msftauth.net | Rejestracja | | mscrl.microsoft.com:80, crl.microsoft.com:80, ocsp.msocsp.com:80, www.microsoft.com:80 | Sprawdzanie certyfikatów |
Przetestuj porty za pomocą 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 ``
Usługa nie działa na Twoim koncie. Microsoft zwraca uwagę, że jeśli zapora wymusza reguły według użytkownika źródłowego, porty trzeba otworzyć dla usług Windows działających jako usługa sieciowa. Test, który działa w interaktywnej sesji administratora, może nadal kończyć się niepowodzeniem dla usługi. Odpowiedź w drugim wątku podkreśla to samo: testuj w kontekście konta usługi, a nie tylko z sesji administratora.
Krok 4: Twórz reguły zapory według nazw, a nie adresów IP
Obie odpowiedzi ostrzegają przed regułami opartymi na adresach IP. Punkty końcowe znajdują się za nazwami z symbolami wieloznacznymi, a adresy mogą się zmieniać.
- Zezwól na TCP 443 do wszystkich adresów, na które rozwiązują się dwie domeny z symbolami wieloznacznymi, w tym do łańcuchów CNAME.
- Zezwól na port 80 dla hostów listy unieważnionych certyfikatów (CRL) i OCSP.
- Zapora z opcją „bez filtrowania” może mimo to przerywać długotrwałe połączenia WebSocket. Sprawdź logi odrzuceń i TLS, a nie tylko listę reguł.
Krok 5: Wyłącz inspekcję TLS dla tych przepływów
Strona Learn dotycząca rozwiązywania problemów z synchronizacją w chmurze zaleca unikanie wszelkich form inspekcji i terminacji w linii dla ruchu TLS wychodzącego między łącznikami prywatnej sieci Microsoft Entra a usługami chmurowymi Application Proxy. Agent komunikuje się z punktami końcowymi msappproxy.net, a odpowiedź we wrześniowym wątku z 2026 roku radziła wykluczyć .msappproxy.net oraz .servicebus.windows.net z inspekcji TLS, podstawiania certyfikatów, uwierzytelniania i pośredniczenia aplikacji. W jednym wątku zmiana zapory była planowana wraz z pominięciem inspekcji dla obu domen. Autor wpisu mimo to zgłosił awarię po zmianie, więc kontynuuj kolejne kroki zamiast zakładać, że zapora jest jedyną przyczyną.
Krok 6: Sprawdź łańcuch certyfikatów
Błąd certyfikatu, taki jak „terminated in a root certificate which is not trusted”, może przerwać TLS. Objawia się to jako błąd WebSocket lub przekroczenie czasu podczas RenewTrustCertificate. Sprawdź następujące punkty:
- Otwórz operacyjny dziennik CAPI2 i poszukaj błędów budowania łańcucha certyfikatów w okolicy czasu wystąpienia awarii.
- Upewnij się, że serwer może połączyć się z hostem listy zaufanych certyfikatów Windows Update
ctldl.windowsupdate.com, aby główne certyfikaty mogły być aktualizowane. Ta wskazówka pochodzi z odpowiedzi społeczności, a nie ze strony Learn z wymaganiami wstępnymi. - Upewnij się, że port 80 jest otwarty dla wyżej wymienionych hostów CRL i OCSP.
Krok 7: Sprawdź ustawienia TLS i serwer proxy
Firma Microsoft wymaga protokołu TLS 1.2 na serwerze agenta przed instalacją. Na starszych serwerach trzeba włączyć TLS 1.2 oraz silną kryptografię dla platformy .NET. Strona Learn pokazuje ustawienia rejestru, w tym SchUseStrongCrypto dla .NET Framework. Microsoft ostrzega, że zmiana ustawień TLS wpływa na cały las, więc zaplanuj tę zmianę.
Jeśli musisz korzystać z wychodzącego serwera proxy, Learn opisuje dodanie sekcji defaultProxy do pliku AADConnectProvisioningAgent.exe.config. Sprawdź, czy proxy obsługuje co najmniej HTTP 1.1 z kodowaniem chunked. Obaj autorzy wpisów zgłosili, że proxy nie było używane. Mimo to potwierdź, że nie ustawiono proxy WinHTTP.
Krok 8: Zbierz dowody
Jeśli testy przejdą, a agent nadal kończy się limitem czasu, zbierz dane, zanim poczekasz lub zainstalujesz agenta ponownie:
- Zainstaluj moduł
AADCloudSyncTools. - Odtwórz błąd, a następnie uruchom
Export-AADCloudSyncToolsLogs. Domyślne przechwytywanie trwa trzy minuty. - Skopiuj pliki z folderu śladów.
- Zapisz dokładny czas UTC przekroczenia limitu czasu.
- Przechwyć logi odrzuceń i TLS z zapory dla tego samego okresu.
Przekaż ten pakiet do pomocy technicznej Microsoft. Zgłoszenie z sygnaturą czasową UTC i logami zapory jest znacznie łatwiejsze do obsłużenia.
Co wydarzyło się w obu wątkach
- W pierwszym wątku administrator testował ustawienia proxy, przeglądał logi zapory, zmieniał ustawienia TLS, odbudowywał magazyn certyfikatów i uruchamiał polecenie naprawcze. Odpowiedź wskazała następnie DNS i łańcuch certyfikatów. Autor wpisu napisał skrypt z zasugerowanymi sprawdzeniami. Wszystkie testy zakończyły się powodzeniem i synchronizacja została ukończona. Autor nie znalazł jednej, jasnej przyczyny i podejrzewa, że coś zmieniło się po stronie chmury.
- W drugim wątku
servicebus.windows.netnie działał na TCP 443, podczas gdy inne punkty końcowe działały. Zmiana w zaporze została przygotowana, ale nie podano ostatecznego rozwiązania.
Traktuj więc listę kontrolną jako sposób na znalezienie problemu z siecią, a nie jako gwarantowane rozwiązanie. Jeśli wszystkie testy przejdą, a stan nie wróci do normy po chwili, otwórz zgłoszenie do pomocy technicznej.
Powiązane
Źródła
- Microsoft Learn: wymagania wstępne synchronizacji w chmurze
- Microsoft Learn: rozwiązywanie problemów z synchronizacją w chmurze
- Microsoft Q&A: problem z Entra Cloud Sync (kwiecień 2026)
- Microsoft Community Hub: dziwny problem z Entra Connect Cloud Sync HybridIdentityServiceAgentTimeout (wrzesień 2026)