M365Con 2027 – conferenza online gratuita · 11–22 Jan 2027 · 120 sessions→ m365con.net

Blog · Mirko Peters

Risolvere i timeout dell'agente di Entra Cloud Sync: checklist su rete e certificati

By ·

L'agente di Entra Cloud Sync si installa senza problemi, ma non sincronizza mai e il portale mostra HybridIdentityServiceAgentTimeout? Verifica DNS, regole del firewall, ispezione TLS e attendibilità dei certificati, in questo ordine.

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

L'agente si installa senza errori. I servizi sono in esecuzione. Il server ha accesso a internet. Eppure la prima sincronizzazione non parte mai e l'interfaccia di amministrazione di Microsoft Entra mostra HybridIdentityServiceAgentTimeout.

Punti chiave

  • Nei casi segnalati, HybridIdentityServiceAgentTimeout indicava un problema di connessione tra l'agente e il servizio cloud, non un agente guasto. Learn collega i timeout dell'agente a connessioni non riuscite.
  • Controlla prima il DNS, poi la TCP 443 in uscita verso .msappproxy.net e .servicebus.windows.net, infine la porta 80 per gli elenchi di revoca dei certificati.
  • Le regole del firewall devono seguire i nomi di dominio, non indirizzi IP fissi, e per questi flussi l'ispezione TLS dovrebbe essere esclusa.
  • Raccogli la traccia dell'agente e un pacchetto di log di AADCloudSyncTools prima di aprire un caso di supporto.

Questo schema è comparso in due discussioni distinte della community Microsoft nel 2026. In entrambe, l'agente in sé sembrava a posto e il problema sospettato si trovava tra il server e il servizio cloud. Questo articolo trasforma le lezioni condivise in una checklist da seguire in ordine. È una guida alla risoluzione dei problemi, non una procedura ufficiale Microsoft, quindi verifica ogni requisito nella pagina dei prerequisiti di cloud sync di Microsoft Learn.

Come si presentano i sintomi

Le segnalazioni mostravano una combinazione di questi segnali:

  • Nell'interfaccia di amministrazione di Entra, lo stato dell'agente mostra HybridIdentityServiceAgentTimeout.
  • La cartella delle tracce dell'agente, C:\ProgramData\Microsoft\Azure AD Connect Provisioning Agent\Trace, contiene righe come Web socket failed to connect.
  • Il registro eventi indica che la ri-registrazione dell'agente è fallita perché la richiesta di rinnovo dell'attendibilità verso un indirizzo msappproxy.net è scaduta.
  • L'agente di aggiornamento non riesce a risolvere un nome come autoupdate.msappproxy.net.
  • Il log CAPI2 segnala una catena di certificati che termina con un certificato radice non attendibile.

Compare anche una riga di traccia, Unable to initialize performance counters. Nella risposta accettata di una delle discussioni, è stata trattata come un problema secondario. Gli errori di connessione erano l'indizio reale.

Passo 1: verifica l'agente e i servizi

Escludi prima i casi semplici.

  1. Nell'interfaccia di amministrazione di Microsoft Entra, apri Entra ID, poi Entra Connect, poi Cloud sync, e verifica che l'agente sia presente nell'elenco.
  2. Sul server apri services.msc e verifica che Microsoft Entra Connect Agent Updater e Microsoft Entra Provisioning Agent siano in esecuzione.
  3. Controlla i requisiti di base indicati da Microsoft: un server aggiunto al dominio (Windows Server Core non è supportato), .NET Framework 4.7.1 o successivo e un criterio di esecuzione di PowerShell impostato su Undefined o RemoteSigned.

Se tutto questo è a posto, passa oltre. L'agente non è il problema.

Passo 2: verifica la risoluzione dei nomi

La risposta accettata nel primo thread indica prima il DNS, e la risposta nel secondo thread chiede anch'essa di testare la risoluzione dei nomi. Esegui questi comandi dal server dell'agente:

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

Se i nomi di msappproxy.net non vengono risolti, non funzionerà nient'altro. Un utente ha usato i controller di dominio come server DNS senza forwarder, affidandosi ai root hint. Questa configurazione è una potenziale fonte di problemi, quindi verifica che il percorso DNS riesca a risolvere in modo affidabile i nomi pubblici.

Passo 3: verifica la connettività TCP 443 verso le destinazioni corrette

Non fermarti a login.microsoftonline.com. In un thread, gli endpoint di accesso e autoupdate.msappproxy.net rispondevano sulla porta 443, ma servicebus.windows.net no. L'agente ha bisogno di entrambe le famiglie di destinazioni.

Secondo Microsoft Learn, i requisiti di uscita per il cloud pubblico includono:

| Destinazione | Motivo | |---|---| | .msappproxy.net, .servicebus.windows.net | Comunicazione con il servizio cloud | | .microsoftonline.com, .microsoft.com, .msappproxy.com, .windowsazure.com | Comunicazione con il servizio cloud | | login.windows.net, login.live.com, aadcdn.msauth.net, aadcdn.msftauth.net | Registrazione | | mscrl.microsoft.com:80, crl.microsoft.com:80, ocsp.msocsp.com:80, www.microsoft.com:80 | Verifica dei certificati |

Verifica le porte con 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 ``

Il servizio non viene eseguito con il tuo account. Microsoft precisa che, se il firewall applica le regole in base all'utente di origine, devi aprire le porte per i servizi Windows che girano come servizio di rete. Un test che funziona nella tua sessione amministrativa interattiva può comunque fallire per il servizio. La risposta nel secondo thread sottolinea lo stesso punto: esegui il test nel contesto dell'account del servizio, non solo da una sessione amministrativa.

Passo 4: scrivi le regole del firewall per nome, non per indirizzo IP

Entrambe le risposte sconsigliano le regole basate su IP. Gli endpoint si trovano dietro nomi con caratteri jolly e gli indirizzi possono cambiare.

  • Consenti la connessione TCP 443 verso tutti gli host a cui risolvono i due domini jolly, incluse le catene CNAME.
  • Consenti la porta 80 per gli host della lista di revoca dei certificati (CRL) e OCSP.
  • Un firewall con "nessun filtraggio" può comunque interrompere le connessioni WebSocket di lunga durata. Controlla i log di negazione e TLS, non solo l'elenco delle regole.

Passo 5: escludi questi flussi dall'ispezione TLS

La pagina di risoluzione dei problemi della sincronizzazione cloud di Learn raccomanda di evitare qualsiasi forma di ispezione e terminazione inline sul traffico TLS in uscita tra i connettori di rete privata di Microsoft Entra e i servizi cloud di Application Proxy. L'agente comunica con gli endpoint msappproxy.net, e una risposta nel thread di settembre 2026 consigliava di escludere .msappproxy.net e .servicebus.windows.net dall'ispezione TLS, dalla sostituzione dei certificati, dall'autenticazione e dal proxy applicativo. In un thread, la modifica del firewall era stata pianificata con il bypass dell'ispezione per entrambi i domini. L'autore del post ha comunque segnalato un errore in seguito, quindi prosegui con i passi successivi invece di dare per scontato che il firewall sia l'unica causa.

Passo 6: verifica la catena dei certificati

Un errore di certificato come "terminated in a root certificate which is not trusted" può interrompere la connessione TLS. Il risultato assomiglia a un errore dei WebSocket o a un timeout durante RenewTrustCertificate. Verifica questi punti:

  1. Apri il registro operativo CAPI2 e cerca gli errori di costruzione della catena intorno al momento del guasto.
  2. Assicurati che il server possa raggiungere l'host dell'elenco di attendibilità dei certificati di Windows Update ctldl.windowsupdate.com, così che i certificati radice possano essere aggiornati. Questo suggerimento arriva da una risposta della community, non dalla pagina dei prerequisiti di Learn.
  3. Assicurati che la porta 80 sia aperta verso gli host CRL e OCSP indicati sopra.

Passo 7: verifica le impostazioni TLS e il proxy

Microsoft richiede TLS 1.2 sul server dell'agente prima dell'installazione. Sui server meno recenti è necessario abilitare TLS 1.2 e la crittografia forte per .NET. La pagina di Learn riporta le impostazioni del Registro di sistema, incluso SchUseStrongCrypto per .NET Framework. Microsoft avverte che la modifica delle impostazioni TLS interessa l'intera foresta, quindi pianifica la modifica con attenzione.

Se devi usare un proxy in uscita, Learn descrive come aggiungere una sezione defaultProxy a AADConnectProvisioningAgent.exe.config. Verifica che il proxy supporti almeno HTTP 1.1 con chunked encoding. Entrambi i autori dei post hanno riferito che non era in uso alcun proxy. Conferma comunque che non sia impostato alcun proxy WinHTTP.

Passo 8: raccogli le evidenze

Se i controlli vanno a buon fine e l'agente va comunque in timeout, raccogli i dati prima di attendere o reinstallare:

  1. Installa il modulo AADCloudSyncTools.
  2. Riproduci il problema, quindi esegui Export-AADCloudSyncToolsLogs. La raccolta predefinita dura tre minuti.
  3. Copia i file dalla cartella della traccia.
  4. Annota l'ora UTC esatta del timeout.
  5. Acquisisci i log dei criteri di blocco e TLS dal firewall per lo stesso orario.

Consegna questo pacchetto al supporto Microsoft. Una richiesta di supporto con un timestamp UTC e i log del firewall è molto più facile da gestire.

Cosa è successo nei due thread

  • Nel primo thread, un amministratore ha provato impostazioni del proxy, verifica dei log del firewall, modifiche a TLS, un archivio certificati ricostruito e un comando di riparazione. Una risposta ha quindi indicato il DNS e la catena dei certificati. L'autore del post ha scritto uno script con i controlli suggeriti. Tutti i test sono stati superati e la sincronizzazione è poi andata a buon fine. L'autore non ha individuato una causa chiara e sospetta che qualcosa sia cambiato dal lato cloud.
  • Nel secondo thread, servicebus.windows.net non rispondeva sulla porta TCP 443, mentre gli altri endpoint funzionavano. La modifica del firewall era stata preparata, ma non è stata riportata alcuna soluzione definitiva.

Quindi considera la checklist come un metodo per individuare un problema di rete, non come una soluzione garantita. Se tutti i controlli sono superati e lo stato non si risolve dopo un po' di tempo, apri una richiesta di supporto.

Correlati

Fonti

Segui il podcastSpotify

Entities in this article

Microsoft Entra Cloud Sync Microsoft Entra Connect

Related articles

RSS