.\" -*- 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-REQ 1ssl" .TH OPENSSL-REQ 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\-req \- دستور تولید گواهی و درخواست گواهی PKCS#10 .SH "خلاصه دستور (SYNOPSIS)" .IX Header "SYNOPSIS" \&\fBopenssl\fR \fBreq\fR [\fB\-help\fR] [\fB\-cipher\fR] [\fB\-inform\fR \fBDER\fR|\fBPEM\fR] [\fB\-outform\fR \fBDER\fR|\fBPEM\fR] [\fB\-in\fR \fIfilename\fR] [\fB\-passin\fR \fIarg\fR] [\fB\-out\fR \fIfilename\fR] [\fB\-passout\fR \fIarg\fR] [\fB\-text\fR] [\fB\-pubkey\fR] [\fB\-noout\fR] [\fB\-verify\fR] [\fB\-modulus\fR] [\fB\-new\fR] [\fB\-newkey\fR \fIarg\fR] [\fB\-pkeyopt\fR \fIopt\fR:\fIvalue\fR] [\fB\-noenc\fR] [\fB\-nodes\fR] [\fB\-key\fR \fIfilename\fR|\fIuri\fR] [\fB\-keyform\fR \fBDER\fR|\fBPEM\fR|\fBP12\fR|\fBENGINE\fR] [\fB\-keyout\fR \fIfilename\fR] [\fB\-keygen_engine\fR \fIid\fR] [\fB\-\fR\f(BIdigest\fR] [\fB\-config\fR \fIfilename\fR] [\fB\-section\fR \fIname\fR] [\fB\-x509\fR] [\fB\-x509v1\fR] [\fB\-CA\fR \fIfilename\fR|\fIuri\fR] [\fB\-CAkey\fR \fIfilename\fR|\fIuri\fR] [\fB\-not_before\fR \fIdate\fR] [\fB\-not_after\fR \fIdate\fR] [\fB\-days\fR \fIn\fR] [\fB\-set_serial\fR \fIn\fR] [\fB\-newhdr\fR] [\fB\-copy_extensions\fR \fIarg\fR] [\fB\-extensions\fR \fIsection\fR] [\fB\-reqexts\fR \fIsection\fR] [\fB\-addext\fR \fIext\fR] [\fB\-precert\fR] [\fB\-utf8\fR] [\fB\-reqopt\fR] [\fB\-subject\fR] [\fB\-subj\fR \fIarg\fR] [\fB\-multivalue\-rdn\fR] [\fB\-sigopt\fR \fInm\fR:\fIv\fR] [\fB\-vfyopt\fR \fInm\fR:\fIv\fR] [\fB\-batch\fR] [\fB\-verbose\fR] [\fB\-quiet\fR] [\fB\-nameopt\fR \fIoption\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) در قالب PKCS#10 به کار می‌رود. همچنین می‌تواند گواهی‌های خودامضا، مثلاً برای استفاده به عنوان CAهای ریشه (Root CA)، ایجاد کند. .SH "گزینه‌ها (OPTIONS)" .IX Header "OPTIONS" .IP \fB\-help\fR 4 .IX Item "-help" پیام راهنمای نحوه استفاده را چاپ می‌کند. .IP "\fB\-inform\fR \fBDER\fR|\fBPEM\fR" 4 .IX Item "-inform DER|PEM" قالب فایل ورودی CSR مورد استفاده؛ به‌طور پیش‌فرض ابتدا PEM آزموده می‌شود. برای جزئیات \fBopenssl\-format\-options\fR\|(1) را ببینید. .IP "\fB\-outform\fR \fBDER\fR|\fBPEM\fR" 4 .IX Item "-outform DER|PEM" قالب خروجی؛ به‌طور پیش‌فرض نامشخص است. برای جزئیات \fBopenssl\-format\-options\fR\|(1) را ببینید. .Sp داده یک شیء PKCS#10 است. .IP "\fB\-cipher\fR \fIname\fR" 4 .IX Item "-cipher name" رمزنگاری مورد استفاده برای رمزگذاری کلید خصوصی را تعیین می‌کند. اگر رمزی مشخص نشود، به‌طور پیش‌فرض AES\-256\-CBC استفاده خواهد شد. می‌توانید با ارائه هر نام رمزنگاری معتبر OpenSSL این مقدار را بازنویسی کنید. .IP "\fB\-in\fR \fIfilename\fR" 4 .IX Item "-in filename" نام فایل ورودی را برای خواندن یک درخواست مشخص می‌کند. در صورتی که \fB\-x509\fR یا \fB\-CA\fR مشخص نشده باشد، به‌طور پیش‌فرض از ورودی استاندارد خوانده می‌شود. یک درخواست تنها در صورتی خوانده می‌شود که گزینه‌های ایجاد (\fB\-new\fR یا \fB\-newkey\fR یا \fB\-precert\fR) مشخص نشده باشند. .IP "\fB\-sigopt\fR \fInm\fR:\fIv\fR" 4 .IX Item "-sigopt nm:v" گزینه‌ها را در طول عملیات امضا به الگوریتم امضا ارسال می‌کند. نام‌ها و مقادیر این گزینه‌ها وابسته به الگوریتم هستند. .IP "\fB\-vfyopt\fR \fInm\fR:\fIv\fR" 4 .IX Item "-vfyopt nm:v" گزینه‌ها را در طول عملیات اعتبارسنجی به الگوریتم امضا ارسال می‌کند. نام‌ها و مقادیر این گزینه‌ها وابسته به الگوریتم هستند. .IP "\fB\-passin\fR \fIarg\fR" 4 .IX Item "-passin arg" منبع گذرواژه برای ورودی کلید خصوصی و گواهی. برای اطلاعات بیشتر درباره قالب \fBarg\fR به \fBopenssl\-passphrase\-options\fR\|(1) مراجعه کنید. .IP "\fB\-passout\fR \fIarg\fR" 4 .IX Item "-passout arg" منبع گذرواژه برای فایل خروجی. برای اطلاعات بیشتر درباره قالب \fBarg\fR به \fBopenssl\-passphrase\-options\fR\|(1) مراجعه کنید. .IP "\fB\-out\fR \fIfilename\fR" 4 .IX Item "-out filename" نام فایل خروجی برای نوشتن را تعیین می‌کند؛ به‌طور پیش‌فرض خروجی استاندارد است. .IP \fB\-text\fR 4 .IX Item "-text" درخواست گواهی را در قالب متنی چاپ می‌کند. .IP \fB\-subject\fR 4 .IX Item "-subject" نام موضوع (subject) درخواست گواهی را چاپ می‌کند (یا موضوع گواهی، در صورتی که \fB\-x509\fR در حال استفاده باشد). .IP \fB\-pubkey\fR 4 .IX Item "-pubkey" کلید عمومی را چاپ می‌کند. .IP \fB\-noout\fR 4 .IX Item "-noout" این گزینه از خروجی دادن نسخه کدگذاری‌شده درخواست گواهی جلوگیری می‌کند. .IP \fB\-modulus\fR 4 .IX Item "-modulus" مقدار مدول کلید عمومی موجود در درخواست را چاپ می‌کند. .IP \fB\-verify\fR 4 .IX Item "-verify" خودامضایی روی درخواست را اعتبارسنجی می‌کند. در صورت ناموفق بودن اعتبارسنجی، برنامه بلافاصله خارج می‌شود، یعنی پردازش گزینه‌های بعدی (مانند \fB\-text\fR) نادیده گرفته خواهد شد. .IP \fB\-new\fR 4 .IX Item "-new" این گزینه یک درخواست گواهی جدید تولید می‌کند. از کاربر برای مقادیر فیلدهای مربوطه درخواست ورودی می‌کند. فیلدهای واقعی که درخواست می‌شوند و حداقل و حداکثر اندازه‌های آن‌ها در فایل پیکربندی و هرگونه افزونه درخواستی تعیین شده‌اند. .Sp اگر گزینه \fB\-key\fR داده نشود، یک کلید خصوصی جدید با استفاده از اطلاعات مشخص‌شده در فایل پیکربندی یا داده‌شده با گزینه‌های \fB\-newkey\fR و \fB\-pkeyopt\fR تولید خواهد شد؛ در غیر این صورت به‌طور پیش‌فرض یک کلید RSA با طول ۲۰۴۸ بیت ایجاد می‌شود. .IP "\fB\-newkey\fR \fIarg\fR" 4 .IX Item "-newkey arg" این گزینه برای تولید یک کلید خصوصی جدید استفاده می‌شود مگر اینکه \fB\-key\fR داده شده باشد. سپس به‌گونه‌ای استفاده می‌شود که گویی با گزینه \fB\-key\fR ارائه شده است. .Sp این گزینه متضمن فلگ \fB\-new\fR برای ایجاد یک درخواست گواهی جدید، یا یک گواهی جدید در صورت استفاده از \fB\-x509\fR است. .Sp آرگومان یکی از چندین قالب را می‌پذیرد. .Sp [\fBrsa:\fR]\fInbits\fR یک کلید RSA با اندازه \fInbits\fR تولید می‌کند. اگر \fInbits\fR حذف شود، یعنی \fB\-newkey\fR \fBrsa\fR مشخص شود، اندازه کلید پیش‌فرضِ مشخص‌شده در فایل پیکربندی با گزینه \fBdefault_bits\fR در صورت وجود، وگرنه ۲۰۴۸ استفاده می‌شود. .Sp سایر الگوریتم‌ها از قالب \fB\-newkey\fR \fIalgname\fR:\fIfile\fR پشتیبانی می‌کنند، که در آن \&\fIfile\fR یک فایل پارامتر الگوریتم است که با \f(CW\*(C`openssl genpkey \-genparam\*(C'\fR یا یک گواهی X.509 برای کلیدی با الگوریتم مناسب ایجاد شده است. .Sp \&\fBparam:\fR\fIfile\fR با استفاده از فایل پارامتر یا گواهی \&\fIfile\fR کلیدی تولید می‌کند؛ الگوریتم بر اساس پارامترها تعیین می‌شود. .Sp \&\fIalgname\fR[:\fIfile\fR] با استفاده از الگوریتم داده‌شده \fIalgname\fR کلیدی تولید می‌کند. اگر یک فایل پارامتر \fIfile\fR داده شود، پارامترهای مشخص‌شده در آن استفاده می‌شوند، به‌طوری که پارامترهای الگوریتم باید با \fIalgname\fR مطابقت داشته باشند. اگر پارامترهای الگوریتم داده نشوند، هر پارامتر ضروری باید از طریق گزینه \fB\-pkeyopt\fR تعیین شود. .Sp \&\fBdsa:\fR\fIfilename\fR با استفاده از پارامترهای موجود در فایل \&\fIfilename\fR یک کلید DSA تولید می‌کند. \fBec:\fR\fIfilename\fR کلید EC تولید می‌کند (قابل استفاده با هر دو الگوریتم ECDSA یا ECDH)، \fBgost2001:\fR\fIfilename\fR کلید GOST R 34.10\-2001 تولید می‌کند (نیازمند موتور \fBgost\fR پیکربندی‌شده در فایل پیکربندی است). اگر فقط \fBgost2001\fR مشخص شود، یک مجموعه پارامتر باید توسط \fB\-pkeyopt\fR \fIparamset:X\fR تعیین گردد. .IP "\fB\-pkeyopt\fR \fIopt\fR:\fIvalue\fR" 4 .IX Item "-pkeyopt opt:value" گزینه الگوریتم کلید عمومی \fIopt\fR را روی \fIvalue\fR تنظیم می‌کند. مجموعه دقیق گزینه‌های پشتیبانی‌شده به الگوریتم کلید عمومی مورد استفاده و پیاده‌سازی آن بستگی دارد. برای جزئیات بیشتر به بخش "KEY GENERATION OPTIONS" در \fBopenssl\-genpkey\fR\|(1) مراجعه کنید. .IP "\fB\-key\fR \fIfilename\fR|\fIuri\fR" 4 .IX Item "-key filename|uri" این گزینه کلید خصوصی را برای امضای گواهی جدید یا درخواست گواهی فراهم می‌کند. مگر اینکه \fB\-in\fR داده شده باشد، کلید عمومی مربوطه در گواهی جدید یا درخواست گواهی قرار داده می‌شود که منجر به یک خودامضایی می‌گردد. .Sp برای امضای گواهی، گزینه \fB\-CA\fR بر این گزینه اولویت داشته و آن را بازنویسی می‌کند. .Sp این گزینه همچنین کلیدهای خصوصی در قالب PKCS#8 را برای فایل‌های قالب PEM می‌پذیرد. .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\-keyout\fR \fIfilename\fR" 4 .IX Item "-keyout filename" نام فایلی را مشخص می‌کند که هر کلید خصوصی تازه‌تولیدشده یا خوانده‌شده از \fB\-key\fR در آن نوشته شود. اگر نه گزینه \fB\-keyout\fR و نه گزینه \fB\-key\fR ارائه نشده باشند، نام فایل مشخص‌شده در فایل پیکربندی با گزینه \&\fBdefault_keyfile\fR در صورت وجود استفاده می‌شود. بنابراین، اگر می‌خواهید کلید خصوصی را بنویسید و گزینه \fB\-key\fR فراهم شده است، باید گزینه \&\fB\-keyout\fR را صراحتاً ارائه دهید. اگر کلید جدیدی تولید شود و هیچ نام فایلی مشخص نشده باشد، کلید در خروجی استاندارد نوشته می‌شود. .IP \fB\-noenc\fR 4 .IX Item "-noenc" اگر این گزینه مشخص شود، در صورت ایجاد کلید خصوصی، آن کلید رمزگذاری نخواهد شد. .IP \fB\-nodes\fR 4 .IX Item "-nodes" این گزینه از زمان OpenSSL 3.0 منسوخ شده است؛ به‌جای آن از \fB\-noenc\fR استفاده کنید. .IP \fB\-\fR\f(BIdigest\fR 4 .IX Item "-digest" چکیده پیام (digest) را برای امضای درخواست مشخص می‌کند. هر چکیده‌ای که توسط دستور \fBdgst\fR در OpenSSL پشتیبانی شود قابل استفاده است. این مقدار، الگوریتم چکیده مشخص‌شده در فایل پیکربندی را بازنویسی می‌کند. .Sp برخی الگوریتم‌های کلید عمومی ممکن است این انتخاب را بازنویسی کنند. برای نمونه، امضاهای DSA همیشه از SHA1 استفاده می‌کنند، امضاهای GOST R 34.10 همیشه از GOST R 34.11\-94 (\fB\-md_gost94\fR) استفاده می‌کنند، و Ed25519 و Ed448 هرگز از هیچ چکیده‌ای استفاده نمی‌کنند. .IP "\fB\-config\fR \fIfilename\fR" 4 .IX Item "-config filename" امکان تعیین یک فایل پیکربندی جایگزین را فراهم می‌کند. اختیاری است؛ برای شرح مقدار پیش‌فرض، بخش "COMMAND SUMMARY" در \fBopenssl\fR\|(1) را ببینید. .IP "\fB\-section\fR \fIname\fR" 4 .IX Item "-section name" نام بخش مورد استفاده را مشخص می‌کند؛ پیش‌فرض \fBreq\fR است. .IP "\fB\-subj\fR \fIarg\fR" 4 .IX Item "-subj arg" نام موضوع (subject) را برای درخواست جدید تنظیم می‌کند یا هنگام پردازش یک درخواست گواهی، جایگزین نام موضوع می‌شود. .Sp آرگومان باید به‌صورت \f(CW\*(C`/type0=value0/type1=value1/type2=...\*(C'\fR قالب‌بندی شود. نویسه‌های خاص می‌توانند با \f(CW\*(C`\e\*(C'\fR (بک‌اسلش) اسکیپ شوند؛ فاصله‌های خالی حفظ می‌شوند. مقادیر خالی مجاز هستند، اما نوع مربوطه در درخواست گنجانده نخواهد شد. ارائه یک \f(CW\*(C`/\*(C'\fR منفرد منجر به یک توالی خالی از RDNها (یک NULL\-DN) می‌شود. RDNهای چندمقداری را می‌توان با قرار دادن نویسه \f(CW\*(C`+\*(C'\fR به‌جای \f(CW\*(C`/\*(C'\fR بین AttributeValueAssertionها (AVAs) که اعضای مجموعه را تعیین می‌کنند، تشکیل داد. مثال: .Sp \&\f(CW\*(C`/DC=org/DC=OpenSSL/DC=users/UID=123456+CN=John Doe\*(C'\fR .IP \fB\-multivalue\-rdn\fR 4 .IX Item "-multivalue-rdn" این گزینه منسوخ شده و هیچ تاثیری ندارد. .IP \fB\-x509\fR 4 .IX Item "-x509" این گزینه به‌جای درخواست گواهی، یک گواهی را در خروجی تولید می‌کند. این گزینه معمولاً برای تولید گواهی‌های آزمایشی استفاده می‌شود. این مورد توسط گزینه \fB\-CA\fR به‌طور ضمنی فعال می‌شود. .Sp اگر \fB\-in\fR داده نشود، این گزینه متضمن فلگ \fB\-new\fR است. .Sp اگر یک درخواست موجود با گزینه \fB\-in\fR مشخص شود، به یک گواهی تبدیل می‌گردد؛ در غیر این صورت یک درخواست از ابتدا ایجاد می‌شود. .Sp مگر اینکه با استفاده از گزینه \fB\-set_serial\fR مشخص شده باشد، یک عدد تصادفی بزرگ برای شماره سریال استفاده خواهد شد. .Sp مگر اینکه از گزینه \fB\-copy_extensions\fR استفاده شود، افزونه‌های X.509 از هیچ فایل ورودی درخواست ارائه‌شده‌ای کپی نمی‌شوند. .Sp افزونه‌های X.509 برای اضافه شدن می‌توانند در فایل پیکربندی (احتمالاً با استفاده از گزینه‌های \fB\-config\fR و \fB\-extensions\fR) و/یا با استفاده از گزینه \fB\-addext\fR مشخص شوند. .Sp مگر اینکه \fB\-x509v1\fR داده شود، گواهی‌های تولیدشده نسخه ۳ از X.509 را دارند. مگر اینکه خلاف آن مشخص شود، افزونه‌های شناسه کلید همان‌طور که در \fBx509v3_config\fR\|(5) توضیح داده شده است گنجانده می‌شوند. .IP \fB\-x509v1\fR 4 .IX Item "-x509v1" درخواست تولید گواهی‌هایی با نسخه ۱ از X.509 را می‌دهد. این گزینه متضمن \fB\-x509\fR است. اگر افزونه‌های X.509 ارائه شوند، در هر صورت نسخه ۳ از X.509 تنظیم می‌شود. .IP "\fB\-CA\fR \fIfilename\fR|\fIuri\fR" 4 .IX Item "-CA filename|uri" گواهی "CA" مورد استفاده برای امضای گواهی جدید را مشخص می‌کند و متضمن استفاده از \fB\-x509\fR است. هنگام حضور، مانند یک "micro CA" به‌شرح زیر عمل می‌کند: نام موضوع گواهی "CA" به‌عنوان نام صادرکننده در گواهی جدید قرار می‌گیرد، که سپس با استفاده از کلید "CA" داده‌شده مطابق آنچه در زیر مشخص شده است، امضا می‌شود. .IP "\fB\-CAkey\fR \fIfilename\fR|\fIuri\fR" 4 .IX Item "-CAkey filename|uri" کلید خصوصی "CA" را برای امضای گواهی تنظیم می‌کند. کلید خصوصی باید با کلید عمومی گواهی داده‌شده با \fB\-CA\fR مطابقت داشته باشد. اگر این گزینه ارائه نشود، کلید باید در ورودی \fB\-CA\fR موجود باشد. .IP "\fB\-not_before\fR \fIdate\fR" 4 .IX Item "-not_before date" هنگامی که \fB\-x509\fR در حال استفاده است، این گزینه امکان تنظیم صریح تاریخ شروع را فراهم می‌کند، در غیر این صورت نادیده گرفته می‌شود. قالب \fIdate\fR به‌صورت YYMMDDHHMMSSZ (همانند یک ساختار ASN1 UTCTime) یا YYYYMMDDHHMMSSZ (همانند یک ساختار ASN1 GeneralizedTime) است. در هر دو قالب، ثانیه‌ها SS و منطقه زمانی Z باید وجود داشته باشند. به‌عنوان جایگزین، می‌توانید از "today" نیز استفاده کنید. .IP "\fB\-not_after\fR \fIdate\fR" 4 .IX Item "-not_after date" هنگامی که \fB\-x509\fR در حال استفاده است، این گزینه امکان تنظیم صریح تاریخ انقضا را فراهم می‌کند، در غیر این صورت نادیده گرفته می‌شود. قالب \fIdate\fR به‌صورت YYMMDDHHMMSSZ (همانند یک ساختار ASN1 UTCTime) یا YYYYMMDDHHMMSSZ (همانند یک ساختار ASN1 GeneralizedTime) است. در هر دو قالب، ثانیه‌ها SS و منطقه زمانی Z باید وجود داشته باشند. به‌عنوان جایگزین، می‌توانید از "today" نیز استفاده کنید. .Sp این گزینه بر گزینه \fB\-days\fR اولویت دارد و آن را بازنویسی می‌کند. .IP "\fB\-days\fR \fIn\fR" 4 .IX Item "-days n" هنگامی که \fB\-x509\fR در حال استفاده است، این گزینه تعداد روزها از امروز را برای اعتباربخشی به گواهی مشخص می‌کند، در غیر این صورت نادیده گرفته می‌شود. \fIn\fR باید یک عدد صحیح مثبت باشد. پیش‌فرض ۳۰ روز است. .Sp صرف‌نظر از گزینه \fB\-not_before\fR، روزها همیشه از امروز شمرده می‌شوند. هنگامی که همراه با گزینه \fB\-not_after\fR استفاده شود، تاریخ انقضای صریح اولویت دارد. .IP "\fB\-set_serial\fR \fIn\fR" 4 .IX Item "-set_serial n" شماره سریالی که هنگام خروجی دادن یک گواهی خودامضا استفاده می‌شود. این مقدار می‌تواند به‌صورت ده‌دهی یا هگزادسیمال در صورت شروع با \f(CW\*(C`0x\*(C'\fR مشخص شود. اگر داده نشود، یک عدد تصادفی بزرگ استفاده خواهد شد. .IP "\fB\-copy_extensions\fR \fIarg\fR" 4 .IX Item "-copy_extensions arg" نحوه مدیریت افزونه‌های X.509 در درخواست‌های گواهی را هنگام استفاده از \fB\-x509\fR تعیین می‌کند. اگر \fIarg\fR برابر با \fBnone\fR باشد یا این گزینه وجود نداشته باشد، افزونه‌ها نادیده گرفته می‌شوند. اگر \fIarg\fR برابر با \fBcopy\fR یا \fBcopyall\fR باشد، تمامی افزونه‌های موجود در درخواست به گواهی کپی می‌شوند. .Sp کاربرد اصلی این گزینه اجازه دادن به یک درخواست گواهی برای ارائه مقادیر برای برخی افزونه‌ها مانند subjectAltName است. .IP "\fB\-extensions\fR \fIsection\fR, \fB\-reqexts\fR \fIsection\fR" 4 .IX Item "-extensions section, -reqexts section" می‌تواند برای بازنویسی نام بخش فایل پیکربندی که افزونه‌های X.509 از آن در گواهی (هنگام استفاده از \fB\-x509\fR) یا درخواست گواهی گنجانده می‌شوند، استفاده شود. این امکان را فراهم می‌کند که چندین بخش مختلف در یک فایل پیکربندی برای مشخص کردن درخواست‌ها با اهداف گوناگون استفاده شوند. .IP "\fB\-addext\fR \fIext\fR" 4 .IX Item "-addext ext" یک افزونه مشخص را به گواهی (اگر \fB\-x509\fR در حال استفاده باشد) یا درخواست گواهی اضافه می‌کند. آرگومان باید به شکل یک جفت \&\f(CW\*(C`key=value\*(C'\fR باشد، همان‌طور که در فایل پیکربندی ظاهر می‌شود. .Sp اگر افزونه‌ای با استفاده از این گزینه اضافه شود که OID آن با یکی از موارد تعریف‌شده در بخش افزونه فایل پیکربندی یکسان باشد، آن را بازنویسی می‌کند. .Sp این گزینه می‌تواند چندین بار مشخص شود. در این صورت، یک کلید یکسان نباید بیش از یک بار داده شود. .IP \fB\-precert\fR 4 .IX Item "-precert" یک افزونه مسموم‌کننده (poison extension) به گواهی اضافه می‌شود که آن را به یک "پیش‌گواهی" (pre\-certificate، به RFC6962 مراجعه کنید) تبدیل می‌کند. این پیش‌گواهی می‌تواند به گزارش‌های شفافیت گواهی (Certificate Transparency) ارسال شود تا برچسب‌های زمانی گواهی امضاشده (SCTs) دریافت گردند. این SCTها سپس می‌توانند قبل از حذف افزونه مسموم‌کننده و امضای گواهی، به‌عنوان یک افزونه درون پیش‌گواهی تعبیه شوند. .Sp این گزینه متضمن فلگ \fB\-new\fR است. .IP \fB\-utf8\fR 4 .IX Item "-utf8" این گزینه باعث می‌شود مقادیر فیلدها به‌عنوان رشته‌های UTF8 تفسیر شوند؛ به‌طور پیش‌فرض آن‌ها به‌عنوان ASCII تفسیر می‌شوند. این بدان معناست که مقادیر فیلدها، چه از ترمینال پرسیده شوند و چه از یک فایل پیکربندی به دست آیند، باید رشته‌های UTF8 معتبر باشند. .IP "\fB\-reqopt\fR \fIoption\fR" 4 .IX Item "-reqopt option" قالب چاپ مورد استفاده با \fB\-text\fR را سفارشی می‌کند. آرگومان \fIoption\fR می‌تواند یک گزینه منفرد یا چندین گزینه جداشده با کاما باشد. .Sp به بحث پارامتر \fB\-certopt\fR در دستور \fBopenssl\-x509\fR\|(1) مراجعه کنید. .IP \fB\-newhdr\fR 4 .IX Item "-newhdr" کلمه \fBNEW\fR را به خطوط سرایند (header) و پانویس (footer) فایل PEM در درخواست خروجی اضافه می‌کند. برخی نرم‌افزارها (مانند سرور گواهی نت‌اسکیپ) و برخی CAها به این نیاز دارند. .IP \fB\-batch\fR 4 .IX Item "-batch" حالت غیرتعاملی. .IP \fB\-verbose\fR 4 .IX Item "-verbose" چاپ جزئیات بیشتر درباره عملیات در حال انجام. .IP \fB\-quiet\fR 4 .IX Item "-quiet" چاپ جزئیات کمتر درباره عملیات در حال انجام، که ممکن است در طول اسکریپت‌های دسته‌ای یا خطوط لوله سودمند باشد (به‌ویژه از چاپ «نقاط پیشرفت» در طول تولید کلید جلوگیری می‌شود). .IP "\fB\-keygen_engine\fR \fIid\fR" 4 .IX Item "-keygen_engine id" یک موتور را (با رشته شناسه یکتای \fIid\fR آن) مشخص می‌کند که برای عملیات تولید کلید استفاده خواهد شد. .IP "\fB\-nameopt\fR \fIoption\fR" 4 .IX Item "-nameopt option" نحوه نمایش نام‌های موضوع یا صادرکننده را مشخص می‌کند. برای جزئیات \fBopenssl\-namedisplay\-options\fR\|(1) را ببینید. .IP "\fB\-rand\fR \fIfiles\fR, \fB\-writerand\fR \fIfile\fR" 4 .IX Item "-rand files, -writerand file" برای جزئیات به "Random State Options" در \fBopenssl\fR\|(1) مراجعه کنید. .IP "\fB\-engine\fR \fIid\fR" 4 .IX Item "-engine id" به "Engine Options" در \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 به "Provider Options" در \fBopenssl\fR\|(1)، \fBprovider\fR\|(7) و \fBproperty\fR\|(7) مراجعه کنید. .SH "قالب فایل پیکربندی (CONFIGURATION FILE FORMAT)" .IX Header "CONFIGURATION FILE FORMAT" گزینه‌های پیکربندی در بخش \fBreq\fR فایل پیکربندی مشخص می‌شوند. با استفاده از گزینه \fB\-section\fR می‌توان نام دیگری را تعیین کرد. همانند تمام فایل‌های پیکربندی، اگر مقداری در بخش مشخص‌شده تعیین نشده باشد، بخش اولیه بدون نام یا بخش \fBdefault\fR نیز جستجو می‌شود. .PP گزینه‌های موجود به‌تفصیل در زیر شرح داده شده‌اند. .IP "\fBinput_password\fR, \fBoutput_password\fR" 4 .IX Item "input_password, output_password" گذرواژه‌ها برای فایل کلید خصوصی ورودی (در صورت وجود) و فایل کلید خصوصی خروجی (اگر یکی ایجاد شود). گزینه‌های خط فرمان \fBpassin\fR و \fBpassout\fR بر مقادیر فایل پیکربندی اولویت دارند و آن‌ها را بازنویسی می‌کنند. .IP \fBdefault_bits\fR 4 .IX Item "default_bits" اندازه پیش‌فرض کلید را بر حسب بیت مشخص می‌کند. .Sp این گزینه در کنار گزینه \fB\-new\fR برای تولید یک کلید جدید استفاده می‌شود. می‌توان آن را با تعیین یک اندازه کلید صریح در گزینه \fB\-newkey\fR بازنویسی کرد. کوچک‌ترین اندازه کلید پذیرفته‌شده ۵۱۲ بیت است. اگر هیچ اندازه کلیدی مشخص نشود، ۲۰۴۸ بیت استفاده می‌شود. .IP \fBdefault_keyfile\fR 4 .IX Item "default_keyfile" این نام فایل پیش‌فرض برای نوشتن کلید خصوصی در آن است. اگر مشخص نشود، کلید در خروجی استاندارد نوشته می‌شود. این مورد می‌تواند توسط گزینه \&\fB\-keyout\fR بازنویسی شود. .IP \fBoid_file\fR 4 .IX Item "oid_file" فایلی حاوی شناسه‌های شیء اضافی (\fBOBJECT IDENTIFIERS\fR) را مشخص می‌کند. هر خط فایل باید شامل شکل عددی شناسه شیء و به دنبال آن فاصله سفید، سپس نام کوتاه و به دنبال آن فاصله سفید و در نهایت نام طولانی باشد. .IP \fBoid_section\fR 4 .IX Item "oid_section" بخشی را در فایل پیکربندی مشخص می‌کند که حاوی شناسه‌های شیء اضافی است. هر خط باید شامل نام کوتاه شناسه شیء و به دنبال آن \fB=\fR و شکل عددی باشد. هنگام استفاده از این گزینه، نام کوتاه و نام طولانی یکسان هستند. .IP \fBRANDFILE\fR 4 .IX Item "RANDFILE" در هنگام شروع، فایل مشخص‌شده در مولد اعداد تصادفی بارگذاری می‌شود، و در هنگام خروج، ۲۵۶ بایت در آن نوشته خواهد شد. این فایل برای تولید کلید خصوصی استفاده می‌شود. .IP \fBencrypt_key\fR 4 .IX Item "encrypt_key" اگر روی \fBno\fR تنظیم شود، در صورت تولید کلید خصوصی، آن کلید رمزگذاری \&\fBنخواهد شد\fR. این معادل گزینه خط فرمان \fB\-noenc\fR است. برای سازگاری، \&\fBencrypt_rsa_key\fR یک گزینه معادل محسوب می‌شود. .IP \fBdefault_md\fR 4 .IX Item "default_md" این گزینه الگوریتم چکیده را برای استفاده مشخص می‌کند. هر چکیده‌ای که توسط دستور \fBdgst\fR در OpenSSL پشتیبانی شود قابل استفاده است. این گزینه می‌تواند در خط فرمان بازنویسی شود. برخی از الگوریتم‌های امضا (مانند Ed25519 و Ed448) هرگونه چکیده تنظیم‌شده را نادیده خواهند گرفت. .IP \fBstring_mask\fR 4 .IX Item "string_mask" این گزینه استفاده از انواع خاصی از رشته‌ها را در فیلدهای مشخصی فیلتر (ماسک) می‌کند. بیشتر کاربران نیازی به تغییر این گزینه نخواهند داشت. این گزینه می‌تواند روی چندین مقدار تنظیم شود: .RS 4 .IP "\fButf8only\fR \- تنها از UTF8Stringها استفاده می‌شود (این مقدار پیش‌فرض است)" 4 .IX Item "utf8only - only UTF8Strings are used (this is the default value)" .PD 0 .IP "\fBpkix\fR \- هر نوع رشته‌ای به‌جز T61Stringها" 4 .IX Item "pkix - any string type except T61Strings" .IP "\fBnombstr\fR \- هر نوع رشته‌ای به‌جز BMPStringها و UTF8Stringها" 4 .IX Item "nombstr - any string type except BMPStrings and UTF8Strings" .IP "\fBdefault\fR \- هر نوع رشته‌ای" 4 .IX Item "default - any kind of string type" .PD .RE .RS 4 .Sp توجه داشته باشید که \fButf8only\fR توصیه PKIX در RFC 5280 و \fBstring_mask\fR پیش‌فرض است؛ مقدار \fBdefault\fR گزینه پیش‌فرض نیست. مقدار \fBnombstr\fR یک راهکار موقت برای برخی نرم‌افزارها است که با رشته‌های BMPString و UTF8String با اندازه متغیر مشکل دارند. .RE .IP \fBreq_extensions\fR 4 .IX Item "req_extensions" بخش فایل پیکربندی حاوی فهرستی از افزونه‌ها را برای اضافه شدن به درخواست گواهی مشخص می‌کند. این گزینه می‌تواند توسط سوییچ خط فرمان \fB\-reqexts\fR (یا \fB\-extensions\fR) بازنویسی شود. برای جزئیات قالب بخش افزونه‌ها، صفحه راهنمای \fBx509v3_config\fR\|(5) را ببینید. .IP \fBx509_extensions\fR 4 .IX Item "x509_extensions" بخش فایل پیکربندی حاوی فهرستی از افزونه‌ها را برای اضافه شدن به گواهی تولیدشده در هنگام استفاده از \fB\-x509\fR مشخص می‌کند. این گزینه می‌تواند توسط سوییچ خط فرمان \fB\-extensions\fR بازنویسی شود. .IP \fBprompt\fR 4 .IX Item "prompt" اگر روی مقدار \fBno\fR تنظیم شود، پرسیدن مقادیر فیلدهای گواهی را غیرفعال کرده و مقادیر را مستقیماً از فایل پیکربندی می‌گیرد. همچنین قالب مورد انتظار بخش‌های \fBdistinguished_name\fR و \fBattributes\fR را تغییر می‌دهد. .IP \fButf8\fR 4 .IX Item "utf8" اگر روی مقدار \fByes\fR تنظیم شود، مقادیر فیلدها به‌عنوان رشته‌های UTF8 تفسیر می‌شوند؛ به‌طور پیش‌فرض آن‌ها به‌عنوان ASCII تفسیر می‌گردند. این بدان معناست که مقادیر فیلدها، چه از طریق ترمینال پرسیده شوند و چه از یک فایل پیکربندی به دست آیند، باید رشته‌های معتبر UTF8 باشند. .IP \fBattributes\fR 4 .IX Item "attributes" بخشی را مشخص می‌کند که حاوی هرگونه صفت درخواستی است: قالب آن مشابه \fBdistinguished_name\fR است. معمولاً این‌ها ممکن است حاوی انواع challengePassword یا unstructuredName باشند. این مقادیر در حال حاضر توسط ابزارهای امضای درخواست در OpenSSL نادیده گرفته می‌شوند، اما برخی CAها ممکن است به آن‌ها نیاز داشته باشند. .IP \fBdistinguished_name\fR 4 .IX Item "distinguished_name" بخشی را مشخص می‌کند که حاوی فیلدهای نام متمایز (DN) برای پرسیدن ورودی در هنگام تولید یک گواهی یا درخواست گواهی است. قالب آن در بخش بعدی شرح داده شده است. .SH "قالب بخش‌های نام متمایز و صفت‌ها (DISTINGUISHED NAME AND ATTRIBUTE SECTION FORMAT)" .IX Header "DISTINGUISHED NAME AND ATTRIBUTE SECTION FORMAT" دو قالب مجزا برای بخش‌های نام متمایز (DN) و صفت‌ها وجود دارد. اگر گزینه \fBprompt\fR روی \fBno\fR تنظیم شده باشد، این بخش‌ها تنها از نام‌های فیلد و مقادیر آن‌ها تشکیل می‌شوند؛ برای مثال: .PP .Vb 3 \& CN=My Name \& OU=My Organization \& emailAddress=someone@somewhere.org .Ve .PP این قابلیت به برنامه‌های خارجی (مانند برنامه‌های گرافیکی) امکان می‌دهد یک فایل الگو با تمام نام‌ها و مقادیر فیلدها تولید کرده و آن را به این دستور ارسال کنند. یک نمونه از این نوع فایل پیکربندی در بخش \fBمثال‌ها (EXAMPLES)\fR آمده است. .PP در حالت دیگر، اگر گزینه \fBprompt\fR وجود نداشته باشد یا روی \fBno\fR تنظیم نشده باشد، فایل حاوی اطلاعات درخواست ورودی فیلدها خواهد بود. این ساختار از خطوطی به شکل زیر تشکیل می‌شود: .PP .Vb 4 \& fieldName="prompt" \& fieldName_default="default field value" \& fieldName_min= 2 \& fieldName_max= 4 .Ve .PP عبارت "fieldName" نام فیلد مورد استفاده است؛ برای مثال commonName (یا CN). رشته "prompt" برای درخواست از کاربر جهت وارد کردن جزئیات مربوطه استفاده می‌شود. اگر کاربر چیزی وارد نکند، در صورت وجود، مقدار پیش‌فرض استفاده می‌شود و اگر مقدار پیش‌فرضی وجود نداشته باشد، فیلد حذف خواهد شد. حتی در صورت وجود مقدار پیش‌فرض، اگر کاربر صرفاً نویسه \*(Aq.\*(Aq را وارد کند، فیلد همچنان حذف می‌شود. .PP تعداد نویسه‌های واردشده باید میان محدودیت‌های fieldName_min و fieldName_max باشد: ممکن است محدودیت‌های دیگری بر اساس فیلد مورد استفاده وجود داشته باشد (برای مثال countryName فقط می‌تواند دو نویسه باشد و باید در یک PrintableString بگنجد). .PP برخی فیلدها (مانند organizationName) می‌توانند بیش از یک بار در یک DN استفاده شوند. این امر مشکلی ایجاد می‌کند چرا که فایل‌های پیکربندی تکرار یک نام یکسان را تشخیص نمی‌دهند. برای جلوگیری از این مشکل، اگر fieldName حاوی نویسه‌هایی باشد که به یک نقطه ختم می‌شوند، آن‌ها نادیده گرفته خواهند شد. بنابراین برای مثال می‌توان organizationName دوم را با نامیدن آن به‌صورت "1.organizationName" وارد کرد. .PP نام‌های فیلد مجاز واقعی، هر نام کوتاه یا طولانی شناسه شیء (OID) هستند. این نام‌ها در OpenSSL کامپایل شده‌اند و شامل مقادیر متداولی مانند commonName، countryName، localityName، organizationName، organizationalUnitName و stateOrProvinceName می‌باشند. علاوه بر این، emailAddress و همچنین name، surname، givenName، initials و dnQualifier نیز گنجانده شده‌اند. .PP شناسه‌های شیء اضافی را می‌توان با گزینه‌های \fBoid_file\fR یا \fBoid_section\fR در فایل پیکربندی تعریف کرد. با هرگونه فیلد اضافی به‌گونه‌ای رفتار می‌شود که گویی یک DirectoryString هستند. .SH "مثال‌ها (EXAMPLES)" .IX Header "EXAMPLES" بررسی و اعتبارسنجی درخواست گواهی: .PP .Vb 1 \& openssl req \-in req.pem \-text \-verify \-noout .Ve .PP تعیین رمزنگاری مورد استفاده برای رمزگذاری کلید خصوصی: .PP .Vb 1 \& openssl req \-newkey rsa:2048 \-keyout privatekey.pem \-out request.csr \-cipher aes\-256\-cbc .Ve .PP ایجاد یک کلید خصوصی و سپس تولید یک درخواست گواهی از آن: .PP .Vb 2 \& openssl genrsa \-out key.pem 2048 \& openssl req \-new \-key key.pem \-out req.pem .Ve .PP همان کار اما فقط با استفاده از req: .PP .Vb 1 \& openssl req \-newkey rsa:2048 \-keyout key.pem \-out req.pem .Ve .PP تولید یک گواهی ریشه خودامضا: .PP .Vb 1 \& openssl req \-x509 \-newkey rsa:2048 \-keyout key.pem \-out req.pem .Ve .PP ایجاد یک کلید خصوصی SM2 و سپس تولید یک درخواست گواهی از آن: .PP .Vb 2 \& openssl ecparam \-genkey \-name SM2 \-out sm2.key \& openssl req \-new \-key sm2.key \-out sm2.csr \-sm3 \-sigopt "distid:1234567812345678" .Ve .PP بررسی و اعتبارسنجی یک درخواست گواهی SM2: .PP .Vb 1 \& openssl req \-verify \-in sm2.csr \-sm3 \-vfyopt "distid:1234567812345678" .Ve .PP نمونه‌ای از یک فایل که توسط گزینه \fBoid_file\fR به آن اشاره شده است: .PP .Vb 2 \& 1.2.3.4 shortName A longer Name \& 1.2.3.6 otherName Other longer Name .Ve .PP نمونه‌ای از بخشی که توسط \fBoid_section\fR با استفاده از بسط متغیر به آن اشاره شده است: .PP .Vb 2 \& testoid1=1.2.3.5 \& testoid2=${testoid1}.6 .Ve .PP نمونه فایل پیکربندی برای پرسیدن مقادیر فیلدها از کاربر: .PP .Vb 6 \& [ req ] \& default_bits = 2048 \& default_keyfile = privkey.pem \& distinguished_name = req_distinguished_name \& attributes = req_attributes \& req_extensions = v3_ca \& \& dirstring_type = nombstr \& \& [ req_distinguished_name ] \& countryName = Country Name (2 letter code) \& countryName_default = AU \& countryName_min = 2 \& countryName_max = 2 \& \& localityName = Locality Name (eg, city) \& \& organizationalUnitName = Organizational Unit Name (eg, section) \& \& commonName = Common Name (eg, YOUR name) \& commonName_max = 64 \& \& emailAddress = Email Address \& emailAddress_max = 40 \& \& [ req_attributes ] \& challengePassword = A challenge password \& challengePassword_min = 4 \& challengePassword_max = 20 \& \& [ v3_ca ] \& \& subjectKeyIdentifier=hash \& authorityKeyIdentifier=keyid:always,issuer:always \& basicConstraints = critical, CA:true .Ve .PP نمونه پیکربندی شامل تمام مقادیر فیلدها: .PP .Vb 7 \& [ req ] \& default_bits = 2048 \& default_keyfile = keyfile.pem \& distinguished_name = req_distinguished_name \& attributes = req_attributes \& prompt = no \& output_password = mypass \& \& [ req_distinguished_name ] \& C = GB \& ST = Test State or Province \& L = Test Locality \& O = Organization Name \& OU = Organizational Unit Name \& CN = Common Name \& emailAddress = test@email.address \& \& [ req_attributes ] \& challengePassword = A challenge password .Ve .PP نمونه ارائه متداول‌ترین صفت‌ها (موضوع و افزونه‌ها) در خط فرمان: .PP .Vb 4 \& openssl req \-new \-subj "/C=GB/CN=foo" \e \& \-addext "subjectAltName = DNS:foo.co.uk" \e \& \-addext "certificatePolicies = 1.2.3.4" \e \& \-newkey rsa:2048 \-keyout key.pem \-out req.pem .Ve .SH "نکات (NOTES)" .IX Header "NOTES" درخواست‌های گواهی تولیدشده توسط \fBXenroll\fR با MSIE دارای افزونه‌هایی هستند. این شامل افزونه \fBkeyUsage\fR است که نوع کلید (فقط امضا یا استفاده عمومی) را تعیین می‌کند و هر OID اضافی واردشده توسط اسکریپت در یک افزونه \&\fBextendedKeyUsage\fR قرار می‌گیرد. .SH "عیب‌یابی (DIAGNOSTICS)" .IX Header "DIAGNOSTICS" پیام‌های زیر معمولاً مورد پرسش قرار می‌گیرند: .PP .Vb 2 \& Using configuration from /some/path/openssl.cnf \& Unable to load config info .Ve .PP این پیام مدتی بعد با پیام زیر دنبال می‌شود: .PP .Vb 2 \& unable to find \*(Aqdistinguished_name\*(Aq in config \& problems making Certificate Request .Ve .PP اولین پیام خطا سرنخ اصلی است: نمی‌تواند فایل پیکربندی را پیدا کند! برخی عملیات (مانند بررسی یک درخواست گواهی) نیازی به فایل پیکربندی ندارند، بنابراین استفاده از آن اجباری نیست. با این حال، تولید گواهی‌ها یا درخواست‌ها به فایل پیکربندی نیاز دارد. این موضوع می‌تواند به‌عنوان یک اشکال در نظر گرفته شود. .PP پیام گیج‌کننده دیگر این است: .PP .Vb 2 \& Attributes: \& a0:00 .Ve .PP این پیام زمانی نمایش داده می‌شود که هیچ صفتی وجود نداشته باشد و درخواست شامل ساختار خالی و صحیح \fBSET OF\fR باشد (که کدگذاری DER آن 0xa0 0x00 است). اگر صرفاً مشاهده کنید: .PP .Vb 1 \& Attributes: .Ve .PP در این صورت \fBSET OF\fR وجود ندارد و کدگذاری از نظر فنی نامعتبر است (اما تحمل می‌شود). برای اطلاعات بیشتر، شرح گزینه خط فرمان \fB\-asn1\-kludge\fR را ببینید. .SH "اشکالات (BUGS)" .IX Header "BUGS" نحوه مدیریت T61Stringها (یا TeletexString) در OpenSSL دارای اشکال است: در عمل با آن‌ها مانند ISO\-8859\-1 (Latin 1) رفتار می‌کند، و Netscape و MSIE نیز رفتار مشابهی دارند. این امر در صورتی که به نویسه‌هایی نیاز داشته باشید که در PrintableStringها موجود نیستند و مایل یا قادر به استفاده از BMPStringها نباشید، می‌تواند مشکل‌ساز شود. .PP در نتیجه این نحوه مدیریت T61String، تنها روش صحیح برای نمایش نویسه‌های دارای اکسنت در OpenSSL استفاده از یک BMPString است: متاسفانه در حال حاضر Netscape روی این‌ها با خطا مواجه می‌شود. اگر مجبورید از نویسه‌های دارای اکسنت با Netscape و MSIE استفاده کنید، در حال حاضر باید از قالب نامعتبر T61String بهره بگیرید. .PP شیوه فعلی دریافت ورودی تعاملی چندان کاربرپسند نیست. این روش به شما اجازه نمی‌دهد آنچه وارد کرده‌اید را تایید کنید. موارد دیگر مانند افزونه‌ها در درخواست‌های گواهی به‌صورت ایستا در فایل پیکربندی تعریف شده‌اند. برخی از این موارد، مانند یک آدرس ایمیل در subjectAltName، باید توسط کاربر وارد شوند. .SH "همچنین ببینید (SEE ALSO)" .IX Header "SEE ALSO" \&\fBopenssl\fR\|(1), \&\fBopenssl\-x509\fR\|(1), \&\fBopenssl\-ca\fR\|(1), \&\fBopenssl\-genrsa\fR\|(1), \&\fBopenssl\-gendsa\fR\|(1), \&\fBconfig\fR\|(5), \&\fBx509v3_config\fR\|(5) .SH "تاریخچه (HISTORY)" .IX Header "HISTORY" رمزنگاری پیش‌فرض از 3DES به AES\-256 در OpenSSL 3.5 تغییر یافت. .PP گزینه \fB\-section\fR در OpenSSL 3.0.0 اضافه شد. .PP گزینه \fB\-multivalue\-rdn\fR در OpenSSL 3.0.0 منسوخ شد و هیچ تاثیری ندارد. .PP گزینه \fB\-engine\fR در OpenSSL 3.0 منسوخ شد. گزینه \fB\-nodes\fR نیز در OpenSSL 3.0 منسوخ شد؛ به‌جای آن از \fB\-noenc\fR استفاده کنید. .PP گزینه \fB\-reqexts\fR در OpenSSL 3.2 به‌عنوان نام مستعار \fB\-extensions\fR قرار گرفت. .PP از زمان OpenSSL 3.2، گواهی‌های تولیدشده دارای نسخه ۳ از X.509 هستند مگر اینکه \fB\-x509v1\fR داده شود، و افزونه‌های شناسه کلید به‌طور پیش‌فرض گنجانده می‌شوند. .PP از زمان OpenSSL 3.3، گزینه \fB\-verify\fR در صورت شکست با کد ۱ خارج می‌شود. .SH "حق نشر (COPYRIGHT)" .IX Header "COPYRIGHT" حق نشر ۲۰۰۰\-۲۰۲۵ متعلق به پدیدآورندگان پروژه OpenSSL است. کلیه حقوق محفوظ است. .PP تحت مجوز آپاچی نسخه ۲.۰ ("مجوز") ارائه شده است. شما نمی‌توانید از این فایل مگر در انطباق با این مجوز استفاده کنید. می‌توانید نسخه‌ای از مجوز را در فایل LICENSE در توزیع مبدا یا در نشانی زیر دریافت کنید: .