.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" 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'.
.de IX
..
.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
.\"
.\" Required to disable full justification in groff 1.23.0.
.if n .ds AD l
.\" ========================================================================
.\"
.IX Title "OPENSSL-X509 1ssl"
.TH OPENSSL-X509 1ssl 2026-08-25 3.6.4 OpenSSL
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "نام (NAME)"
openssl\-x509 \- دستور نمایش و امضای گواهی‌نامه
.SH "خلاصه دستور (SYNOPSIS)"
.IX Header "SYNOPSIS"
\&\fBopenssl\fR \fBx509\fR
[\fB\-help\fR]
[\fB\-in\fR \fIfilename\fR|\fIuri\fR]
[\fB\-passin\fR \fIarg\fR]
[\fB\-new\fR]
[\fB\-x509toreq\fR]
[\fB\-req\fR]
[\fB\-copy_extensions\fR \fIarg\fR]
[\fB\-inform\fR \fBDER\fR|\fBPEM\fR]
[\fB\-vfyopt\fR \fInm\fR:\fIv\fR]
[\fB\-key\fR \fIfilename\fR|\fIuri\fR]
[\fB\-keyform\fR \fBDER\fR|\fBPEM\fR|\fBP12\fR|\fBENGINE\fR]
[\fB\-signkey\fR \fIfilename\fR|\fIuri\fR]
[\fB\-out\fR \fIfilename\fR]
[\fB\-outform\fR \fBDER\fR|\fBPEM\fR]
[\fB\-nocert\fR]
[\fB\-noout\fR]
[\fB\-dateopt\fR]
[\fB\-text\fR]
[\fB\-certopt\fR \fIoption\fR]
[\fB\-fingerprint\fR]
[\fB\-alias\fR]
[\fB\-serial\fR]
[\fB\-startdate\fR]
[\fB\-enddate\fR]
[\fB\-dates\fR]
[\fB\-subject\fR]
[\fB\-issuer\fR]
[\fB\-nameopt\fR \fIoption\fR]
[\fB\-email\fR]
[\fB\-hash\fR]
[\fB\-subject_hash\fR]
[\fB\-subject_hash_old\fR]
[\fB\-issuer_hash\fR]
[\fB\-issuer_hash_old\fR]
[\fB\-ext\fR \fIextensions\fR]
[\fB\-ocspid\fR]
[\fB\-ocsp_uri\fR]
[\fB\-purpose\fR]
[\fB\-pubkey\fR]
[\fB\-modulus\fR]
[\fB\-multi\fR]
[\fB\-checkend\fR \fInum\fR]
[\fB\-checkhost\fR \fIhost\fR]
[\fB\-checkemail\fR \fIhost\fR]
[\fB\-checkip\fR \fIipaddr\fR]
[\fB\-set_serial\fR \fIn\fR]
[\fB\-next_serial\fR]
[\fB\-not_before\fR \fIdate\fR]
[\fB\-not_after\fR \fIdate\fR]
[\fB\-days\fR \fIarg\fR]
[\fB\-preserve_dates\fR]
[\fB\-set_issuer\fR \fIarg\fR]
[\fB\-set_subject\fR \fIarg\fR]
[\fB\-subj\fR \fIarg\fR]
[\fB\-force_pubkey\fR \fIfilename\fR]
[\fB\-clrext\fR]
[\fB\-extfile\fR \fIfilename\fR]
[\fB\-extensions\fR \fIsection\fR]
[\fB\-sigopt\fR \fInm\fR:\fIv\fR]
[\fB\-badsig\fR]
[\fB\-\fR\f(BIdigest\fR]
[\fB\-CA\fR \fIfilename\fR|\fIuri\fR]
[\fB\-CAform\fR \fBDER\fR|\fBPEM\fR|\fBP12\fR]
[\fB\-CAkey\fR \fIfilename\fR|\fIuri\fR]
[\fB\-CAkeyform\fR \fBDER\fR|\fBPEM\fR|\fBP12\fR|\fBENGINE\fR]
[\fB\-CAserial\fR \fIfilename\fR]
[\fB\-CAcreateserial\fR]
[\fB\-trustout\fR]
[\fB\-setalias\fR \fIarg\fR]
[\fB\-clrtrust\fR]
[\fB\-addtrust\fR \fIarg\fR]
[\fB\-clrreject\fR]
[\fB\-addreject\fR \fIarg\fR]
[\fB\-rand\fR \fIfiles\fR]
[\fB\-writerand\fR \fIfile\fR]
[\fB\-engine\fR \fIid\fR]
[\fB\-provider\fR \fIname\fR]
[\fB\-provider\-path\fR \fIpath\fR]
[\fB\-provparam\fR \fI[name:]key=value\fR]
[\fB\-propquery\fR \fIpropq\fR]
.SH "توضیحات (DESCRIPTION)"
.IX Header "DESCRIPTION"
این دستور ابزاری چندمنظوره برای مدیریت و کار با گواهی‌نامه‌ها است.
از این دستور می‌توان برای چاپ اطلاعات گواهی‌نامه،
تبدیل گواهی‌نامه‌ها به قالب‌های مختلف، ویرایش تنظیمات اعتماد گواهی‌نامه،
تولید گواهی‌نامه‌ها از ابتدا یا از روی درخواست‌های صدور گواهی‌نامه (CSR)
و سپس خودامضاکردن (self\-signing) یا امضا کردن آن‌ها مانند یک «CA کوچک» («micro CA») استفاده کرد.
.PP
گواهی‌نامه‌های تولیدشده دارای نسخه ۳ استاندارد X.509 هستند.
مگر آنکه خلاف آن مشخص شده باشد،
افزونه‌های شناسه کلید همان‌طور که در \fBx509v3_config\fR\|(5) تشریح شده است گنجانده می‌شوند.
.PP
با توجه به تعداد زیاد گزینه‌ها، آن‌ها در بخش‌های مختلفی تقسیم‌بندی شده‌اند.
.SH "گزینه‌ها (OPTIONS)"
.IX Header "OPTIONS"
.SS "گزینه‌های ورودی، خروجی و عمومی (Input, Output, and General Purpose Options)"
.IX Subsection "Input, Output, and General Purpose Options"
.IP \fB\-help\fR 4
.IX Item "-help"
چاپ پیام راهنمای نحوه استفاده.
.IP "\fB\-in\fR \fIfilename\fR|\fIuri\fR" 4
.IX Item "-in filename|uri"
مشخص‌کننده ورودی برای خواندن گواهی‌نامه، یا فایل ورودی برای خواندن درخواست گواهی‌نامه در صورت استفاده از پرچم \fB\-req\fR.
در هر دو حالت، مقدار پیش‌فرض ورودی استاندارد است.
.Sp
این گزینه نمی‌تواند با پرچم \fB\-new\fR ترکیب شود.
.IP "\fB\-passin\fR \fIarg\fR" 4
.IX Item "-passin arg"
منبع عبارت عبور فایل کلید و گواهی‌نامه.
برای اطلاعات بیشتر درباره قالب \fIarg\fR،
بخش \fBopenssl\-passphrase\-options\fR\|(1) را ببینید.
.IP \fB\-new\fR 4
.IX Item "-new"
تولید یک گواهی‌نامه از ابتدا، بدون استفاده از گواهی‌نامه یا درخواست گواهی‌نامه ورودی.
بنابراین این گزینه مانع استفاده از گزینه‌های \fB\-in\fR و \fB\-req\fR می‌شود.
در عوض، باید گزینه \fB\-set_subject\fR مشخص گردد.
کلید عمومی جهت گنجاندن در گواهی را می‌توان با گزینه \fB\-force_pubkey\fR تعیین کرد
و به‌طور پیش‌فرض همان کلید ارائه‌شده با گزینه \fB\-key\fR (یا \fB\-signkey\fR) است
که به معنای خودامضایی است.
.IP \fB\-x509toreq\fR 4
.IX Item "-x509toreq"
خروجی دادن یک درخواست گواهی‌نامه PKCS#10 (به جای یک گواهی‌نامه).
گزینه \fB\-key\fR (یا \fB\-signkey\fR) باید برای ارائه کلید خصوصی جهت
خودامضایی استفاده شود؛ کلید عمومی متناظر در فیلد subjectPKInfo قرار می‌گیرد.
.Sp
افزونه‌های X.509 موجود در گواهی‌نامه ورودی به‌طور پیش‌فرض رونوشت نمی‌شوند.
افزونه‌های X.509 که باید اضافه شوند را می‌توان با استفاده از گزینه \fB\-extfile\fR مشخص کرد.
.IP \fB\-req\fR 4
.IX Item "-req"
به‌طور پیش‌فرض در ورودی یک گواهی‌نامه انتظار می‌رود.
با این گزینه، در عوض یک درخواست گواهی‌نامه PKCS#10 انتظار می‌رود
که باید به درستی خودامضا شده باشد.
.Sp
افزونه‌های X.509 موجود در درخواست به‌طور پیش‌فرض رونوشت نمی‌شوند.
افزونه‌های X.509 که باید اضافه شوند را می‌توان با استفاده از گزینه \fB\-extfile\fR مشخص کرد.
.IP "\fB\-copy_extensions\fR \fIarg\fR" 4
.IX Item "-copy_extensions arg"
نحوه مدیریت افزونه‌های X.509 را در هنگام تبدیل از یک گواهی‌نامه به یک درخواست با استفاده از گزینه \fB\-x509toreq\fR
یا تبدیل از یک درخواست به یک گواهی‌نامه با استفاده از گزینه \fB\-req\fR مشخص می‌کند.
اگر \fIarg\fR برابر \fBnone\fR باشد یا این گزینه وجود نداشته باشد، افزونه‌ها نادیده گرفته می‌شوند.
اگر \fIarg\fR برابر \fBcopy\fR یا \fBcopyall\fR باشد، تمام افزونه‌ها رونوشت می‌شوند،
به جز افزونه‌های شناسه موضوع (subject identifier) و شناسه کلید مرجع صدور (authority key identifier)
که در زمان تولید درخواست گواهی‌نامه منتقل نمی‌شوند.
.Sp
گزینه \fB\-ext\fR می‌تواند برای محدود کردن بیشتر افزونه‌هایی که باید رونوشت شوند استفاده شود.
.IP "\fB\-inform\fR \fBDER\fR|\fBPEM\fR" 4
.IX Item "-inform DER|PEM"
قالب فایل ورودی مورد استفاده؛ به‌طور پیش‌فرض ابتدا PEM امتحان می‌شود.
برای جزئیات بیشتر به \fBopenssl\-format\-options\fR\|(1) مراجعه کنید.
.IP "\fB\-vfyopt\fR \fInm\fR:\fIv\fR" 4
.IX Item "-vfyopt nm:v"
ارسال گزینه‌ها به الگوریتم امضا در طول عملیات اعتبارسنجی.
نام‌ها و مقادیر این گزینه‌ها وابسته به الگوریتم هستند.
.IP "\fB\-key\fR \fIfilename\fR|\fIuri\fR" 4
.IX Item "-key filename|uri"
این گزینه کلید خصوصی را برای امضای یک گواهی‌نامه یا
درخواست گواهی‌نامه جدید فراهم می‌کند.
مگر اینکه \fB\-force_pubkey\fR داده شده باشد، کلید عمومی متناظر در
گواهی‌نامه یا درخواست گواهی‌نامه جدید قرار می‌گیرد که منجر به خودامضایی می‌شود.
.Sp
این گزینه نمی‌تواند همراه با گزینه \fB\-CA\fR استفاده شود.
.Sp
این گزینه نام صادرکننده را روی نام موضوع تنظیم می‌کند (یعنی آن را خودصادرشده می‌کند).
مگر اینکه گزینه \fB\-preserve_dates\fR مشخص شده باشد،
تاریخ آغاز اعتبار را روی زمان جاری
و تاریخ پایان را روی مقداری که توسط گزینه \fB\-days\fR تعیین می‌شود تنظیم می‌کند.
تاریخ آغاز و تاریخ پایان همچنین می‌توانند به طور صریح با گزینه‌های
\&\fB\-not_before\fR و \fB\-not_after\fR مشخص شوند.
.IP "\fB\-signkey\fR \fIfilename\fR|\fIuri\fR" 4
.IX Item "-signkey filename|uri"
این گزینه نام مستعاری برای \fB\-key\fR است.
.IP "\fB\-keyform\fR \fBDER\fR|\fBPEM\fR|\fBP12\fR|\fBENGINE\fR" 4
.IX Item "-keyform DER|PEM|P12|ENGINE"
قالب ورودی کلید؛ به‌طور پیش‌فرض نامشخص است.
برای جزئیات به \fBopenssl\-format\-options\fR\|(1) مراجعه کنید.
.IP "\fB\-out\fR \fIfilename\fR" 4
.IX Item "-out filename"
مشخص‌کننده نام فایل خروجی برای نوشتن، یا به‌طور پیش‌فرض خروجی استاندارد.
.IP "\fB\-outform\fR \fBDER\fR|\fBPEM\fR" 4
.IX Item "-outform DER|PEM"
قالب خروجی؛ مقدار پیش‌فرض \fBPEM\fR است.
برای جزئیات به \fBopenssl\-format\-options\fR\|(1) مراجعه کنید.
.IP \fB\-nocert\fR 4
.IX Item "-nocert"
عدم تولید گواهی‌نامه در خروجی (به جز مواردی که با گزینه‌های زیر برای چاپ درخواست شده باشد).
.IP \fB\-noout\fR 4
.IX Item "-noout"
این گزینه از هرگونه خروجی جلوگیری می‌کند به جز مواردی که با گزینه‌های زیر برای چاپ درخواست شده باشد.
.SS "گزینه‌های چاپ گواهی‌نامه (Certificate Printing Options)"
.IX Subsection "Certificate Printing Options"
توجه: گزینه‌های \fB\-alias\fR و \fB\-purpose\fR نیز جزو گزینه‌های چاپ هستند
اما در بخش «تنظیمات اعتماد» (Trust Settings) تشریح شده‌اند.
.IP \fB\-dateopt\fR 4
.IX Item "-dateopt"
مشخص کردن قالب خروجی تاریخ. مقادیر مجاز عبارتند از: rfc_822 و iso_8601.
مقدار پیش‌فرض rfc_822 است.
.IP \fB\-text\fR 4
.IX Item "-text"
چاپ گواهی‌نامه به صورت متنی. تمام جزئیات از جمله کلید عمومی، الگوریتم‌های امضا،
نام‌های صادرکننده و موضوع، شماره سریال،
هرگونه افزونه موجود و تنظیمات اعتماد چاپ می‌شوند.
.IP "\fB\-certopt\fR \fIoption\fR" 4
.IX Item "-certopt option"
سفارشی‌سازی قالب چاپ مورد استفاده با گزینه \fB\-text\fR. آرگومان \fIoption\fR
می‌تواند یک گزینه منفرد یا چندین گزینه جداشده با ویرگول باشد.
سوییچ \fB\-certopt\fR همچنین می‌تواند بیش از یک بار برای تنظیم چندین گزینه استفاده شود.
برای اطلاعات بیشتر بخش «پرچم‌های چاپ متن» (Text Printing Flags) را ببینید.
.IP \fB\-fingerprint\fR 4
.IX Item "-fingerprint"
محاسبه و چاپ خلاصه پیام (digest) نسخه کدگذاری‌شده DER از کل گواهی‌نامه (گزینه‌های digest را ببینید).
این مقدار معمولاً «اثرانگشت» (fingerprint) نامیده می‌شود. به دلیل ماهیت خلاصه‌های پیام، اثرانگشت یک گواهی‌نامه برای آن گواهی‌نامه منحصر‌به‌فرد است و دو گواهی‌نامه با اثرانگشت یکسان را می‌توان یکسان در نظر گرفت.
.IP \fB\-alias\fR 4
.IX Item "-alias"
چاپ «نام مستعار» (nickname) گواهی‌نامه، در صورت وجود.
.IP \fB\-serial\fR 4
.IX Item "-serial"
چاپ شماره سریال گواهی‌نامه.
.IP \fB\-startdate\fR 4
.IX Item "-startdate"
چاپ تاریخ آغاز اعتبار گواهی‌نامه، یعنی تاریخ notBefore.
.IP \fB\-enddate\fR 4
.IX Item "-enddate"
چاپ تاریخ انقضای گواهی‌نامه، یعنی تاریخ notAfter.
.IP \fB\-dates\fR 4
.IX Item "-dates"
چاپ هر دو تاریخ آغاز و انقضای یک گواهی‌نامه.
.IP \fB\-subject\fR 4
.IX Item "-subject"
چاپ نام موضوع (subject).
.IP \fB\-issuer\fR 4
.IX Item "-issuer"
چاپ نام صادرکننده (issuer).
.IP "\fB\-nameopt\fR \fIoption\fR" 4
.IX Item "-nameopt option"
مشخص می‌کند که نام‌های موضوع یا صادرکننده چگونه نمایش داده شوند.
برای جزئیات بیشتر به \fBopenssl\-namedisplay\-options\fR\|(1) مراجعه کنید.
.IP \fB\-email\fR 4
.IX Item "-email"
چاپ نشانی(های) رایانامه (email)، در صورت وجود.
.IP \fB\-hash\fR 4
.IX Item "-hash"
مترادفی برای «\-subject_hash» جهت سازگاری با گذشته.
.IP \fB\-subject_hash\fR 4
.IX Item "-subject_hash"
چاپ «هش» نام موضوع گواهی‌نامه. از این هش در OpenSSL برای ایجاد یک نمایه استفاده می‌شود تا گواهی‌نامه‌های موجود در یک پوشه بتوانند بر اساس نام موضوع جستجو شوند.
.IP \fB\-subject_hash_old\fR 4
.IX Item "-subject_hash_old"
چاپ «هش» نام موضوع گواهی‌نامه با استفاده از الگوریتم قدیمی‌تر که توسط نسخه‌های پیش از 1.0.0 در OpenSSL استفاده می‌شد.
.IP \fB\-issuer_hash\fR 4
.IX Item "-issuer_hash"
چاپ «هش» نام صادرکننده گواهی‌نامه.
.IP \fB\-issuer_hash_old\fR 4
.IX Item "-issuer_hash_old"
چاپ «هش» نام صادرکننده گواهی‌نامه با استفاده از الگوریتم قدیمی‌تر که توسط نسخه‌های پیش از 1.0.0 در OpenSSL استفاده می‌شد.
.IP "\fB\-ext\fR \fIextensions\fR" 4
.IX Item "-ext extensions"
چاپ افزونه‌های گواهی‌نامه به صورت متنی.
همچنین می‌تواند برای محدود کردن افزونه‌هایی که باید رونوشت شوند به کار رود.
افزونه‌ها با یک رشته جداشده با ویرگول مشخص می‌شوند، مانند "subjectAltName, subjectKeyIdentifier".
برای مشاهده نام‌های افزونه‌ها به صفحه راهنمای \fBx509v3_config\fR\|(5) مراجعه کنید.
.IP \fB\-ocspid\fR 4
.IX Item "-ocspid"
چاپ مقادیر هش OCSP برای نام موضوع و کلید عمومی.
.IP \fB\-ocsp_uri\fR 4
.IX Item "-ocsp_uri"
چاپ نشانی(های) پاسخ‌دهنده OCSP، در صورت وجود.
.IP \fB\-purpose\fR 4
.IX Item "-purpose"
این گزینه آزمون‌هایی را روی افزونه‌های گواهی‌نامه انجام داده و نتایج را نمایش می‌دهد. برای توضیح کامل‌تر، بخش «افزونه‌های گواهی‌نامه» در \fBopenssl\-verification\-options\fR\|(1) را ببینید.
.IP \fB\-pubkey\fR 4
.IX Item "-pubkey"
بلوک SubjectPublicKeyInfo گواهی‌نامه را در قالب PEM چاپ می‌کند.
.IP \fB\-modulus\fR 4
.IX Item "-modulus"
این گزینه مقدار پیمانه (modulus) کلید عمومی موجود در گواهی‌نامه را چاپ می‌کند.
.IP \fB\-multi\fR 4
.IX Item "-multi"
این گزینه اطلاعات انتخابی درباره تمام گواهی‌نامه‌های موجود در ورودی را چاپ می‌کند.
.SS "گزینه‌های بررسی گواهی‌نامه (Certificate Checking Options)"
.IX Subsection "Certificate Checking Options"
.IP "\fB\-checkend\fR \fIarg\fR" 4
.IX Item "-checkend arg"
بدون \fB\-multi\fR بررسی می‌کند که آیا گواهی‌نامه ظرف \fIarg\fR ثانیه آینده منقضی می‌شود یا خیر، و اگر منقضی شود با کد غیرصفر و اگر نشود با کد صفر خارج می‌شود.
.Sp
همراه با \fB\-multi\fR بررسی می‌کند که آیا هر کدام از گواهی‌نامه‌های ورودی ظرف \fIarg\fR ثانیه آینده منقضی می‌شوند یا خیر، و اگر حداقل یکی منقضی شود با کد غیرصفر و اگر هیچ‌کدام منقضی نشوند با صفر خارج می‌شود.
.IP "\fB\-checkhost\fR \fIhost\fR" 4
.IX Item "-checkhost host"
بررسی می‌کند که آیا گواهی‌نامه با میزبان مشخص‌شده مطابقت دارد یا خیر.
.IP "\fB\-checkemail\fR \fIemail\fR" 4
.IX Item "-checkemail email"
بررسی می‌کند که آیا گواهی‌نامه با نشانی رایانامه مشخص‌شده مطابقت دارد یا خیر.
.IP "\fB\-checkip\fR \fIipaddr\fR" 4
.IX Item "-checkip ipaddr"
بررسی می‌کند که آیا گواهی‌نامه با نشانی IP مشخص‌شده مطابقت دارد یا خیر.
.SS "گزینه‌های خروجی گواهی‌نامه (Certificate Output Options)"
.IX Subsection "Certificate Output Options"
.IP "\fB\-set_serial\fR \fIn\fR" 4
.IX Item "-set_serial n"
شماره سریال مورد استفاده را مشخص می‌کند.
این گزینه می‌تواند با گزینه‌های \fB\-key\fR، \fB\-signkey\fR یا \fB\-CA\fR استفاده شود.
در صورت استفاده به همراه گزینه \fB\-CA\fR،
فایل شماره سریال (همان‌طور که توسط گزینه \fB\-CAserial\fR مشخص شده) استفاده نخواهد شد.
.Sp
شماره سریال می‌تواند ده‌دهی (decimal) یا هگزادسیمال (در صورتی که با \f(CW\*(C`0x\*(C'\fR شروع شود) باشد.
.IP \fB\-next_serial\fR 4
.IX Item "-next_serial"
شماره سریال را یک واحد بیشتر از شماره موجود در گواهی‌نامه تنظیم می‌کند.
.IP "\fB\-not_before\fR \fIdate\fR" 4
.IX Item "-not_before date"
امکان تنظیم صریح تاریخ آغاز اعتبار را فراهم می‌کند. قالب
تاریخ YYMMDDHHMMSSZ (مشابه ساختار ASN1 UTCTime) یا
YYYYMMDDHHMMSSZ (مشابه ساختار ASN1 GeneralizedTime) است. در
هر دو قالب، ثانیه‌ها SS و منطقه زمانی Z باید وجود داشته باشند.
همچنین می‌توانید از "today" (امروز) استفاده کنید.
.Sp
نمی‌تواند همراه با گزینه \fB\-preserve_dates\fR استفاده شود.
.IP "\fB\-not_after\fR \fIdate\fR" 4
.IX Item "-not_after date"
امکان تنظیم صریح تاریخ انقضا را فراهم می‌کند. قالب
تاریخ YYMMDDHHMMSSZ (مشابه ساختار ASN1 UTCTime) یا
YYYYMMDDHHMMSSZ (مشابه ساختار ASN1 GeneralizedTime) است. در
هر دو قالب، ثانیه‌ها SS و منطقه زمانی Z باید وجود داشته باشند.
همچنین می‌توانید از "today" (امروز) استفاده کنید.
.Sp
نمی‌تواند همراه با گزینه \fB\-preserve_dates\fR استفاده شود.
این گزینه بر گزینه \fB\-days\fR تقدم دارد.
.IP "\fB\-days\fR \fIarg\fR" 4
.IX Item "-days arg"
تعداد روزها از امروز تا زمان انقضای گواهی‌نامه جدیداً تولیدشده را مشخص می‌کند.
مقدار پیش‌فرض ۳۰ است.
.Sp
نمی‌تواند همراه با گزینه \fB\-preserve_dates\fR استفاده شود.
اگر گزینه \fB\-not_after\fR تنظیم شده باشد، تاریخ انقضای صریح اولویت دارد.
.IP \fB\-preserve_dates\fR 4
.IX Item "-preserve_dates"
هنگام امضای یک گواهی‌نامه، تاریخ‌های «notBefore» و «notAfter» هر گواهی‌نامه
ورودی را حفظ می‌کند، به جای اینکه آن‌ها را با زمان و مدت زمان جاری تنظیم نماید.
نمی‌تواند همراه با گزینه‌های \fB\-days\fR، \fB\-not_before\fR و \fB\-not_after\fR استفاده شود.
.IP "\fB\-set_issuer\fR \fIarg\fR" 4
.IX Item "-set_issuer arg"
هنگامی که یک گواهی‌نامه ایجاد می‌شود، نام صادرکننده آن را روی مقدار داده‌شده تنظیم می‌کند.
.Sp
برای نحوه قالب‌بندی آرگومان، بخش \fB\-set_subject\fR را ببینید.
.IP "\fB\-set_subject\fR \fIarg\fR" 4
.IX Item "-set_subject arg"
هنگامی که یک گواهی‌نامه ایجاد می‌شود، نام موضوع آن را روی مقدار داده‌شده تنظیم می‌کند.
هنگامی که گواهی‌نامه خودامضا است، نام صادرکننده روی همین مقدار تنظیم می‌شود،
مگر اینکه گزینه \fB\-set_issuer\fR داده شده باشد.
.Sp
آرگومان باید به صورت \f(CW\*(C`/type0=value0/type1=value1/type2=...\*(C'\fR قالب‌بندی شود.
نویسه‌های خاص می‌توانند با \f(CW\*(C`\e\*(C'\fR (اسلش وارو / backslash) اسکیپ شوند؛ فاصله‌های خالی حفظ می‌شوند.
مقادیر خالی مجاز هستند، اما نوع متناظر در گواهی‌نامه گنجانده نخواهد شد.
ارائه یک \f(CW\*(C`/\*(C'\fR تکی منجر به یک توالی خالی از RDNها (یک NULL\-DN) می‌شود.
RDNهای چندمقداری را می‌توان با قرار دادن یک نویسه \f(CW\*(C`+\*(C'\fR به جای \f(CW\*(C`/\*(C'\fR
بین AttributeValueAssertionها (AVAها) که اعضای مجموعه را مشخص می‌کنند، تشکیل داد.
مثال:
.Sp
\&\f(CW\*(C`/DC=org/DC=OpenSSL/DC=users/UID=123456+CN=John Doe\*(C'\fR
.Sp
این گزینه می‌تواند همراه با گزینه‌های \fB\-new\fR و \fB\-force_pubkey\fR برای ایجاد
یک گواهی‌نامه جدید بدون ارائه گواهی‌نامه یا درخواست گواهی‌نامه ورودی استفاده شود.
.IP "\fB\-subj\fR \fIarg\fR" 4
.IX Item "-subj arg"
این گزینه نام مستعاری برای \fB\-set_subject\fR است.
.IP "\fB\-force_pubkey\fR \fIfilename\fR" 4
.IX Item "-force_pubkey filename"
هنگامی که یک گواهی‌نامه یا درخواست گواهی‌نامه جدید ایجاد می‌شود،
کلید عمومی آن را روی کلید داده‌شده تنظیم می‌کند،
به جای کلید موجود در ورودی
یا داده‌شده با گزینه \fB\-key\fR (یا \fB\-signkey\fR).
اگر ورودی حاوی کلید عمومی نباشد اما حاوی یک کلید خصوصی باشد، بخش عمومی آن استفاده می‌شود.
.Sp
این گزینه می‌تواند به همراه \fB\-new\fR و \fB\-set_subject\fR استفاده شود
تا مستقیماً یک گواهی‌نامه حاوی هر کلید عمومی دلخواه تولید گردد.
.Sp
این گزینه همچنین برای ایجاد گواهی‌نامه‌های خودصادرشده‌ای که خودامضا نیستند مفید است،
برای مثال زمانی که کلید نمی‌تواند برای امضا استفاده شود، مانند DH.
.IP \fB\-clrext\fR 4
.IX Item "-clrext"
هنگام تبدیل یک گواهی‌نامه به یک گواهی‌نامه جدید،
به‌طور پیش‌فرض تمام افزونه‌های گواهی‌نامه حفظ می‌شوند.
.Sp
هنگام تبدیل یک گواهی‌نامه یا درخواست گواهی‌نامه،
گزینه \fB\-clrext\fR از انتقال هرگونه افزونه از منبع جلوگیری می‌کند.
در هر حال، هنگام تولید درخواست گواهی‌نامه،
نه افزونه‌های شناسه موضوع و نه شناسه کلید مرجع صدور گنجانده نمی‌شوند.
.IP "\fB\-extfile\fR \fIfilename\fR" 4
.IX Item "-extfile filename"
فایل پیکربندی حاوی افزونه‌های X.509 گواهی‌نامه و درخواست جهت افزودن.
.IP "\fB\-extensions\fR \fIsection\fR" 4
.IX Item "-extensions section"
بخشی در extfile که افزونه‌های X.509 باید از آن اضافه شوند.
اگر این گزینه مشخص نشود،
افزونه‌ها یا باید در بخش بدون نام (پیش‌فرض) قرار داشته باشند یا بخش پیش‌فرض باید حاوی متغیری به نام
"extensions" باشد که حاوی نام بخش مورد استفاده است.
.Sp
برای جزئیات قالب بخش افزونه به صفحه راهنمای \fBx509v3_config\fR\|(5) مراجعه کنید.
.Sp
مگر اینکه خلاف آن مشخص شده باشد،
افزونه‌های شناسه کلید همان‌طور که در \fBx509v3_config\fR\|(5) شرح داده شده است اضافه می‌شوند.
.IP "\fB\-sigopt\fR \fInm\fR:\fIv\fR" 4
.IX Item "-sigopt nm:v"
ارسال گزینه‌ها به الگوریتم امضا در حین عملیات امضا.
این گزینه می‌تواند چندین بار مشخص شود.
نام‌ها و مقادیر ارائه‌شده با این گزینه وابسته به الگوریتم هستند.
.IP \fB\-badsig\fR 4
.IX Item "-badsig"
مخدوش کردن امضا پیش از نوشتن آن؛ این گزینه می‌تواند برای آزمودن مفید باشد.
.IP \fB\-\fR\f(BIdigest\fR 4
.IX Item "-digest"
خلاصه پیام مورد استفاده.
این بر هر گزینه امضا یا چاپی که از خلاصه پیام استفاده می‌کند تأثیر می‌گذارد،
مانند گزینه‌های \fB\-fingerprint\fR، \fB\-key\fR و \fB\-CA\fR.
هر خلاصه‌ای که توسط دستور \fBopenssl\-dgst\fR\|(1) پشتیبانی شود قابل استفاده است.
اگر مشخص نشود، از SHA1 همراه با \fB\-fingerprint\fR استفاده می‌شود یا
خلاصه پیش‌فرض برای الگوریتم امضا استفاده می‌گردد که معمولاً SHA256 است.
.SS "گزینه‌های CA کوچک (Micro\-CA Options)"
.IX Subsection "Micro-CA Options"
.IP "\fB\-CA\fR \fIfilename\fR|\fIuri\fR" 4
.IX Item "-CA filename|uri"
گواهی‌نامه «CA» مورد استفاده برای امضا را مشخص می‌کند.
در صورت وجود، مانند یک «CA کوچک» («micro CA») به شکل زیر عمل می‌کند:
نام موضوع گواهی‌نامه «CA» به عنوان نام صادرکننده در گواهی‌نامه جدید قرار می‌گیرد،
که سپس با استفاده از کلید «CA» که شرح آن در زیر آمده است امضا می‌شود.
.Sp
این گزینه نمی‌تواند همراه با گزینه \fB\-key\fR (یا \fB\-signkey\fR) استفاده شود.
این گزینه معمولاً همراه با گزینه \fB\-req\fR که به یک CSR اشاره دارد استفاده می‌شود.
بدون گزینه \fB\-req\fR، ورودی باید یک گواهی‌نامه موجود باشد
مگر اینکه گزینه \fB\-new\fR داده شده باشد، که یک گواهی‌نامه را از ابتدا تولید می‌کند.
.IP "\fB\-CAform\fR \fBDER\fR|\fBPEM\fR|\fBP12\fR," 4
.IX Item "-CAform DER|PEM|P12,"
قالب گواهی‌نامه CA؛ به‌طور پیش‌فرض نامشخص است.
برای جزئیات بیشتر به \fBopenssl\-format\-options\fR\|(1) مراجعه کنید.
.IP "\fB\-CAkey\fR \fIfilename\fR|\fIuri\fR" 4
.IX Item "-CAkey filename|uri"
کلید خصوصی CA را برای امضای یک گواهی‌نامه تنظیم می‌کند.
کلید خصوصی باید با کلید عمومی گواهی‌نامه ارائه‌شده با \fB\-CA\fR مطابقت داشته باشد.
اگر این گزینه مشخص نشود، کلید باید در ورودی \fB\-CA\fR موجود باشد.
.IP "\fB\-CAkeyform\fR \fBDER\fR|\fBPEM\fR|\fBP12\fR|\fBENGINE\fR" 4
.IX Item "-CAkeyform DER|PEM|P12|ENGINE"
قالب کلید CA؛ به‌طور پیش‌فرض نامشخص است.
برای جزئیات بیشتر به \fBopenssl\-format\-options\fR\|(1) مراجعه کنید.
.IP "\fB\-CAserial\fR \fIfilename\fR" 4
.IX Item "-CAserial filename"
فایل شماره سریال CA را برای استفاده تنظیم می‌کند.
.Sp
هنگام ایجاد یک گواهی‌نامه با این گزینه و گزینه \fB\-CA\fR،
شماره سریال گواهی‌نامه در فایل مشخص‌شده ذخیره می‌شود.
این فایل شامل یک خط حاوی
تعداد زوجی از ارقام هگزادسیمال با شماره سریالی است که آخرین بار استفاده شده است.
پس از خواندن این شماره، مقدار آن یک واحد افزایش یافته و استفاده می‌شود، و فایل به‌روزرسانی می‌گردد.
.Sp
نام فایل پیش‌فرض شامل نام پایه فایل گواهی‌نامه CA به همراه پسوند
\&\fI.srl\fR است. برای مثال اگر فایل گواهی‌نامه CA با نام
\&\fImycacert.pem\fR باشد، انتظار دارد فایلی با نام
\&\fImycacert.srl\fR برای شماره سریال بیابد.
.Sp
اگر گزینه \fB\-CA\fR مشخص شده باشد و نه <\-CAserial> و نه <\-CAcreateserial>
داده نشده باشند و فایل شماره سریال پیش‌فرض وجود نداشته باشد،
یک شماره تصادفی تولید می‌شود؛ این رویکرد توصیه‌شده است.
.IP \fB\-CAcreateserial\fR 4
.IX Item "-CAcreateserial"
با این گزینه و گزینه \fB\-CA\fR،
فایل شماره سریال CA در صورتی که وجود نداشته باشد ایجاد می‌شود.
یک شماره تصادفی تولید شده، برای گواهی‌نامه استفاده می‌شود،
و در فایل شماره سریالی که طبق توضیحات بالا تعیین شده است ذخیره می‌گردد.
.SS "تنظیمات اعتماد (Trust Settings)"
.IX Subsection "Trust Settings"
یک \fBگواهی‌نامه مورد اعتماد (trusted certificate)\fR یک گواهی‌نامه معمولی است که چندین
بخش اطلاعات اضافی به آن ضمیمه شده است، مانند کاربردهای مجاز
و ممنوع گواهی‌نامه و احتمالاً یک «نام مستعار» (nickname / alias).
.PP
به‌طور معمول هنگامی که یک گواهی‌نامه در حال اعتبارسنجی است، حداقل یک گواهی‌نامه
باید «مورد اعتماد» باشد. به‌طور پیش‌فرض یک گواهی‌نامه مورد اعتماد باید به صورت
محلی ذخیره شده باشد و باید یک ریشه CA (Root CA) باشد: هر زنجیره گواهی‌نامه‌ای که به این CA ختم شود
برای هر منظوری قابل استفاده است.
.PP
تنظیمات اعتماد در حال حاضر فقط برای ریشه CA استفاده می‌شوند.
آن‌ها امکان کنترل دقیق‌تری روی اهدافی که ریشه CA می‌تواند برای آن‌ها استفاده شود را فراهم می‌کنند.
برای مثال، یک CA ممکن است برای کلاینت SSL مورد اعتماد باشد اما برای سرور SSL نه.
.PP
برای اطلاعات بیشتر در مورد مفهوم تنظیمات اعتماد به
\fBopenssl\-verification\-options\fR\|(1) مراجعه کنید.
.PP
نسخه‌های آینده OpenSSL تنظیمات اعتماد را روی هر
گواهی‌نامه‌ای تشخیص خواهند داد، نه فقط ریشه‌های CA.
.IP \fB\-trustout\fR 4
.IX Item "-trustout"
علامت‌گذاری هر خروجی PEM گواهی‌نامه به عنوان یک گواهی‌نامه <trusted> (مورد اعتماد) به جای یک گواهی‌نامه معمولی.
یک گواهی‌نامه معمولی یا مورد اعتماد می‌تواند به عنوان ورودی داده شود اما به‌طور پیش‌فرض یک گواهی‌نامه
معمولی در خروجی تولید می‌شود و تنظیمات اعتماد کنار گذاشته می‌شوند.
با گزینه \fB\-trustout\fR یک گواهی‌نامه مورد اعتماد در خروجی نوشته می‌شود. اگر هر یک از تنظیمات اعتماد تغییر داده شود، یک گواهی‌نامه مورد اعتماد به‌طور خودکار در خروجی تولید می‌شود.
.IP "\fB\-setalias\fR \fIarg\fR" 4
.IX Item "-setalias arg"
«نام مستعار» (alias) گواهی‌نامه را تنظیم می‌کند. این امکان را فراهم می‌سازد که به گواهی‌نامه
با یک نام مستعار اشاره شود، برای مثال "Steve\*(Aqs Certificate".
.IP \fB\-clrtrust\fR 4
.IX Item "-clrtrust"
تمام کاربردهای مجاز یا مورد اعتماد گواهی‌نامه را پاک می‌کند.
.IP "\fB\-addtrust\fR \fIarg\fR" 4
.IX Item "-addtrust arg"
یک کاربرد مورد اعتماد به گواهی‌نامه اضافه می‌کند.
هر نام شیئی می‌تواند در اینجا استفاده شود اما در حال حاضر تنها \fBclientAuth\fR،
\&\fBserverAuth\fR، \fBemailProtection\fR و \fBanyExtendedKeyUsage\fR تعریف شده‌اند.
از OpenSSL 1.1.0 به بعد، آخرین مورد از این گزینه‌ها در صورت رد شدن، تمام اهداف را مسدود می‌کند یا
در صورت مورد اعتماد بودن، تمام اهداف را فعال می‌سازد.
سایر برنامه‌های کاربردی OpenSSL ممکن است کاربردهای بیشتری تعریف کنند.
.IP \fB\-clrreject\fR 4
.IX Item "-clrreject"
تمام کاربردهای ممنوع یا ردشده گواهی‌نامه را پاک می‌کند.
.IP "\fB\-addreject\fR \fIarg\fR" 4
.IX Item "-addreject arg"
یک هدف ممنوع برای نقطه اتکای اعتماد (trust anchor) اضافه می‌کند.
این گزینه همان مقادیر گزینه \fB\-addtrust\fR را می‌پذیرد.
.SS "گزینه‌های عمومی (Generic options)"
.IX Subsection "Generic options"
.IP "\fB\-rand\fR \fIfiles\fR, \fB\-writerand\fR \fIfile\fR" 4
.IX Item "-rand files, -writerand file"
برای جزئیات بیشتر، بخش «گزینه‌های وضعیت تصادفی» در \fBopenssl\fR\|(1) را ببینید.
.IP "\fB\-engine\fR \fIid\fR" 4
.IX Item "-engine id"
بخش «گزینه‌های موتور» در \fBopenssl\fR\|(1) را ببینید.
این گزینه منسوخ شده است.
.IP "\fB\-provider\fR \fIname\fR" 4
.IX Item "-provider name"
.PD 0
.IP "\fB\-provider\-path\fR \fIpath\fR" 4
.IX Item "-provider-path path"
.IP "\fB\-provparam\fR \fI[name:]key=value\fR" 4
.IX Item "-provparam [name:]key=value"
.IP "\fB\-propquery\fR \fIpropq\fR" 4
.IX Item "-propquery propq"
.PD
بخش «گزینه‌های ارائه‌دهنده» در \fBopenssl\fR\|(1)، \fBprovider\fR\|(7) و \fBproperty\fR\|(7) را ببینید.
.SS "پرچم‌های چاپ متن (Text Printing Flags)"
.IX Subsection "Text Printing Flags"
علاوه بر سفارشی‌سازی قالب چاپ نام، سفارشی‌سازی فیلدهای واقعی چاپ‌شده با استفاده از گزینه \fBcertopt\fR در هنگام حضور گزینه \fBtext\fR نیز امکان‌پذیر است. رفتار پیش‌فرض، چاپ تمام فیلدها است.
.IP \fBcompatible\fR 4
.IX Item "compatible"
استفاده از قالب قدیمی. این معادل عدم تعیین هیچ گزینه چاپی است.
.IP \fBno_header\fR 4
.IX Item "no_header"
عدم چاپ اطلاعات سرآیند: یعنی خطوطی که عبارت‌های "Certificate" و "Data" را نشان می‌دهند.
.IP \fBno_version\fR 4
.IX Item "no_version"
عدم چاپ شماره نسخه.
.IP \fBno_serial\fR 4
.IX Item "no_serial"
عدم چاپ شماره سریال.
.IP \fBno_signame\fR 4
.IX Item "no_signame"
عدم چاپ الگوریتم امضای استفاده‌شده.
.IP \fBno_validity\fR 4
.IX Item "no_validity"
عدم چاپ اعتبار، یعنی فیلدهای \fBnotBefore\fR و \fBnotAfter\fR.
.IP \fBno_subject\fR 4
.IX Item "no_subject"
عدم چاپ نام موضوع.
.IP \fBno_issuer\fR 4
.IX Item "no_issuer"
عدم چاپ نام صادرکننده.
.IP \fBno_pubkey\fR 4
.IX Item "no_pubkey"
عدم چاپ کلید عمومی.
.IP \fBno_sigdump\fR 4
.IX Item "no_sigdump"
عدم ارائه دامپ هگزادسیمال از امضای گواهی‌نامه.
.IP \fBno_aux\fR 4
.IX Item "no_aux"
عدم چاپ اطلاعات اعتماد گواهی‌نامه.
.IP \fBno_extensions\fR 4
.IX Item "no_extensions"
عدم چاپ هیچ‌یک از افزونه‌های X509V3.
.IP \fBext_default\fR 4
.IX Item "ext_default"
حفظ رفتار پیش‌فرض افزونه‌ها: تلاش برای چاپ افزونه‌های پشتیبانی‌نشده گواهی‌نامه.
.IP \fBext_error\fR 4
.IX Item "ext_error"
چاپ پیام خطا برای افزونه‌های پشتیبانی‌نشده گواهی‌نامه.
.IP \fBext_parse\fR 4
.IX Item "ext_parse"
تجزیه نحوی ASN1 برای افزونه‌های پشتیبانی‌نشده.
.IP \fBext_dump\fR 4
.IX Item "ext_dump"
دامپ هگزادسیمال افزونه‌های پشتیبانی‌نشده.
.IP \fBca_default\fR 4
.IX Item "ca_default"
مقدار مورد استفاده توسط \fBopenssl\-ca\fR\|(1)، معادل \fBno_issuer\fR، \fBno_pubkey\fR،
\&\fBno_header\fR و \fBno_version\fR.
.SH "مثال‌ها (EXAMPLES)"
.IX Header "EXAMPLES"
توجه: در این مثال‌ها علامت \*(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
چاپ نام موضوع گواهی‌نامه در قالب تک‌خطی (oneline) در پایانه‌ای که از 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
بررسی اینکه آیا هر یک از گواهی‌نامه‌های موجود در یک زنجیره ظرف ۳۰ روز آینده منقضی می‌شوند یا خیر
(اگر هیچ‌کدام منقضی نشوند صفر و در صورتی که هرکدام منقضی شوند مقدار غیرصفر برمی‌گرداند):
.PP
.Vb 2
\& openssl x509 \-in chain.pem \-multi \-checkend $[3600*24*30] \e
\&        && echo \*(Aqperform renewal\*(Aq || echo \*(Aqrenewal unnecessary\*(Aq
.Ve
.SH "نکات (NOTES)"
.IX Header "NOTES"
تبدیل به قالب UTF8 مورد استفاده در گزینه‌های نام فرض می‌کند که رشته‌های T61String از مجموعه نویسه‌های ISO8859\-1 استفاده می‌کنند. این فرضی نادرست است اما مرورگرهای Netscape و MSIE و همچنین بسیاری از گواهی‌نامه‌ها این کار را انجام می‌دهند. بنابراین اگرچه این تبدیل نادرست است، اما احتمال چاپ صحیح اکثریت گواهی‌نامه‌ها را افزایش می‌دهد.
.PP
گزینه \fB\-email\fR نام موضوع و افزونه نام جایگزین موضوع (subject alternative name) را جستجو می‌کند. تنها نشانی‌های رایانامه منحصربه‌فرد چاپ می‌شوند: یک نشانی یکسان بیش از یک بار چاپ نخواهد شد.
.SH "اشکالات (BUGS)"
.IX Header "BUGS"
تولید گواهی‌نامه‌ها یا درخواست‌های نامعتبر با تعیین کلید خصوصی اشتباه، استفاده از افزونه‌های نامناسب X.509
یا در برخی موارد استفاده از گزینه‌های ناسازگار امکان‌پذیر است: این موارد باید بررسی و کنترل شوند.
.PP
باید گزینه‌هایی برای تنظیم صریح مواردی مانند تاریخ آغاز و پایان
به جای انحراف زمانی از زمان جاری وجود داشته باشد.
.SH "همچنین ببینید (SEE ALSO)"
.IX Header "SEE ALSO"
\&\fBopenssl\fR\|(1),
\&\fBopenssl\-req\fR\|(1),
\&\fBopenssl\-ca\fR\|(1),
\&\fBopenssl\-genrsa\fR\|(1),
\&\fBopenssl\-gendsa\fR\|(1),
\&\fBopenssl\-verify\fR\|(1),
\&\fBx509v3_config\fR\|(5)
.SH "تاریخچه (HISTORY)"
.IX Header "HISTORY"
الگوریتم هش استفاده‌شده در گزینه‌های \fB\-subject_hash\fR و \fB\-issuer_hash\fR
پیش از OpenSSL 1.0.0 بر پایه الگوریتم منسوخ‌شده MD5 و کدگذاری
نام متمایز (distinguished name یا DN) بود. در OpenSSL 1.0.0 و بعد از آن، این الگوریتم بر پایه یک نسخه متعارف
از DN با استفاده از SHA1 است. این بدان معنی است که پیوندهای هر پوشه‌ای که از قالب قدیمی استفاده می‌کند
باید با استفاده از \fBopenssl\-rehash\fR\|(1) یا دستورات مشابه بازسازی شوند.
.PP
گزینه \fB\-signkey\fR در OpenSSL 3.0 به \fB\-key\fR تغییر نام یافت،
در حالی که نام قدیمی به عنوان نام مستعار حفظ شد.
.PP
گزینه \fB\-engine\fR در OpenSSL 3.0 منسوخ شد.
.PP
گزینه \fB\-C\fR در OpenSSL 3.0 حذف شد.
.PP
از OpenSSL 3.2 به بعد، گواهی‌نامه‌های تولیدشده دارای نسخه ۳ استاندارد X.509 هستند،
و افزونه‌های شناسه کلید به‌طور پیش‌فرض اضافه می‌شوند.
.SH "حق نشر (COPYRIGHT)"
.IX Header "COPYRIGHT"
حق نشر ۲۰۰۰\-۲۰۲۵ نویسندگان پروژه OpenSSL. کلیه حقوق محفوظ است.
.PP
تحت مجوز آپاچی نسخه ۲.۰ («مجوز») منتشر شده است. شما نمی‌توانید از این فایل جز در انطباق با مجوز استفاده کنید. می‌توانید یک کپی از مجوز را در فایل LICENSE در توزیع منبع یا در
<https://www.openssl.org/source/license.html>
به دست آورید.