نام (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>

شناسه یکتای اختیاری که به کلید واردشده اختصاص می‌یابد

اگر هیچ مقداری ارائه نشود، یک شناسه عمومی برای کلید ایجاد خواهد شد.

-t, --tags <TAGS>

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

برچسب‌های روی کلیدها برای اعطای دسترسی به آن کلیدها به کاربرانی که برچسب‌های یکسانی دارند، به کار می‌روند.

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

مسیر فایلی حاوی عبارت عبور جهت احراز هویت

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

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

-c, --config <CONFIG>

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

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

-l, --label <LABEL>

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

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

-u, --user <USER>

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

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

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

-h, --help

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

<TSK_FILE>

مسیر فایل کلید محرمانهٔ انتقال‌پذیر (Transferable Secret Key یا TSK) برای وارد کردن