إصلاح مهلات انتهاء وكيل 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 المسبقة لـ Cloud Sync.
كيف تبدو الأعراض
أظهرت التقارير مزيجًا من هذه العلامات:
- في مركز إدارة 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 لا تملك مُرحِّلات (forwarders) ويعتمد على 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 إلى أنه إذا كانت جدار الحماية تطبّق القواعد استناداً إلى المستخدم المصدر، فيجب فتح المنافذ للخدمات التي تعمل بحساب Network Service. قد ينجح اختبار في جلسة المسؤول التفاعلية لديك ولا ينجح مع الخدمة. وتؤكد الرسالة الواردة في الخيط الثاني النقطة نفسها: اختبر من سياق حساب الخدمة، لا من جلسة المسؤول وحدها.
الخطوة 4: اكتب قواعد جدار الحماية بالأسماء، لا بعناوين IP
تحذّر الإجابتان من القواعد المعتمدة على عناوين IP. فالنقاط الطرفية تقع خلف أسماء بأحرف بدل (wildcard)، والعناوين قد تتغير.
- اسمح بالمنفذ 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: متطلبات المزامنة السحابية الأساسية
- Microsoft Learn: استكشاف أخطاء المزامنة السحابية وإصلاحها
- Microsoft Q&A: مشكلة Entra Cloud Sync (أبريل 2026)
- Microsoft Community Hub: مشكلة غريبة في Entra Connect Cloud Sync وHybridIdentityServiceAgentTimeout (سبتمبر 2026)