SSL_CTX_SET1_VERIFY_CERT_STORE(3SSL)

الاسم
SSL_CTX_set0_verify_cert_store, SSL_CTX_set1_verify_cert_store, SSL_CTX_set0_chain_cert_store, SSL_CTX_set1_chain_cert_store, SSL_set0_verify_cert_store, SSL_set1_verify_cert_store, SSL_set0_chain_cert_store, SSL_set1_chain_cert_store, SSL_CTX_get0_verify_cert_store, SSL_CTX_get0_chain_cert_store, SSL_get0_verify_cert_store, SSL_get0_chain_cert_store - ضبط مخزن التحقق من الشهادة أو مخزن السلسلة

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

 int SSL_CTX_set0_verify_cert_store(SSL_CTX *ctx, X509_STORE *st);
 int SSL_CTX_set1_verify_cert_store(SSL_CTX *ctx, X509_STORE *st);
 int SSL_CTX_set0_chain_cert_store(SSL_CTX *ctx, X509_STORE *st);
 int SSL_CTX_set1_chain_cert_store(SSL_CTX *ctx, X509_STORE *st);
 int SSL_CTX_get0_verify_cert_store(SSL_CTX *ctx, X509_STORE **st);
 int SSL_CTX_get0_chain_cert_store(SSL_CTX *ctx, X509_STORE **st);

 int SSL_set0_verify_cert_store(SSL *ctx, X509_STORE *st);
 int SSL_set1_verify_cert_store(SSL *ctx, X509_STORE *st);
 int SSL_set0_chain_cert_store(SSL *ctx, X509_STORE *st);
 int SSL_set1_chain_cert_store(SSL *ctx, X509_STORE *st);
 int SSL_get0_verify_cert_store(SSL *ctx, X509_STORE **st);
 int SSL_get0_chain_cert_store(SSL *ctx, X509_STORE **st);

الوصف
SSL_CTX_set0_verify_cert_store() و SSL_CTX_set1_verify_cert_store() يضبطان مخزن الشهادة المُستخدم للتحقق من الشهادة إلى st.

SSL_CTX_set0_chain_cert_store() و SSL_CTX_set1_chain_cert_store() يضبطان مخزن الشهادة المُستخدم لبناء سلسلة الشهادات إلى st.

SSL_set0_verify_cert_store() و SSL_set1_verify_cert_store() و SSL_set0_chain_cert_store() و SSL_set1_chain_cert_store() متشابهة باستثناء أنها تُطبق على بنية SSL ssl.

SSL_CTX_get0_verify_chain_store() و SSL_get0_verify_chain_store() و SSL_CTX_get0_chain_cert_store() و SSL_get0_chain_cert_store() تسترجع الكائنات التي وُضعت سابقًا عبر الاستدعاءات أعلاه. يُكتب مؤشر إلى الكائن (أو NULL إذا لم يُوضع أي كائن من هذا القبيل) إلى *st.

جميع هذه الدوال مُنفذة ككليشيهات. تلك التي تحتوي على 1 تزيد عدد المراجع للمخزن المُقدم لذا يجب تحريره في وقت ما بعد العملية. تلك التي تحتوي على 0 لا تزيد عدد المراجع والمخزن المُقدم يجب ألا يُحرر بعد العملية.

ملاحظات
مؤشرات المخازن المرتبطة ببنية SSL_CTX تُنسخ إلى أي بنيات SSL عند استدعاء SSL_new(). نتيجة لذلك، لا تتأثر بنيات SSL إذا وُضع مؤشر مخزن SSL_CTX الأصلي إلى قيمة جديدة.

يُستخدم مخزن التحقق للتحقق من سلسلة الشهادات المُرسلة من النظير: أي أن عميل SSL/TLS يستخدم مخزن التحقق للتحقق من سلسلة شهادات الخادم، وخادم SSL/TLS يستخدمه للتحقق من أي سلسلة شهادات عميل.

يُستخدم مخزن السلسلة لبناء سلسلة الشهادات. تفاصيل عملية بناء السلسلة والتحقق منها موصوفة في "بناء مسار التصديق" في openssl-verification-options(1) و"التحقق من مسار التصديق" في openssl-verification-options(1).

إذا وُضع الوضع SSL_MODE_NO_AUTO_CHAIN أو إذا كانت سلسلة الشهادات مُهيأة بالفعل (مثلاً باستخدام دوال مثل SSL_CTX_add1_chain_cert(3) أو SSL_CTX_add_extra_chain_cert(3)) فإن بناء السلسلة الآلي يُعطل.

إذا وُضع الوضع SSL_MODE_NO_AUTO_CHAIN فإن بناء السلسلة الآلي يُعطل.

إذا لم يُوضع مخزن السلسلة أو مخزن التحقق، يُستخدم المخزن المرتبط بـ SSL_CTX الأصلي بدلاً من ذلك للحفاظ على التوافق مع الإصدارات السابقة من OpenSSL.

القيم المُرجعة
جميع هذه الدوال تُرجع 1 للنجاح و0 للفشل.

انظر أيضًا
ssl(7), SSL_CTX_add_extra_chain_cert(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)

التاريخ
أُضيفت هذه الدوال في OpenSSL 1.0.2.

حقوق النسخ
حقوق النشر 2013-2022 لمؤلفي مشروع 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.