نام (NAME)

tss2_sign - امضای داده‌ها یا خلاصه پیام با استفاده از کلیدی در TPM

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

tss2_sign [OPTIONS]

همچنین ببینید (SEE ALSO)

fapi-config(5) برای تنظیم پارامترهای Fapi مانند نمایهٔ رمزنگاری مورداستفاده و TCTI یا دایرکتوری‌های ذخیره‌سازی فراداده‌های Fapi.

fapi-profile(5) برای تعیین الگوریتم‌ها و پارامترهای رمزنگاری برای تمام کلیدها و عملیات‌های یک تعامل مشخص با TPM مانند الگوریتم درهم‌سازی نام، الگوریتم، طرح و پارامترهای امضای نامتقارن، و انتخاب بانک PCR.

توضیحات (DESCRIPTION)

دستور tss2_sign(1) از یک کلید درونی TPM برای امضای یک مقدار خلاصه (digest) بر اساس طرح‌های امضای TPM طبق آنچه در نمایهٔ رمزنگاری مشخص شده است (ر.ک. fapi-profile(5)) استفاده می‌کند. مقدار خلاصه می‌تواند به عنوان یک آرگومان ارائه شود یا از داده‌هایی که به عنوان آرگومان ارسال شده‌اند محاسبه گردد.

گزینه‌ها (OPTIONS)

گزینه‌های موجود عبارتند از:

•: -p, --keyPath=STRING:

مسیر منتهی به کلید امضاکننده.

•: -s, --padding=STRING:

طرح لایه‌گذاری (padding) مورداستفاده. مقادیر مجاز عبارتند از “RSA_SSA” و “RSA_PSS” (بدون حساسیت به بزرگی و کوچکی حروف). پارامتر اختیاری. در صورت حذف، مقدار پیش‌فرض لایه‌گذاری مشخص‌شده در نمایهٔ رمزنگاری (ر.ک. fapi-profile(5)) استفاده می‌شود.

•: -c, --certificate=FILENAME یا - (برای stdout):

گواهی مرتبط با keyPath در قالب PEM. پارامتر اختیاری.

•: -d, --digest=FILENAME یا - (برای stdin):

داده‌هایی که باید امضا شوند و از قبل درهم‌سازی (hash) شده‌اند.

•: -m, --data=FILENAME یا - (برای stdin):

داده‌هایی که مقدار درهم‌سازی از آن‌ها محاسبه شده و سپس امضا می‌شود.

•: -f, --force:

بازنویسی اجباری فایل خروجی.

•: -k, --publicKey=FILENAME یا - (برای stdout):

کلید عمومی مرتبط با keyPath در قالب PEM. پارامتر اختیاری.

•: -o, --signature=FILENAME یا - (برای stdout):

امضا را به صورت باینری بازمی‌گرداند.

گزینه‌های عمومی (COMMON OPTIONS)

این مجموعه از گزینه‌ها بین تمامی برنامه‌های tss2 مشترک هستند و اطلاعاتی را ارائه می‌دهند که ممکن است مد نظر کاربران باشد.

•: -h, --help [man|no-man]: نمایش صفحهٔ راهنمای (manpage) ابزار. به‌طور پیش‌فرض، تلاش می‌شود تا manpager برای ابزار فراخوانی شود، اما در صورت شکست، خلاصه‌ای کوتاه از عملکرد ابزار خروجی داده خواهد شد. این رفتار مشابه زمانی است که آرگومان گزینهٔ “man” مشخص شده باشد؛ با این حال در صورت درخواست صریح “man”، ابزار خطاهای man را در stderr ارائه می‌دهد. اگر گزینهٔ “no-man” مشخص شود، یا فراخوانی manpager با شکست مواجه گردد، گزینه‌های کوتاه در stdout خروجی داده خواهند شد.

استفادهٔ موفقیت‌آمیز از ویژگی manpages نیازمند نصب بودن صفحات راهنما یا قرار داشتن آن‌ها در مسیر MANPATH است؛ برای جزئیات بیشتر به man(1) مراجعه کنید.

•: -v, --version: نمایش اطلاعات نسخهٔ این ابزار، TCTIهای پشتیبانی‌شده و خروج.

مثال (EXAMPLE)

tss2_sign --keyPath=HS/SRK/myRSASign --padding="RSA_PSS" --digest=digest.file --signature=signature.file --publicKey=publicKey.file

کدهای بازگشتی (RETURNS)

0 در صورت موفقیت، یا 1 در صورت شکست.

اشکالات (BUGS)

گزارش مشکلات در گیت‌هاب (Github Issues)

راهنما (HELP)

مشاهده فهرست پستی (Mailing List)

مجوز (LICENSE)

این اثر تحت مجوز Creative Commons Attribution 4.0 International License (CC BY 4.0) منتشر شده است.