نام (NAME)

tss2_createseal - ایجاد یک شیء مهر و موم شده و ذخیره آن در مخزن متاداده FAPI

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

tss2_createseal [OPTIONS]

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

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

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

توضیحات (DESCRIPTION)

دستور tss2_createseal(1) یک شیء مهر و موم شده (sealed object) ایجاد کرده و آن را در مخزن متاداده FAPI ذخیره می‌کند. اگر هیچ داده‌ای ارائه نشود (یعنی یک اشاره‌گر NULL)، آن‌گاه TPM داده‌های تصادفی تولید کرده و شیء مهر و موم شده را با آن پر می‌کند. طرح‌های امضای TPM همان‌طور که در نمایه رمزنگاری مشخص شده است مورد استفاده قرار می‌گیرند (نگاه کنید به fapi-profile(5)).

گزینه‌ها (OPTIONS)

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

•: -p, --path=STRING:

مسیر کلید جدید.

•: -t, --type=STRING:

کاربری مد نظر را مشخص می‌کند. پارامتر اختیاری. نوع‌ها می‌توانند هر ترکیبی از مقادیر زیر باشند که با کاما از هم جدا شده‌اند:

- "exportable": Clears the fixedTPM and fixedParent attributes of a key or
  sealed object.
- "noda": Sets the noda attribute of a key or NV index.
- "system": Stores the data blobs and metadata for a created key or seal
  in the system-wide directory instead of user's personal directory.
- A hexadecimal number (e.g. "0x81000001"): Marks a key object to be
  made persistent and sets the persistent object handle to this value.

•: -P, --policyPath=STRING:

سیاستی که باید به کلید جدید مرتبط شود را مشخص می‌کند. پارامتر اختیاری. در صورت حذف شدن، هیچ سیاستی با کلید مرتبط نخواهد شد.

یک policyPath از دو بخش تشکیل شده است که با “/” از یکدیگر جدا می‌شوند. یک policyPath با “/policy” آغاز می‌شود. بخش دوم مسیر، سیاست یا الگوی سیاست را با استفاده از یک نام معنادار مشخص می‌کند.

•: -a, --authValue=STRING:

گذرواژه جدید با کدگذاری UTF-8. پارامتر اختیاری. اگر نادیده گرفته شود، گذرواژه به صورت تعاملی از کاربر پرسیده می‌شود. برای تنظیم نکردن هیچ گذرواژه‌ای، این گزینه باید با یک رشته خالی (““) استفاده شود. حداکثر طول گذرواژه توسط اندازه دایجست الگوریتم درهم‌سازی نام انتخاب‌شده در نمایه رمزنگاری تعیین می‌شود (نگاه کنید به fapi-profile(5)). به عنوان مثال، انتخاب SHA256 به عنوان الگوریتم درهم‌سازی، امکان استفاده از گذرواژه‌هایی با حداکثر طول ۳۲ نویسه را فراهم می‌کند.

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

داده‌هایی که باید توسط TPM مهر و موم شوند. پارامتر اختیاری. نباید همراه با --size استفاده شود.

•: -s, --size=INTEGER:

تعداد بایت‌های تصادفی را مشخص می‌کند که TPM باید تولید کرده و مهر و موم کند. پارامتر اختیاری. نباید مقدار “0” باشد. نباید همراه با --data استفاده شود.

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

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

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

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

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

مثال‌ها (EXAMPLES)

ایجاد یک کلید با گذرواژه “abc” و خواندن داده‌های مهر و موم از فایل.

tss2_createseal --path=HS/SRK/mySealKey --type="noDa" --authValue=abc --data=data.file

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

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

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

Github Issues

راهنما (HELP)

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

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

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