.\" -*- coding: UTF-8 -*-
.de  Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
.\"
.\" Standard preamble:
.\" ========================================================================
.de  Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de  Ve \" End verbatim text
.ft R
.fi
..
.ie  n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds C`
.    ds C'
'br\}
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie  \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.de  IX
..
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.nr rF 0
.if  \n(.g .if rF .nr rF 1
.if  (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.if  n .ds AD l
.\"
.\" Required to disable full justification in groff 1.23.0.
.\" ========================================================================
.\"
.IX Title "SSL_CTX_SET_CIPHER_LIST 3ssl"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH SSL_CTX_SET_CIPHER_LIST 3ssl "7 أبريل 2026" 3.6.2 OpenSSL
.if  n .ad l
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.nh
.SH الاسم
SSL_CTX_set_cipher_list, SSL_set_cipher_list, SSL_CTX_set_ciphersuites,
SSL_set_ciphersuites, OSSL_default_cipher_list, OSSL_default_ciphersuites
\&\- اختيار قائمة SSL_CIPHERs المتاحة
.SH موجز
.IX Header موجز
.Vb 1
\& #include <openssl/ssl.h>
\&
\& int SSL_CTX_set_cipher_list(SSL_CTX *ctx, const char *str);
\& int SSL_set_cipher_list(SSL *ssl, const char *str);
\&
\& int SSL_CTX_set_ciphersuites(SSL_CTX *ctx, const char *str);
\& int SSL_set_ciphersuites(SSL *s, const char *str);
\&
\& const char *OSSL_default_cipher_list(void);
\& const char *OSSL_default_ciphersuites(void);
.Ve
.SH الوصف
.IX Header الوصف
\&\fBSSL_CTX_set_cipher_list()\fP تُعيِّن قائمة المُعمِّيات المتاحة (TLSv1.2
وما دونه) لـ \fBctx\fP باستخدام سلسلة التحكم \fBstr\fP. يُوصف تنسيق السلسلة في
\fBopenssl\-ciphers\fP\|(1). تُورث قائمة المُعمِّيات بواسطة جميع كائنات \&\fBssl\fP
المنشأة من \fBctx\fP. لا تؤثر هذه الدالة على مجموعات المُعمِّيات
TLSv1.3. استخدم \fBSSL_CTX_set_ciphersuites()\fP لتكوينها. \fBctx\fP \fBيجب ألا\fP
يكون NULL.
.PP
\&\fBSSL_set_cipher_list()\fP تُعيِّن قائمة المُعمِّيات (TLSv1.2 وما دونه) فقط
لـ \&\fBssl\fP.
.PP
\&\fBSSL_CTX_set_ciphersuites()\fP تُستخدم لتكوين مجموعات المُعمِّيات TLSv1.3
المتاحة لـ \fBctx\fP. هذه قائمة بسيطة مفصولة بنقطتين (":") لأسماء مجموعات
المُعمِّيات TLSv1.3 حسب ترتيب الأفضلية. أسماء مجموعات المُعمِّيات TLSv1.3
الصالحة هي:
.IP TLS_AES_128_GCM_SHA256 4
.IX Item TLS_AES_128_GCM_SHA256
.PD 0
.IP TLS_AES_256_GCM_SHA384 4
.IX Item TLS_AES_256_GCM_SHA384
.IP TLS_CHACHA20_POLY1305_SHA256 4
.IX Item TLS_CHACHA20_POLY1305_SHA256
.IP TLS_AES_128_CCM_SHA256 4
.IX Item TLS_AES_128_CCM_SHA256
.IP TLS_AES_128_CCM_8_SHA256 4
.IX Item TLS_AES_128_CCM_8_SHA256
.IP "TLS_SHA384_SHA384 \- سلامة فقط" 4
.IX Item "TLS_SHA384_SHA384 \- سلامة فقط"
.IP "TLS_SHA256_SHA256 \- سلامة فقط" 4
.IX Item "TLS_SHA256_SHA256 \- سلامة فقط"
.PD
.PP
القائمة الفارغة مسموحة. القيمة المبدئية لهذا الإعداد هي:
.PP
"TLS_AES_256_GCM_SHA384:TLS_CHACHA20_POLY1305_SHA256:TLS_AES_128_GCM_SHA256"
.PP
\&\fBSSL_set_ciphersuites()\fP مماثلة لـ \fBSSL_CTX_set_ciphersuites()\fP باستثناء
أنها تُكوِّن مجموعات المُعمِّيات لـ \fBssl\fP.
.PP
\&\fBOSSL_default_cipher_list()\fP تُرجع سلسلة المُعمِّي المبدئية لمُعمِّيات
TLSv1.2 (وما قبله). \fBOSSL_default_ciphersuites()\fP تُرجع سلسلة المُعمِّي
المبدئية لمجموعات المُعمِّيات TLSv1.3.
.SH ملاحظات
.IX Header ملاحظات
سلسلة التحكم \fBstr\fP لـ \fBSSL_CTX_set_cipher_list()\fP و
\fBSSL_set_cipher_list()\fP و \&\fBSSL_CTX_set_ciphersuites()\fP و
\fBSSL_set_ciphersuites()\fP يجب أن تكون قابلة للاستخدام عالميًا وألا تعتمد على
تفاصيل تكوين المكتبة (المُعمِّيات المترجمة). لذلك لا يُجرى أي فحص
نحوي. العناصر غير المعروفة، لأن المُعمِّيات المقابلة غير مترجمة أو لأنها
كُتبت بشكل خاطئ، تُتجاهل ببساطة. يُشار إلى الفشل فقط إذا لم يُجمع أي مُعمِّي
على الإطلاق.
.PP
يُشار إلى أن تضمين مُعمِّي لاستخدامه في القائمة هو شرط ضروري. في جانب
العميل، التضمين في القائمة كافٍ أيضًا ما لم يستبعده مستوى الأمان. في جانب
الخادم، تُطبق قيود إضافية. جميع المُعمِّيات لها متطلبات إضافية. مُعمِّيات
ADH لا تحتاج إلى شهادة، لكن معاملات DH يجب أن تكون قد وُضعت. جميع
المُعمِّيات الأخرى تحتاج إلى شهادة ومفتاح مقابلين.
.PP
لا يمكن اختيار مُعمّي RSA إلا عند توفر شهادة RSA. تحتاج مُعمّيات RSA التي
تستخدم DHE إلى شهادة ومفتاح ومعاملات DH إضافية (انظر
\fBSSL_CTX_set_tmp_dh_callback\fP\|(3)).
.PP
لا يمكن اختيار مُعمّي DSA إلا عند توفر شهادة DSA. تستخدم مُعمّيات DSA دائمًا
تبادل مفاتيح DH، وبالتالي تحتاج إلى معاملات DH (انظر
\fBSSL_CTX_set_tmp_dh_callback\fP\|(3)).
.PP
عندما لا تُستوفى هذه الشروط لأي مُعمّي في القائمة (مثلًا، يدعم العميل فقط
مُعمّيات RSA للتصدير بطول مفتاح غير متماثل يبلغ 512 بت، ولم يُهيأ الخادم
لاستخدام مفاتيح RSA مؤقتة)، يُنشأ خطأ "لا يوجد مُعمّي مشترك"
(SSL_R_NO_SHARED_CIPHER) وسيفشل المصافحة.
.PP
\&\fBOSSL_default_cipher_list()\fP و \fBOSSL_default_ciphersuites()\fP تستبدلان
SSL_DEFAULT_CIPHER_LIST و TLS_DEFAULT_CIPHERSUITES على التوالي. تعريفات
قائمة المُعمّيات مُهملة اعتبارًا من الإصدار 3.0.
.SH "القيم المُرجعة"
.IX Header "القيم المُرجعة"
\&\fBSSL_CTX_set_cipher_list()\fP و \fBSSL_set_cipher_list()\fP تُرجعان 1 إذا أمكن
اختيار أي مُعمّي، و0 عند الفشل التام.
.PP
\&\fBSSL_CTX_set_ciphersuites()\fP و \fBSSL_set_ciphersuites()\fP تُرجعان 1 إذا تم
تكوين قائمة حُزم المُعمّيات المطلوبة، و0 بخلاف ذلك.
.SH "انظر أيضًا"
.IX Header "انظر أيضًا"
\&\fBssl\fP\|(7), \fBSSL_get_ciphers\fP\|(3), \&\fBSSL_CTX_use_certificate\fP\|(3),
\&\fBSSL_CTX_set_tmp_dh_callback\fP\|(3), \&\fBopenssl\-ciphers\fP\|(1)
.SH التاريخ
.IX Header التاريخ
\&\fBOSSL_default_cipher_list()\fP و \fBOSSL_default_ciphersites()\fP جديدتان في
الإصدار 3.0.
.SH "حقوق النسخ"
.IX Header "حقوق النسخ"
حقوق النشر 2000\-2024 لمؤلفي مشروع OpenSSL. جميع الحقوق محفوظة.
.PP
مرخص بموجب رخصة Apache 2.0 (المشار إليها فيما يلي بـ ”الرخصة“).  لا يجوز لك
استخدام هذا الملف إلا وفقًا لشروط الرخصة.  يمكنك الحصول على نسخة منها في
الملف LICENSE الموجود في حزمة التوزيع المصدرية أو على الرابط
<https://www.openssl.org/source/license.html>.
.PP
.SH ترجمة
تُرجمت هذه الصفحة من الدليل بواسطة
زايد السعيدي <zayed.alsaidi@gmail.com>
.
.PP
هذه الترجمة هي وثيقة مجانية؛ راجع
.UR https://www.gnu.org/licenses/gpl-3.0.html 
رخصة جنو العامة الإصدار 3
.UE
أو ما بعده للاطلاع على شروط حقوق النشر.
لا توجد أي ضمانات.
.PP
إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه،
يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين:
.MT kde-l10n-ar@kde.org
.ME .