PKI --REQ(1)                      strongSwan                      PKI --REQ(1)

نام (NAME)
       pki --req - ایجاد درخواست گواهی PKCS#10

خلاصه دستور (SYNOPSIS)
       pki --req [--in file|--keyid hex] [--type type] --dn distinguished-name
                 [--san subjectAltName] [--profile profile] [--flag flag]
                 [--password password] [--digest digest]
                 [--rsa-padding padding] [--outform encoding] [--debug level]

       pki --req [--in file|--keyid hex] [--type type] --oldreq file
                 [--password password] [--digest digest]
                 [--rsa-padding padding] [--outform encoding] [--debug level]

       pki --req --options file

       pki --req -h | --help

توضیحات (DESCRIPTION)
       این زیردستور از pki(1) برای ایجاد یک درخواست گواهی PKCS#10 استفاده
       می‌شود.

گزینه‌ها (OPTIONS)
       -h, --help
              چاپ اطلاعات نحوه استفاده به همراه خلاصه‌ای از گزینه‌های موجود.

       -v, --debug level
              تنظیم سطح اشکال‌زدایی (debug)، پیش‌فرض: 1.

       -+, --options file
              خواندن گزینه‌های خط فرمان از file.

       -i, --in file
              فایل ورودی کلید خصوصی. در صورت مشخص نشدن، کلید از STDIN خوانده
              می‌شود.

       -x, --keyid hex
              شناسه شیء (object handle) کلید خصوصی کارت هوشمند (Smartcard) یا
              TPM در قالب هگزادسیمال با پیشوند اختیاری 0x.

       -t, --type type
              نوع کلید ورودی. یکی از موارد priv، rsa یا ecdsa، مقدار پیش‌فرض
              priv است.

       -d, --dn distinguished-name
              نام متمایز موضوع (DN). در صورتی که گزینه --dn تنظیم نشده باشد،
              الزامی است.

       -a, --san subjectAltName
              افزونه subjectAltName برای گنجاندن در درخواست. می‌تواند چندین بار
              استفاده شود.

       -P, --profile profile
              نام پروفایل گواهی برای گنجاندن در درخواست گواهی. می‌تواند هر
              رشته‌ای با کدگذاری UTF8 باشد. به عنوان مثال توسط openxpki (با
              پروفایل‌های pc-client، tls-server و غیره) یا pki --issue (با
              پروفایل‌های server، client، dual یا ocsp) پشتیبانی می‌شود که در
              گواهی X.509 تولیدشده به پرچم‌های متناظر Extended Key Usage (EKU)
              ترجمه می‌شوند.

       -e, --flag flag
              افزودن پرچم extendedKeyUsage. یکی از موارد serverAuth،
              clientAuth، ocspSigning یا msSmartcardLogon. می‌تواند چندین بار
              استفاده شود. یک افزونه X.509v3 EKU شامل این پرچم‌ها را به درخواست
              گواهی اضافه می‌کند.

       -p, --password password
              مقدار challengePassword برای گنجاندن در درخواست گواهی.

       -o, --oldreq file
              درخواست گواهی قدیمی برای استفاده به عنوان الگو. در صورتی که
              گزینه --dn تنظیم نشده باشد، الزامی است. کلید عمومی در درخواست
              گواهی قدیمی جایگزین شده و امضای تازه‌ای با استفاده از کلید خصوصی
              جدید تولید می‌شود. همچنین می‌توان به صورت اختیاری با استفاده از
              گزینه --password یک challengePassword جدید تعیین کرد.

       -g, --digest digest
              خلاصه پیام (digest) مورد استفاده برای ایجاد امضا. یکی از موارد
              sha1، sha224، sha256، sha384، sha512، sha3_224، sha3_256،
              sha3_384 یا sha3_512. مقدار پیش‌فرض بر اساس نوع و اندازه کلید
              امضا تعیین می‌شود.

       -R, --rsa-padding padding
              فاصله‌گذاری (padding) مورد استفاده برای امضاهای RSA. یا pkcs1 یا
              pss، مقدار پیش‌فرض pkcs1 است.

       -f, --outform encoding
              کدگذاری فایل گواهی ایجادشده. یا der (ASN.1 DER) یا pem (Base64
              PEM)، مقدار پیش‌فرض der است.

مثال‌ها (EXAMPLES)
       تولید یک درخواست گواهی برای یک کلید RSA، به همراه یک افزونه
       subjectAltName و یک پروفایل سرور TLS:

         pki --req --in key.der --dn "C=CH, O=strongSwan, CN=moon" \
             --san moon@strongswan.org --profile server > req.der

       تولید یک درخواست گواهی برای یک کلید تمدیدشده بر اساس یک الگوی موجود:

         pki --req --in myNewKey.der --oldreq myReq.der > myNewReq.der

       تولید یک درخواست گواهی برای یک کلید ECDSA و یک خلاصه پیام (digest)
       متفاوت:

         pki --req --in key.der --type ecdsa --digest sha256 \
             --dn "C=CH, O=strongSwan, CN=carol"  > req.der

همچنین ببینید (SEE ALSO)
       pki(1)

6.1.0                             2022-08-30                      PKI --REQ(1)