nethsm-config-get-tls-csr(1) General Commands Manual nethsm-config-get-tls-csr(1)

nethsm-config-get-tls-csr - دریافت درخواست امضای گواهی (CSR) برای گواهی امنیتی TLS

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

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

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

حداقل مشخصه «Common Name» (CN) برای CSR باید ارائه شود.

نیازمند احراز هویت یک کاربر سراسری سیستم در نقش «Administrator» است.

نوشتن در فایل خروجی حتی در صورت وجود داشتن آن از قبل
همچنین می‌توان آن را با متغیر محیطی NETHSM_FORCE مشخص کرد.
مسیر اختیاری فایلی مشخص که گواهی در آن نوشته می‌شود
همچنین می‌توان آن را با متغیر محیطی NETHSM_CONFIG_TLS_CSR_OUTPUT_FILE مشخص کرد.
مسیر فایلی شامل عبارت عبور برای احراز هویت

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

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

همچنین می‌توان آن را با متغیر محیطی NETHSM_AUTH_PASSPHRASE_FILE مشخص کرد.
مسیر فایل پیکربندی سفارشی

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

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

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

همچنین می‌توان آن را با متغیر محیطی NETHSM_LABEL مشخص کرد.
نام کاربری که برای اجرای دستور استفاده می‌شود

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

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

همچنین می‌توان آن را با متغیر محیطی NETHSM_USER مشخص کرد.
نمایش راهنما (مشاهده خلاصه با '-h')
<COMMON_NAME>
مشخصه اجباری «Common Name» (CN) برای CSR

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

همچنین می‌توان آن را با متغیر محیطی NETHSM_TLS_CSR_COMMON_NAME مشخص کرد.
[ORG_NAME]
مشخصه اختیاری «Organization Name» (O) برای CSR

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

همچنین می‌توان آن را با متغیر محیطی NETHSM_TLS_CSR_ORG_NAME مشخص کرد.
[ORG_UNIT]
مشخصه اختیاری «Organizational Unit» (OU) برای CSR

نام بخش یا دپارتمان داخلی سازمان.

همچنین می‌توان آن را با متغیر محیطی NETHSM_TLS_CSR_ORG_UNIT مشخص کرد.
[LOCALITY]
مشخصه اختیاری «Locality» (L) برای CSR

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

همچنین می‌توان آن را با متغیر محیطی NETHSM_TLS_CSR_LOCALITY مشخص کرد.
[STATE]
مشخصه اختیاری «State» (ST) برای CSR

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

همچنین می‌توان آن را با متغیر محیطی NETHSM_TLS_CSR_STATE مشخص کرد.
[COUNTRY]
مشخصه اختیاری «Country» (C) برای CSR

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

همچنین می‌توان آن را با متغیر محیطی NETHSM_TLS_CSR_COUNTRY مشخص کرد.
[EMAIL]
مشخصه اختیاری «Email Address» (EMAIL) برای CSR

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

همچنین می‌توان آن را با متغیر محیطی NETHSM_TLS_CSR_EMAIL مشخص کرد.
nethsm-config-get-tls-csr