.TH "PKI \-\-SELF" 1 "2019-05-06" "6.1.0" "strongSwan"
.
.SH "نام (NAME)"
.
pki \-\-self \- ایجاد یک گواهی خودامضا
.
.SH "خلاصه دستور (SYNOPSIS)"
.
.SY pki\ \-\-self
.RB [ \-\-in
.IR file | \fB\-\-keyid\fR
.IR hex ]
.OP \-\-type t
.BI \-\-dn\~ distinguished-name
.OP \-\-san subjectAltName
.OP \-\-lifetime days
.OP \-\-not-before datetime
.OP \-\-not-after datetime
.OP \-\-serial hex
.OP \-\-flag flag
.OP \-\-digest digest
.OP \-\-rsa\-padding padding
.OP \-\-ca
.OP \-\-ocsp uri
.OP \-\-pathlen len
.OP \-\-addrblock block
.OP \-\-nc-permitted name
.OP \-\-nc-excluded name
.OP \-\-critical oid
.OP \-\-policy\-mapping mapping
.OP \-\-policy\-explicit len
.OP \-\-policy\-inhibit len
.OP \-\-policy\-any len
.OP \-\-cert\-policy oid\ \fR[\fB\-\-cps\-uri\ \fIuri\fR]\ \fR[\fB\-\-user\-notice\ \fItext\fR]
.OP \-\-outform encoding
.OP \-\-debug level
.YS
.
.SY pki\ \-\-self
.BI \-\-options\~ file
.YS
.
.SY "pki \-\-self"
.B \-h
|
.B \-\-help
.YS
.
.SH "توضیحات (DESCRIPTION)"
.
این زیردستور از
.BR pki (1)
برای ایجاد یک گواهی خودامضا استفاده می‌شود.
.
.SH "گزینه‌ها (OPTIONS)"
.
.TP
.B "\-h, \-\-help"
چاپ اطلاعات نحوه استفاده همراه با خلاصه‌ای از گزینه‌های موجود.
.TP
.BI "\-v, \-\-debug " level
تنظیم سطح دیباگ، پیش‌فرض: ۱.
.TP
.BI "\-+, \-\-options " file
خواندن گزینه‌های خط فرمان از \fIfile\fR.
.TP
.BI "\-i, \-\-in " file
فایل ورودی کلید خصوصی. در صورت مشخص نشدن، کلید از \fISTDIN\fR خوانده می‌شود.
.TP
.BI "\-x, \-\-keyid " hex
شناسه شیء کلید خصوصی روی کارت هوشمند یا TPM در قالب هگزادسیمال همراه با پیشوند اختیاری 0x.
.TP
.BI "\-t, \-\-type " type
نوع کلید ورودی. یکی از موارد \fIpriv\fR، \fIrsa\fR، \fIecdsa\fR، \fIed25519\fR یا \fIed448\fR، پیش‌فرض: \fIpriv\fR.
.TP
.BI "\-d, \-\-dn " distinguished-name
نام متمایز (DN) موضوع و صادرکننده. الزامی.
.TP
.BI "\-a, \-\-san " subjectAltName
افزونه subjectAltName برای درج در گواهی. می‌تواند چندین بار استفاده شود.
.TP
.BI "\-l, \-\-lifetime " days
تعداد روزهای اعتبار گواهی، پیش‌فرض: ۱۰۹۵. در صورتی که هر دو زمان شروع و پایان مطلق داده شوند، نادیده گرفته می‌شود.
.TP
.BI "\-F, \-\-not-before " datetime
زمان مطلق آغاز اعتبار گواهی. قالب تاریخ و زمان توسط گزینه
.B \-\-dateform
تعیین می‌شود.
.TP
.BI "\-T, \-\-not-after " datetime
زمان مطلق پایان اعتبار گواهی. قالب تاریخ و زمان توسط گزینه
.B \-\-dateform
تعیین می‌شود.
.TP
.BI "\-D, \-\-dateform " form
قالب strptime(3) برای گزینه‌های
.B \-\-not\-before
و
.B \-\-not\-after
، پیش‌فرض:
.B %d.%m.%y %T
.TP
.BI "\-s, \-\-serial " hex
شماره سریال به صورت هگزادسیمال. به طور پیش‌فرض به شکل تصادفی تخصیص می‌یابد.
.TP
.BI "\-e, \-\-flag " flag
افزودن پرچم extendedKeyUsage. یکی از موارد \fIserverAuth\fR، \fIclientAuth\fR،
\fIcrlSign\fR یا \fIocspSigning\fR. می‌تواند چندین بار استفاده شود.
.TP
.BI "\-g, \-\-digest " digest
خلاصه پیام (دایجست) مورد استفاده برای ایجاد امضا. یکی از موارد \fImd5\fR، \fIsha1\fR،
\fIsha224\fR، \fIsha256\fR، \fIsha384\fR یا \fIsha512\fR. پیش‌فرض بر اساس نوع و اندازه کلید امضا تعیین می‌شود.
.TP
.BI "\-R, \-\-rsa\-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.
.TP
.BI "\-b, \-\-ca"
درج افزونه basicConstraint مرجع صدور گواهی (CA) در گواهی.
.TP
.BI "\-o, \-\-ocsp " uri
شناسه URI بخش AuthorityInfoAccess مربوط به OCSP برای درج در گواهی. می‌تواند چندین بار استفاده شود.
.TP
.BI "\-p, \-\-pathlen " len
تنظیم محدودیت طول مسیر (path length constraint).
.TP
.BI "\-B, \-\-addrblock " block
بلوک آدرس RFC 3779 برای درج در گواهی. \fIblock\fR یا یک زیرشبکه CIDR (مانند \fI10.0.0.0/8\fR) یا یک محدوده آدرس اختیاری (\fI192.168.1.7-192.168.1.13\fR) است. برای درج چندین بلوک قابل تکرار است. لطفاً توجه داشته باشید که بلوک‌های ارائه‌شده همان‌طور که هستند در گواهی درج می‌شوند، بنابراین برای رعایت استانداردها، چندین بلوک باید به ترتیب صحیح ارائه شوند و بلوک‌های مجاور ترکیب گردند. برای جزئیات به RFC 3779 مراجعه کنید.
.TP
.BI "\-n, \-\-nc-permitted " name
افزودن افزونه NameConstraint مجاز به گواهی. برای محدودیت‌های DNS یا ایمیل، نوع هویت همیشه با نام داده‌شده قابل تشخیص نیست. از پیشوند
.B dns:
یا
.B email:
برای تحمیل یک نوع محدودیت استفاده کنید.
.TP
.BI "\-N, \-\-nc-excluded " name
افزودن افزونه NameConstraint مستثنی‌شده به گواهی. برای محدودیت‌های DNS یا ایمیل، نوع هویت همیشه با نام داده‌شده قابل تشخیص نیست. از پیشوند
.B dns:
یا
.B email:
برای تحمیل یک نوع محدودیت استفاده کنید.
.TP
.BI "\-X, \-\-critical " oid
افزودن یک افزونه بحرانی (critical) با OID مشخص‌شده.
.TP
.BI "\-M, \-\-policy-mapping " issuer-oid:subject-oid
افزودن policyMapping از صادرکننده به OID موضوع.
.TP
.BI "\-E, \-\-policy-explicit " len
افزودن محدودیت requireExplicitPolicy.
.TP
.BI "\-H, \-\-policy-inhibit " len
افزودن محدودیت inhibitPolicyMapping.
.TP
.BI "\-A, \-\-policy-any " len
افزودن محدودیت inhibitAnyPolicy.
.PP
.SS "سیاست گواهی (Certificate Policy)"
می‌توان چندین افزونه certificatePolicy اضافه کرد. هر یک با اطلاعات زیر:
.TP
.BI "\-P, \-\-cert-policy " oid
شناسه OID برای درج در افزونه certificatePolicy. الزامی.
.TP
.BI "\-C, \-\-cps-uri " uri
شناسه URI بیانیه رویه صدور گواهی (CPS) برای certificatePolicy.
.TP
.BI "\-U, \-\-user-notice " text
یادداشت کاربر برای certificatePolicy.
.
.SH "مثال‌ها (EXAMPLES)"
.
تولید یک گواهی خودامضا با استفاده از کلید RSA داده‌شده:
.PP
.EX
  pki \-\-self \-\-in key.der \-\-dn "C=CH, O=strongSwan, CN=moon" \\
      \-\-san moon.strongswan.org > cert.der
.EE
.
.SH "همچنین ببینید (SEE ALSO)"
.
.BR pki (1)