SSL_CTX_ADD_EXTRA_CHAIN_CERT(3ssl)

الاسم
SSL_CTX_add_extra_chain_cert, SSL_CTX_get_extra_chain_certs, SSL_CTX_get_extra_chain_certs_only, SSL_CTX_clear_extra_chain_certs - إضافة أو استرداد أو مسح شهادات السلسلة الإضافية

موجز
 #include <openssl/ssl.h>

 long SSL_CTX_add_extra_chain_cert(SSL_CTX *ctx, X509 *x509);
 long SSL_CTX_get_extra_chain_certs(SSL_CTX *ctx, STACK_OF(X509) **sk);
 long SSL_CTX_get_extra_chain_certs_only(SSL_CTX *ctx, STACK_OF(X509) **sk);
 long SSL_CTX_clear_extra_chain_certs(SSL_CTX *ctx);

الوصف
تضيف الدالة SSL_CTX_add_extra_chain_cert() الشهادة x509 إلى شهادات السلسلة الإضافية المرتبطة بـ ctx. يمكن إضافة عدة شهادات واحدة تلو الأخرى.

تسترجع الدالة SSL_CTX_get_extra_chain_certs() شهادات السلسلة الإضافية المرتبطة بـ ctx، أو السلسلة المرتبطة بالشهادة الحالية لـ ctx إذا كانت السلسلة الإضافية فارغة. لا ينبغي للمستدعي تحرير الكومة المُعادة.

تسترجع الدالة SSL_CTX_get_extra_chain_certs_only() شهادات السلسلة الإضافية المرتبطة بـ ctx. لا ينبغي للمستدعي تحرير الكومة المُعادة.

تمسح الدالة SSL_CTX_clear_extra_chain_certs() جميع شهادات السلسلة الإضافية المرتبطة بـ ctx.

هذه الدوال مُنفذة كوحدات ماكرو.

ملاحظات
عند إرسال سلسلة شهادات، تُرسل شهادات السلسلة الإضافية بالترتيب بعد شهادة الكيان النهائي.

إذا لم تُحدد أي سلسلة، تحاول المكتبة إكمال السلسلة من شهادات CA المتاحة في مخزن CA الموثوق، انظر SSL_CTX_load_verify_locations(3).

تُحرر المكتبة الشهادة x509 المُقدمة إلى SSL_CTX_add_extra_chain_cert() عند تدمير SSL_CTX. لا ينبغي للتطبيق تحرير كائن x509.

قيود
يمكن تحديد مجموعة واحدة فقط من شهادات السلسلة الإضافية لكل بنية SSL_CTX. لا يمكن تحديد سلاسل مختلفة لشهادات مختلفة (مثلاً إذا تم تحديد شهادتي RSA و DSA بواسطة نفس الخادم) أو بنى SSL مختلفة مع نفس SSL_CTX الأصلي باستخدام هذه الدالة. لمزيد من المرونة، ينبغي استخدام دوال مثل SSL_add1_chain_cert() بدلاً من ذلك.

القيم المُرجعة
تُرجع الدالتان SSL_CTX_add_extra_chain_cert() و SSL_CTX_clear_extra_chain_certs() 1 عند النجاح و 0 عند الفشل. افحص كومة الأخطاء لمعرفة سبب الفشل.

انظر أيضًا
ssl(7), SSL_CTX_use_certificate(3), SSL_CTX_set_client_cert_cb(3), SSL_CTX_load_verify_locations(3) SSL_CTX_set0_chain(3) SSL_CTX_set1_chain(3) SSL_CTX_add0_chain_cert(3) SSL_CTX_add1_chain_cert(3) SSL_set0_chain(3) SSL_set1_chain(3) SSL_add0_chain_cert(3) SSL_add1_chain_cert(3) SSL_CTX_build_cert_chain(3) SSL_build_cert_chain(3)

حقوق النسخ
حقوق الطبع والنشر 2000-2018 لمؤلفي مشروع OpenSSL. جميع الحقوق محفوظة.

مرخص بموجب رخصة Apache 2.0 (المشار إليها فيما يلي بـ ”الرخصة“). لا يجوز لك استخدام هذا الملف إلا وفقًا لشروط الرخصة. يمكنك الحصول على نسخة منها في الملف LICENSE الموجود في حزمة التوزيع المصدرية أو على الرابط <https://www.openssl.org/source/license.html>.

ترجمة
تُرجمت هذه الصفحة من الدليل بواسطة زايد السعيدي <zayed.alsaidi@gmail.com>

هذه الترجمة هي وثيقة مجانية؛ راجع رخصة جنو العامة الإصدار 3 (https://www.gnu.org/licenses/gpl-3.0.html) أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات.

إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه، يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين: kde-l10n-ar@kde.org.