.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH nethsm-key-encrypt 1  "nethsm-key-encrypt " 
.SH "نام (NAME)"
nethsm\-key\-encrypt \- رمزگذاری یک پیام با استفاده از یک کلید
.SH "خلاصه دستور (SYNOPSIS)"
\fBnethsm key encrypt\fR [\fB\-f\fR|\fB\-\-force\fR] [\fB\-i\fR|\fB\-\-initialization\-vector\fR] [\fB\-o\fR|\fB\-\-output\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> <\fIMESSAGE\fR> [\fIENCRYPT_MODE\fR] 
.SH "توضیحات (DESCRIPTION)"
رمزگذاری یک پیام با استفاده از یک کلید.
.PP
تنها رمزگذاری متقارن پشتیبانی می‌شود.
.PP
کاربران سراسری (System\-wide) با نقش «اپراتور» (Operator) تنها می‌توانند پیام‌ها را با استفاده از کلیدهای سراسری رمزگذاری کنند.
کاربران دارای فضای نام (Namespaced) با نقش «اپراتور» (Operator) تنها می‌توانند پیام‌ها را با استفاده از کلیدهای موجود در فضای نام خودشان رمزگذاری کنند.
.PP
نیازمند احراز هویت کاربری با نقش «اپراتور» (Operator) است که به کلید مورد نظر دسترسی داشته باشد (به «nethsm key tag» و «nethsm user tag» مراجعه کنید).
.SH "گزینه‌ها (OPTIONS)"
.TP
\fB\-f\fR, \fB\-\-force\fR
نوشتن در فایل خروجی حتی در صورتی که از قبل وجود داشته باشد.
.RS
همچنین می‌تواند با متغیر محیطی \fBNETHSM_FORCE\fR مشخص شود. 
.RE
.TP
\fB\-i\fR, \fB\-\-initialization\-vector\fR \fI<INITIALIZATION_VECTOR>\fR
مسیر فایلی حاوی بردار مقداردهی اولیه (IV) برای رمزگذاری متقارن.

بردار مقداردهی اولیه (IV) تنها هنگام انتخاب رمزگذاری متقارن (مانند "AesCbc") قابل استفاده است.
.RS
همچنین می‌تواند با متغیر محیطی \fBNETHSM_KEY_ENCRYPT_IV\fR مشخص شود. 
.RE
.TP
\fB\-o\fR, \fB\-\-output\fR \fI<OUTPUT>\fR
مسیر فایل مشخصی برای نوشتن پیام رمزگذاری‌شده در آن.
.RS
همچنین می‌تواند با متغیر محیطی \fBNETHSM_KEY_ENCRYPT_OUTPUT\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_ID\fR>
شناسه کلید مورد استفاده برای رمزگذاری.
.RS
همچنین می‌تواند با متغیر محیطی \fBNETHSM_KEY_ID\fR مشخص شود. 
.RE
.TP
<\fIMESSAGE\fR>
مسیر پیامی که باید رمزگذاری شود.
.RS
همچنین می‌تواند با متغیر محیطی \fBNETHSM_KEY_ENCRYPT_MESSAGE\fR مشخص شود. 
.RE
.TP
[\fIENCRYPT_MODE\fR]
حالت رمزگذاری مورد استفاده.

یکی از مقادیر ["AesCbc"] (پیش‌فرض "AesCbc").
.RS
همچنین می‌تواند با متغیر محیطی \fBNETHSM_KEY_ENCRYPT_MODE\fR مشخص شود. 
.RE