SSL_CTX_SET_SSL_VERSION(3SSL)

الاسم
SSL_CTX_set_ssl_version, SSL_CTX_get_ssl_method, SSL_set_ssl_method, SSL_get_ssl_method - اختيار أسلوب TLS/SSL جديد

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

 int SSL_CTX_set_ssl_version(SSL_CTX *ctx, const SSL_METHOD *method);
 const SSL_METHOD *SSL_CTX_get_ssl_method(const SSL_CTX *ctx);

 int SSL_set_ssl_method(SSL *s, const SSL_METHOD *method);
 const SSL_METHOD *SSL_get_ssl_method(const SSL *ssl);

الوصف
SSL_CTX_set_ssl_version() يضبط أسلوب TLS/SSL مبدئي جديد لكائنات SSL المنشأة حديثًا من هذا ctx. يُحتفظ بمعظم الإعدادات المرفقة بكائن SSL_CTX، باستثناء المُعمِّيات TLS المُهيأة، والتي تُعاد ضبطها إلى القيم المبدئية. كائنات SSL المنشأة بالفعل من هذا SSL_CTX باستخدام SSL_new(3) لا تتأثر، إلا عند استدعاء SSL_clear(3)، كما هو موصوف أدناه.

SSL_CTX_get_ssl_method() يُرجع SSL_METHOD الذي استُخدم لبناء SSL_CTX.

SSL_set_ssl_method() يضبط أسلوب TLS/SSL جديد لكائن ssl معين. قد يُعاد ضبطه عند استدعاء SSL_clear().

SSL_get_ssl_method() يُرجع مؤشرًا إلى أسلوب TLS/SSL المضبوط في ssl.

ملاحظات
خيارات method المتاحة موصوفة في SSL_CTX_new(3).

عند استدعاء SSL_clear(3) ولا توجد جلسة متصلة بكائن SSL، يُعاد ضبط أسلوب كائن SSL إلى الأسلوب المضبوط حاليًا في كائن SSL_CTX المقابل.

SSL_CTX_set_version() له دلالات غير معتادة ولا حالة استخدام واضحة؛ عادةً ما يُفضل إنشاء كائن SSL_CTX جديد بدلاً من محاولة إعادة استخدام كائن موجود بهذه الطريقة. يُعتبر استخدامه مهملاً.

SSL_set_ssl_method() لا يمكن استخدامه لتغيير كائن SSL غير QUIC إلى كائن SSL QUIC أو العكس، أو تغيير كائن SSL QUIC من أسلوب QUIC إلى آخر.

القيم المُرجعة
قد تحدث قيم الإرجاع التالية لـ SSL_CTX_set_ssl_version() و SSL_set_ssl_method():

0   فشل الاختيار الجديد، افحص مكدس الأخطاء لمعرفة السبب.

1   نجحت العملية.

SSL_CTX_get_ssl_method() و SSL_get_ssl_method() يُرجعان دائمًا مؤشرات غير NULL.

انظر أيضًا
SSL_CTX_new(3), SSL_new(3), SSL_clear(3), ssl(7), SSL_set_connect_state(3)

التاريخ
SSL_CTX_set_ssl_version() أُهمل في OpenSSL 3.0.

حقوق النسخ
حقوق النشر 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.