nethsm-openpgp-import(1)    General Commands Manual   nethsm-openpgp-import(1)

نام (NAME)
       nethsm-openpgp-import - وارد کردن کلید خصوصی با قالب TSK در OpenPGP

خلاصه دستور (SYNOPSIS)
       nethsm openpgp import [-k|--key-id] [-t|--tags]
       [-a|--auth-passphrase-file] [-c|--config] [-l|--label] [-u|--user]
       [-h|--help] <TSK_FILE>

توضیحات (DESCRIPTION)
       وارد کردن کلید خصوصی در قالب کلید محرمانهٔ انتقال‌پذیر (TSK) اوپن‌پی‌جی‌پی
       (OpenPGP Transferable Secret Key)

       تنها از TSKهایی با یک مؤلفه کلید (single component key) پشتیبانی می‌شود.

       کاربران سراسری سیستم در نقش «Administrator» تنها می‌توانند TSKها را به
       عنوان کلیدهای سراسری وارد کنند.  کاربران دارای فضای نام در نقش
       «Administrator» تنها می‌توانند TSKها را به عنوان کلیدها در فضای نام
       خودشان وارد کنند.

       نکته: با این‌که اختصاص برچسب‌ها به کلید جدید اختیاری است، اما اکیداً توصیه
       می‌شود؛ زیرا عدم انجام این کار بدان معناست که همهٔ کاربران در همان حوزه
       (scope) به آن دسترسی خواهند داشت!

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

گزینه‌ها (OPTIONS)
       -k, --key-id <KEY_ID>
              شناسه یکتای اختیاری که به کلید واردشده اختصاص می‌یابد

              اگر هیچ مقداری ارائه نشود، یک شناسه عمومی برای کلید ایجاد خواهد
              شد.
              همچنین می‌تواند از طریق متغیر محیطی NETHSM_OPENPGP_KEY_ID مشخص
              شود.

       -t, --tags <TAGS>
              فهرست اختیاری از برچسب‌هایی که به کلید واردشده اختصاص می‌یابند

              برچسب‌های روی کلیدها برای اعطای دسترسی به آن کلیدها به کاربرانی
              که برچسب‌های یکسانی دارند، به کار می‌روند.
              همچنین می‌تواند از طریق متغیر محیطی NETHSM_OPENPGP_KEY_TAGS مشخص
              شود.

       -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')

       <TSK_FILE>
              مسیر فایل کلید محرمانهٔ انتقال‌پذیر (Transferable Secret Key یا
              TSK) برای وارد کردن
              همچنین می‌تواند از طریق متغیر محیطی NETHSM_OPENPGP_TSK_FILE مشخص
              شود.

                            nethsm-openpgp-import     nethsm-openpgp-import(1)