Timeouts beim Entra Cloud Sync Agent beheben: Eine Checkliste für Netzwerk und Zertifikate
Von Mirko Peters ·
Der Entra Cloud Sync Agent lässt sich fehlerfrei installieren, synchronisiert aber nie, und das Portal zeigt HybridIdentityServiceAgentTimeout an? Arbeiten Sie DNS, Firewallregeln, TLS-Inspektion und Zertifikatsvertrauen in dieser Reihenfolge durch.
Automatisch mit KI aus dem Originalbeitrag übersetzt. Englisches Original lesen
Der Agent wird ohne Fehler installiert. Die Dienste laufen. Der Server hat Internetzugang. Trotzdem startet die erste Synchronisierung nie, und das Microsoft Entra Admin Center zeigt HybridIdentityServiceAgentTimeout an.
Das Wichtigste in Kürze
- In den gemeldeten Fällen bedeutete HybridIdentityServiceAgentTimeout ein Verbindungsproblem zwischen Agent und Cloud-Dienst, nicht einen defekten Agent. Learn führt Agent-Timeouts auf fehlgeschlagene Verbindungen zurück.
- Prüfen Sie zuerst die DNS-Auflösung, danach ausgehend TCP 443 zu .msappproxy.net und .servicebus.windows.net und anschließend Port 80 für die Sperrlisten.
- Firewallregeln müssen den Domainnamen folgen und nicht festen IP-Adressen. Die TLS-Inspektion sollte für diese Datenflüsse umgangen werden.
- Sammeln Sie den Agent-Trace und ein AADCloudSyncTools-Protokollpaket, bevor Sie einen Supportfall eröffnen.
Dieses Muster trat 2026 in zwei voneinander unabhängigen Microsoft-Community-Threads auf. In beiden wirkte der Agent selbst unauffällig, und das vermutete Problem lag zwischen Server und Cloud-Dienst. Dieser Artikel fasst die gemeinsamen Erkenntnisse in einer Checkliste zusammen, die Sie der Reihe nach abarbeiten können. Es handelt sich um einen Leitfaden zur Fehlerbehebung, nicht um ein offizielles Microsoft-Verfahren. Prüfen Sie jede Anforderung daher anhand der aktuellen Microsoft Learn-Voraussetzungen für Cloud-Synchronisierung.
So zeigen sich die Symptome
Die Berichte zeigten eine Mischung aus diesen Anzeichen:
- Im Entra Admin Center zeigt der Agent-Status
HybridIdentityServiceAgentTimeoutan. - Der Trace-Ordner des Agents,
C:\ProgramData\Microsoft\Azure AD Connect Provisioning Agent\Trace, enthält Zeilen wieWeb socket failed to connect. - Das Ereignisprotokoll zeigt, dass die erneute Registrierung des Agents fehlschlug, weil die Anfrage zur Erneuerung des Vertrauens an eine Adresse unter
msappproxy.netdas Zeitlimit überschritt. - Der Agent-Updater kann einen Namen wie
autoupdate.msappproxy.netnicht auflösen. - Das CAPI2-Protokoll meldet eine Zertifikatskette, die in einem nicht vertrauenswürdigen Stammzertifikat endet.
Außerdem erschien die Tracezeile Unable to initialize performance counters. In der akzeptierten Antwort eines Threads wurde sie als Nebenproblem behandelt. Die Verbindungsfehler waren der eigentliche Hinweis.
Schritt 1: Agent und Dienste prüfen
Schließen Sie zunächst die einfachen Ursachen aus.
- Öffnen Sie im Microsoft Entra Admin Center Entra ID, dann Entra Connect und Cloudsynchronisierung und prüfen Sie, ob der Agent aufgelistet ist.
- Öffnen Sie auf dem Server
services.mscund prüfen Sie, ob Microsoft Entra Connect Agent Updater und Microsoft Entra Provisioning Agent ausgeführt werden. - Prüfen Sie die Grundlagen laut den Anforderungen von Microsoft: einen domänenbeigetretenen Server (Windows Server Core wird nicht unterstützt), .NET Framework 4.7.1 oder höher und eine PowerShell-Ausführungsrichtlinie von
UndefinedoderRemoteSigned.
Wenn all das passt, machen Sie weiter. Der Agent ist nicht das Problem.
Schritt 2: Namensauflösung testen
Die akzeptierte Antwort im ersten Thread verweist zuerst auf DNS, und auch die Antwort im zweiten Thread fordert Tests der Namensauflösung. Führen Sie diese vom Agent-Server aus:
`` nslookup autoupdate.msappproxy.net nslookup login.microsoftonline.com nslookup <your-servicebus-namespace>.servicebus.windows.net ``
Wenn sich msappproxy.net-Namen nicht auflösen lassen, funktioniert nichts anderes. Ein Teilnehmer nutzte Domänencontroller als DNS-Server ohne Weiterleitungen (Forwarder), die sich auf Root-Hints verließen. Eine solche Konfiguration ist anfällig für Probleme. Prüfen Sie daher, ob Ihr DNS-Pfad öffentliche Namen zuverlässig auflösen kann.
Schritt 3: TCP 443 zu den richtigen Zielen testen
Belassen Sie es nicht bei login.microsoftonline.com. In einem Thread antworteten Anmelde-Endpunkte und autoupdate.msappproxy.net auf Port 443, servicebus.windows.net dagegen nicht. Der Agent benötigt beide Zielgruppen.
Laut Microsoft Learn gehören zu den ausgehenden Anforderungen für die Public Cloud unter anderem:
| Ziel | Zweck | |---|---| | .msappproxy.net, .servicebus.windows.net | Kommunikation mit dem Cloud-Dienst | | .microsoftonline.com, .microsoft.com, .msappproxy.com, .windowsazure.com | Kommunikation mit dem Cloud-Dienst | | login.windows.net, login.live.com, aadcdn.msauth.net, aadcdn.msftauth.net | Registrierung | | mscrl.microsoft.com:80, crl.microsoft.com:80, ocsp.msocsp.com:80, www.microsoft.com:80 | Zertifikatsprüfungen |
Testen Sie die Ports mit 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 ``
Der Dienst läuft nicht unter Ihrem Benutzerkonto. Microsoft weist darauf hin, dass Sie für Windows-Dienste, die als Netzwerkdienst laufen, die Ports öffnen müssen, wenn Ihre Firewall Regeln nach dem ursprünglichen Benutzer durchsetzt. Ein Test, der in Ihrer interaktiven Administratorsitzung funktioniert, kann für den Dienst trotzdem fehlschlagen. Die Antwort im zweiten Thread betont denselben Punkt: Testen Sie im Kontext des Dienstkontos und nicht nur aus einer Administratorsitzung heraus.
Schritt 4: Firewallregeln nach Namen statt nach IP-Adressen schreiben
Beide Antworten warnen vor IP-basierten Regeln. Die Endpunkte liegen hinter Platzhalter-Namen, und ihre Adressen können sich ändern.
- Erlauben Sie TCP 443 zu allen Zielen, in die sich die beiden Platzhalter-Domänen auflösen, einschließlich CNAME-Ketten.
- Erlauben Sie Port 80 für die Sperrlisten (CRL) und OCSP-Hosts.
- Eine Firewall ohne Filterung kann trotzdem langlebige WebSocket-Verbindungen unterbrechen. Prüfen Sie die Deny- und TLS-Protokolle und nicht nur die Regelliste.
Schritt 5: Diese Verbindungen von der TLS-Inspektion ausnehmen
Die Anleitung zur Fehlerbehebung bei der Cloud-Synchronisierung auf Microsoft Learn empfiehlt, jede Form von Inline-Inspektion und -Terminierung für ausgehendes TLS zwischen Microsoft Entra Private Network Connectors und den Cloud-Diensten von Application Proxy zu vermeiden. Der Agent kommuniziert mit den Endpunkten msappproxy.net, und eine Antwort im Thread vom September 2026 riet dazu, .msappproxy.net und .servicebus.windows.net von TLS-Inspektion, Zertifikatsersetzung, Authentifizierung und Anwendungsproxying auszunehmen. In einem Thread war die Firewalländerung mit einer Inspektionsausnahme für beide Domänen geplant. Der Poster meldete danach trotzdem einen Fehler. Arbeiten Sie daher auch die nächsten Schritte ab, statt anzunehmen, dass die Firewall die einzige Ursache ist.
Schritt 6: Zertifikatskette prüfen
Ein Zertifikatsfehler wie „terminated in a root certificate which is not trusted“ kann TLS stören. Das Ergebnis ähnelt einem WebSocket-Fehler oder einem Timeout während RenewTrustCertificate. Prüfen Sie diese Punkte:
- Öffnen Sie das CAPI2-Betriebsprotokoll und suchen Sie nach Fehlern beim Erstellen der Zertifikatskette rund um den Zeitpunkt des Fehlers.
- Stellen Sie sicher, dass der Server den Host der Vertrauensliste für Windows-Update-Zertifikate
ctldl.windowsupdate.comerreichen kann, damit sich Stammzertifikate aktualisieren können. Dieser Tipp stammt aus einer Antwort in der Community und nicht von der Learn-Seite zu den Voraussetzungen. - Stellen Sie sicher, dass Port 80 zu den oben genannten CRL- und OCSP-Hosts offen ist.
Schritt 7: TLS-Einstellungen und Proxy prüfen
Microsoft setzt vor der Installation TLS 1.2 auf dem Agent-Server voraus. Auf älteren Servern müssen TLS 1.2 und starke Kryptografie für .NET aktiviert werden. Die Learn-Seite zeigt die Registrierungseinstellungen, einschließlich SchUseStrongCrypto für das .NET Framework. Microsoft warnt, dass Änderungen an den TLS-Einstellungen die gesamte Gesamtstruktur betreffen. Planen Sie die Änderung deshalb sorgfältig.
Wenn Sie einen ausgehenden Proxy verwenden müssen, beschreibt Learn, einen Abschnitt defaultProxy in AADConnectProvisioningAgent.exe.config hinzuzufügen. Prüfen Sie, ob der Proxy mindestens HTTP 1.1 mit Chunked Encoding unterstützt. Beide Beitragsverfasser berichteten, dass kein Proxy verwendet wurde. Bestätigen Sie trotzdem, dass kein WinHTTP-Proxy gesetzt ist.
Schritt 8: Nachweise sammeln
Wenn die Prüfungen erfolgreich sind und der Agent trotzdem ein Timeout meldet, sammeln Sie Daten, bevor Sie warten oder neu installieren:
- Installieren Sie das Modul
AADCloudSyncTools. - Reproduzieren Sie den Fehler und führen Sie anschließend
Export-AADCloudSyncToolsLogsaus. Die Standarderfassung läuft drei Minuten. - Kopieren Sie die Dateien aus dem Trace-Ordner.
- Notieren Sie die genaue UTC-Zeit des Timeouts.
- Exportieren Sie zur selben Zeit die Deny- und TLS-Logs Ihrer Firewall.
Geben Sie dieses Paket an den Microsoft Support weiter. Ein Supportfall mit UTC-Zeitstempel und Firewall-Logs lässt sich deutlich leichter bearbeiten.
Was in den beiden Threads passiert ist
- Im ersten Thread probierte ein Administrator Proxy-Einstellungen, die Auswertung der Firewall-Logs, TLS-Änderungen, einen neu aufgebauten Zertifikatspeicher und einen Reparaturbefehl aus. Eine Antwort wies anschließend auf DNS und die Zertifikatkette hin. Der Verfasser schrieb daraufhin ein Skript mit den vorgeschlagenen Prüfungen. Alle Tests waren erfolgreich, und danach wurde die Synchronisierung abgeschlossen. Der Verfasser fand keine eindeutige Ursache und vermutete, dass sich auf Cloud-Seite etwas geändert hat.
- Im zweiten Thread schlug die Verbindung zu
servicebus.windows.netauf TCP 443 fehl, während andere Endpunkte funktionierten. Die Firewall-Änderung war vorbereitet, aber es wurde keine endgültige Lösung gemeldet.
Betrachten Sie die Checkliste daher als Hilfe, um ein Netzwerkproblem einzugrenzen, nicht als garantierte Lösung. Wenn alle Prüfungen erfolgreich sind und sich der Status nach einiger Zeit nicht erholt, eröffnen Sie einen Supportfall.
Verwandte Inhalte
Quellen
- Microsoft Learn: Voraussetzungen für Cloud Sync
- Microsoft Learn: Problembehandlung für Cloud Sync
- Microsoft Q&A: Problem mit Entra Cloud Sync (April 2026)
- Microsoft Community Hub: Seltsames Problem mit Entra Connect Cloud Sync HybridIdentityServiceAgentTimeout (September 2026)