.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH nethsm-openpgp-import 1  "nethsm-openpgp-import " 
.SH "نام (NAME)"
nethsm\-openpgp\-import \- وارد کردن کلید خصوصی با قالب TSK در OpenPGP
.SH "خلاصه دستور (SYNOPSIS)"
\fBnethsm openpgp import\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] <\fITSK_FILE\fR> 
.SH "توضیحات (DESCRIPTION)"
وارد کردن کلید خصوصی در قالب کلید محرمانهٔ انتقال‌پذیر (TSK) اوپن‌پی‌جی‌پی (OpenPGP Transferable Secret Key)
.PP
تنها از TSKهایی با یک مؤلفه کلید (single component key) پشتیبانی می‌شود.
.PP
کاربران سراسری سیستم در نقش «Administrator» تنها می‌توانند TSKها را به عنوان کلیدهای سراسری وارد کنند.
کاربران دارای فضای نام در نقش «Administrator» تنها می‌توانند TSKها را به عنوان کلیدها در فضای نام خودشان وارد کنند.
.PP
نکته: با این‌که اختصاص برچسب‌ها به کلید جدید اختیاری است، اما اکیداً توصیه می‌شود؛ زیرا عدم انجام این کار بدان معناست که همهٔ کاربران در همان حوزه (scope) به آن دسترسی خواهند داشت!
.PP
نیازمند احراز هویت یک کاربر در نقش «Administrator» است.
.SH "گزینه‌ها (OPTIONS)"
.TP
\fB\-k\fR, \fB\-\-key\-id\fR \fI<KEY_ID>\fR
شناسه یکتای اختیاری که به کلید واردشده اختصاص می‌یابد

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

برچسب‌های روی کلیدها برای اعطای دسترسی به آن کلیدها به کاربرانی که برچسب‌های یکسانی دارند، به کار می‌روند.
.RS
همچنین می‌تواند از طریق متغیر محیطی \fBNETHSM_OPENPGP_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
<\fITSK_FILE\fR>
مسیر فایل کلید محرمانهٔ انتقال‌پذیر (Transferable Secret Key یا TSK) برای وارد کردن
.RS
همچنین می‌تواند از طریق متغیر محیطی \fBNETHSM_OPENPGP_TSK_FILE\fR مشخص شود. 
.RE