نام (NAME)

tss2_quote - انجام تصدیق اصالت با استفاده از TPM

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

tss2_quote [OPTIONS]

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

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

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

توضیحات (DESCRIPTION)

دستور tss2_quote(1) یک تصدیق اصالت (attestation) را با استفاده از TPM انجام می‌دهد. بانک PCR برای هر اندیس ارائه‌شده از PCR و طرح امضا در نمایه رمزنگاری تنظیم می‌شوند (رجوع کنید به fapi-profile(5)).

گزینه‌ها (OPTIONS)

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

•: -x, --pcrList=STRING:

آرایه‌ای شامل اندیس‌های PCR برای اعمال عملیات quote.

•: -Q, --qualifyingData=FILENAME یا - (برای stdin):

یک نانس (nonce) ارائه‌شده توسط فراخوان‌کننده جهت اطمینان از تازگی امضا. پارامتر اختیاری.

•: -l, --pcrLog=FILENAME یا - (برای stdout):

لاگ PCR را برای PCR انتخاب‌شده بازمی‌گرداند. پارامتر اختیاری.

لاگ‌های رویداد PCR فهرستی (آرایه JSON با طول دلخواه) از مدخل‌های لاگ با محتوای زیر هستند:

- recnum: شماره رکورد یکتا
- pcr: اندیس PCR
- digest: خلاصه‌ها (digests)
- type: نوع رویداد. در حال حاضر تنها مقدار ممکن: "LINUX_IMA" (نسخه قدیمی IMA)
- eventDigest: خلاصه رویداد؛ برای مثال خلاصه فایل اندازه‌گیری‌شده
- eventName: نام رویداد؛ برای مثال نام فایل اندازه‌گیری‌شده.

•: -f, --force:

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

•: -p, --keyPath=STRING:

کلید امضا را مشخص می‌کند.

•: -q, --quoteInfo=FILENAME یا - (برای stdout):

یک ساختار با کدگذاری JSON شامل ورودی‌های عملیات quote را بازمی‌گرداند. این ساختار شامل مقدار درهم‌سازی (digest) و مقادیر PCR است.

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

امضای اعمال‌شده بر روی داده‌های quote را بازمی‌گرداند.

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

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

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

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

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

برای استفاده موفق از قابلیت صفحات راهنما، لازم است که این صفحات نصب شده یا در MANPATH موجود باشند؛ برای جزئیات بیشتر به man(1) رجوع کنید.

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

مثال‌ها (EXAMPLES)

tss2_quote --keyPath=HS/SRK/quotekey --pcrList="10,16" --qualifyingData=qualifyingData.file --signature=signature.file --pcrLog=pcrLog.file --certificate=certificate.file --quoteInfo=quoteInfo.info

وضعیت خروج (EXIT STATUS)

0 در صورت موفقیت، یا 1 در صورت بروز خطا.

گزارش باگ‌ها (BUGS)

مسائل گیت‌هاب (Github Issues)

راهنما (HELP)

به فهرست رایانامه (Mailing List) مراجعه کنید.

کپی‌رایت و تکثیر (COPYRIGHT)

این اثر تحت مجوز کریتیو کامنز ارجاع نسخه 4.0 بین‌المللی (CC BY 4.0) منتشر شده است.