SSL_GET_PEER_CERTIFICATE(3SSL)

الاسم
SSL_get_peer_certificate, SSL_get0_peer_certificate, SSL_get1_peer_certificate - الحصول على شهادة X509 للنظير

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

 X509 *SSL_get0_peer_certificate(const SSL *ssl);
 X509 *SSL_get1_peer_certificate(const SSL *ssl);

الدالة التالية أصبحت مهجورة منذ OpenSSL 3.0، ويمكن إخفاؤها تمامًا عبر تعريف OPENSSL_API_COMPAT بقيمة إصدار مناسبة، انظر openssl_user_macros(7):

 X509 *SSL_get_peer_certificate(const SSL *ssl);

الوصف
تُعيد هذه الدوال مؤشرًا إلى شهادة X509 التي قدمها النظير. إذا لم يقدم النظير شهادة، يُعاد NULL.

ملاحظات
بسبب تعريف البروتوكول، يُرسل خادم TLS/SSL دائمًا شهادة، إن وُجدت. يُرسل العميل شهادة فقط عندما يُطلب منه ذلك صراحةً من قبل الخادم (انظر SSL_CTX_set_verify(3)). إذا استُخدم مُعمٍّ مجهول، لا تُرسل أي شهادات.

أن تُعاد شهادة لا يشير إلى معلومات حول حالة التحقق، استخدم SSL_get_verify_result(3) للتحقق من حالة التحقق.

يُزاد عدد مراجع كائن X509 الذي تُعيده SSL_get1_peer_certificate() بمقدار واحد، حتى لا يُدمر عند تحرير الجلسة التي تحتوي على شهادة النظير. يجب تحرير كائن X509 صراحةً باستخدام X509_free().

لا يُزاد عدد مراجع كائن X509 الذي تُعيده SSL_get0_peer_certificate()، ويجب ألا يُحرر.

SSL_get_peer_certificate() هو اسم مستعار لـ SSL_get1_peer_certificate().

القيم المُرجعة
يمكن أن تحدث قيم الإعادة التالية:

NULL
    لم تُقدم أي شهادة من قبل النظير أو لم يُنشأ أي اتصال.

مؤشر إلى شهادة X509
    تشير القيمة المُعادة إلى الشهادة التي قدمها النظير.

انظر أيضًا
ssl(7), SSL_get_verify_result(3), SSL_CTX_set_verify(3)

التاريخ
أُضيفت SSL_get0_peer_certificate() و SSL_get1_peer_certificate() في 3.0.0. أُهملت SSL_get_peer_certificate() في 3.0.0.

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