Corrija os timeouts do agente do Microsoft Entra Cloud Sync: uma lista de verificação de rede e certificados
By Mirko Peters ·
O agente do Entra Cloud Sync instala sem problemas, mas nunca sincroniza, e o portal mostra HybridIdentityServiceAgentTimeout? Siga a verificação de DNS, regras de firewall, inspeção TLS e confiança em certificados, nessa ordem.
Automatically translated with AI from the original post. Read the English original
O agente instala sem erros. Os serviços estão em execução. O servidor tem acesso à internet. Mesmo assim, a primeira sincronização nunca começa, e o centro de administração do Microsoft Entra mostra HybridIdentityServiceAgentTimeout.
Pontos-chave
- Nos casos relatados, HybridIdentityServiceAgentTimeout indicava um problema de conexão entre o agente e o serviço de nuvem, e não um agente quebrado. O Learn associa os timeouts do agente a conexões que falharam.
- Verifique primeiro o DNS, depois o TCP 443 de saída para .msappproxy.net e .servicebus.windows.net, e por fim a porta 80 para as listas de revogação de certificados.
- As regras de firewall devem seguir os nomes de domínio, e não endereços IP fixos, e a inspeção TLS deve ser ignorada para esses fluxos.
- Colete o trace do agente e um pacote de log do AADCloudSyncTools antes de abrir um chamado de suporte.
Esse padrão apareceu em dois tópicos separados da comunidade Microsoft em 2026. Nos dois, o próprio agente parecia estar bem, e o problema suspeito estava entre o servidor e o serviço de nuvem. Este artigo transforma as lições em comum em uma lista de verificação que você pode seguir em ordem. É um guia de solução de problemas, não um procedimento oficial da Microsoft, então confirme cada requisito nos pré-requisitos do cloud sync no Microsoft Learn.
Como os sintomas aparecem
Os relatos mostraram uma combinação destes sinais:
- No centro de administração do Entra, o status do agente mostra
HybridIdentityServiceAgentTimeout. - A pasta de trace do agente,
C:\ProgramData\Microsoft\Azure AD Connect Provisioning Agent\Trace, contém linhas comoWeb socket failed to connect. - O log de eventos mostra que o novo registro do agente falhou porque a solicitação de renovação de confiança para um endereço
msappproxy.netexpirou. - O atualizador do agente não consegue resolver um nome como
autoupdate.msappproxy.net. - O log do CAPI2 informa uma cadeia de certificados que termina em um certificado raiz não confiável.
Uma linha de trace, Unable to initialize performance counters, também apareceu. Na resposta aceita de um dos tópicos, ela foi tratada como um problema secundário. Os erros de conexão eram a pista real.
Passo 1: confirme o agente e os serviços
Primeiro, descarte os casos simples.
- No centro de administração do Microsoft Entra, abra Entra ID, depois Entra Connect, depois Cloud sync, e confirme que o agente aparece na lista.
- No servidor, abra o
services.msce confirme se Microsoft Entra Connect Agent Updater e Microsoft Entra Provisioning Agent estão em execução. - Verifique o básico dos requisitos da Microsoft: um servidor ingressado no domínio (o Windows Server Core não é suportado), .NET Framework 4.7.1 ou posterior e uma política de execução do PowerShell de
UndefinedouRemoteSigned.
Se tudo isso estiver correto, siga em frente. O agente não é o problema.
Etapa 2: testar a resolução de nomes
A resposta aceita no primeiro tópico aponta primeiro para o DNS, e a resposta no segundo tópico também pede testes de resolução de nomes. Execute estes comandos a partir do servidor do agente:
`` nslookup autoupdate.msappproxy.net nslookup login.microsoftonline.com nslookup <your-servicebus-namespace>.servicebus.windows.net ``
Se os nomes de msappproxy.net não forem resolvidos, nada mais vai funcionar. Um participante usava controladores de domínio como servidores DNS sem encaminhadores e dependia de root hints. Essa configuração é uma candidata a problemas, então verifique se o seu caminho de DNS consegue resolver nomes públicos de forma confiável.
Etapa 3: testar o TCP 443 para os destinos corretos
Não pare em login.microsoftonline.com. Em um dos tópicos, os endpoints de entrada e o autoupdate.msappproxy.net responderam na porta 443, mas o servicebus.windows.net não respondeu. O agente precisa das duas famílias de destinos.
Segundo o Microsoft Learn, os requisitos de saída para a nuvem pública incluem:
| Destino | Finalidade | |---|---| | .msappproxy.net, .servicebus.windows.net | Comunicação com o serviço em nuvem | | .microsoftonline.com, .microsoft.com, .msappproxy.com, .windowsazure.com | Comunicação com o serviço em nuvem | | login.windows.net, login.live.com, aadcdn.msauth.net, aadcdn.msftauth.net | Registro | | mscrl.microsoft.com:80, crl.microsoft.com:80, ocsp.msocsp.com:80, www.microsoft.com:80 | Verificações de certificado |
Teste as portas com o 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 ``
O serviço não é executado com o seu usuário. A Microsoft observa que, se o seu firewall aplica regras por usuário de origem, você deve abrir as portas para os serviços do Windows que são executados como serviço de rede. Um teste que funciona na sua sessão administrativa interativa ainda pode falhar para o serviço. A resposta no segundo tópico faz o mesmo alerta: teste no contexto da conta de serviço, não apenas em uma sessão de administrador.
Etapa 4: criar regras de firewall por nome, não por endereço IP
As duas respostas alertam contra regras baseadas em IP. Os endpoints ficam atrás de nomes com curinga, e os endereços podem mudar.
- Permita o TCP 443 para tudo o que os dois domínios com curinga resolvem, incluindo cadeias de CNAME.
- Permita a porta 80 para os hosts de lista de revogação de certificados e OCSP.
- Um firewall com "nenhum filtro" ainda pode interromper conexões WebSocket de longa duração. Verifique os logs de bloqueio e de TLS, não apenas a lista de regras.
Etapa 5: retire estes fluxos da inspeção TLS
A página de solução de problemas de sincronização em nuvem do Learn recomenda evitar qualquer forma de inspeção e interrupção inline no TLS de saída entre os conectores de rede privada do Microsoft Entra e os serviços em nuvem do Application Proxy. O agente se comunica com os endpoints msappproxy.net, e uma resposta no tópico de setembro de 2026 aconselhava excluir .msappproxy.net e .servicebus.windows.net da inspeção TLS, da substituição de certificados, da autenticação e do proxy de aplicações. Em um dos tópicos, a alteração no firewall foi planejada com desvio da inspeção para os dois domínios. O participante, ainda assim, relatou uma falha depois, então continue também com as próximas etapas em vez de presumir que o firewall é a única causa.
Etapa 6: verifique a cadeia de certificados
Um erro de certificado como "terminated in a root certificate which is not trusted" pode quebrar o TLS. O resultado aparece como falha de WebSocket ou como timeout durante o RenewTrustCertificate. Verifique estes pontos:
- Abra o log operacional do CAPI2 e procure erros de construção de cadeia próximos ao horário da falha.
- Verifique se o servidor consegue acessar o host da lista de confiança de certificados da Windows Update,
ctldl.windowsupdate.com, para que os certificados raiz possam ser atualizados. Esta dica vem de uma resposta da comunidade, não da página de pré-requisitos do Learn. - Verifique se a porta 80 está aberta para os hosts de CRL e OCSP mencionados acima.
Etapa 7: Verifique as configurações de TLS e do proxy
A Microsoft exige TLS 1.2 no servidor do agente antes da instalação. Em servidores mais antigos, é preciso habilitar o TLS 1.2 e a criptografia forte para o .NET. A página do Learn mostra as configurações do registro, incluindo SchUseStrongCrypto para o .NET Framework. A Microsoft alerta que alterar as configurações de TLS afeta toda a floresta, então planeje a mudança com cuidado.
Se você precisar usar um proxy de saída, o Learn descreve como adicionar uma seção defaultProxy ao arquivo AADConnectProvisioningAgent.exe.config. Confirme que o proxy oferece suporte a pelo menos HTTP 1.1 com codificação chunked. Os dois autores relataram que nenhum proxy estava em uso. Ainda assim, confirme que nenhum proxy do WinHTTP está configurado.
Etapa 8: Colete evidências
Se as verificações passarem e o agente continuar expirando, colete dados antes de esperar ou reinstalar:
- Instale o módulo
AADCloudSyncTools. - Reproduza a falha e, em seguida, execute
Export-AADCloudSyncToolsLogs. A captura padrão dura três minutos. - Copie os arquivos da pasta de rastreamento.
- Anote o horário UTC exato do timeout.
- Capture os logs de bloqueio e de TLS do seu firewall para o mesmo período.
Envie este pacote para o Suporte da Microsoft. Um caso de suporte com carimbo de data/hora UTC e logs do firewall é muito mais fácil de analisar.
O que aconteceu nas duas discussões
- Na primeira discussão, um administrador testou configurações de proxy, revisou logs do firewall, alterou o TLS, reconstruiu o repositório de certificados e executou um comando de reparo. Depois, uma resposta apontou para o DNS e para a cadeia de certificados. O autor escreveu um script com as verificações sugeridas. Todos os testes passaram e a sincronização então foi concluída. O autor não encontrou uma causa clara e suspeitou que algo tenha mudado do lado da nuvem.
- Na segunda discussão,
servicebus.windows.netfalhou na TCP 443, enquanto os outros endpoints funcionavam. A alteração no firewall foi preparada, mas nenhuma solução final foi relatada.
Por isso, trate a checklist como uma forma de encontrar um problema de rede, e não como uma solução garantida. Se tudo passar e o status não se recuperar após algum tempo, abra um caso de suporte.
Relacionados
Fontes
- Microsoft Learn: pré-requisitos do Cloud Sync
- Microsoft Learn: solução de problemas do Cloud Sync
- Microsoft Q&A: problema com o Entra Cloud Sync (abril de 2026)
- Microsoft Community Hub: Problema estranho com o Entra Connect Cloud Sync HybridIdentityServiceAgentTimeout (setembro de 2026)