نام (NAME)

tss2_verifyquote - اعتبارسنجی صحت داده‌های بازگردانده‌شده توسط یک quote

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

tss2_verifyquote [OPTIONS]

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

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

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

توضیحات (DESCRIPTION)

دستور tss2_verifyquote(1) معتبر بودن داده‌های بازگردانده‌شده توسط یک quote را تأیید می‌کند. این فرایند شامل موارد زیر است:

•: بازسازی مقادیر PCR مربوط به quoteInfo از روی eventLog (در صورتی که eventLog ارائه شده باشد)
•: اعتبارسنجی quoteInfo با استفاده از امضا و publicKeyPath

طرح‌وارهٔ اعتبارسنجی امضای استفاده‌شده در نمایهٔ رمزنگاری مشخص می‌شود (نگاه کنید به fapi-profile(5)).

برنامه‌ای که از ()tss2_verifyquote استفاده می‌کند، علاوه بر این باید موارد زیر را انجام دهد:

•: ارزیابی میزان قابل اعتماد بودن publicKey
•: ارزیابی میزان قابل اعتماد بودن مدخل‌های eventLog

گزینه‌ها (OPTIONS)

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

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

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

•: -l، --pcrLog=FILENAME یا - (برای stdin):

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

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

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

•: -q، --quoteInfo=FILENAME یا - (برای stdin):

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

•: -k، --publicKeyPath=STRING:

کلید امضاکننده را مشخص می‌کند. می‌تواند مسیری به سلسله‌مراتب کلید عمومی /ext باشد.

•: -i، --signature=FILENAME یا - (برای stdin):

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

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

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

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

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

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

مثال‌ها (EXAMPLES)

tss2_verifyquote --publicKeyPath="ext/myNewParent" --qualifyingData=qualifyingData.file --quoteInfo=quoteInfo.file --signature=signature.file --pcrLog=pcrLog.file

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

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

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

Github Issues

راهنما (HELP)

مشاهدهٔ Mailing List

مجوز (LICENSE)

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