.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH nethsm-key-tag 1  "nethsm-key-tag"
.SH "نام (NAME)"
nethsm\-key\-tag \- برچسب‌گذاری یک کلید در دستگاه NetHSM
.SH "خلاصه دستور (SYNOPSIS)"
\fBnethsm key tag\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> <\fITAG\fR>
.SH "توضیحات (DESCRIPTION)"
برچسب‌گذاری (تگ زدن) بر روی یک کلید رمزنگاری.
.PP
برچسب‌ها برای اعطای دسترسی به کلیدها به کاربران دارای نقش «اپراتور» (Operator) به کار می‌روند. چنانچه یک کاربر و یک کلید با برچسبی یکسان نشانه‌گذاری شوند، آن کاربر به کلید دسترسی خواهد داشت. از آنجا که کلیدها یا در سطح کل سیستم یا در یک فضای نام (namespace) تعریف می‌شوند، کاربران دارای نقش Operator باید در همان حوزه کلید قرار داشته باشند تا این دسترسی معتبر باشد.
.PP
نکته: برچسب‌های کلیدها باید پیش از ایجاد برچسب روی کاربران تعریف شوند.
.PP
کاربران سراسری سیستم با نقش «مدیر» (Administrator) صرفاً می‌توانند کلیدهای سراسری را برچسب‌گذاری کنند. کاربران دارای فضای نام با نقش Administrator نیز صرفاً مجاز به برچسب‌گذاری کلیدهای فضای نام خود هستند.
.PP
اجرای این دستور نیازمند احراز هویت کاربری با نقش «Administrator» است.
.SH "گزینه‌ها (OPTIONS)"
.TP
\fB\-a\fR, \fB\-\-auth\-passphrase\-file\fR \fI<AUTH_PASSPHRASE_FILE>\fR
مسیر پرونده حاوی عبارت عبور جهت احراز هویت.
.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
نمایش پیام راهنما.
.TP
<\fIKEY_ID\fR>
شناسه کلیدی که برچسب به آن اضافه می‌شود.
.RS
همچنین از طریق متغیر محیطی \fBNETHSM_KEY_ID\fR قابل تنظیم است.
.RE
.TP
<\fITAG\fR>
برچسب مورد نظر جهت افزودن به کلید.
.RS
همچنین از طریق متغیر محیطی \fBNETHSM_KEY_TAG\fR قابل تنظیم است.
.RE