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

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

خلاصه دستور (SYNOPSIS)
       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]

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

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

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

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

گزینه‌ها (OPTIONS)
       -f, --force
              نوشتن در فایل خروجی حتی در صورت وجود داشتن آن از قبل
              همچنین می‌توان آن را با متغیر محیطی NETHSM_FORCE مشخص کرد.

       -o, --output <OUTPUT>
              مسیر اختیاری فایلی مشخص که گواهی در آن نوشته می‌شود
              همچنین می‌توان آن را با متغیر محیطی
              NETHSM_CONFIG_TLS_CSR_OUTPUT_FILE مشخص کرد.

       -a, --auth-passphrase-file <AUTH_PASSPHRASE_FILE>
              مسیر فایلی شامل عبارت عبور برای احراز هویت

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

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

       -c, --config <CONFIG>
              مسیر فایل پیکربندی سفارشی

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

       -l, --label <LABEL>
              برچسبی که به صورت یکتا یک دستگاه را در فایل پیکربندی مشخص می‌کند

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

       -u, --user <USER>
              نام کاربری که برای اجرای دستور استفاده می‌شود

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

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

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

       -h, --help
              نمایش راهنما (مشاهده خلاصه با '-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
                                                  nethsm-config-get-tls-csr(1)