المحتويات

مسألة

فشل Claude AI في العمل ضمن تطبيق Visual Studio، حيث يرجع خطأ API متعلق بفشل التحقق من شهادة SSL.

رسالة الخطأ المحددة المعروضة هي:

API Error: Unable to connect to API. SSL Certificate verification failed. Check your proxy or corporate SSL certificates.

تحدث هذه المشكلة تحديدا عند محاولة إستخدام AI الخاص ب Claude من داخل بيئة تطوير Visual Studio، بينما يعمل الوصول إلى Claude من خلال مستعرض ويب بشكل طبيعي من نفس نقطة النهاية. يتعذر على ملحق "التعليمات البرمجية ل Cloud" إنشاء اتصال آمن ب API الخاص ب Anthropic بسبب مشاكل ثقة شهادة SSL في بيئة وقت تشغيل Node.js.

البيئة

- Cisco Secure Access (Umbrella) مع تمكين فك تشفير SSL

- Visual Studio Code مع امتداد Claude Code

- بيئة الملحق المستندة إلى Node.js

- CA الجذر للوصول الآمن من Cisco المثبت في مخزن ثقة الجهاز

- api.anthropic.com مسموح به في سياسات الوصول الآمن من Cisco مع تمكين فك التشفير

قرار

تم حل المشكلة عن طريق تكوين متغير بيئة NODE_EXTRA_CA_CERTS ليثق بشكل صريح في شهادة جذر الوصول الآمن من Cisco للتطبيقات المستندة إلى Node.js.

اتبع الخطوات التالية لحل فشل التحقق من شهادة SSL:

الخطوة 1: تكوين متغير بيئة NODE_EXTRA_CA_CERTS

قم بتعيين متغير بيئة نظام NODE_EXTRA_CA_CERTS للإشارة إلى مسار ملف ترخيص جذر Cisco Secure Access. يسمح هذا التكوين لتطبيقات Node.js بالثقة في مرجع الشهادات الاعتراضية حتى في حالة تثبيت المرجع المصدق الجذر بالفعل في مخزن ثقة نظام التشغيل.

NODE_EXTRA_CA_CERTS=[path_to_secure_access_root_certificate]

الخطوة 2: إعادة تشغيل Visual Studio Code

قم بإغلاق Visual Studio Code وإعادة تشغيله للتأكد من أن تكوين متغير البيئة الجديد يصبح نافذ المفعول لامتداد كود كلود.

الخطوة 3: إعادة تشغيل وكيل Umbrella (Secure Access)

قم بإعادة تشغيل خدمة وكيل Umbrella لضمان معالجة الشهادة بشكل صحيح بعد تغيير البيئة المتغير.

الخطوة 4: التحقق من الدقة

قم باختبار وظيفة ملحق التعليمات البرمجية ل Cloud داخل Visual Studio Code للتأكد من حل خطأ التحقق من SSL ومن أن التعليمات البرمجية ل Cloud تعمل بشكل طبيعي.

ملاحظة: المحاولات السابقة لحل هذه المشكلة عن طريق إستبعاد api.anthropic.com من فك تشفير SSL في قواعد الوصول الآمن من Cisco أو تثبيت الشهادات مباشرة في Visual Studio لم تحل المشكلة، نظرا لأن المشكلة كانت خاصة ببيئة وقت تشغيل Node.js المستخدمة من قبل ملحق التعليمات البرمجية ل Cloud.

السبب

السبب الجذري لهذه المشكلة هو متطلب تكوين Node.js لثقة شهادة SSL. تتطلب الملحقات المستندة إلى Node.js، مثل ملحق التعليمات البرمجية ل Claude في Visual Studio، تكوين مرجع شهادات صريح من خلال متغير بيئة NODE_EXTRA_CA_CERTS للثقة في شهادات الاعتراض، حتى في حالة تثبيت مرجع الشهادة الجذر مسبقا في مخزن ثقة نظام التشغيل.

عندما يقوم Cisco Secure Access بفك تشفير SSL على حركة المرور إلى api.anthropic.com، فإنه يقدم شهادته الخاصة إلى تطبيق العميل. بينما يمكن لمستعرضات الويب الوصول إلى المخزن الموثوق به لنظام التشغيل للتحقق من صحة هذه الشهادة، تحتاج تطبيقات Node.js إلى متغير NODE_EXTRA_CA_CERTS ليتم تكوينه بشكل صريح للثقة في شهادة جذر الوصول الآمن. بدون هذا التكوين، يفشل وقت تشغيل Node.js في التحقق من صحة سلسلة شهادة SSL، مما يؤدي إلى خطأ التحقق من شهادة SSL.

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

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