.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH nethsm-key-decrypt 1  "nethsm-key-decrypt "
.SH "نام (NAME)"
nethsm\-key\-decrypt \- رمزگشایی داده‌ها با استفاده از کلید رمزنگاری در NetHSM
.SH "خلاصه دستور (SYNOPSIS)"
\fBnethsm key decrypt\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> [\fIDECRYPT_MODE\fR]
.SH "توضیحات (DESCRIPTION)"
رمزگشایی یک پیام با استفاده از یک کلید.
.PP
حالت رمزگشایی انتخاب‌شده باید با کلید مورد نظر مطابقت داشته باشد و بردار مقداردهی اولیه (IV) (در صورت کاربرد) باید دقیقاً همان موردی باشد که هنگام رمزگذاری استفاده شده است.
.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_DECRYPT_IV\fR مشخص شود.
.RE
.TP
\fB\-o\fR, \fB\-\-output\fR \fI<OUTPUT>\fR
مسیر فایلی مشخص برای نوشتن پیام رمزگشایی‌شده در آن.
.RS
همچنین می‌تواند با متغیر محیطی \fBNETHSM_KEY_DECRYPT_OUTPUT\fR مشخص شود.
.RE
.TP
\fB\-a\fR, \fB\-\-auth\-passphrase\-file\fR \fI<AUTH_PASSPHRASE_FILE>\fR
مسیر فایلی حاوی عبارت عبور (Passphrase) برای احراز هویت.

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

این گزینه می‌تواند چندین بار مشخص شود که برای دستورات نیازمند چندین نقش به صورت هم‌زمان، لازم است.
در صورت استفاده از چند فایل عبارت عبور، ترتیب آن‌ها اهمیت دارد، زیرا فایل‌ها به ترتیب به کاربران متناظر مشخص‌شده با گزینه «\-\-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_DECRYPT_MESSAGE\fR مشخص شود.
.RE
.TP
[\fIDECRYPT_MODE\fR]
حالت رمزگشایی مورد استفاده.

یکی از مقادیر ["AesCbc", "OaepMd5", "OaepSha1", "OaepSha224", "OaepSha256", "OaepSha384", "OaepSha512", "Pkcs1", "Raw"] (پیش‌فرض "Raw").
.RS
همچنین می‌تواند با متغیر محیطی \fBNETHSM_KEY_DECRYPT_MODE\fR مشخص شود.
.RE