M365Con 2027 – бесплатная онлайн-конференция · 11–22 Jan 2027 · 120 sessions→ m365con.net

Блог · Mirko Peters

Устранение тайм-аутов агента Entra Cloud Sync: контрольный список по сети и сертификатам

By ·

Агент Entra Cloud Sync устанавливается без проблем, но синхронизация так и не начинается, а на портале отображается HybridIdentityServiceAgentTimeout? Проверьте DNS, правила брандмауэра, инспекцию TLS и доверие к сертификатам именно в таком порядке.

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

Агент устанавливается без ошибок. Службы запущены. У сервера есть доступ в интернет. Тем не менее первая синхронизация так и не начинается, а центр администрирования Microsoft Entra показывает HybridIdentityServiceAgentTimeout.

Ключевые выводы

  • В описанных случаях HybridIdentityServiceAgentTimeout означал проблему соединения между агентом и облачной службой, а не неисправность самого агента. Learn связывает тайм-ауты агента с неудачными подключениями.
  • Сначала проверьте DNS, затем исходящий TCP 443 к .msappproxy.net и .servicebus.windows.net, а затем порт 80 для списков отзыва сертификатов.
  • Правила брандмауэра должны опираться на доменные имена, а не на фиксированные IP-адреса, а для этих потоков инспекцию TLS следует обходить.
  • Соберите трассировку агента и пакет журналов AADCloudSyncTools, прежде чем открывать обращение в поддержку.

Эта закономерность проявилась в двух отдельных обсуждениях в сообществе Microsoft в 2026 году. В обоих случаях сам агент выглядел исправным, а предполагаемая проблема находилась между сервером и облачной службой. Эта статья собирает общие выводы в контрольный список, которому можно следовать по порядку. Это руководство по устранению неполадок, а не официальная процедура Microsoft, поэтому сверяйте каждое требование с актуальными требованиями Microsoft Learn для облачной синхронизации.

Как выглядят симптомы

В сообщениях встречалась смесь следующих признаков:

  • В центре администрирования 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: проверьте агент и службы

Сначала исключите простые причины.

  1. В центре администрирования Microsoft Entra откройте Entra ID, затем Entra Connect, затем Облачная синхронизация и убедитесь, что агент есть в списке.
  2. На сервере откройте services.msc и убедитесь, что службы Microsoft Entra Connect Agent Updater и Microsoft Entra Provisioning Agent запущены.
  3. Проверьте базовые требования из документации Microsoft: сервер должен быть присоединён к домену (Windows Server Core не поддерживается), нужен .NET Framework 4.7.1 или новее, а политика выполнения PowerShell должна быть Undefined или RemoteSigned.

Если всё это в порядке, двигайтесь дальше. Агент не является причиной проблемы.

Шаг 2: проверка разрешения имён

Принятый ответ в первой ветке указывает в первую очередь на DNS, а ответ во второй ветке также просит проверить разрешение имён. Выполните эти команды на сервере с агентом:

`` 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, работающих под учётной записью сетевой службы. Тест, который успешно проходит в вашей интерактивной сессии администратора, может всё равно завершаться ошибкой для службы. Ответ во второй ветке подчёркивает то же самое: тестируйте из контекста учётной записи службы, а не только из сеанса администратора.

Шаг 4: создавайте правила межсетевого экрана по именам, а не по IP-адресам

Оба ответа предостерегают от правил на основе IP-адресов. Конечные точки скрыты за подстановочными именами, а адреса могут меняться.

  • Разрешите TCP 443 для всего, во что разрешаются два подстановочных домена, включая цепочки CNAME.
  • Разрешите порт 80 для узлов списков отзыва сертификатов и OCSP.
  • Межсетевой экран с режимом «без фильтрации» всё равно может прервать долгоживущие соединения WebSocket. Проверьте журналы запрещённых подключений и TLS, а не только список правил.

Шаг 5: исключите эти потоки из инспекции TLS

На странице Learn по устранению неполадок облачной синхронизации говорится, что нужно избегать любых форм встроенной инспекции и терминирования исходящего трафика TLS между частными сетевыми коннекторами Microsoft Entra и облачными службами Application Proxy. Агент обращается к конечным точкам msappproxy.net, а ответ в ветке за сентябрь 2026 года рекомендовал исключить .msappproxy.net и .servicebus.windows.net из инспекции TLS, подмены сертификатов, аутентификации и проксирования приложений. В одной ветке изменение межсетевого экрана планировалось вместе с обходом инспекции для обоих доменов. Участник всё равно сообщил об ошибке после этого, поэтому продолжайте следующие шаги, а не исходите из того, что межсетевой экран — единственная причина.

Шаг 6: проверьте цепочку сертификатов

Ошибка сертификата вида «terminated in a root certificate which is not trusted» может нарушить TLS. Результат выглядит как сбой WebSocket или тайм-аут во время RenewTrustCertificate. Проверьте следующие моменты:

  1. Откройте оперативный журнал CAPI2 и найдите ошибки построения цепочки в момент сбоя.
  2. Убедитесь, что сервер может обращаться к хосту списка доверенных сертификатов Windows Update ctldl.windowsupdate.com, чтобы корневые сертификаты могли обновляться. Этот совет взят из ответа сообщества, а не со страницы предварительных требований в Learn.
  3. Убедитесь, что порт 80 открыт для указанных выше хостов CRL и OCSP.

Шаг 7: Проверка настроек TLS и прокси

Microsoft требует, чтобы на сервере агента перед установкой был включён TLS 1.2. На старых серверах нужно включить TLS 1.2 и сильную криптографию для .NET. На странице Learn приведены параметры реестра, в том числе SchUseStrongCrypto для .NET Framework. Microsoft предупреждает, что изменение настроек TLS затрагивает весь лес, поэтому такое изменение нужно тщательно спланировать.

Если без исходящего прокси не обойтись, в Learn описано добавление раздела defaultProxy в файл AADConnectProvisioningAgent.exe.config. Проверьте, что прокси поддерживает как минимум HTTP 1.1 с фрагментированной передачей (chunked encoding). Оба автора сообщений написали, что прокси не использовался. Тем не менее убедитесь, что для WinHTTP не задан прокси.

Шаг 8: Сбор доказательств

Если проверки пройдены, а агент всё равно выходит по таймауту, соберите данные, прежде чем ждать или переустанавливать агент:

  1. Установите модуль AADCloudSyncTools.
  2. Воспроизведите сбой и выполните Export-AADCloudSyncToolsLogs. По умолчанию запись длится три минуты.
  3. Скопируйте файлы из папки с трассировкой.
  4. Запишите точное время таймаута в UTC.
  5. Выгрузите журналы запрещённых подключений и TLS с межсетевого экрана за то же время.

Передайте этот комплект в службу поддержки Microsoft. Обращение с меткой времени в UTC и журналами межсетевого экрана значительно проще взять в работу.

Что произошло в двух обсуждениях

  • В первом обсуждении администратор проверил настройки прокси, журналы межсетевого экрана, изменил TLS, пересоздал хранилище сертификатов и выполнил команду восстановления. Затем в одном из ответов указали на DNS и цепочку сертификатов. Автор написал скрипт с предложенными проверками. Все тесты были пройдены, и после этого синхронизация завершилась. Причину автор однозначно не установил и предположил, что на стороне облака что-то изменилось.
  • Во втором обсуждении servicebus.windows.net не отвечал по TCP 443, тогда как другие конечные точки работали. Изменение на межсетевом экране было подготовлено, но окончательное решение в обсуждении не описано.

Поэтому относитесь к чек-листу как к способу найти проблему в сети, а не как к гарантированному решению. Если все проверки пройдены, а статус через некоторое время не восстанавливается, откройте обращение в службу поддержки.

Связанные материалы

Источники

Подписаться на подкастSpotify

Entities in this article

Microsoft Entra Cloud Sync Microsoft Entra Connect

Related articles

RSS