Entra Cloud Sync エージェントのタイムアウトを解決する:ネットワークと証明書のチェックリスト
By Mirko Peters ·
Entra Cloud Sync エージェントは正常にインストールされるのに、一度も同期が始まらず、管理センターに HybridIdentityServiceAgentTimeout と表示されていませんか? DNS、ファイアウォール規則、TLS インスペクション、証明書の信頼の順に確認していきます。
Automatically translated with AI from the original post. Read the English original
エージェントはエラーなくインストールされ、サービスも実行されています。サーバーはインターネットにアクセスできます。それでも最初の同期が開始されず、Microsoft Entra 管理センターに HybridIdentityServiceAgentTimeout が表示されます。
重要なポイント
- 報告されたケースでは、HybridIdentityServiceAgentTimeout はエージェントの故障ではなく、エージェントとクラウド サービスの間の接続の問題を示していました。Learn もエージェントのタイムアウトを接続の失敗に関連付けています。
- まず DNS を確認し、次に .msappproxy.net と .servicebus.windows.net への送信 TCP 443、最後に証明書失効リスト用のポート 80 を確認します。
- ファイアウォール規則は固定の IP アドレスではなくドメイン名に従う必要があり、これらの通信では TLS インスペクションを迂回させるべきです。
- サポート ケースを開く前に、エージェントのトレースと AADCloudSyncTools のログ バンドルを収集してください。
このパターンは 2026 年に、2 つの別々の Microsoft コミュニティのスレッドで現れました。どちらのケースでも、エージェント自体は問題なさそうに見え、疑われた問題はサーバーとクラウド サービスの間にありました。この記事では、共通する教訓を順番に従えるチェックリストにまとめます。これは公式の Microsoft 手順ではなくトラブルシューティングのガイドです。各要件は、最新の クラウド同期の Microsoft Learn の前提条件で必ず確認してください。
症状の例
報告には、次のような兆候が混在していました:
- Microsoft Entra 管理センターでは、エージェントのステータスに
HybridIdentityServiceAgentTimeoutと表示されます。 - エージェントのトレース フォルダー
C:\ProgramData\Microsoft\Azure AD Connect Provisioning Agent\Traceには、Web socket failed to connectのような行が含まれています。 - イベント ログには、
msappproxy.netのアドレスへの信頼更新要求がタイムアウトしたため、エージェントの再登録に失敗したと記録されています。 - エージェントの更新プログラムが
autoupdate.msappproxy.netのような名前を解決できません。 - CAPI2 ログには、信頼されていないルート証明書で終わる証明書チェーンが記録されています。
Unable to initialize performance counters というトレースの行も現れました。あるスレッドの採用された回答では、これは副次的な問題として扱われていました。しかし、接続エラーこそが本当の手がかりでした。
手順 1:エージェントとサービスを確認する
まず単純な原因を除外します。
- Microsoft Entra 管理センターで Entra ID、Entra Connect、クラウド同期 の順に開き、エージェントが一覧に表示されているか確認します。
- サーバーで
services.mscを開き、Microsoft Entra Connect Agent Updater と Microsoft Entra Provisioning Agent が実行中であることを確認します。 - Microsoft の要件に沿って基本事項を確認します。ドメインに参加しているサーバーであること(Windows Server Core はサポートされません)、.NET Framework 4.7.1 以降がインストールされていること、PowerShell の実行ポリシーが
UndefinedまたはRemoteSignedであることです。
ここまで問題がなければ、次に進みます。エージェントが原因ではありません。
手順 2: 名前解決をテストする
1 つ目のスレッドで採用された回答では、まず DNS を確認するよう指摘しています。2 つ目のスレッドの返信でも名前解決のテストが求められています。エージェントのサーバーから次のコマンドを実行します。
`` nslookup autoupdate.msappproxy.net nslookup login.microsoftonline.com nslookup <your-servicebus-namespace>.servicebus.windows.net ``
msappproxy.net の名前が解決できない場合、ほかの処理もすべて失敗します。ある投稿者は、転送設定がなくルートヒントに依存するドメインコントローラーを DNS サーバーとして使っていました。このような構成は問題を起こしやすいため、DNS の経路でパブリック名を安定して解決できるか確認してください。
手順 3: 正しい宛先への TCP 443 をテストする
login.microsoftonline.com だけで確認を終えないでください。あるスレッドでは、サインイン用のエンドポイントと autoupdate.msappproxy.net はポート 443 で応答したものの、servicebus.windows.net は応答しませんでした。エージェントには両方のグループの宛先が必要です。
Microsoft Learn によると、パブリック クラウドへの送信要件には次のものが含まれます。
| 宛先 | 目的 | |---|---| | .msappproxy.net, .servicebus.windows.net | クラウド サービスとの通信 | | .microsoftonline.com, .microsoft.com, .msappproxy.com, .windowsazure.com | クラウド サービスとの通信 | | login.windows.net, login.live.com, aadcdn.msauth.net, aadcdn.msftauth.net | 登録 | | mscrl.microsoft.com:80, crl.microsoft.com:80, ocsp.msocsp.com:80, www.microsoft.com:80 | 証明書の検証 |
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 ``
サービスはご自身のユーザーとして実行されるわけではありません。Microsoft は、ファイアウォールが発信元ユーザーごとにルールを適用している場合、ネットワーク サービスとして実行される Windows サービス向けにポートを開放する必要があると述べています。対話型の管理者セッションで成功したテストでも、サービスでは失敗することがあります。2 つ目のスレッドの返信も同じ点を指摘しており、管理者セッションだけでなく、サービス アカウントのコンテキストからテストするよう求めています。
手順 4: IP アドレスではなく名前でファイアウォール規則を作成する
両方の回答が IP アドレスベースの規則に注意を促しています。エンドポイントはワイルドカード名の背後にあり、アドレスは変わる可能性があるためです。
- CNAME チェーンを含め、2 つのワイルドカード ドメインが解決される先すべてへの TCP 443 を許可します。
- 証明書失効リスト(CRL)と OCSP のホストに対して、ポート 80 を許可します。
- 「フィルタリングなし」のファイアウォールでも、長時間維持される WebSocket 接続が切断されることがあります。規則の一覧だけでなく、拒否ログと TLS ログも確認してください。
手順 5: これらの通信を TLS インスペクションの対象から除外する
Learn のクラウド同期のトラブルシューティング ページでは、Microsoft Entra のプライベート ネットワーク コネクタと Application Proxy のクラウド サービスの間の送信 TLS については、インラインでのインスペクションや終端処理をすべて避けるよう説明しています。エージェントは msappproxy.net のエンドポイントと通信するため、2026 年 9 月のスレッドの返信では、.msappproxy.net と .servicebus.windows.net を TLS インスペクション、証明書の置き換え、認証、アプリケーション プロキシの対象から除外するよう助言されていました。あるスレッドでは、両ドメインをインスペクションの対象外にするファイアウォール変更が計画されていました。しかし投稿者は、その後も失敗が続くと報告しています。ファイアウォールだけが原因だと決めつけず、次の手順も続けて確認してください。
手順 6: 証明書チェーンを確認する
「信頼されていないルート証明書で終了しています」のような証明書エラーは、TLS を妨げる可能性があります。その結果、WebSocket の障害や RenewTrustCertificate の実行中のタイムアウトとして現れることがあります。次の点を確認してください。
- 障害が発生した時刻の前後で、CAPI2 の運用ログを開き、チェーンの構築エラーを探します。
- サーバーから Windows Update の証明書信頼リストホスト
ctldl.windowsupdate.comに到達できることを確認してください。これにより、ルート証明書を更新できるようになります。このヒントは Learn の前提条件ページではなく、コミュニティの回答によるものです。 - 上記の CRL および OCSP ホストに対して、ポート 80 が開いていることを確認してください。
手順 7: TLS 設定とプロキシを確認する
Microsoft では、インストール前にエージェントサーバーで TLS 1.2 を有効にすることを求めています。古いサーバーでは、TLS 1.2 と .NET の強力な暗号化を有効にする必要があります。Learn のページには、.NET Framework 向けの SchUseStrongCrypto を含むレジストリ設定が記載されています。Microsoft は、TLS 設定の変更がフォレスト全体に影響すると警告しているため、変更は計画的に行ってください。
送信プロキシを使用する必要がある場合、Learn では AADConnectProvisioningAgent.exe.config に defaultProxy セクションを追加する方法が説明されています。プロキシが、チャンク転送エンコーディングを伴う HTTP 1.1 以上をサポートしていることを確認してください。両方の投稿者は、プロキシを使用していないと報告しています。それでも、WinHTTP プロキシが設定されていないことは確認してください。
手順 8: 証跡を収集する
チェックに合格したにもかかわらずエージェントがタイムアウトする場合は、待機や再インストールの前にデータを収集してください。
AADCloudSyncToolsモジュールをインストールします。- 障害を再現してから、
Export-AADCloudSyncToolsLogsを実行します。既定の取得時間は 3 分です。 - トレースフォルダーからファイルをコピーします。
- タイムアウトが発生した正確な UTC 時刻をメモします。
- 同じ時間帯のファイアウォールの拒否ログと TLS ログを取得します。
このパッケージを Microsoft サポートに提出してください。UTC のタイムスタンプとファイアウォールログを添えたサポートケースは、はるかに対応しやすくなります。
2 つのスレッドで起きたこと
- 1 つ目のスレッドでは、管理者がプロキシ設定、ファイアウォールログの確認、TLS の変更、証明書ストアの再構築、修復コマンドを試しました。その後、ある回答が DNS と証明書チェーンを指摘しました。投稿者は、提案されたチェックを行うスクリプトを作成しました。すべてのテストに合格し、その後同期が完了しました。投稿者は明確な原因を特定できず、クラウド側で何かが変わったのではないかと推測しています。
- 2 つ目のスレッドでは、他のエンドポイントは正常に動作していましたが、
servicebus.windows.netへの TCP 443 接続が失敗しました。ファイアウォールの変更は準備されましたが、最終的な解決策は報告されていません。
そのため、このチェックリストは解決策を保証するものではなく、ネットワークの問題を特定するための手段として扱ってください。すべてのチェックに合格しても、しばらくしてステータスが回復しない場合は、サポートケースを開いてください。
関連リンク
データソース
- Microsoft Learn: クラウド同期の前提条件
- Microsoft Learn: クラウド同期のトラブルシューティング
- Microsoft Q&A: Entra Cloud Sync の問題(2026年4月)
- Microsoft Community Hub: Weird issue with Entra Connect Cloud Sync HybridIdentityServiceAgentTimeout(2026年9月)