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

Blog · Mirko Peters

Entra Cloud Sync-agent: timeouts oplossen met een checklist voor netwerk en certificaten

By ·

De Entra Cloud Sync-agent installeert zonder problemen, maar synchroniseert nooit en het portaal toont HybridIdentityServiceAgentTimeout? Werk DNS, firewallregels, TLS-inspectie en certificaatvertrouwen in deze volgorde af.

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

De agent installeert zonder foutmelding. De services draaien. De server heeft internettoegang. Toch start de eerste synchronisatie nooit, en het Microsoft Entra-beheercentrum toont HybridIdentityServiceAgentTimeout.

Belangrijkste punten

  • In de gemelde gevallen betekende HybridIdentityServiceAgentTimeout een verbindingsprobleem tussen de agent en de cloudservice, niet een kapotte agent. Learn koppelt agenttimeouts aan mislukte verbindingen.
  • Controleer eerst DNS, daarna uitgaand TCP 443 naar .msappproxy.net en .servicebus.windows.net, en vervolgens poort 80 voor certificaatintrekkingslijsten.
  • Firewallregels moeten de domeinnamen volgen en niet vaste IP-adressen, en TLS-inspectie moet voor deze verkeersstromen worden omzeild.
  • Verzamel de agenttrace en een AADCloudSyncTools-logbundel voordat je een supportcase opent.

Dit patroon kwam voor in twee afzonderlijke Microsoft-communitydiscussies in 2026. In beide zag de agent er zelf goed uit, en lag het vermoedelijke probleem tussen de server en de cloudservice. Dit artikel vertaalt de gedeelde lessen naar een checklist die je in volgorde kunt doorlopen. Het is een troubleshootinggids, geen officiële Microsoft-procedure, dus controleer elke vereiste tegen de actuele Microsoft Learn-vereisten voor cloud sync.

Hoe de symptomen eruitzien

De meldingen toonden een mix van deze signalen:

  • In het Entra-beheercentrum toont de agentstatus HybridIdentityServiceAgentTimeout.
  • De tracemap van de agent, C:\ProgramData\Microsoft\Azure AD Connect Provisioning Agent\Trace, bevat regels zoals Web socket failed to connect.
  • Het gebeurlijkheidslogboek toont dat de herregistratie van de agent mislukte omdat het verzoek om vertrouwensvernieuwing naar een msappproxy.net-adres een time-out kreeg.
  • De agent-updater kan een naam zoals autoupdate.msappproxy.net niet resolven.
  • Het CAPI2-logboek meldt een certificaatketen die eindigt in een basiscertificaat dat niet vertrouwd wordt.

Eén traceregel, Unable to initialize performance counters, kwam ook voor. In het geaccepteerde antwoord van één discussie werd dit als bijzaak behandeld. De verbindingsfouten waren de echte aanwijzing.

Stap 1: Controleer de agent en de services

Sluit eerst de eenvoudige oorzaken uit.

  1. Open in het Microsoft Entra-beheercentrum Entra ID, daarna Entra Connect, daarna Cloud sync, en controleer of de agent in de lijst staat.
  2. Open op de server services.msc en controleer of Microsoft Entra Connect Agent Updater en Microsoft Entra Provisioning Agent draaien.
  3. Controleer de basis volgens de vereisten van Microsoft: een server die aan het domein is gekoppeld (Windows Server Core wordt niet ondersteund), .NET Framework 4.7.1 of hoger, en een PowerShell-uitvoeringsbeleid van Undefined of RemoteSigned.

Als dit allemaal in orde is, ga je verder. De agent is niet het probleem.

Stap 2: Test de naamresolutie

Het geaccepteerde antwoord in de eerste thread wijst eerst naar DNS, en het antwoord in de tweede thread vraagt ook om tests van de naamresolutie. Voer deze uit vanaf de agentserver:

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

Als namen onder msappproxy.net niet worden opgelost, werkt verder niets. Eén poster gebruikte domeincontrollers als DNS-servers zonder forwarders, die vertrouwden op root hints. Die opzet kan voor problemen zorgen, dus controleer of je DNS-route openbare namen betrouwbaar kan oplossen.

Stap 3: Test TCP 443 naar de juiste bestemmingen

Stop niet bij login.microsoftonline.com. In één thread reageerden de aanmeldeindpunten en autoupdate.msappproxy.net wel op poort 443, maar servicebus.windows.net niet. De agent heeft beide groepen bestemmingen nodig.

Volgens Microsoft Learn omvatten de uitgaande vereisten voor de publieke cloud onder meer:

| Bestemming | Waarvoor | |---|---| | .msappproxy.net, .servicebus.windows.net | Communicatie met de cloudservice | | .microsoftonline.com, .microsoft.com, .msappproxy.com, .windowsazure.com | Communicatie met de cloudservice | | login.windows.net, login.live.com, aadcdn.msauth.net, aadcdn.msftauth.net | Registratie | | mscrl.microsoft.com:80, crl.microsoft.com:80, ocsp.msocsp.com:80, www.microsoft.com:80 | Controles van certificaten |

Test de poorten met 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 ``

De service draait niet onder jouw account. Microsoft meldt dat je, als je firewall regels afdwingt op basis van de oorspronkelijke gebruiker, de poorten moet openzetten voor Windows-services die draaien als netwerkservice. Een test die werkt in je interactieve beheersessie kan voor de service nog steeds mislukken. Het antwoord in de tweede thread maakt hetzelfde punt: test vanuit de context van het serviceaccount, en niet alleen vanuit een beheersessie.

Stap 4: Schrijf firewallregels op naam, niet op IP-adres

Beide antwoorden waarschuwen tegen op IP-adres gebaseerde regels. De eindpunten zitten achter wildcard-namen en de adressen kunnen veranderen.

  • Sta TCP 443 toe naar alles waar de twee wildcard-domeinen naar verwijzen, inclusief CNAME-ketens.
  • Sta poort 80 toe voor de hosts van de certificaatintrekkingslijst (CRL) en OCSP.
  • Een firewall zonder filtering kan nog steeds langlopende WebSocket-verbindingen verstoren. Controleer de deny- en TLS-logs, niet alleen de regellijst.

Stap 5: Haal deze verkeersstromen uit de TLS-inspectie

De pagina over probleemoplossing voor cloudsynchronisatie op Learn adviseert om alle vormen van inline inspectie en beëindiging op uitgaand TLS-verkeer tussen Microsoft Entra private network connectors en de cloudservices van Application Proxy te vermijden. De agent communiceert met eindpunten van msappproxy.net, en een antwoord in de thread van september 2026 adviseerde om .msappproxy.net en .servicebus.windows.net uit te sluiten van TLS-inspectie, certificaatvervanging, authenticatie en application proxying. In één thread was de firewallwijziging gepland met een inspectie-uitzondering voor beide domeinen. De poster meldde daarna toch nog een storing, dus ga ook door met de volgende stappen in plaats van aan te nemen dat de firewall de enige oorzaak is.

Stap 6: Controleer de certificaatketen

Een certificaatfout zoals "terminated in a root certificate which is not trusted" kan TLS verstoren. Het resultaat lijkt op een WebSocket-storing of een time-out tijdens RenewTrustCertificate. Controleer deze punten:

  1. Open het operationele CAPI2-logboek en zoek naar fouten bij het opbouwen van de certificaatketen rond het moment van de storing.
  2. Zorg dat de server het host voor de vertrouwenslijst van certificaten van Windows Update, ctldl.windowsupdate.com, kan bereiken, zodat basiscertificaten kunnen worden bijgewerkt. Deze tip komt uit een antwoord van de community en niet van de vereistenpagina op Learn.
  3. Zorg dat poort 80 open staat voor de hierboven genoemde CRL- en OCSP-hosts.

Stap 7: Controleer de TLS-instellingen en de proxy

Microsoft vereist TLS 1.2 op de agentserver voordat de installatie plaatsvindt. Op oudere servers moeten TLS 1.2 en sterke cryptografie voor .NET worden ingeschakeld. De Learn-pagina toont de registerinstellingen, waaronder SchUseStrongCrypto voor het .NET Framework. Microsoft waarschuwt dat het wijzigen van TLS-instellingen het hele forest beïnvloedt, dus plan de wijziging goed.

Als je toch een uitgaande proxy moet gebruiken, beschrijft Learn hoe je een defaultProxy-sectie toevoegt aan AADConnectProvisioningAgent.exe.config. Controleer of de proxy minimaal HTTP 1.1 met chunked encoding ondersteunt. Beide posters meldden dat er geen proxy in gebruik was. Controleer toch of er geen WinHTTP-proxy is ingesteld.

Stap 8: Verzamel bewijs

Als de controles slagen en de agent nog steeds een timeout geeft, verzamel dan gegevens voordat je wacht of opnieuw installeert:

  1. Installeer de module AADCloudSyncTools.
  2. Reproduceer de fout en voer daarna Export-AADCloudSyncToolsLogs uit. De standaardopname duurt drie minuten.
  3. Kopieer de bestanden uit de tracemap.
  4. Noteer het exacte UTC-tijdstip van de timeout.
  5. Verzamel de deny- en TLS-logs van je firewall voor hetzelfde tijdstip.

Geef dit pakket aan Microsoft Support. Een supportcase met een UTC-tijdstempel en firewalllogs is veel makkelijker op te pakken.

Wat er in de twee threads gebeurde

  • In de eerste thread probeerde een beheerder proxy-instellingen, de controle van firewalllogs, TLS-wijzigingen, een opnieuw opgebouwde certificaatopslag en een reparatieopdracht. Daarna wees een antwoord op DNS en de certificaatketen. De poster schreef een script met de voorgestelde controles. Alle tests slaagden en de synchronisatie werd daarna voltooid. De poster vond geen duidelijke oorzaak en vermoedde dat er aan de cloudkant iets was veranderd.
  • In de tweede thread faalde servicebus.windows.net op TCP 443, terwijl andere eindpunten wel werkten. De firewallwijziging was voorbereid, maar er werd geen definitieve oplossing gemeld.

Zie de checklist dus als een manier om een netwerkprobleem te vinden, niet als een gegarandeerde oplossing. Als alles slaagt en de status na een tijdje niet herstelt, open dan een supportcase.

Gerelateerd

Bronnen

Volg de podcastSpotify

Entities in this article

Microsoft Entra Cloud Sync Microsoft Entra Connect

Related articles

RSS