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

pki --req - ایجاد درخواست گواهی PKCS#10

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

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

چاپ اطلاعات نحوه استفاده به همراه خلاصه‌ای از گزینه‌های موجود.
تنظیم سطح اشکال‌زدایی (debug)، پیش‌فرض: 1.
-+, --options file
خواندن گزینه‌های خط فرمان از file.
فایل ورودی کلید خصوصی. در صورت مشخص نشدن، کلید از STDIN خوانده می‌شود.
شناسه شیء (object handle) کلید خصوصی کارت هوشمند (Smartcard) یا TPM در قالب هگزادسیمال با پیشوند اختیاری 0x.
نوع کلید ورودی. یکی از موارد priv، rsa یا ecdsa، مقدار پیش‌فرض priv است.
نام متمایز موضوع (DN). در صورتی که گزینه --dn تنظیم نشده باشد، الزامی است.
افزونه subjectAltName برای گنجاندن در درخواست. می‌تواند چندین بار استفاده شود.
نام پروفایل گواهی برای گنجاندن در درخواست گواهی. می‌تواند هر رشته‌ای با کدگذاری UTF8 باشد. به عنوان مثال توسط openxpki (با پروفایل‌های pc-client، tls-server و غیره) یا pki --issue (با پروفایل‌های server، client، dual یا ocsp) پشتیبانی می‌شود که در گواهی X.509 تولیدشده به پرچم‌های متناظر Extended Key Usage (EKU) ترجمه می‌شوند.
افزودن پرچم extendedKeyUsage. یکی از موارد serverAuth، clientAuth، ocspSigning یا msSmartcardLogon. می‌تواند چندین بار استفاده شود. یک افزونه X.509v3 EKU شامل این پرچم‌ها را به درخواست گواهی اضافه می‌کند.
مقدار challengePassword برای گنجاندن در درخواست گواهی.
درخواست گواهی قدیمی برای استفاده به عنوان الگو. در صورتی که گزینه --dn تنظیم نشده باشد، الزامی است. کلید عمومی در درخواست گواهی قدیمی جایگزین شده و امضای تازه‌ای با استفاده از کلید خصوصی جدید تولید می‌شود. همچنین می‌توان به صورت اختیاری با استفاده از گزینه --password یک challengePassword جدید تعیین کرد.
خلاصه پیام (digest) مورد استفاده برای ایجاد امضا. یکی از موارد sha1، sha224، sha256، sha384، sha512، sha3_224، sha3_256، sha3_384 یا sha3_512. مقدار پیش‌فرض بر اساس نوع و اندازه کلید امضا تعیین می‌شود.
فاصله‌گذاری (padding) مورد استفاده برای امضاهای RSA. یا pkcs1 یا pss، مقدار پیش‌فرض pkcs1 است.
کدگذاری فایل گواهی ایجادشده. یا der (ASN.1 DER) یا pem (Base64 PEM)، مقدار پیش‌فرض der است.

تولید یک درخواست گواهی برای یک کلید 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

pki(1)

2022-08-30 6.1.0