حل فشل التحقق من شهادة AI SSL في Visual Studio مع الوصول الآمن

خيارات التنزيل

  • PDF     (250.3 KB)
    عرض باستخدام Adobe Reader على مجموعة متنوعة من الأجهزة
  • ePub     (82.0 KB)
    العرض في تطبيقات مختلفة على iPhone أو iPad أو نظام تشغيل Android أو قارئ Sony أو نظام التشغيل Windows Phone
  • Mobi (Kindle)     (66.7 KB)
    عرض على جهاز Kindle أو تطبيق Kindle على أجهزة متعددة
تم التحديث:٦ أغسطس ٢٠٢٦
معرّف المستند:226235

لغة خالية من التحيز

تسعى مجموعة الوثائق لهذا المنتج جاهدة لاستخدام لغة خالية من التحيز. لأغراض مجموعة الوثائق هذه، يتم تعريف "خالية من التحيز" على أنها لغة لا تعني التمييز على أساس العمر، والإعاقة، والجنس، والهوية العرقية، والهوية الإثنية، والتوجه الجنسي، والحالة الاجتماعية والاقتصادية، والتمييز متعدد الجوانب. قد تكون الاستثناءات موجودة في الوثائق بسبب اللغة التي يتم تشفيرها بشكل ثابت في واجهات المستخدم الخاصة ببرنامج المنتج، أو اللغة المستخدمة بناءً على وثائق RFP، أو اللغة التي يستخدمها منتج الجهة الخارجية المُشار إليه. تعرّف على المزيد حول كيفية استخدام Cisco للغة الشاملة.

حول هذه الترجمة

ترجمت Cisco هذا المستند باستخدام مجموعة من التقنيات الآلية والبشرية لتقديم محتوى دعم للمستخدمين في جميع أنحاء العالم بلغتهم الخاصة. يُرجى ملاحظة أن أفضل ترجمة آلية لن تكون دقيقة كما هو الحال مع الترجمة الاحترافية التي يقدمها مترجم محترف. تخلي Cisco Systems مسئوليتها عن دقة هذه الترجمات وتُوصي بالرجوع دائمًا إلى المستند الإنجليزي الأصلي (الرابط متوفر).

المحتويات

مسألة

فشل 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 تعمل بشكل طبيعي.

note-icon

ملاحظة: المحاولات السابقة لحل هذه المشكلة عن طريق إستبعاد 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.

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

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

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

تمت المساهمة بواسطة مهندسو Cisco

  • أميت أرورا
    الشركة الرائدة التقنية للاستشارات الهندسية التقنية

هل كان هذا المستند مفيدًا؟

Feedbackالتعليقات

اتصل بنا

ينطبق هذا المستند على هذه المنتجات