.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH nethsm-key-import 1  "nethsm-key-import " 
.SH "نام (NAME)"
nethsm\-key\-import \- وارد کردن یک کلید
.SH "خلاصه دستور (SYNOPSIS)"
\fBnethsm key import\fR [\fB\-\-format\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_DATA\fR> [\fIKEY_MECHANISMS\fR] 
.SH "توضیحات (DESCRIPTION)"
وارد کردن یک کلید
.PP
داده‌های کلید ارائه‌شده باید به عنوان یک کلید خصوصی PKCS#8 با کدگذاری ASN.1 DER یا در قالب PEM (Privacy\-Enhanced Mail) ارائه شوند.
داده‌های کلید باید با نوع کلید ارائه‌شده مطابقت داشته باشند.
.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\-\-format\fR \fI<FORMAT>\fR [default: Der]
قالب کلید برای وارد کردن

کلیدها را می‌توان در قالب‌های Distinguished Encoding Rules (DER) یا Privacy\-Enhanced Mail (PEM) وارد کرد.

یکی از مقادیر ["Pem", "Der"].
.RS
همچنین می‌تواند از طریق متغیر محیطی \fBNETHSM_KEY_FORMAT\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>
نوع کلید برای وارد کردن

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

یکی از موارد ["AesDecryptionCbc", "AesEncryptionCbc", "EcdsaSignature", "EdDsaSignature", "RsaDecryptionOaepMd5", "RsaDecryptionOaepSha1", "RsaDecryptionOaepSha224", "RsaDecryptionOaepSha256", "RsaDecryptionOaepSha384", "RsaDecryptionOaepSha512", "RsaDecryptionPkcs1", "RsaDecryptionRaw", "RsaSignaturePkcs1", "RsaSignaturePssMd5", "RsaSignaturePssSha1", "RsaSignaturePssSha224", "RsaSignaturePssSha256", "RsaSignaturePssSha384", "RsaSignaturePssSha512"].
.RS
همچنین می‌تواند از طریق متغیر محیطی \fBNETHSM_KEY_TYPE\fR مشخص شود. 
.RE
.TP
<\fIKEY_DATA\fR>
مسیر یک کلید خصوصی PKCS#8 با قالب کدگذاری‌شده ASN.1 DER

داده‌های کلید خصوصی باید با نوع کلید انتخاب‌شده مطابقت داشته باشند.
.RS
همچنین می‌تواند از طریق متغیر محیطی \fBNETHSM_KEY_DATA\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"].
.RS
همچنین می‌تواند از طریق متغیر محیطی \fBNETHSM_KEY_MECHANISMS\fR مشخص شود. 
.RE