.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH nethsm-key-generate 1  "nethsm-key-generate " 
.SH "نام (NAME)"
nethsm\-key\-generate \- تولید یک کلید جدید
.SH "خلاصه دستور (SYNOPSIS)"
\fBnethsm key generate\fR [\fB\-L\fR|\fB\-\-length\fR] [\fB\-k\fR|\fB\-\-key\-id\fR] [\fB\-t\fR|\fB\-\-tags\fR] [\fB\-a\fR|\fB\-\-auth\-passphrase\-file\fR] [\fB\-c\fR|\fB\-\-config\fR] [\fB\-l\fR|\fB\-\-label\fR] [\fB\-u\fR|\fB\-\-user\fR] [\fB\-h\fR|\fB\-\-help\fR] [\fIKEY_TYPE\fR] [\fIKEY_MECHANISMS\fR] 
.SH "توضیحات (DESCRIPTION)"
تولید یک کلید جدید
.PP
نوع کلید ارائه‌شده و فهرست سازوکارهای (mechanisms) کلید باید با یکدیگر مطابقت داشته باشند:
* "Rsa" به یکی از موارد [RsaDecryptionRaw, RsaDecryptionPkcs1, RsaDecryptionOaepMd5, RsaDecryptionOaepSha1, RsaDecryptionOaepSha224, RsaDecryptionOaepSha256, RsaDecryptionOaepSha384, RsaDecryptionOaepSha512, RsaSignaturePkcs1, RsaSignaturePssMd5, RsaSignaturePssSha1, RsaSignaturePssSha224, RsaSignaturePssSha256, RsaSignaturePssSha384, RsaSignaturePssSha512] نیاز دارد.
* "Curve25519" به یکی از موارد [EdDsaSignature] نیاز دارد.
* "EcP256" ،"EcP384" و "EcP521" به یکی از موارد [EcdsaSignature] نیاز دارند.
* "Generic" حداقل به یکی از موارد [AesDecryptionCbc, AesEncryptionCbc] نیاز دارد.
.PP
کاربران سراسری سیستم (System\-wide) در نقش "Administrator" کلیدهای سراسری تولید می‌کنند.
کاربران دارای فضای نام (Namespaced) در نقش "Administrator" کلیدها را در فضای نام اختصاصی خود تولید می‌کنند.
.PP
نکته: با این‌که اختصاص برچسب‌ها (tags) به کلید جدید اختیاری است، اما اکیداً توصیه می‌شود؛ زیرا عدم انجام این کار بدان معناست که همهٔ کاربران در همان حوزه (scope) به آن دسترسی خواهند داشت!
.PP
نیازمند احراز هویت یک کاربر در نقش "Administrator" است.
.SH "گزینه‌ها (OPTIONS)"
.TP
\fB\-L\fR, \fB\-\-length\fR \fI<LENGTH>\fR
طول اختیاری کلید تولیدشده بر حسب بیت

در صورت مشخص نشدن، مقدار پیش‌فرض انتخاب می‌شود.
.RS
همچنین می‌تواند از طریق متغیر محیطی \fBNETHSM_KEY_BIT_LENGTH\fR مشخص شود. 
.RE
.TP
\fB\-k\fR, \fB\-\-key\-id\fR \fI<KEY_ID>\fR
شناسهٔ یکتای اختیاری که به کلید تولیدشده اختصاص می‌یابد

اگر مقداری ارائه نشود، یک شناسهٔ عمومی برای کلید ایجاد خواهد شد.
.RS
همچنین می‌تواند از طریق متغیر محیطی \fBNETHSM_KEY_ID\fR مشخص شود. 
.RE
.TP
\fB\-t\fR, \fB\-\-tags\fR \fI<TAGS>\fR
فهرست اختیاری از برچسب‌هایی که به کلید تولیدشده اختصاص می‌یابند

برچسب‌های روی کلیدها برای اعطای دسترسی به آن کلیدها به کاربرانی که برچسب‌های یکسانی دارند، به کار می‌روند.
.RS
همچنین می‌تواند از طریق متغیر محیطی \fBNETHSM_KEY_TAGS\fR مشخص شود. 
.RE
.TP
\fB\-a\fR, \fB\-\-auth\-passphrase\-file\fR \fI<AUTH_PASSPHRASE_FILE>\fR
مسیر یک فایل حاوی عبارت عبور برای احراز هویت

عبارت عبور ارائه‌شده در فایل باید متعلق به کاربری باشد که برای این دستور انتخاب شده است.

این گزینه می‌تواند چندین بار مشخص شود که برای دستوراتی که به‌طور همزمان به چند نقش نیاز دارند، الزامی است.
در صورت وجود چندین فایل عبارت عبور، ترتیب آنها اهمیت دارد؛ چرا که فایل‌ها به کاربر متناظر ارائه‌شده توسط گزینهٔ «\-\-user» تخصیص داده می‌شوند.
.RS
همچنین می‌تواند از طریق متغیر محیطی \fBNETHSM_AUTH_PASSPHRASE_FILE\fR مشخص شود. 
.RE
.TP
\fB\-c\fR, \fB\-\-config\fR \fI<CONFIG>\fR
مسیر یک فایل پیکربندی سفارشی

در صورت مشخص شدن، فایل پیکربندی سفارشی به جای مکان پیش‌فرض فایل پیکربندی استفاده می‌شود.
.RS
همچنین می‌تواند از طریق متغیر محیطی \fBNETHSM_CONFIG\fR مشخص شود. 
.RE
.TP
\fB\-l\fR, \fB\-\-label\fR \fI<LABEL>\fR
برچسبی که به طور یکتا یک دستگاه را در فایل پیکربندی مشخص می‌کند

اگر بیش از یک دستگاه در فایل پیکربندی تنظیم شده باشد، مشخص کردن این گزینه الزامی است.
.RS
همچنین می‌تواند از طریق متغیر محیطی \fBNETHSM_LABEL\fR مشخص شود. 
.RE
.TP
\fB\-u\fR, \fB\-\-user\fR \fI<USER>\fR
نام کاربری که برای اجرای یک دستور استفاده می‌شود

اگر هیچ نام کاربری در فایل پیکربندی برای یک دستگاه تنظیم نشده باشد، می‌تواند ارائه شود.
اگر چندین نام کاربر با نقش هدف یکسان در فایل پیکربندی برای یک دستگاه تنظیم شده باشند، تعیین آن الزامی است.

این گزینه می‌تواند چندین بار مشخص شود که برای دستوراتی که به‌طور همزمان به چند نقش نیاز دارند، الزامی است.

.RS
همچنین می‌تواند از طریق متغیر محیطی \fBNETHSM_USER\fR مشخص شود. 
.RE
.TP
\fB\-h\fR, \fB\-\-help\fR
چاپ راهنما (مشاهدهٔ خلاصه با \*(Aq\-h\*(Aq)
.TP
[\fIKEY_TYPE\fR]
نوع اختیاری کلید برای تولید

نوع کلید باید با سازوکارهای کلید انتخابی مطابقت داشته باشد!

یکی از ["Curve25519", "EcP256", "EcP384", "EcP521", "Generic", "Rsa"] (پیش‌فرض: "Curve25519").
.RS
همچنین می‌تواند از طریق متغیر محیطی \fBNETHSM_KEY_TYPE\fR مشخص شود. 
.RE
.TP
[\fIKEY_MECHANISMS\fR]
سازوکارهای ارائه‌شده توسط کلید تولیدشده

سازوکارهای کلید باید با نوع کلید انتخابی مطابقت داشته باشند!

حداقل یکی از ["AesDecryptionCbc", "AesEncryptionCbc", "EcdsaSignature", "EdDsaSignature", "RsaDecryptionOaepMd5", "RsaDecryptionOaepSha1", "RsaDecryptionOaepSha224", "RsaDecryptionOaepSha256", "RsaDecryptionOaepSha384", "RsaDecryptionOaepSha512", "RsaDecryptionPkcs1", "RsaDecryptionRaw", "RsaSignaturePkcs1", "RsaSignaturePssMd5", "RsaSignaturePssSha1", "RsaSignaturePssSha224", "RsaSignaturePssSha256", "RsaSignaturePssSha384", "RsaSignaturePssSha512"] (پیش‌فرض: "EdDsaSignature").
.RS
همچنین می‌تواند از طریق متغیر محیطی \fBNETHSM_KEY_MECHANISMS\fR مشخص شود. 
.RE