SSL_GET_VERIFY_RESULT(3ssl)

الاسم
SSL_get_verify_result - الحصول على نتيجة التحقق من شهادة النظير

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

 long SSL_get_verify_result(const SSL *ssl);

الوصف
SSL_get_verify_result() تُرجع نتيجة التحقق من شهادة X509 التي قدمها النظير، إن وُجدت. ssl يجب ألا يكون NULL.

ملاحظات
SSL_get_verify_result() يمكنها فقط إرجاع رمز خطأ واحد بينما يمكن أن يفشل التحقق من الشهادة لأسباب عديدة في نفس الوقت. فقط آخر خطأ تحقق حدث أثناء المعالجة يكون متاحًا من SSL_get_verify_result().

أحيانًا قد يكون هناك سلسلة من الأخطاء تؤدي إلى فشل التحقق كما يُبلغ عنه SSL_get_verify_result(). للحصول على الأخطاء، من الضروري إعداد استدعاء تحقق عبر SSL_CTX_set_verify(3) أو SSL_set_verify(3) واسترداد الأخطاء من مكدس الأخطاء هناك، لأنه بمجرد أن يُرجع SSL_connect(3)، قد لا تكون هذه الأخطاء متاحة بعد الآن.

نتيجة التحقق هي جزء من الجلسة المنشأة وتُستعاد عند إعادة استخدام جلسة.

العلل
إذا لم تُقدم شهادة نظير، فإن رمز النتيجة المُرجَع هو X509_V_OK. هذا لأنه لم يحدث خطأ تحقق، لكنه لا يشير إلى النجاح. SSL_get_verify_result() مفيدة فقط بالاقتران مع SSL_get_peer_certificate(3).

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

X509_V_OK
    نجح التحقق أو لم تُقدم شهادة نظير.

أي قيمة أخرى
    مُوثقة في openssl-verify(1).

انظر أيضًا
ssl(7), SSL_set_verify_result(3), SSL_get_peer_certificate(3), openssl-verify(1)

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