.TH "PKI \-\-SCEP" 1 "2022-08-22" "6.1.0" "strongSwan"
.
.SH "نام (NAME)"
.
pki \-\-scep \- ثبت و دریافت گواهی X.509 از یک کارساز SCEP
.
.SH "خلاصه دستور (SYNOPSIS)"
.
.SY pki\ \-\-scep
.BI\-\-\-url\~ url
.OP \-\-in file
.OP \-\-dn\~ distinguished-name
.OP \-\-san subjectAltName
.OP \-\-profile profile
.OP \-\-password password
.BI \-\-ca-cert-enc\~ file
.BI \-\-ca-cert-sig\~ file
.OP \-\-cacert file
.BI [\-\-cert\~ file
.BI \-\-key\~ file ]
.OP \-\-cipher cipher
.OP \-\-digest digest
.OP \-\-rsa-padding padding
.OP \-\-interval time
.OP \-\-maxpolltime time
.OP \-\-outform encoding
.OP \-\-debug level
.YS
.
.SY pki\ \-\-scep
.BI \-\-options\~ file
.YS
.
.SY "pki \-\-scep"
.B \-h
|
.B \-\-help
.YS
.
.SH "توضیحات (DESCRIPTION)"
.
این زیردستور از
.BR pki (1)
یک درخواست گواهی PKCS#10 را درون یک ظرف رمزنگاری‌شده و امضاشدهٔ PKCS#7 از طریق HTTP به یک کارساز SCEP با استفاده از پروتکل ثبت گواهی ساده (Simple Certificate Enrollment Protocol - RFC 8894) ارسال می‌کند. پس از احراز هویت موفقیت‌آمیز، که در صورت تأیید دستی نیازمند بررسی دوره‌ای (polling) توسط کلاینت ثبت‌نام‌کننده است، کارساز SCEP یک گواهی X.509 امضاشده توسط CA را بازمی‌گرداند.
.PP
پیش از انقضای گواهی فعلی، می‌توان یک گواهی کلاینت جدید مبتنی بر یک کلید خصوصی RSA تازه درخواست کرد که با استفاده از گواهی و کلید پیشین برای احراز هویت خودکار با کارساز SCEP صورت می‌پذیرد.
.
.SH "گزینه‌ها (OPTIONS)"
.
.TP
.B "\-h, \-\-help"
چاپ اطلاعات نحوه استفاده به همراه خلاصه‌ای از گزینه‌های موجود.
.TP
.BI "\-v, \-\-debug " level
تنظیم سطح اشکال‌زدایی (debug)، پیش‌فرض: 1.
.TP
.BI "\-+, \-\-options " file
خواندن گزینه‌های خط فرمان از \fIfile\fR.
.TP
.BI "\-u, \-\-url " url
آدرس URL کارساز SCEP.
.TP
.BI "\-i, \-\-in " file
کلید خصوصی RSA. در صورت مشخص نشدن، کلید از \fISTDIN\fR خوانده می‌شود.
.TP
.BI "\-d, \-\-dn " distinguished-name
نام متمایز موضوع (Subject DN). الزامی است مگر اینکه \-\-cert داده شده باشد.
.TP
.BI "\-a, \-\-san " subjectAltName
افزونه subjectAltName برای گنجاندن در درخواست. می‌تواند چندین بار استفاده شود.
.TP
.BI "\-P, \-\-profile " profile
نام نمایه (profile) گواهی برای گنجانده شدن در درخواست گواهی. می‌تواند هر رشتهٔ UTF8 باشد. برای نمونه توسط کارساز SCEP
.B openxpki
با نمایه‌هایی (\fIpc-client\fR، \fItls-server\fR و غیره) که به پرچم‌های متناظر Extended Key Usage (EKU) در گواهی X.509 ایجادشده تبدیل می‌شوند، پشتیبانی می‌شود.
.TP
.BI "\-p, \-\-password " password
مقدار challengePassword برای گنجاندن در درخواست گواهی.
.TP
.BI "\-e, \-\-cacert-enc " file
گواهی CA یا RA برای رمزنگاری.
.TP
.BI "\-s, \-\-cacert-sig " file
گواهی CA برای اعتبارسنجی امضا.
.TP
.BI "\-C, \-\-cacert " file
گواهی CA اضافی در زنجیره اعتماد که برای اعتبارسنجی امضا استفاده می‌شود. می‌تواند چندین بار استفاده شود.
.TP
.BI "\-c, \-\-cert " file
گواهی کلاینت که باید تمدید شود.
.TP
.BI "\-k, \-\-key " file
کلید خصوصی RSA کلاینت که باید جایگزین شود.
.TP
.BI "\-E, \-\-cipher " cipher
رمز مورد استفاده برای رمزنگاری متقارن. مقدار آن \fIaes\fR (پیش‌فرض) یا \fIdes3\fR است.
.TP
.BI "\-g, \-\-digest " digest
درهم‌ساز (digest) مورد استفاده برای ایجاد امضا. یکی از مقادیر \fIsha256\fR (پیش‌فرض)، \fIsha384\fR، \fIsha512\fR یا \fIsha1\fR.
.TP
.BI "\-R, \-\-rsa\-padding " padding
لایه‌گذاری (padding) مورد استفاده برای امضاهای RSA. مقدار آن \fIpkcs1\fR (پیش‌فرض) یا \fIpss\fR است.
.TP
.BI "\-t, \-\-interval " time
بازه زمانی بررسی دوره‌ای (poll) بر حسب ثانیه، پیش‌فرض \fI60s\fR است.
.TP
.BI "\-m, \-\-maxpolltime " time
بیشینه زمان بررسی دوره‌ای (poll) بر حسب ثانیه، پیش‌فرض \fI0\fR است که به معنی بررسی دوره‌ای نامحدود است.
.TP
.BI "\-f, \-\-outform " encoding
کدگذاری فایل گواهی ایجادشده. یکی از مقادیر \fIder\fR (ASN.1 DER) یا \fIpem\fR (Base64 PEM)، پیش‌فرض \fIder\fR است.
.
.SH "مثال‌ها (EXAMPLES)"
.
برای صرفه‌جویی در تایپ، گزینه‌های خط فرمان زیر در یک فایل \fIscep.opt\fR ذخیره شده‌اند:
.PP
.EX
\-\-url http://pki.strongswan.org:8080/scep
\-\-cacert-enc myra.crt
\-\-cacert-sig myca-1.crt
\-\-cacert myca.crt
.EE
.PP
با دستور زیر، یک گواهی X.509 امضاشده توسط CA میانی از یک کارساز SCEP درخواست می‌شود:
.PP
.EX
pki \-\-options scep.opt \-\-in moonKey.der \-\-san "moon.strongswan.org" \\
    \-\-dn "C=CH, O=strongSec GmbH, CN=moon.strongswan.org" > moonCert.der

transaction ID: 4DFCF31CB18A9B5333CCEC6F99CF230E4524E334
  using certificate "C=CH, O=strongSwan Project, CN=SCEP RA"
  using trusted intermediate ca certificate "C=CH, O=strongSwan Project, CN=strongSwan Issuing CA"
  using trusted ca certificate "C=CH, O=strongSwan Project, CN=strongSwan Root CA"
  reached self-signed root ca with a path length of 1
  SCEP request pending, polling indefinitely every 60 seconds
  going to sleep for 60 seconds
transaction ID: 4DFCF31CB18A9B5333CCEC6F99CF230E4524E334
  ...
  going to sleep for 60 seconds
Issued certificate "C=CH, O=strongSwan Project, CN=moon.strongswan.org"
  serial: 1e:ff:22:7b:6e:d7:4c:c1:8a:06
  using certificate "C=CH, O=strongSwan Project, CN=moon.strongswan.org"
  using trusted intermediate ca certificate "C=CH, O=strongSwan Project, CN=strongSwan Issuing CA"
  using trusted ca certificate "C=CH, O=strongSwan Project, CN=strongSwan Root CA"
  reached self-signed root ca with a path length of 1
Issued certificate is trusted, valid from Aug 22 18:56:23 2022 until Aug 22 18:56:23 2023 (currently valid)
.EE
.PP
گواهی‌ای که در آستانه انقضا قرار دارد را می‌توان با دستور زیر تمدید کرد:
.PP
.EX
pki \-\-options scep.opt \-\-in moonNewKey.der \-\-san "moon.strongswan.org" \\
    \-\-dn "C=CH, O=strongSec GmbH, CN=moon.strongswan.org" \\
    \-\-cert moonCert.der \-\-key moonKey.der > moonNewCert.der

transaction ID: A9A63D028CC439F68452D125C4DBA025E67DBA95
  using certificate "C=CH, O=strongSwan Project, CN=SCEP RA"
  using trusted intermediate ca certificate "C=CH, O=strongSwan Project, CN=strongSwan Issuing CA"
  using trusted ca certificate "C=CH, O=strongSwan Project, CN=strongSwan Root CA"
  reached self-signed root ca with a path length of 1
Issued certificate "C=CH, O=strongSwan Project, CN=moon.strongswan.org"
  serial: 1f:ff:b2:78:43:a2:9d:85:00:38
  using certificate "C=CH, O=strongSwan Project, CN=moon.strongswan.org"
  using trusted intermediate ca certificate "C=CH, O=strongSwan Project, CN=strongSwan Issuing CA"
  using trusted ca certificate "C=CH, O=strongSwan Project, CN=strongSwan Root CA"
  reached self-signed root ca with a path length of 1
Issued certificate is trusted, valid from Jul 20 15:05:33 2023 until Jul 20 15:05:33 2024 (currently valid)
.EE
.
.SH "همچنین ببینید (SEE ALSO)"
.
.BR pki (1)