.TH "PKI \-\-REQ" 1 "2022-08-30" "6.1.0" "strongSwan"
.
.SH "نام (NAME)"
.
pki \-\-req \- ایجاد درخواست گواهی PKCS#10
.
.SH "خلاصه دستور (SYNOPSIS)"
.
.SY pki\ \-\-req
.RB [ \-\-in
.IR file | \fB\-\-keyid\fR
.IR hex ]
.OP \-\-type type
.BI \-\-dn\~ distinguished-name
.OP \-\-san subjectAltName
.OP \-\-profile profile
.OP \-\-flag flag
.OP \-\-password password
.OP \-\-digest digest
.OP \-\-rsa\-padding padding
.OP \-\-outform encoding
.OP \-\-debug level
.YS
.
.SY pki\ \-\-req
.RB [ \-\-in
.IR file | \fB\-\-keyid\fR
.IR hex ]
.OP \-\-type type
.BI \-\-oldreq\~ file
.OP \-\-password password
.OP \-\-digest digest
.OP \-\-rsa\-padding padding
.OP \-\-outform encoding
.OP \-\-debug level
.YS
.
.SY pki\ \-\-req
.BI \-\-options\~ file
.YS
.
.SY "pki \-\-req"
.B \-h
|
.B \-\-help
.YS
.q
.SH "توضیحات (DESCRIPTION)"
.
این زیردستور از
.BR pki (1)
برای ایجاد یک درخواست گواهی PKCS#10 استفاده می‌شود.
.
.SH "گزینه‌ها (OPTIONS)"
.
.TP
.B "\-h, \-\-help"
چاپ اطلاعات نحوه استفاده به همراه خلاصه‌ای از گزینه‌های موجود.
.TP
.BI "\-v, \-\-debug " level
تنظیم سطح اشکال‌زدایی (debug)، پیش‌فرض: 1.
.TP
.BI "\-+, \-\-options " file
خواندن گزینه‌های خط فرمان از \fIfile\fR.
.TP
.BI "\-i, \-\-in " file
فایل ورودی کلید خصوصی. در صورت مشخص نشدن، کلید از \fISTDIN\fR خوانده می‌شود.
.TP
.BI "\-x, \-\-keyid " hex
شناسه شیء (object handle) کلید خصوصی کارت هوشمند (Smartcard) یا TPM در قالب هگزادسیمال با پیشوند اختیاری 0x.
.TP
.BI "\-t, \-\-type " type
نوع کلید ورودی. یکی از موارد \fIpriv\fR، \fIrsa\fR یا \fIecdsa\fR، مقدار پیش‌فرض \fIpriv\fR است.
.TP
.BI "\-d, \-\-dn " distinguished-name
نام متمایز موضوع (DN). در صورتی که گزینه
.B \-\-dn
تنظیم نشده باشد، الزامی است.
.TP
.BI "\-a, \-\-san " subjectAltName
افزونه subjectAltName برای گنجاندن در درخواست. می‌تواند چندین بار استفاده شود.
.TP
.BI "\-P, \-\-profile " profile
نام پروفایل گواهی برای گنجاندن در درخواست گواهی. می‌تواند هر رشته‌ای با کدگذاری UTF8 باشد. به عنوان مثال توسط
.B openxpki
(با پروفایل‌های \fIpc-client\fR، \fItls-server\fR و غیره) یا
.B pki \-\-issue
(با پروفایل‌های \fIserver\fR، \fIclient\fR، \fIdual\fR یا \fIocsp\fR) پشتیبانی می‌شود که در گواهی X.509 تولیدشده به پرچم‌های متناظر Extended Key Usage (EKU) ترجمه می‌شوند.
.TP
.BI "\-e, \-\-flag " flag
افزودن پرچم extendedKeyUsage. یکی از موارد \fIserverAuth\fR، \fIclientAuth\fR، \fIocspSigning\fR یا \fImsSmartcardLogon\fR. می‌تواند چندین بار استفاده شود. یک افزونه X.509v3 EKU شامل این پرچم‌ها را به درخواست گواهی اضافه می‌کند.
.TP
.BI "\-p, \-\-password " password
مقدار challengePassword برای گنجاندن در درخواست گواهی.
.TP
.BI "\-o, \-\-oldreq " file
درخواست گواهی قدیمی برای استفاده به عنوان الگو. در صورتی که گزینه
.B --dn
تنظیم نشده باشد، الزامی است. کلید عمومی در درخواست گواهی قدیمی جایگزین شده و امضای تازه‌ای با استفاده از کلید خصوصی جدید تولید می‌شود. همچنین می‌توان به صورت اختیاری با استفاده از گزینه
.B --password
یک challengePassword جدید تعیین کرد.
.TP
.BI "\-g, \-\-digest " digest
خلاصه پیام (digest) مورد استفاده برای ایجاد امضا. یکی از موارد \fIsha1\fR، \fIsha224\fR، \fIsha256\fR، \fIsha384\fR، \fIsha512\fR، \fIsha3_224\fR، \fIsha3_256\fR، \fIsha3_384\fR یا \fIsha3_512\fR. مقدار پیش‌فرض بر اساس نوع و اندازه کلید امضا تعیین می‌شود.
.TP
.BI "\-R, \-\-rsa\-padding " padding
فاصله‌گذاری (padding) مورد استفاده برای امضاهای RSA. یا \fIpkcs1\fR یا \fIpss\fR، مقدار پیش‌فرض \fIpkcs1\fR است.
.TP
.BI "\-f, \-\-outform " encoding
کدگذاری فایل گواهی ایجادشده. یا \fIder\fR (ASN.1 DER) یا \fIpem\fR (Base64 PEM)، مقدار پیش‌فرض \fIder\fR است.
.
.SH "مثال‌ها (EXAMPLES)"
.
تولید یک درخواست گواهی برای یک کلید RSA، به همراه یک افزونه subjectAltName و یک پروفایل سرور TLS:
.PP
.EX
  pki \-\-req \-\-in key.der \-\-dn "C=CH, O=strongSwan, CN=moon" \\
      \-\-san moon@strongswan.org \-\-profile server > req.der
.EE
.PP
تولید یک درخواست گواهی برای یک کلید تمدیدشده بر اساس یک الگوی موجود:
.PP
.EX
  pki \-\-req \-\-in myNewKey.der \-\-oldreq myReq.der > myNewReq.der
.EE
.PP
تولید یک درخواست گواهی برای یک کلید ECDSA و یک خلاصه پیام (digest) متفاوت:
.PP
.EX
  pki \-\-req \-\-in key.der \-\-type ecdsa \-\-digest sha256 \\
      \-\-dn "C=CH, O=strongSwan, CN=carol"  > req.der
.EE
.PP
.
.SH "همچنین ببینید (SEE ALSO)"
.
.BR pki (1)