.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH nethsm-openpgp-add 1  "nethsm-openpgp-add "
.SH "نام (NAME)"
nethsm\-openpgp\-add \- افزودن و ثبت کلیدهای OpenPGP در دستگاه NetHSM
.SH "خلاصه دستور (SYNOPSIS)"
\fBnethsm openpgp add\fR [\fB\-t\fR|\fB\-\-time\fR] [\fB\-v\fR|\fB\-\-version\fR] [\fB\-\-can\-sign\fR] [\fB\-\-cannot\-sign\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_ID\fR> <\fIUSER_ID\fR>
.SH "توضیحات (DESCRIPTION)"
افزودن یک گواهی OpenPGP برای یک کلید.
.PP
برای یک کلید موجود، یک گواهی OpenPGP ایجاد می‌کند.
گواهی ایجادشده سپس به عنوان گواهی کلید افزوده می‌شود (دستور «nethsm key cert import» را ببینید).
.PP
کاربران سراسری سیستم در نقش‌های «Administrator» (مدیر) و «Operator» (عملگر) تنها می‌توانند گواهی‌های OpenPGP را برای کلیدهای سراسری سیستم اضافه کنند.
کاربران دارای فضای نام در نقش‌های «Administrator» و «Operator» فقط می‌توانند گواهی‌های OpenPGP را برای کلیدهای موجود در فضای نام خود بیفزایند.
.PP
نیازمند احراز هویت کاربری در نقش «Operator» است که به کلید هدف دسترسی داشته باشد (دستورهای «nethsm key tag» و «nethsm user tag» را ببینید).
علاوه بر این، برای درون‌ریزی گواهی، احراز هویت کاربری در نقش «Administrator» نیز الزامی است.
.SH "گزینه‌ها (OPTIONS)"
.TP
\fB\-t\fR, \fB\-\-time\fR \fI<TIME>\fR
زمان اختیاری ایجاد گواهی (پیش‌فرض: زمان جاری)
.RS
همچنین می‌تواند از طریق متغیر محیطی \fBNETHSM_OPENPGP_CREATED_AT\fR مشخص شود.
.RE
.TP
\fB\-v\fR, \fB\-\-version\fR \fI<VERSION>\fR
نسخه OpenPGP که گواهی با آن ایجاد می‌شود (پیش‌فرض: "4")

یکی از مقادیر ["4", "6"].
.RS
همچنین می‌تواند از طریق متغیر محیطی \fBNETHSM_OPENPGP_VERSION\fR مشخص شود.
.RE
.TP
\fB\-\-can\-sign\fR
تنظیم نشانگر امکان امضا برای کلید (به‌طور پیش‌فرض تنظیم است)

در صورت استفاده از این گزینه، کلید همراه با یک کلید مولفه که نشانگر امضا برای آن فعال است ایجاد می‌شود.
.RS
همچنین می‌تواند از طریق متغیر محیطی \fBNETHSM_OPENPGP_CERT_GENERATE_CAN_SIGN\fR مشخص شود.
.RE
.TP
\fB\-\-cannot\-sign\fR
پاک کردن نشانگر امکان امضا برای کلید

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

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

این گزینه می‌تواند چندین بار مشخص شود، که برای دستورات نیازمند چندین نقش همزمان مورد نیاز است.
هنگام استفاده از چند فایل عبارت عبور، ترتیب آنها مهم است، زیرا فایل‌ها به ترتیب به کاربر مشخص‌شده با گزینه
.B \-\-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_ID\fR>
شناسه کلید مورد استفاده
.RS
همچنین می‌تواند از طریق متغیر محیطی \fBNETHSM_KEY_ID\fR مشخص شود.
.RE
.TP
<\fIUSER_ID\fR>
شناسه کاربری (User ID) مورد استفاده برای کلید
.RS
همچنین می‌تواند از طریق متغیر محیطی \fBNETHSM_OPENPGP_USERID\fR مشخص شود.
.RE