.TH "PKI \-\-ISSUE" 1 "2019-05-06" "6.1.0" "strongSwan"
.
.SH "نام (NAME)"
.
ga5	pki \-\-issue \- صدور گواهی با استفاده از گواهی و کلید CA
.
.SH "خلاصه دستور (SYNOPSIS)"
.
.SY pki\ \-\-issue
.OP \-\-in file
.OP \-\-type type
.BI \-\-cakey\~ file |\-\-cakeyid\~ hex
.BI \-\-cacert\~ file
.OP \-\-dn subject-dn
.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 \-\-crl uri\ \fR[\fB\-\-crlissuer\ \fIissuer\fR]
.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\ \-\-issue
.BI \-\-options\~ file
.YS
.
.SY "pki \-\-issue"
.B \-h
|
.B \-\-help
.YS
.
.SH "توضیحات (DESCRIPTION)"
.
af52	این زیردستور از
ix53	.BR pki (1)
hw54	برای صدور یک گواهی با استفاده از گواهی CA و کلید خصوصی استفاده می‌شود.
yh55	.
gg56	.SH "گزینه‌ها (OPTIONS)"
yh57	.
ho58	.TP
jl59	.B "\-h, \-\-help"
sx60	چاپ اطلاعات نحوه استفاده همراه با خلاصه‌ای از گزینه‌های موجود.
ho61	.TP
ab62	.BI "\-v, \-\-debug " level
hx63	تنظیم سطح دیباگ، پیش‌فرض: ۱.
ho64	.TP
vo65	.BI "\-+, \-\-options " file
jm66	خواندن گزینه‌های خط فرمان از \fIfile\fR.
ho67	.TP
sd68	.BI "\-i, \-\-in " file
fc69	فایل کلید عمومی یا درخواست گواهی PKCS#10 برای صدور. در صورت مشخص نشدن،
hr70	کلید/درخواست از \fISTDIN\fR خوانده می‌شود.
ho71	.TP
au72	.BI "\-t, \-\-type " type
nv73	نوع ورودی. یکی از موارد \fIpub\fR (کلید عمومی)، \fIpriv\fR (کلید خصوصی)،
ax74	\fIrsa\fR (کلید خصوصی RSA)، \fIecdsa\fR (کلید خصوصی ECDSA)،
df75	\fIed25519\fR (کلید خصوصی Ed25519)، \fIed448\fR (کلید خصوصی Ed448) یا
fk76	\fIpkcs10\fR (درخواست گواهی PKCS#10)،
vj77	پیش‌فرض: \fIpub\fR.
ho78	.TP
vv79	.BI "\-k, \-\-cakey " file
vr80	فایل کلید خصوصی CA. وجود این گزینه یا
qh81	.B \-\-cakeyid
hi82	الزامی است.
ho83	.TP
vu84	.BI "\-x, \-\-cakeyid " hex
fm85	شناسه شیء کلید خصوصی CA روی کارت هوشمند یا TPM در قالب هگزادسیمال همراه با پیشوند اختیاری 0x. وجود این گزینه یا
wh87	.B \-\-cakey
hi88	الزامی است.
ho89	.TP
cb90	.BI "\-c, \-\-cacert " file
kg91	فایل گواهی CA. الزامی.
ho92	.TP
uc93	.BI "\-d, \-\-dn " subject-dn
wf94	نام متمایز موضوع (DN) در گواهی صادرشده.
ho95	.TP
cy96	.BI "\-a, \-\-san " subjectAltName
no97	افزونه subjectAltName برای درج در گواهی. می‌تواند چندین بار استفاده شود.
ho98	.TP
pd99	.BI "\-l, \-\-lifetime " days
mn100	تعداد روزهای اعتبار گواهی، پیش‌فرض: ۱۰۹۵. در صورتی که هر دو زمان شروع و پایان مطلق داده شوند، نادیده گرفته می‌شود.
ho102	.TP
dk103	.BI "\-F, \-\-not-before " datetime
ec104	زمان مطلق آغاز اعتبار گواهی. قالب تاریخ و زمان توسط گزینه
kh106	.B \-\-dateform
rl107	تعیین می‌شود.
ho108	.TP
xr109	.BI "\-T, \-\-not-after " datetime
bp110	زمان مطلق پایان اعتبار گواهی. قالب تاریخ و زمان توسط گزینه
kh112	.B \-\-dateform
rl113	تعیین می‌شود.
ho114	.TP
wb115	.BI "\-D, \-\-dateform " form
ze116	قالب strptime(3) برای گزینه‌های
aa117	.B \-\-not\-before
nn118	و
ln119	.B \-\-not\-after
ud120	، پیش‌فرض:
ed121	.B %d.%m.%y %T
ho122	.TP
aq123	.BI "\-s, \-\-serial " hex
el124	شماره سریال به صورت هگزادسیمال. به طور پیش‌فرض به شکل تصادفی تخصیص می‌یابد.
ho125	.TP
fm126	.BI "\-e, \-\-flag " flag
nd127	افزودن پرچم extendedKeyUsage. یکی از موارد \fIserverAuth\fR، \fIclientAuth\fR،
yr128	\fIcrlSign\fR، \fIocspSigning\fR یا \fImsSmartcardLogon\fR. می‌تواند چندین بار استفاده شود. بدون اصلاح‌کننده‌ها، این پرچم‌ها روی پرچم‌های خوانده‌شده از درخواست PKCS#10 رونویسی می‌شوند. افزودن پیشوند \fI+\fR پرچم را به مجموعه اضافه می‌کند و پیشوند \fI-\fR آن را حذف می‌کند.
ho132	.TP
bs133	.BI "\-g, \-\-digest " digest
dw134	خلاصه پیام (دایجست) مورد استفاده برای ایجاد امضا. یکی از موارد \fImd5\fR، \fIsha1\fR،
fo135	\fIsha224\fR، \fIsha256\fR، \fIsha384\fR یا \fIsha512\fR. پیش‌فرض بر اساس نوع و اندازه کلید امضا تعیین می‌شود.
ho137	.TP
ww138	.BI "\-R, \-\-rsa\-padding " padding
tk139	پدینگ مورد استفاده برای امضاهای RSA. یکی از موارد \fIpkcs1\fR یا \fIpss\fR، پیش‌فرض: \fIpkcs1\fR.
ho141	.TP
kc142	.BI "\-f, \-\-outform " encoding
aq143	کدگذاری فایل گواهی ایجادشده. یکی از موارد \fIder\fR (ASN.1 DER) یا
ii144	\fIpem\fR (Base64 PEM)، پیش‌فرض: \fIder\fR.
ho145	.TP
tu146	.BI "\-b, \-\-ca"
ut147	درج افزونه basicConstraint مرجع صدور گواهی (CA) در گواهی.
ho148	.TP
sm149	.BI "\-u, \-\-crl " uri
qc150	شناسه URI نقطه توزیع CRL برای درج در گواهی. می‌تواند چندین بار استفاده شود.
ho152	.TP
ct153	.BI "\-I, \-\-crlissuer " issuer
zy154	صادرکننده اختیاری CRL برای CRL در نقطه توزیع قبلی.
ho155	.TP
pr156	.BI "\-o, \-\-ocsp " uri
xz157	شناسه URI بخش AuthorityInfoAccess مربوط به OCSP برای درج در گواهی. می‌تواند چندین بار استفاده شود.
ho159	.TP
de160	.BI "\-p, \-\-pathlen " len
mc161	تنظیم محدودیت طول مسیر (path length constraint).
ho162	.TP
ni163	.BI "\-B, \-\-addrblock " block
vf164	بلوک آدرس RFC 3779 برای درج در گواهی. \fIblock\fR یا یک زیرشبکه CIDR (مانند \fI10.0.0.0/8\fR) یا یک محدوده آدرس اختیاری (\fI192.168.1.7-192.168.1.13\fR) است. برای درج چندین بلوک قابل تکرار است.
ho170	.TP
hs171	.BI "\-n, \-\-nc-permitted " name
ip172	افزودن افزونه NameConstraint مجاز به گواهی. برای محدودیت‌های DNS یا ایمیل، نوع هویت همیشه با نام داده‌شده قابل تشخیص نیست. از پیشوند
am175	.B dns:
zl176	یا
yh177	.B email:
yt178	برای تحمیل یک نوع محدودیت استفاده کنید.
ho179	.TP
qb180	.BI "\-N, \-\-nc-excluded " name
jt181	افزودن افزونه NameConstraint مستثنی‌شده به گواهی. از پیشوند
am184	.B dns:
zl185	یا
yh186	.B email:
yt187	برای تحمیل یک نوع محدودیت استفاده کنید.
ho188	.TP
qc189	.BI "\-X, \-\-critical " oid
ue190	افزودن یک افزونه بحرانی (critical) با OID مشخص‌شده.
ho191	.TP
if192	.BI "\-M, \-\-policy-mapping " issuer-oid:subject-oid
ew193	افزودن policyMapping از صادرکننده به OID موضوع.
ho194	.TP
th195	.BI "\-E, \-\-policy-explicit " len
ej196	افزودن محدودیت requireExplicitPolicy.
ho197	.TP
xx198	.BI "\-H, \-\-policy-inhibit " len
yn199	افزودن محدودیت inhibitPolicyMapping.
ho200	.TP
kb201	.BI "\-A, \-\-policy-any " len
lc202	افزودن محدودیت inhibitAnyPolicy.
rl203	.PP
pc204	.SS "سیاست گواهی (Certificate Policy)"
ut205	می‌توان چندین افزونه certificatePolicy اضافه کرد. هر یک با اطلاعات زیر:
ho207	.TP
xa208	.BI "\-P, \-\-cert-policy " oid
dw209	شناسه OID برای درج در افزونه certificatePolicy. الزامی.
ho210	.TP
sw211	.BI "\-C, \-\-cps-uri " uri
rk212	شناسه URI بیانیه رویه صدور گواهی (CPS) برای certificatePolicy.
ho213	.TP
gi214	.BI "\-U, \-\-user-notice " text
vt215	یادداشت کاربر برای certificatePolicy.
yh216	.
we217	.SH "مثال‌ها (EXAMPLES)"
yh218	.
dp219	برای صرفه‌جویی در تایپ تکراری، گزینه‌های خط فرمان را می‌توان در فایل ذخیره کرد. فرض کنید
vw221	.I pki.opt
jb222	حاوی محتوای زیر است:
rl223	.PP
rr224	.EX
wr225	  --cacert ca_cert.der --cakey ca_key.der --digest sha256
fy226	  --flag serverAuth --lifetime 1460 --type pkcs10
nn227	.EE
rl228	.PP
nk229	سپس دستور زیر را می‌توان برای صدور یک گواهی بر اساس یک درخواست گواهی PKCS#10 و گزینه‌های بالا به کار برد:
rl231	.PP
rr232	.EX
pt233	  pki --issue --options pki.opt --in req.der > cert.der
nn234	.EE
rl235	.PP
yh236	.
bw237	.SH "همچنین ببینید (SEE ALSO)"
yh238	.
ix239	.BR pki (1)