نام (NAME)

nethsm-key-sign - امضای یک پیام با استفاده از یک کلید

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

nethsm key sign [-f|--force] [-o|--output] [-a|--auth-passphrase-file] [-c|--config] [-l|--label] [-u|--user] [-h|--help] <KEY_ID> <SIGNATURE_TYPE> <MESSAGE>

توضیحات (DESCRIPTION)

امضای یک پیام با استفاده از یک کلید.

کلید مورد نظر باید به سازوکارهای کلید مربوطه برای امضا مجهز باشد. نوع امضای انتخاب‌شده باید با نوع کلید هدف و سازوکارهای کلید مطابقت داشته باشد.

اگر هیچ فایل خروجی مشخصی انتخاب نشود، امضا در خروجی استاندارد (stdout) نوشته می‌شود.

کاربران سراسری (System-wide) با نقش «اپراتور» (Operator) تنها می‌توانند با استفاده از کلیدهای سراسری برای پیام‌ها امضا ایجاد کنند. کاربران دارای فضای نام (Namespaced) با نقش «اپراتور» (Operator) تنها می‌توانند با کلیدهای موجود در فضای نام خودشان برای پیام‌ها امضا ایجاد کنند.

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

گزینه‌ها (OPTIONS)

-f, --force

نوشتن در فایل خروجی حتی در صورتی که از قبل وجود داشته باشد.

-o, --output <OUTPUT>

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

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

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

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

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

-c, --config <CONFIG>

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

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

-l, --label <LABEL>

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

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

-u, --user <USER>

نام کاربری مورد استفاده برای یک دستور.

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

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

-h, --help

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

<KEY_ID>

شناسه کلید مورد استفاده برای امضای پیام.

<SIGNATURE_TYPE>

نوع امضای مورد استفاده برای امضا.

یکی از مقادیر ["EcdsaP256", "EcdsaP384", "EcdsaP521", "EdDsa", "Pkcs1", "PssMd5", "PssSha1", "PssSha224", "PssSha256", "PssSha384", "PssSha512"].

<MESSAGE>

مسیر پیامی که باید برای آن امضا ایجاد شود.