.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH nethsm-config-get-tls-csr 1  "nethsm-config-get-tls-csr " 
.SH "نام (NAME)"
nethsm\-config\-get\-tls\-csr \- دریافت درخواست امضای گواهی (CSR) برای گواهی امنیتی TLS
.SH "خلاصه دستور (SYNOPSIS)"
\fBnethsm config get tls\-csr\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] <\fICOMMON_NAME\fR> [\fIORG_NAME\fR] [\fIORG_UNIT\fR] [\fILOCALITY\fR] [\fISTATE\fR] [\fICOUNTRY\fR] [\fIEMAIL\fR] 
.SH "توضیحات (DESCRIPTION)"
دریافت درخواست امضای گواهی (CSR) برای گواهی TLS
.PP
درخواست امضای گواهی PKCS#10 (CSR) در قالب استاندارد PEM (Privacy\-enhanced Electronic Mail) بازگردانده می‌شود.
مگر در حالتی که فایل خروجی مشخصی انتخاب شده باشد، درخواست امضا در خروجی استاندارد (stdout) بازگردانده می‌شود.
.PP
حداقل مشخصه «Common Name» (CN) برای CSR باید ارائه شود.
.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_CSR_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)
.TP
<\fICOMMON_NAME\fR>
مشخصه اجباری «Common Name» (CN) برای CSR

یک نام دامنه کاملاً معتبر (FQDN) که باید با استفاده از CSR ایمن شود.
.RS
همچنین می‌توان آن را با متغیر محیطی \fBNETHSM_TLS_CSR_COMMON_NAME\fR مشخص کرد. 
.RE
.TP
[\fIORG_NAME\fR]
مشخصه اختیاری «Organization Name» (O) برای CSR

معمولاً نام قانونی شرکت یا نهاد است و باید شامل پسوندهایی مانند Ltd.، Inc. یا Corp باشد.
.RS
همچنین می‌توان آن را با متغیر محیطی \fBNETHSM_TLS_CSR_ORG_NAME\fR مشخص کرد. 
.RE
.TP
[\fIORG_UNIT\fR]
مشخصه اختیاری «Organizational Unit» (OU) برای CSR

نام بخش یا دپارتمان داخلی سازمان.
.RS
همچنین می‌توان آن را با متغیر محیطی \fBNETHSM_TLS_CSR_ORG_UNIT\fR مشخص کرد. 
.RE
.TP
[\fILOCALITY\fR]
مشخصه اختیاری «Locality» (L) برای CSR

نام شهرک، شهر، روستا و غیره.
.RS
همچنین می‌توان آن را با متغیر محیطی \fBNETHSM_TLS_CSR_LOCALITY\fR مشخص کرد. 
.RE
.TP
[\fISTATE\fR]
مشخصه اختیاری «State» (ST) برای CSR

استان، منطقه، شهرستان یا ایالت.
.RS
همچنین می‌توان آن را با متغیر محیطی \fBNETHSM_TLS_CSR_STATE\fR مشخص کرد. 
.RE
.TP
[\fICOUNTRY\fR]
مشخصه اختیاری «Country» (C) برای CSR

کد دوحرفی ISO برای کشوری که «سازمان» (O) در آن واقع شده است.
.RS
همچنین می‌توان آن را با متغیر محیطی \fBNETHSM_TLS_CSR_COUNTRY\fR مشخص کرد. 
.RE
.TP
[\fIEMAIL\fR]
مشخصه اختیاری «Email Address» (EMAIL) برای CSR

اطلاعات تماس سازمان، معمولاً متعلق به مدیر گواهی یا بخش فناوری اطلاعات (IT).
.RS
همچنین می‌توان آن را با متغیر محیطی \fBNETHSM_TLS_CSR_EMAIL\fR مشخص کرد. 
.RE