نام (NAME)

nethsm-key-csr - دریافت درخواست امضای گواهی (CSR) برای یک کلید

خلاصه دستور (SYNOPSIS)

nethsm key csr [-f|--force] [-o|--output] [-a|--auth-passphrase-file] [-c|--config] [-l|--label] [-u|--user] [-h|--help] <KEY_ID> <COMMON_NAME> [ORG_NAME] [ORG_UNIT] [LOCALITY] [STATE] [COUNTRY] [EMAIL]

توضیحات (DESCRIPTION)

دریافت یک درخواست امضای گواهی (CSR) برای یک کلید.

درخواست امضای گواهی (CSR) استاندارد PKCS#10 در قالب PEM بازگردانده می‌شود. مگر اینکه فایل خروجی خاصی تعیین شده باشد، گواهی در stdout بازگردانده می‌شود.

دست‌کم مشخصه «Common Name» (CN) برای CSR باید ارائه شود.

کاربران سراسری سیستم در نقش «Administrator» یا «Operator» فقط می‌توانند برای کلیدهای سراسری سیستم CSR ایجاد کنند. کاربران دارای فضای نام (namespaced) در نقش «Administrator» یا «Operator» تنها می‌توانند برای کلیدهای موجود در فضای نام خود CSR ایجاد کنند.

نیازمند احراز هویت کاربری در نقش «Administrator» یا «Operator» است (با دسترسی به کلید - «nethsm key tag» و «nethsm user tag» را ببینید).

گزینه‌ها (OPTIONS)

-f, --force

نوشتن در فایل خروجی حتی در صورت وجود داشتن آن

-o, --output <OUTPUT>

مسیر اختیاری برای یک فایل خروجی مشخص

-a, --auth-passphrase-file <AUTH_PASSPHRASE_FILE>

مسیر فایل حاوی عبارت عبور (passphrase) برای احراز هویت

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

این گزینه می‌تواند چندین بار مشخص شود که برای دستورهای نیازمند به چند نقش به‌طور هم‌زمان لازم است. در صورت استفاده از چند فایل عبارت عبور، ترتیب آنها مهم است؛ زیرا فایل‌ها به کاربر متناظری که با گزینه «--user» مشخص شده اختصاص می‌یابند.

-c, --config <CONFIG>

مسیر یک فایل پیکربندی سفارشی

در صورت مشخص شدن، فایل پیکربندی سفارشی به‌جای مکان پیش‌فرض فایل پیکربندی استفاده می‌شود.

-l, --label <LABEL>

برچسبی که به‌طور یکتا یک دستگاه را در فایل پیکربندی مشخص می‌کند

در صورتی که بیش از یک دستگاه در فایل پیکربندی تنظیم شده باشد، مشخص کردن این گزینه الزامی است.

-u, --user <USER>

نام کاربری که برای اجرای دستور استفاده می‌شود

اگر نام کاربری در فایل پیکربندی برای یک دستگاه تنظیم نشده باشد، می‌تواند ارائه شود. اگر چندین نام کاربری با نقش هدف یکسان در فایل پیکربندی برای یک دستگاه تنظیم شده باشند، ارائه آن الزامی است.

این گزینه می‌تواند چندین بار مشخص شود که برای دستورهای نیازمند به چند نقش به‌طور هم‌زمان لازم است.

-h, --help

چاپ راهنما (مشاهده خلاصه با '-h')

<KEY_ID>

شناسه کلید که قرار است برای آن CSR ایجاد شود

<COMMON_NAME>

مشخصه اجباری «Common Name» (CN) برای CSR

یک نام دامنه کاملاً واجد شرایط (FQDN) که باید با استفاده از CSR امن شود.

[ORG_NAME]

مشخصه اختیاری «Organization Name» (O) برای CSR

معمولاً نام حقوقی یک شرکت یا نهاد است و باید شامل پسوندهایی مانند .Ltd یا .Inc یا .Corp باشد.

[ORG_UNIT]

مشخصه اختیاری «Organizational Unit» (OU) برای CSR

نام بخش یا واحد سازمانی داخلی.

[LOCALITY]

مشخصه اختیاری «Locality» (L) برای CSR

نام شهرک، شهر، روستا و غیره.

[STATE]

مشخصه اختیاری «State» (ST) برای CSR

استان، منطقه، شهرستان یا ایالت.

[COUNTRY]

مشخصه اختیاری «Country» (C) برای CSR

کد دوحرفی ISO برای کشوری که «Organization» (O) در آن واقع شده است.

[EMAIL]

مشخصه اختیاری «Email Address» (EMAIL) برای CSR

اطلاعات تماس سازمان، معمولاً مربوط به مدیر گواهی یا بخش فناوری اطلاعات (IT).