SSL_CTX_SET_TIMEOUT(3SSL)

الاسم
SSL_CTX_set_timeout, SSL_CTX_get_timeout - معالجة قيم المهلة للتخزين المؤقت للجلسات

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

 long SSL_CTX_set_timeout(SSL_CTX *ctx, long t);
 long SSL_CTX_get_timeout(SSL_CTX *ctx);

الوصف
SSL_CTX_set_timeout() يضبط المهلة للجلسات المنشأة حديثًا لـ ctx إلى t. يجب إعطاء قيمة المهلة t بالثواني.

SSL_CTX_get_timeout() يُرجع قيمة المهلة المضبوطة حاليًا لـ ctx.

ملاحظات
عند إنشاء جلسة جديدة، تُخصص لها عمر أقصى. يُحدد هذا العمر بتخزين وقت إنشاء الجلسة وقيمة المهلة السارية في هذا الوقت. إذا كان الوقت الفعلي لاحقًا لوقت الإنشاء زائد المهلة، لا تُعاد استخدام الجلسة.

بسبب هذا التحقيق، تتصرف جميع الجلسات وفقًا لقيمة المهلة السارية وقت التفاوض على الجلسة. لا تؤثر تغييرات قيمة المهلة على الجلسات المنشأة بالفعل.

يمكن تعديل وقت انتهاء صلاحية جلسة واحدة باستخدام عائلة الدوال SSL_SESSION_get_time(3).

تُزال الجلسات منتهية الصلاحية من خبيئة الجلسات الداخلية، كلما استُدعيت SSL_CTX_flush_sessions(3)، إما مباشرة من التطبيق أو آليًا (انظر SSL_CTX_set_session_cache_mode(3))

تُحدد القيمة المبدئية لمهلة الجلسة على أساس كل بروتوكول، انظر SSL_get_default_timeout(3). جميع البروتوكولات المدعومة حاليًا لها نفس القيمة المبدئية للمهلة وهي 300 ثانية.

تُستخدم قيمة المهلة هذه كتلميح عمر التذكرة لتذاكر الجلسات عديمة الحالة. تُستخدم أيضًا كقيمة المهلة داخل التذكرة نفسها.

لـ TLSv1.3، يحد RFC8446 نقل هذه القيمة إلى أسبوع واحد (604800 ثانية).

لـ TLSv1.2، تستخدم التذاكر المُنشأة أثناء المصافحة الأولية القيمة كما هو محدد. التذاكر المُنشأة أثناء مصافحة مستأنفة لها قيمة 0 لتلميح عمر التذكرة.

القيم المُرجعة
SSL_CTX_set_timeout() يُرجع قيمة المهلة المضبوطة سابقًا.

SSL_CTX_get_timeout() يُرجع قيمة المهلة المضبوطة حاليًا.

انظر أيضًا
ssl(7)، و SSL_CTX_set_session_cache_mode(3)، و SSL_SESSION_get_time(3)، و SSL_CTX_flush_sessions(3)، و SSL_get_default_timeout(3)

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