.TH "PKI \-\-SIGNCRL" 1 "2019-05-06" "6.1.0" "strongSwan"
.
.SH "نام (NAME)"
.
pki \-\-signcrl \- صدور یک لیست ابطال گواهی (CRL) با استفاده از گواهی و کلید CA
.
.SH "خلاصه دستور (SYNOPSIS)"
.
.SY pki\ \-\-signcrl
.BI \-\-cakey\~ file |\-\-cakeyid\~ hex
.BI \-\-cacert\~ file
.OP \-\-lifetime days
.OP \-\-this-update datetime
.OP \-\-next-update datetime
.OP \-\-lastcrl crl
.OP \-\-basecrl crl
.OP \-\-crluri uri
.OP \-\-digest digest
.OP \-\-rsa\-padding padding
.OP \fR[\fB\-\-reason\ \fIreason\fR]\ \fR[\fB\-\-date\ \fIts\fR]\ \fB\-\-cert\ \fIfile\fB|\-\-serial\ \fIhex\fR
.OP \-\-critical oid
.OP \-\-outform encoding
.OP \-\-debug level
.YS
.
.SY pki\ \-\-signcrl
.BI \-\-options\~ file
.YS
.
.SY "pki \-\-signcrl"
.B \-h
|
.B \-\-help
.YS
.
.SH "توضیحات (DESCRIPTION)"
.
این زیردستور از
.BR pki (1)
برای صدور یک لیست ابطال گواهی (CRL) با استفاده از یک گواهی و کلید خصوصی CA به‌کار می‌رود.
.
.SH "گزینه‌ها (OPTIONS)"
.
.TP
.B "\-h, \-\-help"
چاپ اطلاعات نحوه استفاده به همراه خلاصه‌ای از گزینه‌های موجود.
.TP
.BI "\-v, \-\-debug " level
تنظیم سطح اشکال‌زدایی (دیباگ)، پیش‌فرض: 1.
.TP
.BI "\-+, \-\-options " file
خواندن گزینه‌های خط فرمان از \fIfile\fR.
.TP
.BI "\-k, \-\-cakey " file
فایل کلید خصوصی CA. استفاده از این گزینه یا
.B \-\-cakeyid
الزامی است.
.TP
.BI "\-x, \-\-cakeyid " hex
هندل شیء کلید خصوصی CA در کارت هوشمند یا TPM در قالب هگزادسیمال همراه با پیشوند اختیاری 0x. استفاده از این گزینه یا
.B \-\-cakey
الزامی است.
.TP
.BI "\-c, \-\-cacert " file
فایل گواهی CA. الزامی است.
.TP
.BI "\-l, \-\-lifetime " days
تعداد روزها تا زمانی که CRL یک nextUpdate دریافت کند، پیش‌فرض: 15. در صورت مشخص شدن هر دو زمان شروع و پایان مطلق، نادیده گرفته می‌شود.
.TP
.BI "\-F, \-\-this-update " datetime
زمان مطلق شروع اعتبار CRL. قالب datetime توسط گزینه
.B \-\-dateform
تعیین می‌شود.
.TP
.BI "\-T, \-\-next-update " datetime
زمان مطلق پایان اعتبار CRL. قالب datetime توسط گزینه
.B \-\-dateform
تعیین می‌شود.
.TP
.BI "\-D, \-\-dateform " form
قالب strptime(3) برای گزینه‌های
.B \-\-this\-update
و
.B \-\-next\-update
، پیش‌فرض:
.B %d.%m.%y %T
.TP
.BI "\-a, \-\-lastcrl " crl
فایل CRL مربوط به lastUpdate برای کپی کردن ابطال‌ها از آن.
.TP
.BI "\-b, \-\-basecrl " crl
فایل CRL پایه برای ایجاد یک delta CRL برای آن.
.TP
.BI "\-u, \-\-crluri " uri
شناسه URI مربوط به تازه‌ترین delta CRL برای گنجاندن در CRL. می‌تواند چندین بار استفاده شود.
.TP
.BI "\-g, \-\-digest " digest
خلاصه پیام (Digest) مورد استفاده برای ایجاد امضا. یکی از مقادیر \fImd5\fR، \fIsha1\fR،
\fIsha224\fR، \fIsha256\fR، \fIsha384\fR، یا \fIsha512\fR. مقدار پیش‌فرض بر اساس نوع
و اندازه کلید امضا تعیین می‌شود.
.TP
.BI "\-R, \-\-rsa\-padding " padding
لایه‌گذاری (Padding) مورد استفاده برای امضاهای RSA. مقدار می‌تواند \fIpkcs1\fR یا \fIpss\fR باشد،
پیش‌فرض \fIpkcs1\fR است.
.TP
.BI "\-X, \-\-critical " oid
افزودن یک افزونه بحرانی (critical extension) با OID مشخص‌شده.
.TP
.BI "\-f, \-\-outform " encoding
قالب کدگذاری فایل گواهی ایجادشده. یا \fIder\fR (ASN.1 DER) یا
\fIpem\fR (Base64 PEM)، پیش‌فرض \fIder\fR است.
.PP
.SS "گواهی‌های باطل‌شده (Revoked Certificates)"
چندین گواهی باطل‌شده را می‌توان با ارائه مستقیم فایل گواهی یا شماره سریال مربوط به آن به CRL اضافه کرد.
برای هر مورد ابطال می‌توان یک دلیل و یک برچسب زمانی پیکربندی کرد (این موارد باید
پیش از هر گواهی/سریال در خط فرمان آورده شوند).
.TP
.BI "\-r, \-\-reason " reason
دلیل ابطال گواهی. یکی از موارد \fIkey\-compromise\fR،
\fIca\-compromise\fR، \fIaffiliation\-changed\fR، \fIsuperseded\fR،
\fIcessation\-of\-operation\fR، یا \fIcertificate\-hold\fR.
.TP
.BI "\-d, \-\-date " ts
تاریخ ابطال به‌صورت برچسب زمانی یونیکس (Unix timestamp). پیش‌فرض زمان فعلی است.
.TP
.BI "\-z, \-\-cert " file
فایل گواهی برای ابطال.
.TP
.BI "\-s, \-\-serial " hex
شماره سریال با کدگذاری هگزادسیمال مربوط به گواهی مورد نظر برای ابطال.
.
.SH "مثال‌ها (EXAMPLES)"
.
ابطال یک گواهی:
.PP
.EX
  pki \-\-signcrl \-\-cacert ca_cert.der \-\-cakey ca_key.der \\
      \-\-reason superseded \-\-cert cert.der > crl.der
.EE
.PP
به‌روزرسانی یک CRL موجود با دو ابطال جدید با استفاده از شماره سریال گواهی، بدون ذکر دلیل:
.PP
.EX
  pki \-\-signcrl \-\-cacert ca_cert.der \-\-cakey ca_key.der \\
      \-\-lastcrl old_crl.der \-\-serial 0123 \-\-serial 0345 > crl.der
.EE
.PP
.SH "همچنین ببینید (SEE ALSO)"
.
.BR pki (1)