يفشل تسجيل موصل مورد الوصول الآمن مع حدوث الخطأ 106

مسألة

تم تشغيل "موصلات موارد الوصول الآمن" المستندة إلى Docker الموجودة على Ubuntu بنجاح ولكن فشل التسجيل إلى Cisco Secure Service Edge (SSE)، مما نتج عنه خطأ 106 بسبب التحقق من طول معرف المثيل وعدم رؤية الموصل في لوحة المعلومات.

بدا تشغيل "موصل الموارد" ناجحا مع الرسالة "تم تشغيل موصل الموارد بنجاح"، ولكن فشل ظهور الموصل في لوحة معلومات SSE وكشفت عمليات الفحص التشخيصية عن حالات فشل التسجيل.

أظهرت مخرجات التشخيص مشاكل متعددة في اتصال الشبكة بما في ذلك حالات فشل تحليل DNS لخدمات SSE وخطأ خلفي محدد:

daemon init state
106

أشار فحص صحة التشخيص إلى:

error: 106 fail to register, the provision key could be expired

على الرغم من إعادة إنشاء مفتاح الإمداد عدة مرات والتحقق من قواعد جدار الحماية، استمر التسجيل في الفشل دون ظهور أي موصل في لوحة المعلومات.

البيئة

• الوصول الآمن من Cisco - موصل الموارد

• نشر مستند إلى Docker على Ubuntu

قرار

تم حل المشكلة عن طريق معالجة خطأ التحقق من صحة طول معرف المثيل الذي تسبب في فشل التسجيل. لم يكن السبب الجذري الفعلي مشكلة متعلقة بمفتاح الإمداد أو اتصال الشبكة منتهية الصلاحية، بل كان اسم المضيف لموصل الموارد طويل جدا، مما أدى إلى تجاوز معرف المثيل الذي تم إنشاؤه للحد الأقصى المكون من 50 حرفا.

الخطوة 1: تحديد مشكلة طول معرف المثيل

راجع سجلات "موصل الموارد" للتعرف على خطأ التسجيل الفعلي من خلال تشغيل 'sudo /opt/connector/data/bin/techsupport':

2026-05-28T17:08:51Z INF requesting registration func=makeACARegistrationRequest parameters={"environment":"container","hostname":"(NAME)","instanceId":"(NAME)-d5d28cd78f24759","originIpAddress":"10.162.129.140","sha1":"9a1146f75071717837eff564e7f950a6e8ff2303","version":"v2.0.99"}
2026-05-28T17:08:51Z ERR registration request failed error="RegisterConnector::failed registration request  with code 400 - Validation Error - {InstanceId:Attribute value length should be between 1 to 50 Version: Hostname: Sha1: OriginIpAddress: Environment:}" func=registerAndInitACA

الخطوة 2: تعديل اسم المضيف لموصل الموارد

تأكد من أن اسم المضيف لموصل الموارد قصير بشكل كاف بحيث يبقى معرف المثيل الذي تم إنشاؤه بين 10 و 50 حرفا. يتم إنشاء معرف المثيل من خلال دمج اسم المضيف مع لاحقة التجزئة.

بدء تشغيل "موصل الموارد" باسم مضيف أقصر:

sudo /opt/connector/install/connector.sh launch --name [shorter-name] --key [provisioning-key]

الخطوة 3: تمكين إعادة توجيه IP

تأكد تمكين إعادة توجيه IP على النظام المضيف:

echo "net.ipv4.ip_forward=1" | sudo tee /etc/sysctl.d/99-docker-forwarding.conf

الخطوة 4: إعادة تشغيل الحاوية أو الجهاز الظاهري

قم بإعادة تشغيل الحاوية أو الجهاز الظاهري لتطبيق تكوين إعادة توجيه IP وضمان بدء موصل الموارد باسم المضيف الجديد.

الخطوة 5: التحقق من التسجيل

قم بتشغيل الأمر التشخيصي للتحقق من التسجيل الناجح:

/opt/connector/data/bin/diagnostic

تحقق من أن حالة وحدة التخزين المؤقت لا تظهر أية وحدة أخرى خطأ 106 ومن ظهور موصل الموارد في لوحة معلومات SSE.

السبب

حدث فشل في تسجيل "موصل الموارد" بسبب خطأ في التحقق من صحة طول معرف المثيل. عندما يكون اسم المضيف لموصل الموارد طويل جدا، يتجاوز معرف المثيل الذي تم إنشاؤه (والذي يجمع اسم المضيف مع لاحقة التجزئة) الحد الأقصى للطول المسموح به وقدره 50 حرفا. يتحقق SSE API من طول معرف المثيل ويرفض طلبات التسجيل باستخدام معرفات المثيل التي تقع خارج نطاق الأحرف 1-50، مما ينتج عنه خطأ في التحقق من الصحة يبلغ 400 ويمنع الموصل من الظهور في لوحة المعلومات.

رسالة الخطأ 106 "فشل التسجيل، قد تنتهي صلاحية مفتاح التوفير" كانت مضللة، نظرا لأن المشكلة الفعلية لم تكن مرتبطة بانتهاء صلاحية مفتاح التوفير بل بفشل التحقق من صحة معرف المثيل.

المحتوى ذي الصلة

• الدعم الفني والتنزيلات من Cisco

محفوظات المراجعة

المراجعة	تاريخ النشر	التعليقات
1.0	06-Oct-2026	الإصدار الأولي