.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH nethsm-key-csr 1  "nethsm-key-csr " 
.SH "نام (NAME)"
nethsm\-key\-csr \- دریافت درخواست امضای گواهی (CSR) برای یک کلید
.SH "خلاصه دستور (SYNOPSIS)"
\fBnethsm key 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] <\fIKEY_ID\fR> <\fICOMMON_NAME\fR> [\fIORG_NAME\fR] [\fIORG_UNIT\fR] [\fILOCALITY\fR] [\fISTATE\fR] [\fICOUNTRY\fR] [\fIEMAIL\fR] 
.SH "توضیحات (DESCRIPTION)"
دریافت یک درخواست امضای گواهی (CSR) برای یک کلید.
.PP
درخواست امضای گواهی (CSR) استاندارد PKCS#10 در قالب PEM بازگردانده می‌شود.
مگر اینکه فایل خروجی خاصی تعیین شده باشد، گواهی در stdout بازگردانده می‌شود.
.PP
دست‌کم مشخصه «Common Name» (CN) برای CSR باید ارائه شود.
.PP
کاربران سراسری سیستم در نقش «Administrator» یا «Operator» فقط می‌توانند برای کلیدهای سراسری سیستم CSR ایجاد کنند.
کاربران دارای فضای نام (namespaced) در نقش «Administrator» یا «Operator» تنها می‌توانند برای کلیدهای موجود در فضای نام خود CSR ایجاد کنند.
.PP
نیازمند احراز هویت کاربری در نقش «Administrator» یا «Operator» است (با دسترسی به کلید \- «nethsm key tag» و «nethsm user tag» را ببینید).
.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_KEY_CSR_OUTPUT_FILE\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>
شناسه کلید که قرار است برای آن CSR ایجاد شود
.RS
همچنین می‌تواند با متغیر محیطی \fBNETHSM_KEY_ID\fR مشخص شود. 
.RE
.TP
<\fICOMMON_NAME\fR>
مشخصه اجباری «Common Name» (CN) برای CSR

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

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

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

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

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

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

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