.TH "PKI \-\-GEN" 1 "2016-12-13" "6.1.0" "strongSwan"
.
.SH "نام (NAME)"
.
pki \-\-gen \- تولید یک کلید خصوصی جدید RSA یا ECDSA
.
.SH "خلاصه دستور (SYNOPSIS)"
.
.SY pki\ \-\-gen
.OP \-\-type type
.OP \-\-size bits
.OP \-\-safe\-primes
.OP \-\-shares n
.OP \-\-threshold l
.OP \-\-outform encoding
.OP \-\-debug level
.YS
.
.SY pki\ \-\-gen
.BI \-\-options\~ file
.YS
.
.SY "pki \-\-gen"
.B \-h
|
.B \-\-help
.YS
.
.SH "توضیحات (DESCRIPTION)"
.
این زیردستور از
.BR pki (1)
برای تولید یک کلید خصوصی جدید RSA یا ECDSA استفاده می‌شود.
.
.SH "گزینه‌ها (OPTIONS)"
.
.TP
.B "\-h, \-\-help"
چاپ اطلاعات نحوه استفاده به همراه خلاصه‌ای از گزینه‌های موجود.
.TP
.BI "\-v, \-\-debug " level
تنظیم سطح دیباگ، پیش‌فرض: 1.
.TP
.BI "\-+, \-\-options " file
خواندن گزینه‌های خط فرمان از \fIfile\fR.
.TP
.BI "\-t, \-\-type " type
نوع کلید برای تولید. یکی از گزینه‌های \fIrsa\fR، \fIecdsa\fR، \fIed25519\fR یا \fIed448\fR، پیش‌فرض \fIrsa\fR است.
.TP
.BI "\-s, \-\-size " bits
طول کلید به بیت. پیش‌فرض 2048 برای \fIrsa\fR و 384 برای \fIecdsa\fR است.
برای \fIecdsa\fR در حال حاضر تنها سه مقدار پشتیبانی می‌شوند: 256، 384 و 521.
.TP
.BI "\-p, \-\-safe\-primes"
تولید اعداد اول امن (safe primes) برای RSA.
.TP
.BI "\-f, \-\-outform " encoding
کدگذاری کلید خصوصی تولید شده. یکی از \fIder\fR (ASN.1 DER) یا \fIpem\fR (Base64 PEM)، پیش‌فرض \fIder\fR است.
.PP
.SS "رمزنگاری آستانه‌ای RSA"
.TP
.BI "\-n, \-\-shares " <n>
تعداد سهم‌های کلید خصوصی RSA.
.TP
.BI "\-l, \-\-threshold " <l>
حداقل تعداد سهم‌های مشارکت‌کننده کلید RSA.
.
.SH "مشکلات در میزبان‌های با آنتروپی پایین (PROBLEMS ON HOSTS WITH LOW ENTROPY)"
.
اگر از افزونهٔ
.I gmp
برای تولید کلیدهای خصوصی RSA استفاده شود، داده‌های کلید از
.I /dev/random
(از طریق افزونهٔ
.IR random )
خوانده می‌شود. بنابراین، اگر استخر آنتروپی سیستم خالی باشد، ممکن است اجرای دستور متوقف (block) شود.
برای جلوگیری از این امر، یا از یک تولیدکننده سخت‌افزاری اعداد تصادفی برای تغذیهٔ
.I /dev/random
استفاده کنید، یا از OpenSSL (از طریق افزونهٔ
.I openssl
یا خط فرمان) بهره ببرید که در مورد کیفیت داده‌های کلید چندان سخت‌گیر نیست (در صورت لزوم از
.I /dev/urandom
داده می‌خواند). همچنین امکان پیکربندی دستگاه‌های استفاده‌شده توسط افزونهٔ
.I random
در
.BR strongswan.conf (5)
وجود دارد. تنظیم
.B libstrongswan.plugins.random.random
به
.I /dev/urandom
افزونه را وادار می‌کند تا بایت‌های خوانده‌شده از
.I /dev/urandom
را به عنوان داده‌های تصادفی با کیفیت بالا در نظر بگیرد و بدین ترتیب از مسدود شدن جلوگیری کند. البته
این امر این حقیقت را تغییر نمی‌دهد که داده‌های کلید تولید شده از این روش کیفیت پایین‌تری دارند.
.
.SH "مثال‌ها (EXAMPLES)"
.
.TP
.B pki \-\-gen \-\-size 3072 > rsa_key.der
یک کلید خصوصی ۳۰۷۲ بیتی RSA تولید می‌کند.
.
.TP
.B pki \-\-gen \-\-type ecdsa \-\-size 256 > ecdsa_key.der
یک کلید خصوصی ۲۵۶ بیتی ECDSA تولید می‌کند.
.
.SH "همچنین ببینید (SEE ALSO)"
.
.BR pki (1)