.\" -*- 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 "X509V3_CONFIG 5ssl" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH X509V3_CONFIG 5ssl "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 الاسم x509v3_config \- تنسيق ضبط امتداد شهادة X509 V3 .SH الوصف .IX Header الوصف تستطيع عدة أوامر من OpenSSL إضافة امتدادات إلى شهادة أو طلب شهادة بناءً على محتويات ملف ضبط وخيارات سطر الأوامر مثل \fB\-addext\fP. تُوصف صيغة ملفات الضبط في \fBconfig\fP\|(5). عادةً ما تحتوي الأوامر على خيار لتحديد اسم ملف الضبط، وقسم داخل ذلك الملف؛ انظر توثيق كل أمر للحصول على التفاصيل. .PP تستخدم هذه الصفحة \fBextensions\fP كاسم للقسم، عند الحاجة لذلك في الأمثلة. .PP يتخذ كل إدخال في قسم الامتداد الصيغة: .PP .Vb 1 \& name = [critical, ]value(s) .Ve .PP إذا وُجد \fBcritical\fP، فسيُعلم الامتداد على أنه حرج. .PP إذا عُولجت إدخالات متعددة لنفس اسم الامتداد، فإن الإدخالات اللاحقة تتجاوز السابقة التي تحمل نفس الاسم. .PP يعتمد تنسيق \fBvalues\fP على قيمة \fBname\fP، فالكثير منها يحتوي على زوج من النوع والقيمة حيث يُفصل بين النوع والقيمة بنقطتين رأسيتين. هناك أربعة أنواع رئيسة للامتدادات: .PP .Vb 4 \& string \& multi\-valued \& raw \& arbitrary .Ve .PP يُوصف كل منها في الفقرات التالية. .PP تحتوي الامتدادات السلسلة ببساطة على سلسلة نصية تتضمن إما القيمة نفسها أو كيفية الحصول عليها. .PP للامتدادات متعددة القيم شكل قصير وشكل طويل. الشكل القصير هو قائمة مفصولة بفواصل من الأسماء والقيم: .PP .Vb 1 \& basicConstraints = critical, CA:true, pathlen:1 .Ve .PP يسمح الشكل الطويل بوضع القيم في قسم منفصل: .PP .Vb 2 \& [extensions] \& basicConstraints = critical, @basic_constraints \& \& [basic_constraints] \& CA = true \& pathlen = 1 .Ve .PP كلا الشكلين متكافئان. .PP إذا كان الامتداد متعدد القيم ويجب أن تحتوي قيمة الحقل على فاصلة، فيجب استخدام الشكل الطويل، وإلا فسيُساء فهم الفاصلة على أنها فاصل حقول. على سبيل المثال: .PP .Vb 1 \& subjectAltName = URI:ldap://somehost.com/CN=foo,OU=bar .Ve .PP سيؤدي إلى خطأ، لكن الشكل المكافئ: .PP .Vb 2 \& [extensions] \& subjectAltName = @subject_alt_section \& \& [subject_alt_section] \& subjectAltName = URI:ldap://somehost.com/CN=foo,OU=bar .Ve .PP صحيح. .PP لا يدعم OpenSSL التكرارات المتعددة لنفس الحقل داخل القسم. في هذا المثال: .PP .Vb 2 \& [extensions] \& subjectAltName = @alt_section \& \& [alt_section] \& email = steve@example.com \& email = steve@example.org .Ve .PP سيتعرف فقط على القيمة الأخيرة. لتحديد قيم متعددة، ألحق معرفًا رقميًا، كما هو موضح هنا: .PP .Vb 2 \& [extensions] \& subjectAltName = @alt_section \& \& [alt_section] \& email.1 = steve@example.com \& email.2 = steve@example.org .Ve .PP تُحدد صيغة الامتدادات الخام بواسطة الشيفرة المصدرية التي تحلل الامتداد ولكن ينبغي توثيقها. انظر "سياسات الشهادة" للحصول على مثال لامتداد خام. .PP إذا كان نوع الامتداد غير مدعوم، فيجب استخدام صيغة الامتداد \fIالاعتباطي\fP، انظر قسم "الامتدادات الاعتباطية" لمزيد من التفاصيل. .SH "الامتدادات القياسية" .IX Header "الامتدادات القياسية" تصف الأقسام التالية صيغة كل امتداد مدعوم. وهي لا تُعرّف دلالات الامتداد. .SS "القيود الأساسية" .IX Subsection "القيود الأساسية" هذا امتداد متعدد القيم يشير إلى ما إذا كانت الشهادة شهادة CA. القيمة الأولى هي \fBCA\fP متبوعة بـ \fBTRUE\fP أو \fBFALSE\fP. إذا كانت \fBCA\fP تساوي \fBTRUE\fP، فيمكن تضمين اسم \fBpathlen\fP اختياري متبوعًا بقيمة غير سالبة. .PP على سبيل المثال: .PP .Vb 1 \& basicConstraints = CA:TRUE \& \& basicConstraints = CA:FALSE \& \& basicConstraints = critical, CA:TRUE, pathlen:1 .Ve .PP يجب \fIأن\fP تتضمن شهادة CA اسم \fBbasicConstraints\fP مع ضبط معامل \fBCA\fP على \fBTRUE\fP. يجب أن تحتوي شهادة المستخدم النهائي إما على \fBCA:FALSE\fP أو حذف الامتداد تمامًا. يحدد معامل \fBpathlen\fP الحد الأقصى لعدد شهادات CA التي يمكن أن تظهر أسفل هذه الشهادة في سلسلة. تعني قيمة \fBpathlen\fP الصفرية أن CA لا يمكنه توقيع أي شهادات CA فرعية، ولا يمكنه سوى توقيع شهادات كيانات النهاية. .SS "استخدام المفتاح" .IX Subsection "استخدام المفتاح" استخدام المفتاح هو امتداد متعدد القيم يتكون من قائمة بأسماء استخدامات المفاتيح المسموح بها. القيم المُعرّفة هي: \f(CW\*(C`digitalSignature\*(C'\fP، و \&\f(CW\*(C`nonRepudiation\*(C'\fP (مع اسم بديل هو \f(CW\*(C`contentCommitment\*(C'\fP)، \&\f(CW\*(C`keyEncipherment\*(C'\fP، و \f(CW\*(C`dataEncipherment\*(C'\fP، و \f(CW\*(C`keyAgreement\*(C'\fP، و \f(CW\*(C`keyCertSign\*(C'\fP، \&\f(CW\*(C`cRLSign\*(C'\fP، و \f(CW\*(C`encipherOnly\*(C'\fP، و \f(CW\*(C`decipherOnly\*(C'\fP. .PP أمثلة: .PP .Vb 1 \& keyUsage = digitalSignature, nonRepudiation \& \& keyUsage = digitalSignature, contentCommitment \& \& keyUsage = critical, keyCertSign .Ve .SS "استخدام المفتاح الموسع" .IX Subsection "استخدام المفتاح الموسع" يتكون هذا الامتداد من قائمة قيم تشير إلى الأغراض التي يمكن استخدام مفتاح الشهادة العام لأجلها. يمكن أن تكون كل قيمة إما اسمًا نصيًا قصيرًا أو OID. الأسماء النصية التالية، ومعناها المقصود، معروفة: .PP .Vb 10 \& Value Meaning according to RFC 5280 etc. \& \-\-\-\-\- \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \& serverAuth SSL/TLS WWW Server Authentication \& clientAuth SSL/TLS WWW Client Authentication \& codeSigning Code Signing \& emailProtection E\-mail Protection (S/MIME) \& timeStamping Trusted Timestamping \& OCSPSigning OCSP Signing \& ipsecIKE ipsec Internet Key Exchange \& msCodeInd Microsoft Individual Code Signing (authenticode) \& msCodeCom Microsoft Commercial Code Signing (authenticode) \& msCTLSign Microsoft Trust List Signing \& msEFS Microsoft Encrypted File System .Ve .PP بينما تقول IETF RFC 5280 أن \fBid\-kp\-serverAuth\fP و \fBid\-kp\-clientAuth\fP مخصصان فقط لاستخدام WWW، إلا أنهما في الواقع يُستخدمان لجميع أنواع عملاء وخوادم TLS، وهذا ما يفترضه OpenSSL أيضًا. .PP أمثلة: .PP .Vb 1 \& extendedKeyUsage = critical, codeSigning, 1.2.3.4 \& \& extendedKeyUsage = serverAuth, clientAuth .Ve .SS "معرّف مفتاح الموضوع" .IX Subsection "معرّف مفتاح الموضوع" مواصفة امتداد SKID لها قيمة ذات ثلاثة خيارات. .IP \fBnone\fP 4 .IX Item "لا يوجد" لن يُضمن أي امتداد SKID. .IP \fBhash\fP 4 .IX Item hash تُتبع العملية المحددة في RFC 5280 القسم 4.2.1.2. (1): يتكون keyIdentifier من تجزئة SHA\-1 بطول 160 بت لقيمة BIT STRING subjectPublicKey (باستثناء الوسم، والطول، وعدد البتات غير المستخدمة). .ie n .IP "A hex string (possibly with "":"" separating bytes)" 4 .el .IP "A hex string (possibly with \f(CW:\fR separating bytes)" 4 .IX Item "سلسلة ست عشرية (ربما مع : تفصل البايتات)" تُخرج القيمة المقدمة مباشرة. لا يُنصح بهذا الخيار بشدة. .PP مبدئيًا، تتصرف تطبيقات \fBx509\fP، و \fBreq\fP، و \fBca\fP كما لو أُعطي \fBhash\fP. .PP مثال: .PP .Vb 1 \& subjectKeyIdentifier = hash .Ve .SS "معرّف مفتاح المرجع" .IX Subsection "معرّف مفتاح المرجع" قد تحمل مواصفة امتداد AKID القيمة \fBnone\fP مما يشير إلى عدم تضمين AKID. وإلا فقد تحمل القيمة \fBkeyid\fP أو \fBissuer\fP أو كليهما، مفصولين بـ \f(CW\*(C`,\*(C'\fP. يمكن لأي منهما أو كليهما الحصول على خيار \fBalways\fP، المشار إليه بوضع نقطتين رأسيتين \f(CW\*(C`:\*(C'\fP بين القيمة وهذا الخيار. بالنسبة للشهادات الموقعة ذاتيًا، يُحجب AKID ما لم يكن \fBalways\fP موجودًا. .PP مبدئيًا، تتصرف تطبيقات \fBx509\fP، و \fBreq\fP، و \fBca\fP كما لو أُعطي \fBnone\fP للشهادات الموقعة ذاتيًا و \fBkeyid\fP\f(CW\*(C`,\*(C'\fP \fBissuer\fP بخلاف ذلك. .PP إذا وُجد \fBkeyid\fP، تُبذل محاولة لنسخ معرّف مفتاح الموضوع (SKID) من شهادة المرجع، إلا إذا كانت شهادة المرجع هي نفسها الحالية ولم تكن موقعة ذاتيًا. تُؤخذ تجزئة المفتاح العام المتعلق بمفتاح التوقيع كبديل إذا كانت شهادة المرجع هي نفسها الشهادة الحالية. إذا كان \fBalways\fP موجودًا ولكن تعذر الحصول على أي قيمة، فإنه يُرجع خطأ. .PP إذا وُجد \fBissuer\fP، بالإضافة إلى تحديد الخيار \fBalways\fP أو عدم وجود \fBkeyid\fP، فإن DN المرجع والرقم التسلسلي يُنسخان من شهادة المرجع. إذا فشل ذلك، فإنه يُرجع خطأ. .PP أمثلة: .PP .Vb 1 \& authorityKeyIdentifier = keyid, issuer \& \& authorityKeyIdentifier = keyid, issuer:always .Ve .SS "اسم الموضوع البديل" .IX Subsection "اسم الموضوع البديل" هذا امتداد متعدد القيم يدعم عدة أنواع من معرّفات الأسماء، بما في ذلك \&\fBemail\fP (عنوان بريد إلكتروني)، \&\fBURI\fP (مؤشر مورد موحد)، \&\fBDNS\fP (اسم نطاق DNS)، \&\fBRID\fP (معرّف مسجل: OBJECT IDENTIFIER)، \&\fBIP\fP (عنوان IP)، \&\fBdirName\fP (اسم مميز)، و \fBotherName\fP. تُوصف صيغة كل منها في الفقرات التالية. .PP يحتوي خيار \fBemail\fP على قيمتين خاصتين. \&\f(CW\*(C`copy\*(C'\fP سيضمن آليًا أي عناوين بريد إلكتروني مضمنة في اسم موضوع الشهادة في الامتداد. \&\f(CW\*(C`move\*(C'\fP سينقل آليًا أي عناوين بريد إلكتروني من اسم موضوع الشهادة إلى الامتداد. .PP يمكن أن يكون عنوان IP المستخدم في خيار \fBIP\fP بتنسيق IPv4 أو IPv6. .PP تحدد قيمة \fBdirName\fP قسم الضبط الذي يحتوي على الاسم المميز المُراد استخدامه، كمجموعة من أزواج الاسم والقيمة. يمكن تشكيل AVAs متعددة القيم عن طريق وضع حرف \fB+\fP قبل الاسم. .PP يمكن أن تتضمن قيمة \fBotherName\fP بيانات اعتباطية مرتبطة بـ OID؛ يجب أن تكون القيمة هي OID متبوعة بفاصلة منقوطة والمحتوى المحدّد باستخدام الصيغة في \fBASN1_generate_nconf\fP\|(3). .PP أمثلة: .PP .Vb 1 \& subjectAltName = email:copy, email:my@example.com, URI:http://my.example.com/ \& \& subjectAltName = IP:192.168.7.1 \& \& subjectAltName = IP:13::17 \& \& subjectAltName = email:my@example.com, RID:1.2.3.4 \& \& subjectAltName = otherName:1.2.3.4;UTF8:some other identifier \& \& [extensions] \& subjectAltName = dirName:dir_sect \& \& [dir_sect] \& C = UK \& O = My Organization \& OU = My Unit \& CN = My Name .Ve .PP تُقدّم عناوين البريد الإلكتروني غير ASCII التي تتوافق مع الصيغة المحددة في القسم 3.3 من RFC 6531 كـ otherName.SmtpUTF8Mailbox. وفقًا لـ RFC 8398، ينبغي تقديم عنوان البريد الإلكتروني كـ UTF8String. لفرض التمثيل الصحيح في الشهادة، ينبغي تقديم SmtpUTF8Mailbox كما يلي .PP .Vb 3 \& subjectAltName=@alts \& [alts] \& otherName = 1.3.6.1.5.5.7.8.9;FORMAT:UTF8,UTF8String:nonasciiname.example.com .Ve .SS "اسم المرجع البديل" .IX Subsection "اسم المرجع البديل" يدعم هذا الامتداد معظم خيارات اسم الموضوع البديل؛ وهو لا يدعم \fBemail:copy\fP. كما أنه يضيف \fBissuer:copy\fP كقيمة مسموح بها، والتي تنسخ أي أسماء موضوع بديلة من شهادة المرجع، إن أمكن. .PP مثال: .PP .Vb 1 \& issuerAltName = issuer:copy .Ve .SS "وصول معلومات المرجع" .IX Subsection "وصول معلومات المرجع" يعطي هذا الامتداد تفاصيل حول كيفية استرجاع المعلومات المتعلقة بالشهادة التي يوفرها CA. الصيغة هي \&\fBaccess_id;location\fP، حيث \fBaccess_id\fP هو معرّف كائن (على الرغم من أن بضع قيم فقط معروفة جيدًا) و \fBlocation\fP له نفس صيغة اسم الموضوع البديل (باستثناء أن \fBemail:copy\fP غير مدعوم). .PP القيم المحتملة لـ access_id تتضمن \fBOCSP\fP (مستجيب OCSP)، \&\fBcaIssuers\fP (مصدرو CA)، \&\fBad_timestamping\fP (طابع زمني AD)، \&\fBAD_DVCS\fP (ad dvcs)، \&\fBcaRepository\fP (مستودع CA). .PP أمثلة: .PP .Vb 1 \& authorityInfoAccess = OCSP;URI:http://ocsp.example.com/,caIssuers;URI:http://myca.example.com/ca.cer \& \& authorityInfoAccess = OCSP;URI:http://ocsp.example.com/ .Ve .SS "نقاط توزيع CRL" .IX Subsection "نقاط توزيع CRL" هذا امتداد متعدد القيم يمكن أن تكون قيمه إما زوج اسم\-قيمة باستخدام نفس صيغة الاسم البديل للموضوع (subject alternative name) أو قيمة واحدة تحدد اسم القسم الذي يحتوي على جميع قيم نقطة التوزيع. .PP عند استخدام زوج اسم\-قيمة، سيُضبط امتداد DistributionPoint بالقيمة المعطاة كحقل fullName كقيمة لـ distributionPoint، وسيُهمل حقلا reasons و cRLIssuer. .PP عند استخدام خيار واحد، تحدد القيمة القسم، ويمكن أن يحتوي ذلك القسم على العناصر التالية: .IP fullname 4 .IX Item fullname الاسم الكامل لنقطة التوزيع، بنفس صيغة الاسم البديل للموضوع. .IP relativename 4 .IX Item relativename تُؤخذ القيمة كجزء من الاسم المميز (distinguished name) الذي يُضبط كقيمة لحقل nameRelativeToCRLIssuer. .IP CRLIssuer 4 .IX Item CRLIssuer يجب أن تكون القيمة بنفس صيغة الاسم البديل للموضوع. .IP reasons 4 .IX Item reasons حقل متعدد القيم يحتوي على أسباب الإبطال. القيم المتعارف عليها هي: \f(CW\*(C`keyCompromise\*(C'\fP، \f(CW\*(C`CACompromise\*(C'\fP، \f(CW\*(C`affiliationChanged\*(C'\fP، \&\f(CW\*(C`superseded\*(C'\fP، \f(CW\*(C`cessationOfOperation\*(C'\fP، \f(CW\*(C`certificateHold\*(C'\fP، \&\f(CW\*(C`privilegeWithdrawn\*(C'\fP، و \f(CW\*(C`AACompromise\*(C'\fP. .PP يجب تحديد أحد \fBfullname\fP أو \fBrelativename\fP فقط. .PP أمثلة بسيطة: .PP .Vb 1 \& crlDistributionPoints = URI:http://example.com/myca.crl \& \& crlDistributionPoints = URI:http://example.com/myca.crl, URI:http://example.org/my.crl .Ve .PP مثال على نقطة توزيع كاملة: .PP .Vb 2 \& [extensions] \& crlDistributionPoints = crldp1_section \& \& [crldp1_section] \& fullname = URI:http://example.com/myca.crl \& CRLissuer = dirName:issuer_sect \& reasons = keyCompromise, CACompromise \& \& [issuer_sect] \& C = UK \& O = Organisation \& CN = Some Name .Ve .SS "نقطة توزيع الإصدار" .IX Subsection "نقطة توزيع الإصدار" يجب ألا يظهر هذا الامتداد إلا في CRLs. وهو امتداد متعدد القيم تماثل صيغته صيغة "القسم" الذي تشير إليه امتداد نقاط توزيع CRL. للأسماء التالية معنى: .IP fullname 4 .IX Item fullname الاسم الكامل لنقطة التوزيع، بنفس صيغة الاسم البديل للموضوع. .IP relativename 4 .IX Item relativename تُؤخذ القيمة كجزء من الاسم المميز (distinguished name) الذي يُضبط كقيمة لحقل nameRelativeToCRLIssuer. .IP onlysomereasons 4 .IX Item onlysomereasons حقل متعدد القيم يحتوي على أسباب الإبطال. القيم المتعارف عليها هي: \f(CW\*(C`keyCompromise\*(C'\fP، \f(CW\*(C`CACompromise\*(C'\fP، \f(CW\*(C`affiliationChanged\*(C'\fP، \&\f(CW\*(C`superseded\*(C'\fP، \f(CW\*(C`cessationOfOperation\*(C'\fP، \f(CW\*(C`certificateHold\*(C'\fP، \&\f(CW\*(C`privilegeWithdrawn\*(C'\fP، و \f(CW\*(C`AACompromise\*(C'\fP. .IP "onlyuser, onlyCA, onlyAA, indirectCRL" 4 .IX Item "onlyuser, onlyCA, onlyAA, indirectCRL" قيمة كل من هذه الأسماء هي قيمة منطقية (boolean). .PP مثال: .PP .Vb 2 \& [extensions] \& issuingDistributionPoint = critical, @idp_section \& \& [idp_section] \& fullname = URI:http://example.com/myca.crl \& indirectCRL = TRUE \& onlysomereasons = keyCompromise, CACompromise .Ve .SS "سياسات الشهادة" .IX Subsection "سياسات الشهادة" هذا امتداد \fIخام\fP يدعم جميع الحقول المعرفة لامتداد الشهادة. .PP تُحدد السياسات بدون مؤهلات بإعطاء OID. تُفصل السياسات المتعددة بفواصل. على سبيل المثال: .PP .Vb 1 \& certificatePolicies = 1.2.4.5, 1.1.3.4 .Ve .PP لتضمين مؤهلات السياسة، استخدم صيغة "@section" للإشارة إلى قسم يحدد جميع المعلومات. .PP يجب أن يتضمن القسم المشار إليه OID السياسة باستخدام الاسم \&\fBpolicyIdentifier\fP. يمكن تضمين مؤهلات cPSuri باستخدام الصيغة: .PP .Vb 1 \& CPS.nnn = value .Ve .PP حيث \f(CW\*(C`nnn\*(C'\fP هو رقم. .PP يمكن ضبط مؤهلات userNotice باستخدام الصيغة: .PP .Vb 1 \& userNotice.nnn = @notice .Ve .PP تُحدد قيمة مؤهل userNotice في القسم ذي الصلة. يمكن أن يتضمن هذا القسم خيارات \fBexplicitText\fP، و \fBorganization\fP، و \fBnoticeNumbers\fP. خيارا explicitText و organization هما سلسلتان نصيتان، بينما noticeNumbers هو قائمة أرقام مفصولة بفواصل. يجب أن يكون خيارا organization و noticeNumbers (إذا أُدرجا) موجودين كلاهما. قد تتطلب بعض البرمجيات خيار \fBia5org\fP في المستوى الأعلى؛ حيث يغير هذا الترميز من Displaytext إلى IA5String. .PP مثال: .PP .Vb 2 \& [extensions] \& certificatePolicies = ia5org, 1.2.3.4, 1.5.6.7.8, @polsect \& \& [polsect] \& policyIdentifier = 1.3.5.8 \& CPS.1 = "http://my.host.example.com/" \& CPS.2 = "http://my.your.example.com/" \& userNotice.1 = @notice \& \& [notice] \& explicitText = "Explicit Text Here" \& organization = "Organisation Name" \& noticeNumbers = 1, 2, 3, 4 .Ve .PP يمكن تحديد ترميز محارف explicitText عن طريق إضافة البادئة \fBUTF8\fP، أو \fBBMP\fP، أو \fBVISIBLE\fP متبوعة بنقطتين قبل القيمة. على سبيل المثال: .PP .Vb 2 \& [notice] \& explicitText = "UTF8:Explicit Text Here" .Ve .SS "قيود السياسة" .IX Subsection "قيود السياسة" هذا امتداد متعدد القيم يتكون من الأسماء \&\fBrequireExplicitPolicy\fP أو \fBinhibitPolicyMapping\fP وقيمة عدد صحيح غير سالب. يجب أن يكون عنصر واحد على الأقل موجوداً. .PP مثال: .PP .Vb 1 \& policyConstraints = requireExplicitPolicy:3 .Ve .SS "منع أي سياسة" .IX Subsection "منع أي سياسة" هذا امتداد نصي يجب أن تكون قيمته عدداً صحيحاً غير سالب. .PP مثال: .PP .Vb 1 \& inhibitAnyPolicy = 2 .Ve .SS "قيود الاسم" .IX Subsection "قيود الاسم" هذا امتداد متعدد القيم. يجب أن يبدأ الاسم بالكلمة \fBpermitted\fP أو \fBexcluded\fP متبوعة بـ \fB;\fP. يتبع بقية الاسم والقيمة صيغة subjectAltName باستثناء أن \fBemail:copy\fP غير مدعوم، ويجب أن تتكون صيغة \fBIP\fP من عنوان IP وقناع شبكة فرعية مفصولين بـ \fB/\fP. .PP أمثلة: .PP .Vb 1 \& nameConstraints = permitted;IP:192.168.0.0/255.255.0.0 \& \& nameConstraints = permitted;email:.example.com \& \& nameConstraints = excluded;email:.com .Ve .SS "لا تحقق OCSP" .IX Subsection "لا تحقق OCSP" هذا امتداد نصي. يجري تحليله، ولكنه يُهمل. .PP مثال: .PP .Vb 1 \& noCheck = ignored .Ve .SS "ميزة TLS (تُعرف بـ Must Staple)" .IX Subsection "ميزة TLS (تُعرف بـ Must Staple)" هذا امتداد متعدد القيم يتكون من قائمة بمعرفات امتدادات TLS. قد يكون كل معرف رقماً (0..65535) أو اسماً مدعوماً. عندما يرسل عميل TLS امتداداً مدرجاً، يُتوقع من خادم TLS تضمين ذلك الامتداد في رده. .PP الأسماء المدعومة هي: \fBstatus_request\fP و \fBstatus_request_v2\fP. .PP مثال: .PP .Vb 1 \& tlsfeature = status_request .Ve .SH "امتدادات مهجورة" .IX Header "امتدادات مهجورة" الامتدادات التالية غير قياسية، وخاصة بـ Netscape، وبالية إلى حد كبير. يُنصح بعدم استخدامها في التطبيقات الجديدة. .SS "امتدادات نص Netscape" .IX Subsection "امتدادات نص Netscape" تعليق Netscape (\fBnsComment\fP) هو امتداد نصي يحتوي على تعليق سيُعرض عند عرض الشهادة في بعض المتصفحات. امتدادات أخرى من هذا النوع هي: \fBnsBaseUrl\fP، \&\fBnsRevocationUrl\fP، \fBnsCaRevocationUrl\fP، \fBnsRenewalUrl\fP، \fBnsCaPolicyUrl\fP و \fBnsSslServerName\fP. .SS "نوع شهادة Netscape" .IX Subsection "نوع شهادة Netscape" هذا امتداد متعدد القيم يتكون من قائمة بالأعلام (flags) التي يجب تضمينها. كان يُستخدم للإشارة إلى الأغراض التي يمكن استخدام الشهادة من أجلها. تُستخدم الآن امتدادات basicConstraints، و keyUsage، و extended key usage بدلاً من ذلك. .PP القيم المقبولة لـ nsCertType هي: \fBclient\fP، \fBserver\fP، \fBemail\fP، \&\fBobjsign\fP، \fBreserved\fP، \fBsslCA\fP، \fBemailCA\fP، \fBobjCA\fP. .SH "امتدادات عشوائية" .IX Header "امتدادات عشوائية" إذا كان الامتداد غير مدعوم من قِبل كود OpenSSL، فيجب ترميزه باستخدام تنسيق الامتداد العشوائي. من الممكن أيضًا استخدام التنسيق العشوائي للامتدادات المدعومة. يجب توخي الحذر الشديد لضمان تهيئة البيانات بشكل صحيح لنوع الامتداد المعني. .PP هناك طريقتان لترميز الامتدادات العشوائية. .PP الطريقة الأولى هي استخدام الكلمة ASN1 متبوعة بمحتوى الامتداد باستخدام نفس صيغة \fBASN1_generate_nconf\fP\|(3). على سبيل المثال: .PP .Vb 3 \& [extensions] \& 1.2.3.4 = critical, ASN1:UTF8String:Some random data \& 1.2.3.4.1 = ASN1:SEQUENCE:seq_sect \& \& [seq_sect] \& field1 = UTF8:field1 \& field2 = UTF8:field2 .Ve .PP من الممكن أيضًا استخدام الكلمة DER لتضمين البيانات المرمزة الخام في أي امتداد. .PP .Vb 2 \& 1.2.3.4 = critical, DER:01:02:03:04 \& 1.2.3.4.1 = DER:01020304 .Ve .PP القيمة التي تتبع DER هي تفريغ ست عشري لترميز DER الخاص بالامتداد. يمكن وضع أي امتداد في هذا الشكل لتجاوز السلوك المبدئي. على سبيل المثال: .PP .Vb 1 \& basicConstraints = critical, DER:00:01:02:03 .Ve .SH تحذيرات .IX Header تحذيرات لا يوجد ضمان بأن تطبيقاً معيناً سيعالج امتداداً ما. لذا قد يكون من الممكن أحياناً استخدام شهادات لأغراض محظورة بواسطة امتداداتها لأن تطبيقاً معيناً لا يتعرف على قيم الامتدادات ذات الصلة أو لا يلتزم بها. .PP يجب استخدام خياري DER و ASN1 بحذر. من الممكن إنشاء امتدادات غير صالحة إذا لم تُستخدم بعناية. .SH "انظر أيضًا" .IX Header "انظر أيضًا" \&\fBopenssl\-req\fP\|(1), \fBopenssl\-ca\fP\|(1), \fBopenssl\-x509\fP\|(1), \&\fBASN1_generate_nconf\fP\|(3) .SH "حقوق النسخ" .IX Header "حقوق النسخ" حقوق النشر 2004\-2025 مؤلفو مشروع OpenSSL. جميع الحقوق محفوظة. .PP مرخص بموجب رخصة Apache 2.0 (المشار إليها فيما يلي بـ ”الرخصة“). لا يجوز لك استخدام هذا الملف إلا وفقًا لشروط الرخصة. يمكنك الحصول على نسخة منها في الملف LICENSE الموجود في حزمة التوزيع المصدرية أو على الرابط . .PP .SH ترجمة تُرجمت هذه الصفحة من الدليل بواسطة زايد السعيدي . .PP هذه الترجمة هي وثيقة مجانية؛ راجع .UR https://www.gnu.org/licenses/gpl-3.0.html رخصة جنو العامة الإصدار 3 .UE أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات. .PP إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه، يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين: .MT kde-l10n-ar@kde.org .ME .