M365Con 2027 – conférence en ligne gratuite · 11–22 Jan 2027 · 120 sessions→ m365con.net

Blog · Mirko Peters

Corriger les délais d’expiration de l’agent Entra Cloud Sync : liste de contrôle réseau et certificats

Par ·

L’agent Entra Cloud Sync s’installe correctement, mais ne synchronise jamais, et le portail affiche HybridIdentityServiceAgentTimeout ? Passez en revue le DNS, les règles de pare-feu, l’inspection TLS et la confiance accordée aux certificats, dans cet ordre.

Traduit automatiquement par IA à partir de l'article original. Lire l'original en anglais

L’agent s’installe sans erreur. Les services sont en cours d’exécution. Le serveur dispose d’un accès Internet. Pourtant, la première synchronisation ne démarre jamais, et le Centre d’administration Microsoft Entra affiche HybridIdentityServiceAgentTimeout.

Points clés

  • Dans les cas signalés, HybridIdentityServiceAgentTimeout correspondait à un problème de connexion entre l’agent et le service cloud, et non à un agent défectueux. Learn associe les délais d’expiration de l’agent à des connexions échouées.
  • Vérifiez d’abord le DNS, puis le TCP 443 sortant vers .msappproxy.net et .servicebus.windows.net, puis le port 80 pour les listes de révocation de certificats.
  • Les règles de pare-feu doivent suivre les noms de domaine et non des adresses IP fixes, et l’inspection TLS doit être contournée pour ces flux.
  • Collectez la trace de l’agent et un ensemble de journaux AADCloudSyncTools avant d’ouvrir un dossier de support.

Ce schéma est apparu dans deux discussions distinctes de la communauté Microsoft en 2026. Dans les deux cas, l’agent lui-même semblait sain, et le problème suspecté se situait entre le serveur et le service cloud. Cet article transforme les enseignements communs en une liste de contrôle à suivre dans l’ordre. Il s’agit d’un guide de dépannage, et non d’une procédure officielle de Microsoft. Vérifiez chaque exigence dans les prérequis de la synchronisation cloud sur Microsoft Learn.

À quoi ressemblent les symptômes

Les signalements présentaient un mélange de ces signes :

  • Dans le Centre d’administration Microsoft Entra, l’état de l’agent affiche HybridIdentityServiceAgentTimeout.
  • Le dossier de trace de l’agent, C:\ProgramData\Microsoft\Azure AD Connect Provisioning Agent\Trace, contient des lignes telles que Web socket failed to connect.
  • Le journal des événements indique que la réinscription de l’agent a échoué, car la demande de renouvellement de confiance adressée à une adresse msappproxy.net a expiré.
  • La fonction de mise à jour de l’agent ne parvient pas à résoudre un nom tel que autoupdate.msappproxy.net.
  • Le journal CAPI2 signale une chaîne de certificats qui se termine par un certificat racine non approuvé.

Une autre ligne de trace, Unable to initialize performance counters, est également apparue. Dans la réponse acceptée d’un fil de discussion, elle était considérée comme un problème secondaire. Les erreurs de connexion constituaient en réalité l’indice déterminant.

Étape 1 : vérifier l’agent et les services

Commencez par écarter les cas simples.

  1. Dans le Centre d’administration Microsoft Entra, ouvrez Entra ID, puis Entra Connect, puis Synchronisation cloud, et vérifiez que l’agent figure dans la liste.
  2. Sur le serveur, ouvrez services.msc et vérifiez que Microsoft Entra Connect Agent Updater et Microsoft Entra Provisioning Agent sont en cours d’exécution.
  3. Vérifiez les prérequis de base indiqués par Microsoft : un serveur joint à un domaine (Windows Server Core n’est pas pris en charge), .NET Framework 4.7.1 ou version ultérieure, et une stratégie d’exécution PowerShell de Undefined ou RemoteSigned.

Si tous ces points sont corrects, passez à la suite. L’agent n’est pas le problème.

Étape 2 : tester la résolution de noms

La réponse acceptée dans le premier fil pointe d’abord vers le DNS, et la réponse du second fil demande également de tester la résolution de noms. Exécutez ces tests depuis le serveur de l’agent :

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

Si les noms msappproxy.net ne se résolvent pas, rien d’autre ne fonctionnera. Un intervenant utilisait des contrôleurs de domaine comme serveurs DNS, sans redirecteurs et en s’appuyant sur les indications racine. Cette configuration risque fort de poser problème : vérifiez que votre chemin DNS peut résoudre les noms publics de manière fiable.

Étape 3 : tester le TCP 443 vers les bonnes destinations

Ne vous limitez pas à login.microsoftonline.com. Dans un fil, les points de terminaison de connexion et autoupdate.msappproxy.net répondaient sur le port 443, mais servicebus.windows.net ne répondait pas. L’agent a besoin des deux familles de destinations.

D’après Microsoft Learn, les exigences de sortie pour le cloud public incluent notamment :

| Destination | Raison | |---|---| | .msappproxy.net, .servicebus.windows.net | Communication avec le service cloud | | .microsoftonline.com, .microsoft.com, .msappproxy.com, .windowsazure.com | Communication avec le service cloud | | login.windows.net, login.live.com, aadcdn.msauth.net, aadcdn.msftauth.net | Enregistrement | | mscrl.microsoft.com:80, crl.microsoft.com:80, ocsp.msocsp.com:80, www.microsoft.com:80 | Vérifications des certificats |

Testez les ports avec 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 ``

Le service ne s’exécute pas sous votre identité. Microsoft indique que si votre pare-feu applique des règles selon l’utilisateur d’origine, vous devez ouvrir les ports pour les services Windows qui s’exécutent en tant que service réseau. Un test qui fonctionne dans votre session d’administration interactive peut donc échouer pour le service. La réponse du second fil va dans le même sens : testez depuis le contexte du compte de service, et pas uniquement depuis une session d’administrateur.

Étape 4 : écrire les règles de pare-feu par nom, et non par adresse IP

Les deux réponses mettent en garde contre les règles basées sur les adresses IP. Les points de terminaison reposent sur des noms génériques, et leurs adresses peuvent changer.

  • Autorisez le TCP 443 vers toutes les cibles auxquelles résolvent les deux domaines génériques, y compris les chaînes CNAME.
  • Autorisez le port 80 pour les hôtes de liste de révocation des certificats et OCSP.
  • Un pare-feu configuré « sans filtrage » peut tout de même interrompre les connexions WebSocket de longue durée. Consultez les journaux de refus et de TLS, et pas seulement la liste des règles.

Étape 5 : exclure ces flux de l’inspection TLS

La page de dépannage de la synchronisation cloud de Microsoft Learn recommande d’éviter toute forme d’inspection et de terminaison en ligne sur le trafic TLS sortant entre les connecteurs réseau privés de Microsoft Entra et les services cloud d’Application Proxy. L’agent communique avec les points de terminaison msappproxy.net, et une réponse du fil de septembre 2026 conseillait d’exclure .msappproxy.net et .servicebus.windows.net de l’inspection TLS, de la substitution de certificats, de l’authentification et du proxy applicatif. Dans un fil, la modification du pare-feu était prévue avec un contournement de l’inspection pour les deux domaines. L’intervenant a tout de même signalé une panne ensuite. Poursuivez donc les étapes suivantes plutôt que de supposer que le pare-feu est la seule cause.

Étape 6 : vérifier la chaîne de certificats

Une erreur de certificat telle que « terminated in a root certificate which is not trusted » peut interrompre TLS. Le résultat ressemble à une panne de WebSocket ou à un dépassement de délai pendant RenewTrustCertificate. Vérifiez les points suivants :

  1. Ouvrez le journal opérationnel CAPI2 et recherchez les erreurs de construction de chaîne au moment de la panne.
  2. Vérifiez que le serveur peut atteindre l’hôte de la liste de confiance des certificats Windows Update ctldl.windowsupdate.com, afin que les certificats racines puissent être mis à jour. Cette astuce provient d’une réponse de la communauté, et non de la page des prérequis de Learn.
  3. Vérifiez que le port 80 est ouvert vers les hôtes CRL et OCSP mentionnés ci-dessus.

Étape 7 : vérifier les paramètres TLS et le proxy

Microsoft exige TLS 1.2 sur le serveur d’agent avant l’installation. Sur les serveurs plus anciens, TLS 1.2 et la cryptographie forte pour .NET doivent être activés. La page Learn présente les paramètres de registre, dont SchUseStrongCrypto pour .NET Framework. Microsoft avertit que la modification des paramètres TLS affecte l’ensemble de la forêt ; prévoyez donc soigneusement cette modification.

Si vous devez utiliser un proxy sortant, Learn décrit l’ajout d’une section defaultProxy dans AADConnectProvisioningAgent.exe.config. Vérifiez que le proxy prend en charge au minimum HTTP 1.1 avec le codage chunked. Les deux intervenants ont indiqué qu’aucun proxy n’était utilisé. Vérifiez néanmoins qu’aucun proxy WinHTTP n’est configuré.

Étape 8 : collecter des preuves

Si les contrôles sont concluants et que l’agent expire toujours, collectez des données avant d’attendre ou de réinstaller.

  1. Installez le module AADCloudSyncTools.
  2. Reproduisez la défaillance, puis exécutez Export-AADCloudSyncToolsLogs. La capture par défaut dure trois minutes.
  3. Copiez les fichiers du dossier de trace.
  4. Notez l’heure UTC exacte de l’expiration du délai.
  5. Récupérez les journaux de refus et de TLS de votre pare-feu pour la même période.

Transmettez ce dossier au support Microsoft. Un dossier de support accompagné d’un horodatage UTC et des journaux du pare-feu est beaucoup plus facile à traiter.

Ce qui s’est passé dans les deux fils de discussion

  • Dans le premier fil, un administrateur a testé les paramètres de proxy, l’analyse des journaux du pare-feu, les modifications TLS, un magasin de certificats reconstruit et une commande de réparation. Une réponse a ensuite pointé vers le DNS et la chaîne de certificats. L’auteur a rédigé un script intégrant les vérifications suggérées. Tous les tests ont réussi et la synchronisation s’est alors terminée. L’auteur n’a pas identifié de cause claire et soupçonne une modification côté cloud.
  • Dans le second fil, servicebus.windows.net échouait sur le TCP 443 alors que les autres points de terminaison fonctionnaient. La modification du pare-feu était préparée, mais aucune solution définitive n’a été signalée.

Considérez donc la liste de contrôle comme un moyen de localiser un problème réseau, et non comme un remède garanti. Si tous les contrôles sont concluants et que l’état ne se rétablit pas après un certain temps, ouvrez un dossier de support.

À lire aussi

Sources

Suivre le podcastSpotify

Entités dans cet article

Microsoft Entra Cloud Sync Microsoft Entra Connect

Articles associés

RSS