.\" -*- 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 "OPENSSL\-X509 1ssl" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH OPENSSL\-X509 1ssl "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 الاسم openssl\-x509 \- أمر لعرض وتوقيع الشهادات .SH موجز .IX Header موجز \&\fBopenssl\fP \fBx509\fP [\fB\-help\fP] [\fB\-in\fP \fIاسم_الملف\fP|\fIمعرف_المورد\fP] [\fB\-passin\fP \fIمعطى\fP] [\fB\-new\fP] [\fB\-x509toreq\fP] [\fB\-req\fP] [\fB\-copy_extensions\fP \fIمعطى\fP] [\fB\-inform\fP \fBDER\fP|\fBPEM\fP] [\fB\-vfyopt\fP \fIاسم\fP:\fIقيمة\fP] [\fB\-key\fP \fIاسم_الملف\fP|\fIمعرف_المورد\fP] [\fB\-keyform\fP \fBDER\fP|\fBPEM\fP|\fBP12\fP|\fBENGINE\fP] [\fB\-signkey\fP \fIاسم_الملف\fP|\fIمعرف_المورد\fP] [\fB\-out\fP \fIاسم_الملف\fP] [\fB\-outform\fP \fBDER\fP|\fBPEM\fP] [\fB\-nocert\fP] [\fB\-noout\fP] [\fB\-dateopt\fP] [\fB\-text\fP] [\fB\-certopt\fP \fIخيار\fP] [\fB\-fingerprint\fP] [\fB\-alias\fP] [\fB\-serial\fP] [\fB\-startdate\fP] [\fB\-enddate\fP] [\fB\-dates\fP] [\fB\-subject\fP] [\fB\-issuer\fP] [\fB\-nameopt\fP \fIخيار\fP] [\fB\-email\fP] [\fB\-hash\fP] [\fB\-subject_hash\fP] [\fB\-subject_hash_old\fP] [\fB\-issuer_hash\fP] [\fB\-issuer_hash_old\fP] [\fB\-ext\fP \fIملحقات\fP] [\fB\-ocspid\fP] [\fB\-ocsp_uri\fP] [\fB\-purpose\fP] [\fB\-pubkey\fP] [\fB\-modulus\fP] [\fB\-multi\fP] [\fB\-checkend\fP \fIرقم\fP] [\fB\-checkhost\fP \fIمضيف\fP] [\fB\-checkemail\fP \fIمضيف\fP] [\fB\-checkip\fP \fIعنوان_أي_بي\fP] [\fB\-set_serial\fP \fIرقم\fP] [\fB\-next_serial\fP] [\fB\-not_before\fP \fIتاريخ\fP] [\fB\-not_after\fP \fIتاريخ\fP] [\fB\-days\fP \fIمعطى\fP] [\fB\-preserve_dates\fP] [\fB\-set_issuer\fP \fIمعطى\fP] [\fB\-set_subject\fP \fIمعطى\fP] [\fB\-subj\fP \fIمعطى\fP] [\fB\-force_pubkey\fP \fIاسم_الملف\fP] [\fB\-clrext\fP] [\fB\-extfile\fP \fIاسم_الملف\fP] [\fB\-extensions\fP \fIقسم\fP] [\fB\-sigopt\fP \fIاسم\fP:\fIقيمة\fP] [\fB\-badsig\fP] [\fB\-\fP\f(BIخلاصة\fR] [\fB\-CA\fP \fIاسم_الملف\fP|\fIمعرف_المورد\fP] [\fB\-CAform\fP \fBDER\fP|\fBPEM\fP|\fBP12\fP] [\fB\-CAkey\fP \fIاسم_الملف\fP|\fIمعرف_المورد\fP] [\fB\-CAkeyform\fP \fBDER\fP|\fBPEM\fP|\fBP12\fP|\fBENGINE\fP] [\fB\-CAserial\fP \fIاسم_الملف\fP] [\fB\-CAcreateserial\fP] [\fB\-trustout\fP] [\fB\-setalias\fP \fIمعطى\fP] [\fB\-clrtrust\fP] [\fB\-addtrust\fP \fIمعطى\fP] [\fB\-clrreject\fP] [\fB\-addreject\fP \fIمعطى\fP] [\fB\-rand\fP \fIملفات\fP] [\fB\-writerand\fP \fIملف\fP] [\fB\-engine\fP \fIمعرف\fP] [\fB\-provider\fP \fIاسم\fP] [\fB\-provider\-path\fP \fIمسار\fP] [\fB\-provparam\fP \fI[الاسم:]مفتاح=قيمة\fP] [\fB\-propquery\fP \fIاستعلام\fP] .SH الوصف .IX Header الوصف هذا الأمر هو أمر متعدد الأغراض لإدارة الشهادات. ويمكن استخدامه لطباعة معلومات الشهادة، وتحويل الشهادات إلى صيغ مختلفة، وتعديل إعدادات الثقة الخاصة بالشهادات، وإنشاء شهادات من البداية أو من طلبات إصدار الشهادات، ثم التوقيع عليها ذاتيًا أو التوقيع عليها بصفة ”سلطة تصديق مصغرة“. .PP تحمل الشهادات المُولدة الإصدار 3 من X.509. ما لم يُحدد خلاف ذلك، تُدرج ملحقات معرف المفتاح كما هو موصوف في \fBx509v3_config\fP\|(5). .PP نظرًا لوجود عدد كبير من الخيارات، فقد قُسمت إلى أقسام متنوعة. .SH الخيارات .IX Header الخيارات .SS "خيارات الدخل والخرج والأغراض العامة" .IX Subsection "خيارات الدخل والخرج والأغراض العامة" .IP \fB\-help\fP 4 .IX Item \-help اطبع رسالة الاستخدام. .IP "\fB\-in\fP \fIاسم_الملف\fP|\fIمعرف_المورد\fP" 4 .IX Item "\-in اسم_الملف|معرف_المورد" يحدد هذا الدخل لقراءة شهادة منه أو ملف الدخل لقراءة طلب شهادة إذا استُخدمت علامة \fB\-req\fP. وفي كلتا الحالتين، يكون الدخل القياسي هو المبدئي. .Sp لا يمكن دمج هذا الخيار مع علامة \fB\-new\fP. .IP "\fB\-passin\fP \fIالمعطى\fP" 4 .IX Item "\-passin arg" مصدر كلمة سر ملف المفتاح والشهادة. لمزيد من المعلومات حول تنسيق \fIالمعطى\fP انظر \fBopenssl\-passphrase\-options\fP\|(1). .IP \fB\-new\fP 4 .IX Item \-new توليد شهادة من الصفر، دون استخدام شهادة دخل أو طلب شهادة. لذا فإن هذا يستبعد خياري \fB\-in\fP و \fB\-req\fP. وبدلاً من ذلك، يجب تقديم خيار \fB\-set_subject\fP. يمكن تقديم المفتاح العام المراد تضمينه عبر خيار \fB\-force_pubkey\fP ويكون المبدئي هو المفتاح المعطى عبر خيار \fB\-key\fP (أو \fB\-signkey\fP)، مما يعني التوقيع الذاتي. .IP \fB\-x509toreq\fP 4 .IX Item \-x509toreq إخراج طلب شهادة PKCS#10 (بدلاً من الشهادة). يجب استخدام خيار \fB\-key\fP (أو \fB\-signkey\fP) لتوفير المفتاح الخاص للتوقيع الذاتي؛ ويُوضع المفتاح العام المقابل في حقل subjectPKInfo. .Sp لا تُنسخ ملحقات X.509 المضمنة في دخل الشهادة مبدئيًا. يمكن تحديد ملحقات X.509 المراد إضافتها باستخدام خيار \fB\-extfile\fP. .IP \fB\-req\fP 4 .IX Item \-req يُتوقع وجود شهادة في الدخل مبدئيًا. باستخدام هذا الخيار، يُتوقع طلب شهادة PKCS#10 بدلاً من ذلك، والذي يجب أن يكون موقعًا ذاتيًا بشكل صحيح. .Sp لا تُنسخ ملحقات X.509 المضمنة في الطلب مبدئيًا. يمكن تحديد ملحقات X.509 المراد إضافتها باستخدام خيار \fB\-extfile\fP. .IP "\fB\-copy_extensions\fP \fIمعطى\fP" 4 .IX Item "\-copy_extensions arg" يحدد كيفية التعامل مع ملحقات X.509 عند التحويل من شهادة إلى طلب باستخدام خيار \fB\-x509toreq\fP أو التحويل من طلب إلى شهادة باستخدام خيار \fB\-req\fP. إذا كان \fIالمعطى\fP هو \fBnone\fP أو لم يتوفر هذا الخيار، فسيتم تجاهل الملحقات. إذا كان \fIالمعطى\fP هو \fBcopy\fP أو \fBcopyall\fP، فستُنسخ جميع الملحقات، باستثناء ملحقات معرف الموضوع ومعرف مفتاح السلطة التي لا تُنقل عند إنتاج طلب شهادة. .Sp يمكن استخدام خيار \fB\-ext\fP لتقييد الملحقات المراد نسخها بشكل أكبر. .IP "\fB\-inform\fP \fBDER\fP|\fBPEM\fP" 4 .IX Item "\-inform DER|PEM" تنسيق ملف الدخل المستخدم؛ تُحاول المحاولة مع PEM أولاً مبدئيًا. انظر \fBopenssl\-format\-options\fP\|(1) للتفاصيل. .IP "\fB\-vfyopt\fP \fIاسم\fP:\fIقيمة\fP" 4 .IX Item "\-vfyopt nm:v" مرر الخيارات إلى خوارزمية التوقيع أثناء عمليات التحقق. أسماء وقيم هذه الخيارات خاصة بالخوارزمية. .IP "\fB\-key\fP \fIاسم_الملف\fP|\fIمعرف_المورد\fP" 4 .IX Item "\-key اسم_الملف|معرف_المورد" يوفر هذا الخيار المفتاح الخاص لتوقيع شهادة جديدة أو طلب شهادة. ما لم يُعطَ \fB\-force_pubkey\fP، يُوضع المفتاح العام المقابل في الشهادة الجديدة أو طلب الشهادة، مما يؤدي إلى توقيع ذاتي. .Sp لا يمكن استخدام هذا الخيار بالتزامن مع خيار \fB\-CA\fP. .Sp يضبط اسم المصدر ليكون هو نفسه اسم الموضوع (أي يجعلها صادرة ذاتيًا). ما لم يُوفر خيار \fB\-preserve_dates\fP، فإنه يضبط تاريخ بدء الصلاحية على الوقت الحالي وتاريخ الانتهاء على قيمة يحددها خيار \fB\-days\fP. يمكن أيضًا توفير تاريخي البدء والانتهاء صراحةً عبر خياري \&\fB\-not_before\fP و \fB\-not_after\fP. .IP "\fB\-signkey\fP \fIاسم_الملف\fP|\fIمعرف_المورد\fP" 4 .IX Item "\-signkey اسم_الملف|معرف_المورد" هذا الخيار هو اسم مستعار لـ \fB\-key\fP. .IP "\fB\-keyform\fP \fBDER\fP|\fBPEM\fP|\fBP12\fP|\fBENGINE\fP" 4 .IX Item "\-keyform DER|PEM|P12|ENGINE" تنسيق مدخل المفتاح؛ غير محدد مبدئيًا. انظر \fBopenssl\-format\-options\fP\|(1) للتفاصيل. .IP "\fB\-out\fP \fIاسم_الملف\fP" 4 .IX Item "\-out اسم_الملف" يحدد هذا اسم ملف المخرجات للكتابة إليه أو الخرج القياسي مبدئيًا. .IP "\fB\-outform\fP \fBDER\fP|\fBPEM\fP" 4 .IX Item "\-outform DER|PEM" تنسيق الخرج؛ المبدئي هو \fBPEM\fP. انظر \fBopenssl\-format\-options\fP\|(1) للتفاصيل. .IP \fB\-nocert\fP 4 .IX Item \-nocert عدم إخراج شهادة (باستثناء الطباعة كما هو مطلوب عبر الخيارات أدناه). .IP \fB\-noout\fP 4 .IX Item \-noout يمنع هذا الخيار الخرج باستثناء الطباعة كما هو مطلوب عبر الخيارات أدناه. .SS "خيارات طباعة الشهادة" .IX Subsection "خيارات طباعة الشهادة" ملاحظة: خيارا \fB\-alias\fP و \fB\-purpose\fP هما أيضًا خيارات طباعة ولكنهما موصوفان في قسم "إعدادات الثقة". .IP \fB\-dateopt\fP 4 .IX Item \-dateopt حدد تنسيق خرج التاريخ. القيم هي: rfc_822 و iso_8601. المبدئي هو rfc_822. .IP \fB\-text\fP 4 .IX Item \-text يطبع الشهادة في شكل نصي. تُطبع التفاصيل الكاملة بما في ذلك المفتاح العام، وخوارزميات التوقيع، وأسماء المصدر والموضوع، والرقم التسلسلي وأي ملحقات موجودة وأي إعدادات ثقة. .IP "\fB\-certopt\fP \fIخيار\fP" 4 .IX Item "\-certopt خيار" تخصيص تنسيق الطباعة المستخدم مع \fB\-text\fP. يمكن أن يكون معطى \fIالخيار\fP خيارًا واحدًا أو خيارات متعددة مفصولة بفواصل. قد يُستخدم مفتاح \fB\-certopt\fP أيضًا أكثر من مرة لضبط خيارات متعددة. انظر قسم "علامات طباعة النصوص" لمزيد من المعلومات. .IP \fB\-fingerprint\fP 4 .IX Item \-fingerprint يحسب ويطبع خلاصة إصدار DER المرمز للشهادة بأكملها (انظر خيارات الخلاصة). يُطلق على هذا عادةً اسم "البصمة". وبسبب طبيعة خلاصات الرسائل، فإن بصمة الشهادة فريدة لتلك الشهادة ويمكن اعتبار شهادتين بنفس البصمة شهادة واحدة. .IP \fB\-alias\fP 4 .IX Item \-alias يطبع "الاسم المستعار" للشهادة (الكنية)، إن وجد. .IP \fB\-serial\fP 4 .IX Item \-serial يطبع الرقم التسلسلي للشهادة. .IP \fB\-startdate\fP 4 .IX Item \-startdate يطبع تاريخ بدء الشهادة، وهو تاريخ notBefore. .IP \fB\-enddate\fP 4 .IX Item \-enddate يطبع تاريخ انتهاء الشهادة، وهو تاريخ notAfter. .IP \fB\-dates\fP 4 .IX Item \-dates يطبع تاريخي البدء وانتهاء الصلاحية للشهادة. .IP \fB\-subject\fP 4 .IX Item \-subject يطبع اسم الموضوع. .IP \fB\-issuer\fP 4 .IX Item \-issuer يطبع اسم المصدر. .IP "\fB\-nameopt\fP \fIخيار\fP" 4 .IX Item "\-nameopt خيار" يحدد هذا كيفية عرض أسماء الموضوع أو المصدر. انظر \fBopenssl\-namedisplay\-options\fP\|(1) للحصول على التفاصيل. .IP \fB\-email\fP 4 .IX Item \-email يطبع عنوان (أو عناوين) البريد الإلكتروني إن وجدت. .IP \fB\-hash\fP 4 .IX Item \-hash مرادف لـ "\-subject_hash" لأسباب تتعلق بالتوافقية مع الإصدارات القديمة. .IP \fB\-subject_hash\fP 4 .IX Item \-subject_hash يطبع "بصمة" (hash) اسم موضوع الشهادة. يُستخدم هذا في OpenSSL لتشكيل فهرس يتيح البحث عن الشهادات في دليل ما عبر اسم الموضوع. .IP \fB\-subject_hash_old\fP 4 .IX Item \-subject_hash_old يطبع "بصمة" اسم موضوع الشهادة باستخدام الخوارزمية القديمة التي كانت مُستخدمة في OpenSSL قبل الإصدار 1.0.0. .IP \fB\-issuer_hash\fP 4 .IX Item \-issuer_hash يطبع "بصمة" اسم مصدر الشهادة. .IP \fB\-issuer_hash_old\fP 4 .IX Item \-issuer_hash_old يطبع "بصمة" اسم مصدر الشهادة باستخدام الخوارزمية القديمة التي كانت مُستخدمة في OpenSSL قبل الإصدار 1.0.0. .IP "\fB\-ext\fP \fIالامتدادات\fP" 4 .IX Item "\-ext الامتدادات" يطبع امتدادات الشهادة في شكل نصي. يمكن استخدامه أيضًا لتقييد الامتدادات التي تُنسخ. تُحدد الامتدادات بسلسلة نصية مفصولة بفاصلة، على سبيل المثال، "subjectAltName, subjectKeyIdentifier". انظر صفحة الدليل \fBx509v3_config\fP\|(5) لمعرفة أسماء الامتدادات. .IP \fB\-ocspid\fP 4 .IX Item \-ocspid يطبع قيم بصمة OCSP لاسم الموضوع والمفتاح العام. .IP \fB\-ocsp_uri\fP 4 .IX Item \-ocsp_uri يطبع عنوان (أو عناوين) مستجيب OCSP إن وجدت. .IP \fB\-purpose\fP 4 .IX Item \-purpose يجري هذا الخيار اختبارات على امتدادات الشهادة ويخرج النتائج. لوصف أكثر اكتمالاً، انظر "Certificate Extensions" في \fBopenssl\-verification\-options\fP\|(1). .IP \fB\-pubkey\fP 4 .IX Item \-pubkey يطبع كتلة SubjectPublicKeyInfo الخاصة بالشهادة بتنسيق PEM. .IP \fB\-modulus\fP 4 .IX Item \-modulus يطبع هذا الخيار قيمة المقياس (modulus) للمفتاح العام المضمن في الشهادة. .IP \fB\-multi\fP 4 .IX Item \-multi يطبع هذا الخيار معلومات محددة عن جميع الشهادات الموجودة في المدخلات. .SS "خيارات فحص الشهادة" .IX Subsection "خيارات فحص الشهادة" .IP "\fB\-checkend\fP \fIمعطى\fP" 4 .IX Item "\-checkend معطى" بدون \fB\-multi\fP، يفحص ما إذا كانت الشهادة ستنتهي صلاحيتها خلال الثواني \fIمعطى\fP القادمة، ويخرج بقيمة غير صفرية إذا كانت ستنتهي، أو صفر إذا لم تنتهِ. .Sp مع \fB\-multi\fP، يفحص ما إذا كانت أي شهادة في المدخلات ستنتهي صلاحيتها خلال الثواني \fIمعطى\fP القادمة، ويخرج بقيمة غير صفرية إذا انتهت صلاحية أي منها، أو صفر إذا لم تنتهِ صلاحية أي واحدة. .IP "\fB\-checkhost\fP \fIمضيف\fP" 4 .IX Item "\-checkhost مضيف" يفحص ما إذا كانت الشهادة تطابق المضيف المحدد. .IP "\fB\-checkemail\fP \fIبريد_إلكتروني\fP" 4 .IX Item "\-checkemail بريد_إلكتروني" يفحص ما إذا كانت الشهادة تطابق عنوان البريد الإلكتروني المحدد. .IP "\fB\-checkip\fP \fIعنوان_ip\fP" 4 .IX Item "\-checkip عنوان_ip" يفحص ما إذا كانت الشهادة تطابق عنوان IP المحدد. .SS "خيارات مخرجات الشهادة" .IX Subsection "خيارات مخرجات الشهادة" .IP "\fB\-set_serial\fP \fIn\fP" 4 .IX Item "\-set_serial n" يحدد الرقم التسلسلي المراد استخدامه. يمكن استخدام هذا الخيار مع خيارات \fB\-key\fP أو \fB\-signkey\fP أو \fB\-CA\fP. وإذا استُخدم مع الخيار \fB\-CA\fP فلا يُستخدم ملف الأرقام التسلسلية (كما هو محدد بالخيار \fB\-CAserial\fP). .Sp يمكن أن يكون الرقم التسلسلي عشريًا أو ستة عشريًا (إذا سُبق بـ \f(CW\*(C`0x\*(C'\fP). .IP \fB\-next_serial\fP 4 .IX Item \-next_serial يضبط الرقم التسلسلي ليكون أكبر بواحد من الرقم الموجود في الشهادة. .IP "\fB\-not_before\fP \fIتاريخ\fP" 4 .IX Item "\-not_before تاريخ" يسمح هذا بضبط تاريخ البدء صراحةً. تنسيق التاريخ هو YYMMDDHHMMSSZ (نفس هيكل ASN1 UTCTime)، أو YYYYMMDDHHMMSSZ (نفس هيكل ASN1 GeneralizedTime). في كلا التنسيقين، يجب أن تكون الثواني SS والمنطقة الزمنية Z حاضرتين. بدلاً من ذلك، يمكنك أيضًا استخدام "today". .Sp لا يمكن استخدامه مع الخيار \fB\-preserve_dates\fP. .IP "\fB\-not_after\fP \fIتاريخ\fP" 4 .IX Item "\-not_after تاريخ" يسمح هذا بضبط تاريخ انتهاء الصلاحية صراحةً. تنسيق التاريخ هو YYMMDDHHMMSSZ (نفس هيكل ASN1 UTCTime)، أو YYYYMMDDHHMMSSZ (نفس هيكل ASN1 GeneralizedTime). في كلا التنسيقين، يجب أن تكون الثواني SS والمنطقة الزمنية Z حاضرتين. بدلاً من ذلك، يمكنك أيضًا استخدام "today". .Sp لا يمكن استخدامه مع الخيار \fB\-preserve_dates\fP. يتجاوز هذا الخيار الخيار \fB\-days\fP. .IP "\fB\-days\fP \fIمعطى\fP" 4 .IX Item "\-days معطى" يحدد عدد الأيام من اليوم حتى انتهاء صلاحية الشهادة التي وُلدت حديثًا. القيمة المبدئية هي 30. .Sp لا يمكن استخدامه مع الخيار \fB\-preserve_dates\fP. إذا ضُبط الخيار \fB\-not_after\fP، فإن تاريخ انتهاء الصلاحية الصريح له الأولوية. .IP \fB\-preserve_dates\fP 4 .IX Item \-preserve_dates عند توقيع شهادة، تُحفظ تواريخ "notBefore" و "notAfter" لأي شهادة مدخلة بدلاً من ضبطها على الوقت والمدة الحاليين. لا يمكن استخدامه مع الخيارات \fB\-days\fP و \fB\-not_before\fP و \fB\-not_after\fP. .IP "\fB\-set_issuer\fP \fIمعطى\fP" 4 .IX Item "\-set_issuer معطى" عند إنشاء شهادة، يُضبط اسم مصدرها على القيمة المعطاة. .Sp انظر \fB\-set_subject\fP لمعرفة كيفية تنسيق المعطى. .IP "\fB\-set_subject\fP \fIمعطى\fP" 4 .IX Item "\-set_subject معطى" عند إنشاء شهادة، يُضبط اسم موضوعها على القيمة المعطاة. عندما تكون الشهادة موقعة ذاتيًا، يُضبط اسم المصدر على القيمة نفسها، ما لم يُعطَ الخيار \fB\-set_issuer\fP. .Sp يجب تنسيق المعطى كـ \f(CW\*(C`/type0=value0/type1=value1/type2=...\*(C'\fP. يمكن الهروب من المحارف الخاصة باستخدام \f(CW\*(C`\e\*(C'\fP (الشرطة المائلة الخلفية)، وتُحفظ المسافات البيضاء. القيم الفارغة مسموح بها، لكن النوع المقابل لن يُدرج في الشهادة. إعطاء \f(CW\*(C`/\*(C'\fP مفردة سيؤدي إلى تسلسل فارغ من RDNs (أي NULL\-DN). يمكن تشكيل RDNs متعددة القيم بوضع محرف \f(CW\*(C`+\*(C'\fP بدلاً من \f(CW\*(C`/\*(C'\fP بين تأكيدات قيم السمات (AVAs) التي تحدد أعضاء المجموعة. مثال: .Sp \&\f(CW\*(C`/DC=org/DC=OpenSSL/DC=users/UID=123456+CN=John Doe\*(C'\fP .Sp يمكن استخدام هذا الخيار مع خياري \fB\-new\fP و \fB\-force_pubkey\fP لإنشاء شهادة جديدة دون تقديم شهادة مدخلة أو طلب شهادة. .IP "\fB\-subj\fP \fIمعطى\fP" 4 .IX Item "\-subj معطى" هذا الخيار هو الاسم المستعار لـ \fB\-set_subject\fP. .IP "\fB\-force_pubkey\fP \fIاسم_الملف\fP" 4 .IX Item "\-force_pubkey اسم_الملف" عند إنشاء شهادة جديدة أو طلب شهادة، يُضبط مفتاحها العام على المفتاح المعطى بدلاً من المفتاح الموجود في المدخلات أو المعطى مع الخيار \fB\-key\fP (أو \fB\-signkey\fP). إذا لم تكن المدخلات تحتوي على مفتاح عام ولكنها تحتوي على مفتاح خاص، يُستخدم جزؤه العام. .Sp يمكن استخدام هذا الخيار بالاشتراك مع \fB\-new\fP و \fB\-set_subject\fP لتوليد شهادة تحتوي على أي مفتاح عام مطلوب مباشرة. .Sp هذا الخيار مفيد أيضًا لإنشاء شهادات صادرة ذاتيًا ولكنها ليست موقعة ذاتيًا، على سبيل المثال عندما لا يمكن استخدام المفتاح للتوقيع، مثل DH. .IP \fB\-clrext\fP 4 .IX Item \-clrext عند تحويل شهادة إلى شهادة جديدة، تُحفظ جميع امتدادات الشهادة بشكل مبدئي. .Sp عند تحويل شهادة أو طلب شهادة، يمنع الخيار \fB\-clrext\fP نقل أي امتدادات من المصدر. وفي كل الأحوال، عند إصدار طلب شهادة، لا يُدرج امتداد معرف الموضوع ولا امتداد معرف مفتاح السلطة. .IP "\fB\-extfile\fP \fIاسم_الملف\fP" 4 .IX Item "\-extfile اسم_الملف" ملف الإعداد الذي يحتوي على امتدادات شهادة وطلب X.509 المراد إضافتها. .IP "\fB\-extensions\fP \fIالقسم\fP" 4 .IX Item "\-extensions القسم" القسم في ملف الامتدادات (extfile) الذي تُضاف منه امتدادات X.509. إذا لم يُحدد هذا الخيار، فيجب أن تكون الامتدادات إما في القسم غير المسمى (المبدئي) أو يجب أن يحتوي القسم المبدئي على متغير يسمى "extensions" يحتوي على القسم المراد استخدامه. .Sp انظر صفحة الدليل \fBx509v3_config\fP\|(5) لتفاصيل تنسيق قسم الامتداد. .Sp ما لم يُذكر خلاف ذلك، تُدرج امتدادات معرف المفتاح كما هو موضح في \fBx509v3_config\fP\|(5). .IP "\fB\-sigopt\fP \fIاسم\fP:\fIقيمة\fP" 4 .IX Item "\-sigopt nm:v" مرر خيارات إلى خوارزمية التوقيع أثناء عمليات التوقيع. يمكن إعطاء هذا الخيار مرات متعددة. الأسماء والقيم المقدمة باستخدام هذا الخيار تعتمد على الخوارزمية. .IP \fB\-badsig\fP 4 .IX Item \-badsig أفسد التوقيع قبل كتابته؛ قد يكون هذا مفيدًا للاختبار. .IP \fB\-\fP\f(BIخلاصة\fR 4 .IX Item \-digest الخلاصة المراد استخدامها. يؤثر هذا على أي خيار توقيع أو طباعة يستخدم خلاصة رسالة، مثل خيارات \fB\-fingerprint\fP و \fB\-key\fP و \fB\-CA\fP. يمكن استخدام أي خلاصة يدعمها الأمر \fBopenssl\-dgst\fP\|(1). إذا لم تُحدد، فسيُستخدم SHA1 مع \fB\-fingerprint\fP أو تُستخدم الخلاصة المبدئية لخوارزمية التوقيع، وعادة ما تكون SHA256. .SS "خيارات Micro\-CA" .IX Subsection "خيارات Micro\-CA" .IP "\fB\-CA\fP \fIاسم_الملف\fP|\fIuri\fP" 4 .IX Item "\-CA اسم_الملف|uri" يحدد شهادة "سلطة التصديق" (CA) التي ستُستخدم للتوقيع. عند وجوده، يعمل هذا مثل "micro CA" كما يلي: يوضع اسم الموضوع لشهادة "CA" كاسم للمُصدر في الشهادة الجديدة، والتي تُوقع بعد ذلك باستخدام مفتاح "CA" المعطى كما هو مفصل أدناه. .Sp لا يمكن استخدام هذا الخيار بالاشتراك مع \fB\-key\fP (أو \fB\-signkey\fP). يُجمع هذا الخيار عادةً مع خيار \fB\-req\fP الذي يشير إلى طلب توقيع شهادة (CSR). بدون خيار \fB\-req\fP، يجب أن تكون المدخلات شهادة موجودة ما لم يُعط خيار \fB\-new\fP، الذي يولد شهادة من الصفر. .IP "\fB\-CAform\fP \fBDER\fP|\fBPEM\fP|\fBP12\fP،" 4 .IX Item "\-CAform DER|PEM|P12،" تنسيق شهادة سلطة التصديق؛ غير محدد بشكل مبدئي. انظر \fBopenssl\-format\-options\fP\|(1) للتفاصيل. .IP "\fB\-CAkey\fP \fIاسم_الملف\fP|\fIuri\fP" 4 .IX Item "\-CAkey اسم_الملف|uri" يضبط المفتاح الخاص لسلطة التصديق للتوقيع به على الشهادة. يجب أن يتطابق المفتاح الخاص مع المفتاح العام للشهادة المعطاة مع \fB\-CA\fP. إذا لم يُوفر هذا الخيار، فيجب أن يكون المفتاح موجودًا في مدخلات \fB\-CA\fP. .IP "\fB\-CAkeyform\fP \fBDER\fP|\fBPEM\fP|\fBP12\fP|\fBENGINE\fP" 4 .IX Item "\-CAkeyform DER|PEM|P12|ENGINE" تنسيق مفتاح سلطة التصديق؛ غير محدد بشكل مبدئي. انظر \fBopenssl\-format\-options\fP\|(1) للتفاصيل. .IP "\fB\-CAserial\fP \fIاسم_الملف\fP" 4 .IX Item "\-CAserial اسم_الملف" يضبط ملف الرقم التسلسلي لسلطة التصديق المراد استخدامه. .Sp عند إنشاء شهادة بهذا الخيار ومع الخيار \fB\-CA\fP، يُخزن الرقم التسلسلي للشهادة في الملف المعطى. يتكون هذا الملف من سطر واحد يحتوي على عدد زوجي من الأرقام الست عشرية مع الرقم التسلسلي المستخدم في المرة الأخيرة. بعد قراءة هذا الرقم، يُزاد ويُستخدم، ويُحدث الملف. .Sp يتكون اسم الملف المبدئي من الاسم الأساسي لملف شهادة سلطة التصديق مع إضافة \&\fI.srl\fP. على سبيل المثال، إذا كان ملف شهادة سلطة التصديق يسمى \&\fImycacert.pem\fP فإنه يتوقع العثور على ملف رقم تسلسلي يسمى \&\fImycacert.srl\fP. .Sp إذا حُدد الخيار \fB\-CA\fP ولم يُعطَ لا <\-CAserial> ولا <\-CAcreateserial> وكان ملف الرقم التسلسلي المبدئي غير موجود، يُولد رقم عشوائي؛ وهذا هو الإجراء الموصى به. .IP \fB\-CAcreateserial\fP 4 .IX Item \-CAcreateserial مع هذا الخيار والخيار \fB\-CA\fP، يُنشأ ملف الرقم التسلسلي لسلطة التصديق إذا لم يكن موجودًا. يُولد رقم عشوائي، ويُستخدم للشهادة، ويُحفظ في ملف الرقم التسلسلي المحدد كما هو موضح أعلاه. .SS "إعدادات الثقة" .IX Subsection "إعدادات الثقة" \fBالشهادة الموثوقة\fP هي شهادة عادية مُلحق بها عدة معلومات إضافية مثل الاستخدامات المسموح بها والمحظورة للشهادة وربما "اسم مستعار" (لقب). .PP عادةً عندما تُحقق صحة شهادة، يجب أن تكون هناك شهادة واحدة على الأقل "موثوقة". بشكل مبدئي، يجب تخزين الشهادة الموثوقة محليًا ويجب أن تكون سلطة تصديق جذرية (root CA): وعندئذٍ تكون أي سلسلة شهادات تنتهي بسلطة التصديق هذه قابلة للاستخدام لأي غرض. .PP تُستخدم إعدادات الثقة حاليًا فقط مع سلطة التصديق الجذرية. وهي تسمح بتحكم أدق في الأغراض التي يمكن استخدام سلطة التصديق الجذرية لها. على سبيل المثال، قد تكون سلطة التصديق موثوقة لعميل SSL ولكن ليس لاستخدام خادم SSL. .PP انظر \fBopenssl\-verification\-options\fP\|(1) لمزيد من المعلومات حول معنى إعدادات الثقة. .PP سوف تتعرف الإصدارات المستقبلية من OpenSSL على إعدادات الثقة في أي شهادة: وليس فقط في سلطات التصديق الجذرية. .IP \fB\-trustout\fP 4 .IX Item \-trustout يُعلم أي خرج لشهادة PEM كشهادة <موثوقة> بدلاً من كونها عادية. يمكن إدخال شهادة عادية أو موثوقة ولكن بشكل مبدئي تُخرج شهادة عادية وتُتجاهل أي إعدادات ثقة. مع الخيار \fB\-trustout\fP، تُخرج شهادة موثوقة. تُخرج الشهادة الموثوقة آليًا إذا عُدلت أي إعدادات ثقة. .IP "\fB\-setalias\fP \fIمعامل\fP" 4 .IX Item "\-setalias معامل" يضبط "الاسم المستعار" للشهادة. سيسمح هذا بالإشارة إلى الشهادة باستخدام لقب، على سبيل المثال "Steve\*(Aqs Certificate". .IP \fB\-clrtrust\fP 4 .IX Item \-clrtrust يمسح جميع الاستخدامات المسموح بها أو الموثوقة للشهادة. .IP "\fB\-addtrust\fP \fIمعامل\fP" 4 .IX Item "\-addtrust معامل" يضيف استخدامًا موثوقًا للشهادة. يمكن استخدام أي اسم كائن هنا ولكن حاليًا فقط \fBclientAuth\fP و \&\fBserverAuth\fP و \fBemailProtection\fP و \fBanyExtendedKeyUsage\fP هي المعرفة. بدءًا من OpenSSL 1.1.0، فإن الأخير منها يحظر جميع الأغراض عند رفضه أو يمكن جميع الأغراض عند الوثوق به. قد تُعرف تطبيقات OpenSSL الأخرى استخدامات إضافية. .IP \fB\-clrreject\fP 4 .IX Item \-clrreject يمسح جميع الاستخدامات المحظورة أو المرفوضة للشهادة. .IP "\fB\-addreject\fP \fIمعامل\fP" 4 .IX Item "\-addreject معامل" يضيف غرضًا محظورًا لمرساة الثقة. يقبل نفس القيم مثل خيار \fB\-addtrust\fP. .SS "خيارات عامة" .IX Subsection "خيارات عامة" .IP "\fB\-rand\fP \fIملفات\fP، \fB\-writerand\fP \fIملف\fP" 4 .IX Item "\-rand ملفات، \-writerand ملف" انظر "خيارات الحالة العشوائية" في \fBopenssl\fP\|(1) للتفاصيل. .IP "\fB\-engine\fP \fIid\fP" 4 .IX Item "\-engine id" انظر "خيارات المحرك" في \fBopenssl\fP\|(1). هذا الخيار مهجور. .IP "\fB\-provider\fP \fIالاسم\fP" 4 .IX Item "\-provider الاسم" .PD 0 .IP "\fB\-provider\-path\fP \fIالمسار\fP" 4 .IX Item "\-provider\-path المسار" .IP "\fB\-provparam\fP \fI[الاسم:]المفتاح=القيمة\fP" 4 .IX Item "\-provparam [الاسم:]المفتاح=القيمة" .IP "\fB\-propquery\fP \fIpropq\fP" 4 .IX Item "\-propquery propq" .PD انظر "خيارات المزود" في \fBopenssl\fP\|(1)، و \fBprovider\fP\|(7)، و \fBproperty\fP\|(7). .SS "أعلام طباعة النص" .IX Subsection "أعلام طباعة النص" بالإضافة إلى تخصيص تنسيق طباعة الاسم، من الممكن أيضًا تخصيص الحقول الفعلية المطبوعة باستخدام خيار \fBcertopt\fP عند وجود خيار \fBtext\fP. السلوك المبدئي هو طباعة كافة الحقول. .IP \fBcompatible\fP 4 .IX Item متوافق استخدم التنسيق القديم. وهذا يعادل عدم تحديد أي خيارات طباعة على الإطلاق. .IP \fBno_header\fP 4 .IX Item بدون_ترويسة لا تطبع معلومات الترويسة: أي السطور التي تقول "Certificate" و "Data". .IP \fBno_version\fP 4 .IX Item بدون_إصدار لا تطبع رقم الإصدار. .IP \fBno_serial\fP 4 .IX Item no_serial لا تطبع الرقم التسلسلي. .IP \fBno_signame\fP 4 .IX Item no_signame لا تطبع خوارزمية التوقيع المستخدمة. .IP \fBno_validity\fP 4 .IX Item no_validity لا تطبع الصلاحية، وهي حقلا \fBnotBefore\fP و \fBnotAfter\fP. .IP \fBno_subject\fP 4 .IX Item no_subject لا تطبع اسم المُصْدَر له (الموضوع). .IP \fBno_issuer\fP 4 .IX Item no_issuer لا تطبع اسم المُصدِر. .IP \fBno_pubkey\fP 4 .IX Item no_pubkey لا تطبع المفتاح العام. .IP \fBno_sigdump\fP 4 .IX Item no_sigdump لا تعطِ تفريغاً ست عشرياً لتوقيع الشهادة. .IP \fBno_aux\fP 4 .IX Item no_aux لا تطبع معلومات موثوقية الشهادة. .IP \fBno_extensions\fP 4 .IX Item no_extensions لا تطبع أي ملحقات X509V3. .IP \fBext_default\fP 4 .IX Item ext_default الاحتفاظ بسلوك الملحقات المبدئي: محاولة طباعة ملحقات الشهادة غير المدعومة. .IP \fBext_error\fP 4 .IX Item ext_error طباعة رسالة خطأ للملحقات غير المدعومة في الشهادة. .IP \fBext_parse\fP 4 .IX Item ext_parse تحليل ASN1 للملحقات غير المدعومة. .IP \fBext_dump\fP 4 .IX Item ext_dump تفريغ ست عشري للملحقات غير المدعومة. .IP \fBca_default\fP 4 .IX Item ca_default القيمة المستخدمة بواسطة \fBopenssl\-ca\fP\|(1)، وتكافئ \fBno_issuer\fP و \fBno_pubkey\fP و \&\fBno_header\fP و \fBno_version\fP. .SH أمثلة .IX Header أمثلة ملاحظة: في هذه الأمثلة تعني العلامة \*(Aq\e\*(Aq أن المثال يجب أن يكون بالكامل في سطر واحد. .PP طباعة محتويات شهادة: .PP .Vb 1 \& openssl x509 \-in cert.pem \-noout \-text .Ve .PP طباعة ملحق "Subject Alternative Name" لشهادة: .PP .Vb 1 \& openssl x509 \-in cert.pem \-noout \-ext subjectAltName .Ve .PP طباعة المزيد من ملحقات الشهادة: .PP .Vb 1 \& openssl x509 \-in cert.pem \-noout \-ext subjectAltName,nsCertType .Ve .PP طباعة الرقم التسلسلي للشهادة: .PP .Vb 1 \& openssl x509 \-in cert.pem \-noout \-serial .Ve .PP طباعة اسم المُصْدَر له الشهادة: .PP .Vb 1 \& openssl x509 \-in cert.pem \-noout \-subject .Ve .PP طباعة اسم المُصْدَر له الشهادة بصيغة RFC2253: .PP .Vb 1 \& openssl x509 \-in cert.pem \-noout \-subject \-nameopt RFC2253 .Ve .PP طباعة اسم المُصْدَر له الشهادة في سطر واحد على طرفية تدعم ترميز UTF8: .PP .Vb 1 \& openssl x509 \-in cert.pem \-noout \-subject \-nameopt oneline,\-esc_msb .Ve .PP طباعة بصمة SHA1 للشهادة: .PP .Vb 1 \& openssl x509 \-sha1 \-in cert.pem \-noout \-fingerprint .Ve .PP تحويل شهادة من صيغة PEM إلى DER: .PP .Vb 1 \& openssl x509 \-in cert.pem \-inform PEM \-out cert.der \-outform DER .Ve .PP تحويل شهادة إلى طلب شهادة: .PP .Vb 1 \& openssl x509 \-x509toreq \-in cert.pem \-out req.pem \-key key.pem .Ve .PP تحويل طلب شهادة إلى شهادة موقعة ذاتياً باستخدام ملحقات لسلطة شهادات (CA): .PP .Vb 2 \& openssl x509 \-req \-in careq.pem \-extfile openssl.cnf \-extensions v3_ca \e \& \-key key.pem \-out cacert.pem .Ve .PP توقيع طلب شهادة باستخدام شهادة سلطة الشهادات (CA) المذكورة أعلاه وإضافة ملحقات شهادة المستخدم: .PP .Vb 2 \& openssl x509 \-req \-in req.pem \-extfile openssl.cnf \-extensions v3_usr \e \& \-CA cacert.pem \-CAkey key.pem \-CAcreateserial .Ve .PP ضبط الشهادة لتكون موثوقة لاستخدام عميل SSL وتغيير اسمها المستعار إلى "Steve\*(Aqs Class 1 CA" .PP .Vb 2 \& openssl x509 \-in cert.pem \-addtrust clientAuth \e \& \-setalias "Steve\*(Aqs Class 1 CA" \-out trust.pem .Ve .PP التحقق مما إذا كانت أي شهادات في السلسلة ستنتهي صلاحيتها خلال الـ 30 يوماً القادمة (يعيد صفراً إذا لم تنتهِ صلاحية أي منها، وغير الصفر إذا انتهت صلاحية أي منها): .PP .Vb 2 \& openssl x509 \-in chain.pem \-multi \-checkend $[3600*24*30] \e \& && echo \*(Aqperform renewal\*(Aq || echo \*(Aqrenewal unnecessary\*(Aq .Ve .SH ملاحظات .IX Header ملاحظات يفترض التحويل إلى تنسيق UTF8 المستخدم مع خيارات الأسماء أن T61Strings تستخدم مجموعة محارف ISO8859\-1. هذا خاطئ ولكن Netscape و MSIE يفعلان ذلك كما تفعل العديد من الشهادات. لذا على الرغم من أن هذا غير صحيح، فمن المرجح أن يطبع أغلب الشهادات بشكل صحيح. .PP يبحث الخيار \fB\-email\fP في اسم المُصْدَر له وملحق الاسم البديل للمُصْدَر له. ستُطبع عناوين البريد الإلكتروني الفريدة فقط: لن يُطبع العنوان نفسه أكثر من مرة. .SH العلل .IX Header العلل من الممكن إنتاج شهادات أو طلبات غير صالحة من خلال تحديد مفتاح خاص خاطئ، أو استخدام ملحقات X.509 غير مناسبة، أو استخدام خيارات غير متسقة في بعض الحالات: يجب فحص هذه الأمور. .PP يجب أن تتوفر خيارات لتعيين أمور مثل تواريخ البدء والانتهاء صراحةً بدلاً من الاعتماد على إزاحة من الوقت الحالي. .SH "انظر أيضًا" .IX Header "انظر أيضًا" \&\fBopenssl\fP\|(1), \&\fBopenssl\-req\fP\|(1), \&\fBopenssl\-ca\fP\|(1), \&\fBopenssl\-genrsa\fP\|(1), \&\fBopenssl\-gendsa\fP\|(1), \&\fBopenssl\-verify\fP\|(1), \&\fBx509v3_config\fP\|(5) .SH التاريخ .IX Header التاريخ كانت خوارزمية التجزئة المستخدمة في خياري \fB\-subject_hash\fP و \fB\-issuer_hash\fP قبل الإصدار 1.0.0 من OpenSSL تعتمد على خوارزمية MD5 المهجورة وترميز الاسم المتميز (DN). في الإصدار 1.0.0 وما بعده، أصبحت تعتمد على نسخة معيارية من الاسم المتميز (DN) باستخدام SHA1. هذا يعني أن أي أدلة تستخدم الشكل القديم يجب إعادة بناء روابطها باستخدام \fBopenssl\-rehash\fP\|(1) أو ما شابه. .PP أُعيدت تسمية الخيار \fB\-signkey\fP إلى \fB\-key\fP في الإصدار 3.0 من OpenSSL، مع الاحتفاظ بالاسم القديم كاسم مستعار. .PP خيار \fB\-engine\fP أصبح مهجوراً في OpenSSL 3.0. .PP أُزيل الخيار \fB\-C\fP في OpenSSL 3.0. .PP منذ الإصدار 3.2 من OpenSSL، تحمل الشهادات المُنشأة الإصدار 3 من معيار X.509، وتُدرج ملحقات معرف المفتاح (key identifier extensions) بشكل مبدئي. .SH "حقوق النسخ" .IX Header "حقوق النسخ" حقوق النشر 2000\-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 .