Виправлення тайм-аутів агента 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, потім вихідний 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: перевірте агент і служби
Спочатку виключіть прості причини.
- У центрі адміністрування Microsoft Entra відкрийте Entra ID, далі Entra Connect, далі Cloud sync і переконайтеся, що агент є у списку.
- На сервері відкрийте
services.mscі переконайтеся, що служби Microsoft Entra Connect Agent Updater та Microsoft Entra Provisioning Agent запущені. - Перевірте основні вимоги з документації 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-сервери без форвардерів, покладаючись на кореневі підказки (root hints). Така конфігурація є потенційним джерелом проблем, тож переконайтеся, що ваш шлях 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 для хостів списку відкликаних сертифікатів (CRL) та 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. Перевірте такі моменти:
- Відкрийте журнал CAPI2 і знайдіть помилки побудови ланцюжка в момент збою.
- Переконайтеся, що сервер має доступ до хоста списку довірених сертифікатів Windows Update
ctldl.windowsupdate.com, щоб кореневі сертифікати могли оновлюватися. Ця порада походить із відповіді спільноти, а не зі сторінки вимог Learn. - Переконайтеся, що порт 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: Збирайте докази
Якщо перевірки пройдені, а агент і далі завершується за тайм-аутом, зберіть дані, перш ніж чекати або перевстановлювати його:
- Установіть модуль
AADCloudSyncTools. - Відтворіть збій, а потім виконайте
Export-AADCloudSyncToolsLogs. Стандартне збирання триває три хвилини. - Скопіюйте файли з папки трасування.
- Запишіть точний час тайм-ауту в UTC.
- Зберіть журнали заборонених з'єднань і TLS з вашого брандмауера за той самий час.
Передайте цей пакет у службу підтримки Microsoft. Звернення з міткою часу в UTC і журналами брандмауера опрацьовувати значно простіше.
Що сталося в двох обговореннях
- У першому обговоренні адміністратор перевірив параметри проксі, переглянув журнали брандмауера, змінив TLS, перебудував сховище сертифікатів і виконав команду відновлення. Потім одна з відповідей вказала на DNS і ланцюжок сертифікатів. Автор допису написав скрипт із запропонованими перевірками. Усі тести пройшли, і синхронізація завершилася. Автор не знайшов одну чітку причину й припустив, що щось змінилося на боці хмари.
- У другому обговоренні
servicebus.windows.netне відповідав на TCP 443, тоді як інші кінцеві точки працювали. Зміну брандмауера підготували, але остаточного виправлення не повідомлено.
Тож сприймайте цей контрольний список як спосіб знайти мережеву проблему, а не як гарантоване рішення. Якщо все пройшло перевірку, а статус не відновлюється через деякий час, відкрийте звернення до служби підтримки.
Пов'язане
Джерела
- Microsoft Learn: Cloud sync prerequisites
- Microsoft Learn: Cloud sync troubleshooting
- Microsoft Q&A: проблема з Entra Cloud Sync (квітень 2026)
- Microsoft Community Hub: дивна проблема з Entra Connect Cloud Sync HybridIdentityServiceAgentTimeout (вересень 2026)