.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH nethsm-config-get-tls-certificate 1  "nethsm-config-get-tls-certificate "
.SH "نام (NAME)"
nethsm\-config\-get\-tls\-certificate \- دریافت گواهی امنیتی TLS دستگاه NetHSM
.SH "خلاصه دستور (SYNOPSIS)"
\fBnethsm config get tls\-certificate\fR [\fB\-f\fR|\fB\-\-force\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]
.SH "توضیحات (DESCRIPTION)"
دریافت گواهی برای اتصال TLS
.PP
گواهی X.509 در قالب استاندارد PEM (Privacy\-enhanced Electronic Mail) بازگردانده می‌شود.
مگر در حالتی که فایل خروجی مشخصی تعیین شده باشد، گواهی در خروجی استاندارد (stdout) چاپ می‌شود.
.PP
نیازمند احراز هویت یک کاربر سراسری سیستم در نقش «Administrator» است.
.SH "گزینه‌ها (OPTIONS)"
.TP
\fB\-f\fR, \fB\-\-force\fR
نوشتن در فایل خروجی حتی در صورت وجود داشتن آن از قبل
.RS
همچنین می‌توان آن را با متغیر محیطی \fBNETHSM_FORCE\fR مشخص کرد.
.RE
.TP
\fB\-o\fR, \fB\-\-output\fR \fI<OUTPUT>\fR
مسیر اختیاری فایلی مشخص که گواهی در آن نوشته می‌شود
.RS
همچنین می‌توان آن را با متغیر محیطی \fBNETHSM_CONFIG_TLS_CERT_OUTPUT_FILE\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)