.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH nethsm-config-set-tls-generate 1  "nethsm-config-set-tls-generate " 
.SH "نام (NAME)"
nethsm\-config\-set\-tls\-generate \- تولید یک گواهی TLS جدید
.SH "خلاصه دستور (SYNOPSIS)"
\fBnethsm config set tls\-generate\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] [\fITLS_KEY_TYPE\fR] [\fITLS_KEY_LENGTH\fR] 
.SH "توضیحات (DESCRIPTION)"
تولید یک گواهی TLS جدید
.PP
گواهی TLS فعلی با گواهی تازه تولیدشده جایگزین می‌شود.
به طور اختیاری، نوع کلید و طول آن قابل تعیین است.
.PP
نیازمند احراز هویت یک کاربر سراسری سیستم در نقش "Administrator" است.
.SH "گزینه‌ها (OPTIONS)"
.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
[\fITLS_KEY_TYPE\fR]
نوع کلید اختیاری گواهی TLS برای تولید

یکی از موارد ["Curve25519", "EcP224", "EcP256", "EcP384", "EcP521", "Rsa"] (پیش‌فرض "Rsa" است).
.RS
همچنین می‌تواند از طریق متغیر محیطی \fBNETHSM_TLS_KEY_TYPE\fR مشخص شود. 
.RE
.TP
[\fITLS_KEY_LENGTH\fR]
طول بیتی اختیاری کلید TLS برای تولید

طول بیت باید با نوع کلید انتخاب‌شده سازگار باشد.

نیازمند احراز هویت یک کاربر در نقش "Administrator" است.
.RS
همچنین می‌تواند از طریق متغیر محیطی \fBNETHSM_TLS_KEY_LENGTH\fR مشخص شود. 
.RE