tss2_createkey(1) General Commands Manual tss2_createkey(1)

tss2_createkey - ایجاد کلید درون TPM

tss2_createkey [OPTIONS]

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

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

دستور tss2_createkey(1) یک کلید درون TPM ایجاد کرده و آن را در مخزن فراداده FAPI و در صورت درخواست، به‌صورت پایا درون TPM ذخیره می‌کند. بسته به نوع کلید مشخص‌شده، الگوریتم‌ها و پارامترهای رمزنگاری کلید ایجادشده بر اساس نمایه رمزنگاری متناظر تعیین می‌شوند (ر.ک. fapi-profile(5)).

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

•
-p, --path=STRING:

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

•
-t, --type=STRING:

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

- "sign": صفت sign کلید را تنظیم می‌کند.
- "decrypt": صفت decrypt کلید را تنظیم می‌کند.
- راهنما: در صورتی که نه sign و نه decrypt مشخص شوند، هر دو صفت تنظیم می‌شوند.
- "restricted": صفت restricted کلید را تنظیم می‌کند.
- راهنما: اگر restricted تنظیم شود، باید sign یا decrypt (اما نه هر دو) تنظیم شوند.
- "exportable": صفت‌های fixedTPM و fixedParent کلید یا
  شیء مهروموم‌شده را پاک می‌کند.
- "noda": صفت noda کلید یا NV index را تنظیم می‌کند.
- "system": داده‌های دوتایی (blobs) و فراداده‌ها را برای کلید یا شیء
  مهروموم‌شده در دایرکتوری سراسری سیستم به‌جای دایرکتوری شخصی کاربر ذخیره می‌کند.
- یک عدد هگزادسیمال (مانند "0x81000001"): شیء کلید را برای پایا
  شدن نشانه‌گذاری کرده و هندل شیء پایا را روی این مقدار تنظیم می‌کند.
•
-P, --policyPath=STRING:

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

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

•
-a, --authValue=STRING:

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

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

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

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

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

tss2_createkey --path=HS/SRK/myRsaCryptKey --type="noDa, decrypt" --authValue=""

tss2_createkey --path=HS/SRK/myRsaCryptKey --type="noDa, decrypt"

tss2_createkey --path=HS/SRK/myRsaCryptKey --type="noDa, decrypt" --authValue=abc

۰ در صورت موفقیت یا ۱ در صورت شکست.

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

ببینید فهرست پستی (Mailing List)

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

APRIL 2019 tpm2-tools