Solucionar los tiempos de espera del agente de Entra Cloud Sync: lista de comprobación de red y certificados
Por Mirko Peters ·
¿El agente de Entra Cloud Sync se instala bien, pero nunca sincroniza y el portal muestra HybridIdentityServiceAgentTimeout? Revisa DNS, reglas de firewall, inspección TLS y confianza en certificados, en este orden.
Traducido automáticamente con IA a partir de la publicación original. Lee el original en inglés
El agente se instala sin errores. Los servicios están en ejecución. El servidor tiene acceso a Internet. Aun así, la primera sincronización nunca empieza y el Centro de administración de Microsoft Entra muestra HybridIdentityServiceAgentTimeout.
Puntos clave
- En los casos reportados, HybridIdentityServiceAgentTimeout indicaba un problema de conexión entre el agente y el servicio en la nube, no un agente roto. Learn vincula los tiempos de espera del agente con conexiones fallidas.
- Comprueba primero el DNS, después TCP 443 saliente hacia .msappproxy.net y .servicebus.windows.net, y por último el puerto 80 para las listas de revocación de certificados.
- Las reglas de firewall deben seguir los nombres de dominio, no direcciones IP fijas, y la inspección TLS debe omitirse en estos flujos.
- Recopila el seguimiento del agente y un paquete de registros de AADCloudSyncTools antes de abrir un caso de soporte.
Este patrón apareció en dos hilos distintos de la comunidad de Microsoft en 2026. En ambos, el propio agente parecía correcto, y el problema sospechado estaba entre el servidor y el servicio en la nube. Este artículo convierte las lecciones comunes en una lista de comprobación que puedes seguir en orden. Es una guía de solución de problemas, no un procedimiento oficial de Microsoft, así que confirma cada requisito con los requisitos previos de cloud sync en Microsoft Learn vigentes.
Qué aspecto tienen los síntomas
Los informes mostraban una combinación de estas señales:
- En el Centro de administración de Microsoft Entra, el estado del agente muestra
HybridIdentityServiceAgentTimeout. - La carpeta de seguimiento del agente,
C:\ProgramData\Microsoft\Azure AD Connect Provisioning Agent\Trace, contiene líneas comoWeb socket failed to connect. - El registro de eventos muestra que el nuevo registro del agente falló porque la solicitud de renovación de confianza a una dirección
msappproxy.netagotó el tiempo de espera. - El actualizador del agente no puede resolver un nombre como
autoupdate.msappproxy.net. - El registro de CAPI2 informa de una cadena de certificados que termina en un certificado raíz que no es de confianza.
También apareció una línea de seguimiento, Unable to initialize performance counters. En la respuesta aceptada de uno de los hilos, se trató como un problema secundario. Los errores de conexión eran la pista real.
Paso 1: confirma el agente y los servicios
Primero descarta los casos sencillos.
- En el Centro de administración de Microsoft Entra, abre Entra ID, después Entra Connect y luego Sincronización en la nube, y comprueba que el agente aparece en la lista.
- En el servidor, abre
services.mscy confirma que Microsoft Entra Connect Agent Updater y Microsoft Entra Provisioning Agent están en ejecución. - Revisa lo básico según los requisitos de Microsoft: un servidor unido al dominio (Windows Server Core no es compatible), .NET Framework 4.7.1 o posterior, y una directiva de ejecución de PowerShell de
UndefinedoRemoteSigned.
Si todo esto está bien, continúa. El agente no es el problema.
Paso 2: Prueba la resolución de nombres
La respuesta aceptada del primer hilo apunta primero al DNS, y la respuesta del segundo hilo también pide pruebas de resolución de nombres. Ejecútalas desde el servidor del agente:
`` nslookup autoupdate.msappproxy.net nslookup login.microsoftonline.com nslookup <your-servicebus-namespace>.servicebus.windows.net ``
Si los nombres de msappproxy.net no se resuelven, nada más funcionará. Un participante usaba controladores de dominio como servidores DNS sin reenviadores y dependía de los root hints. Esa configuración es candidata a dar problemas, así que comprueba que tu ruta DNS puede resolver nombres públicos de forma fiable.
Paso 3: Prueba TCP 443 hacia los destinos correctos
No te quedes solo en login.microsoftonline.com. En un hilo, los endpoints de inicio de sesión y autoupdate.msappproxy.net respondían por el puerto 443, pero servicebus.windows.net no. El agente necesita las dos familias de destinos.
Según Microsoft Learn, los requisitos de salida para la nube pública incluyen:
| Destino | Motivo | |---|---| | .msappproxy.net, .servicebus.windows.net | Comunicación con el servicio en la nube | | .microsoftonline.com, .microsoft.com, .msappproxy.com, .windowsazure.com | Comunicación con el servicio en la nube | | 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 | Comprobaciones de certificados |
Prueba los puertos 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 ``
El servicio no se ejecuta con tu cuenta. Microsoft indica que, si tu firewall aplica reglas según el usuario de origen, debes abrir los puertos para los servicios de Windows que se ejecutan como servicio de red. Una prueba que funciona en tu sesión interactiva de administrador puede seguir fallando para el servicio. La respuesta del segundo hilo hace el mismo planteamiento: prueba desde el contexto de la cuenta de servicio, no solo desde una sesión de administrador.
Paso 4: Escribe las reglas de firewall por nombre, no por dirección IP
Ambas respuestas advierten contra las reglas basadas en IP. Los endpoints se encuentran detrás de nombres con comodín, y las direcciones pueden cambiar.
- Permite TCP 443 hacia todo lo que resuelvan los dos dominios con comodín, incluidas las cadenas CNAME.
- Permite el puerto 80 para las listas de revocación de certificados y los hosts de OCSP.
- Un firewall con «sin filtrado» también puede romper las conexiones WebSocket de larga duración. Revisa los registros de denegaciones y de TLS, no solo la lista de reglas.
Paso 5: Excluye estos flujos de la inspección TLS
La página de solución de problemas de sincronización en la nube de Learn indica que se deben evitar todas las formas de inspección y terminación en línea del TLS saliente entre los conectores de red privada de Microsoft Entra y los servicios en la nube de Application Proxy. El agente se comunica con los endpoints de msappproxy.net, y una respuesta del hilo de septiembre de 2026 recomendaba excluir .msappproxy.net y .servicebus.windows.net de la inspección TLS, la sustitución de certificados, la autenticación y el proxy de aplicaciones. En un hilo, el cambio de firewall se planificó con una omisión de inspección para ambos dominios. El autor, aun así, comunicó un fallo después, así que continúa también con los siguientes pasos en lugar de dar por hecho que el firewall es la única causa.
Paso 6: Comprueba la cadena de certificados
Un error de certificado como «terminated in a root certificate which is not trusted» puede romper TLS. El resultado parece un fallo de WebSocket o un timeout durante RenewTrustCertificate. Comprueba estos puntos:
- Abre el registro operativo de CAPI2 y busca errores de construcción de cadenas alrededor del momento del fallo.
- Asegúrate de que el servidor pueda acceder al host de la lista de confianza de certificados de Windows Update
ctldl.windowsupdate.com, para que los certificados raíz se puedan actualizar. Este consejo procede de una respuesta de la comunidad, no de la página de requisitos previos de Learn. - Asegúrate de que el puerto 80 esté abierto para los hosts de CRL y OCSP mencionados arriba.
Paso 7: Comprueba la configuración de TLS y el proxy
Microsoft exige TLS 1.2 en el servidor del agente antes de la instalación. En servidores más antiguos, hay que habilitar TLS 1.2 y la criptografía sólida para .NET. La página de Learn muestra la configuración del registro, incluida SchUseStrongCrypto para .NET Framework. Microsoft advierte de que cambiar la configuración de TLS afecta a todo el bosque, así que planifica el cambio.
Si necesitas usar un proxy de salida, Learn describe cómo añadir una sección defaultProxy en AADConnectProvisioningAgent.exe.config. Comprueba que el proxy admita al menos HTTP 1.1 con transferencia fragmentada (chunked). Ambos autores de las publicaciones indicaron que no había ningún proxy en uso. Aun así, confirma que no hay ningún proxy de WinHTTP configurado.
Paso 8: Recopila pruebas
Si las comprobaciones son correctas y el agente sigue agotando el tiempo de espera, recopila datos antes de esperar o reinstalar:
- Instala el módulo
AADCloudSyncTools. - Reproduce el fallo y, a continuación, ejecuta
Export-AADCloudSyncToolsLogs. La captura predeterminada dura tres minutos. - Copia los archivos de la carpeta de seguimiento.
- Anota la hora UTC exacta del tiempo de espera agotado.
- Obtén los registros de denegación y de TLS de tu cortafuegos para el mismo momento.
Entrega este paquete a Microsoft Support. Un caso de soporte con una marca de tiempo UTC y los registros del cortafuegos es mucho más fácil de tratar.
Qué ocurrió en los dos hilos
- En el primer hilo, un administrador probó la configuración del proxy, revisó los registros del cortafuegos, cambió la configuración de TLS, reconstruyó el almacén de certificados y ejecutó un comando de reparación. Después, una respuesta señaló el DNS y la cadena de certificados. El autor escribió un script con las comprobaciones sugeridas. Todas las pruebas pasaron y la sincronización se completó después. El autor no encontró una causa clara y sospechó que algo había cambiado en el lado de la nube.
- En el segundo hilo,
servicebus.windows.netfalló en el TCP 443 mientras otros puntos de conexión funcionaban. Se preparó el cambio en el cortafuegos, pero no se informó de una solución definitiva.
Así que considera la lista de comprobación como una forma de localizar un problema de red, no como una solución garantizada. Si todo pasa y el estado no se recupera tras un tiempo, abre un caso de soporte.
Relacionado
Fuentes
- Microsoft Learn: requisitos previos de Cloud Sync
- Microsoft Learn: solución de problemas de Cloud Sync
- Microsoft Q&A: problema con Entra Cloud Sync (abril de 2026)
- Microsoft Community Hub: problema extraño con Entra Connect Cloud Sync HybridIdentityServiceAgentTimeout (septiembre de 2026)