.\" Automatically generated by Pandoc 3.6.1 .\" .TH "tpm2_zgen2phase" "1" "" "tpm2\-tools" "General Commands Manual" .SH "نام (NAME)" tpm2_zgen2phase \- دستوری برای فعال‌سازی TPM جهت ترکیب داده‌های طرف مقابل با کلید موقت تولیدشده در فاز نخست پروتکل‌های تبادل کلید دومرحله‌ای .SH "خلاصه دستور (SYNOPSIS)" \f[B]tpm2_zgen2phase\f[R] [\f[I]OPTIONS\f[R]] .SH "توضیحات (DESCRIPTION)" \f[B]tpm2_zgen2phase\f[R](1) \- دستوری برای فعال‌سازی TPM جهت ترکیب داده‌های طرف مقابل با کلید موقت (ephemeral key) تولیدشده در فاز نخست پروتکل‌های تبادل کلید دومرحله‌ای (two\-phase key exchange). .SH "گزینه‌ها (OPTIONS)" .IP \[bu] 2 \f[B]\-c\f[R], \f[B]\-\-key\-context\f[R]=\f[I]FILE\f[R]: .RS 2 .PP شیء زمینه (context object) که به کلید ECC اشاره دارد. می‌تواند یک فایل یا شماره اشاره‌گر (handle) باشد. بخش \[lq]Context Object Format\[rq] را ببینید. .RE .IP \[bu] 2 \f[B]\-p\f[R], \f[B]\-\-key\-auth\f[R]=\f[I]AUTH\f[R]: .RS 2 .PP مقدار احراز هویت برای شیء کلید ECC. .RE .IP \[bu] 2 \f[B]\-s\f[R], \f[B]\-\-scheme\f[R]=\f[I]ALGORITHM\f[R]: .RS 2 .PP طرح تبادل کلید (key exchange scheme). اختیاری است. گزینه‌های معتبر شامل ecdh یا sm2 هستند. .RE .IP \[bu] 2 \f[B]\-t\f[R], \f[B]\-\-counter\f[R]=\f[I]NATURALNUMBER\f[R]: .RS 2 .PP تعداد commit برای تعیین نمایه کلید مورد استفاده. .RE .IP \[bu] 2 \f[B]\-\-static\-public\f[R]=\f[I]FILE\f[R]: .RS 2 .PP ورودی کلید عمومی ایستا (static public key) متعلق به طرف مقابل. .RE .IP \[bu] 2 \f[B]\-\-ephemeral\-public\f[R]=\f[I]FILE\f[R]: .RS 2 .PP ورودی کلید عمومی موقت (ephemeral public key) متعلق به طرف مقابل. .RE .IP \[bu] 2 \f[B]\-\-output\-Z1\f[R]=\f[I]FILE\f[R] .RS 2 .PP مسیر فایل را برای ذخیره نقطه سری Z1 محاسبه‌شده در ecdh مشخص می‌کند. .RE .IP \[bu] 2 \f[B]\-\-output\-Z2\f[R]=\f[I]FILE\f[R] .RS 2 .PP مسیر فایل را برای ذخیره نقطه سری Z2 محاسبه‌شده در ecdh مشخص می‌کند. .RE .SS مراجع (References) .SH "مشخص‌کننده‌های الگوریتم (Algorithm Specifiers)" گزینه‌هایی که الگوریتم می‌پذیرند، از \[lq]nice\-names\[rq] پشتیبانی می‌کنند. .PP دو دسته رشته اصلی برای تعیین الگوریتم وجود دارد: ساده و پیچیده. تنها الگوریتم‌های خاصی بر اساس نوع استفاده و شرایط توسط TPM پذیرفته می‌شوند. .SS مشخص‌کننده‌های ساده (Simple specifiers) این‌ها رشته‌هایی بدون داده‌های مشخص‌کننده اضافی هستند. هنگام ایجاد اشیاء، بخش‌های تعیین‌نشده یک شیء به صورت پیش‌فرض در نظر گرفته می‌شوند. می‌توانید فهرست \[lq]مشخص‌کننده‌های ساده\[rq] شناخته‌شده را در زیر بیابید. .SS نامتقارن (Asymmetric) .IP \[bu] 2 rsa .IP \[bu] 2 ecc.SS "متقارن (Symmetric)" .IP \[bu] 2 aes .IP \[bu] 2 camellia .IP \[bu] 2 sm4 .SS "الگوریتم‌های درهم‌سازی (Hashing Algorithms)" .IP \[bu] 2 sha1 .IP \[bu] 2 sha256 .IP \[bu] 2 sha384 .IP \[bu] 2 sha512 .IP \[bu] 2 sm3_256 .IP \[bu] 2 sha3_256 .IP \[bu] 2 sha3_384 .IP \[bu] 2 sha3_512 .SS "درهم‌سازی کلیددار (Keyed Hash)" .IP \[bu] 2 hmac .IP \[bu] 2 xor .SS "طرح‌های امضا (Signing Schemes)" .IP \[bu] 2 rsassa .IP \[bu] 2 rsapss .IP \[bu] 2 ecdsa .IP \[bu] 2 ecdaa .IP \[bu] 2 ecschnorr .IP \[bu] 2 sm2 .SS "طرح‌های رمزنگاری نامتقارن (Asymmetric Encryption Schemes)" .IP \[bu] 2 oaep .IP \[bu] 2 rsaes .IP \[bu] 2 ecdh .SS "حالت‌ها (Modes)" .IP \[bu] 2 ctr .IP \[bu] 2 ofb .IP \[bu] 2 cbc .IP \[bu] 2 cfb .IP \[bu] 2 ecb .SS "متفرقه (Misc)" .IP \[bu] 2 null .SS "مشخص‌کننده‌های پیچیده (Complex Specifiers)" اشیاء، هنگامی که برای ایجاد توسط TPM تعیین می‌شوند، الگوریتم‌های متعددی دارند که در داده‌های عمومی مقداردهی می‌شوند. مواردی مانند نوع، طرح و جزئیات نامتقارن، اندازهٔ کلید و غیره. در ادامه قالب کلی برای تعیین این داده‌ها آمده است: \f[CR]::\f[R] .SS "مشخص‌کننده‌های نوع (Type Specifiers)" این بخش از مشخص‌کنندهٔ پیچیدهٔ الگوریتم الزامی است. جزئیات باقی‌ماندهٔ طرح و الگوریتم متقارن بر اساس نوع مشخص‌شده و نوع شیء در حال ایجاد، پیش‌فرض‌گذاری خواهند شد. .IP \[bu] 2 aes \- پیش‌فرض AES: aes128 .IP \[bu] 2 aes128\f[CR]\f[R] \- الگوریتم AES ۱۲۸ بیتی با حالت اختیاری (\f[I]ctr\f[R]|\f[I]ofb\f[R]|\f[I]cbc\f[R]|\f[I]cfb\f[R]|\f[I]ecb\f[R]). اگر حالت مشخص نشود، پیش‌فرض \f[I]null\f[R] است. .IP \[bu] 2 aes192\f[CR]\f[R] \- مشابه aes128\f[CR]\f[R]، به جز اندازهٔ کلید که ۱۹۲ بیتی است. .IP \[bu] 2 aes256\f[CR]\f[R] \- مشابه aes128\f[CR]\f[R]، به جز اندازهٔ کلید که ۲۵۶ بیتی است. .IP \[bu] 2 sm4 \- پیش‌فرض SM4: sm4128 .IP \[bu] 2 sm4128 یا sm4_128 \f[CR]\f[R] \- الگوریتم SM4 ۱۲۸ بیتی با حالت اختیاری (\f[I]ctr\f[R]|\f[I]ofb\f[R]|\f[I]cbc\f[R]|\f[I]cfb\f[R]|\f[I]ecb\f[R]). اگر حالت مشخص نشود، پیش‌فرض \f[I]null\f[R] است. .IP \[bu] 2 ecc \- منحنی بیضوی، پیش‌فرض ecc256 است. .IP \[bu] 2 ecc192 یا ecc_nist_p192 \- منحنی ECC NIST ۱۹۲ بیتی .IP \[bu] 2 ecc224 یا ecc_nist_p224 \- منحنی ECC NIST ۲۲۴ بیتی .IP \[bu] 2 ecc256 یا ecc_nist_p256 \- منحنی ECC NIST ۲۵۶ بیتی .IP \[bu] 2 ecc384 یا ecc_nist_p384 \- منحنی ECC NIST ۳۸۴ بیتی .IP \[bu] 2 ecc521 یا ecc_nist_p521 \- منحنی ECC NIST ۵۲۱ بیتی .IP \[bu] 2 ecc_sm2 یا ecc_sm2_p256 \- منحنی SM2 ۲۵۶ بیتی .IP \[bu] 2 rsa \- پیش‌فرض RSA: rsa2048 .IP \[bu] 2 rsa1024 \- الگوریتم RSA با اندازهٔ کلید ۱۰۲۴ بیتی. .IP \[bu] 2 rsa2048 \- الگوریتم RSA با اندازهٔ کلید ۲۰۴۸ بیتی. .IP \[bu] 2 rsa3072 \- الگوریتم RSA با اندازهٔ کلید ۳۰۷۲ بیتی. .IP \[bu] 2 rsa4096 \- الگوریتم RSA با اندازهٔ کلید ۴۰۹۶ بیتی..SS مشخص‌کننده‌های طرح (Scheme Specifiers) مورد بعدی، یک فیلد اختیاری است و می‌توان از آن صرف‌نظر کرد. .PP طرح‌ها معمولاً \f[B]طرح‌های امضا (Signing Schemes)\f[R] یا \f[B]طرح‌های رمزنگاری نامتقارن (Asymmetric Encryption Schemes)\f[R] هستند. بیشتر طرح‌های امضا، یک الگوریتم هش را بلافاصله پس از طرح امضا می‌پذیرند. اگر الگوریتم هش مشخص نشود، مقدار پیش‌فرض آن \f[I]sha256\f[R] خواهد بود. برخی هیچ آرگومانی نمی‌پذیرند و برخی چندین آرگومان دریافت می‌کنند. .SS مشخص‌کننده‌های طرح با هش اختیاری (Hash Optional Scheme Specifiers) پس از این مشخص‌کننده‌های طرح یک خط تیره و یک الگوریتم هش معتبر می‌آید، برای نمونه: \f[CR]oaep\-sha256\f[R]. .IP \[bu] 2 oaep .IP \[bu] 2 ecdh .IP \[bu] 2 rsassa .IP \[bu] 2 rsapss .IP \[bu] 2 ecdsa .IP \[bu] 2 ecschnorr .IP \[bu] 2 sm2 .SS مشخص‌کننده‌های طرح چندگزینه‌ای (Multiple Option Scheme Specifiers) پس از این مشخص‌کننده طرح یک شمارش (حداکثر اندازه UINT16) و به دنبال آن یک خط تیره (\-) و یک الگوریتم هش معتبر می‌آید. * ecdaa برای نمونه، ecdaa4\-sha256. اگر هیچ شمارشی مشخص نشود، مقدار پیش‌فرض آن 4 است. .SS مشخص‌کننده‌های طرح بدون گزینه (No Option Scheme Specifiers) این مشخص‌کننده طرح هیچ آرگومانی نمی‌گیرد. * rsaes .SS مشخص‌کننده‌های جزئیات متقارن (Symmetric Details Specifiers) این فیلد اختیاری است و مقدار پیش‌فرض آن بر اساس \f[I]type\f[R] شیء در حال ایجاد و ویژگی‌های آن تعیین می‌شود. به‌طور کلی، هر مشخص‌کننده معتبر \f[B]Symmetric\f[R] از فهرست \f[B]Type Specifiers\f[R] باید کار کند. اگر مشخص نشود، جزئیات متقارن یک شیء نامتقارن به‌طور پیش‌فرض \f[I]aes128cfb\f[R] خواهد بود. .SS "مثال‌ها (EXAMPLES)" .SS ساخت یک کلید rsa2048 با طرح رمزنگاری نامتقارن rsaes \f[CR]tpm2_create \-C parent.ctx \-G rsa2048:rsaes \-u key.pub \-r key.priv\f[R] .SS ساخت یک کلید ecc256 با طرح امضای ecdaa با شمارش ۴ و هش sha384 \f[CR]/tpm2_create \-C parent.ctx \-G ecc256:ecdaa4\-sha384 \-u key.pub \-r key.priv\f[R] الگوریتم‌های رمزنگاری \f[I]ALGORITHM\f[R]. .SH "گزینه‌های عمومی (COMMON OPTIONS)" این مجموعه از گزینه‌ها بین بسیاری از برنامه‌ها مشترک هستند و اطلاعاتی را ارائه می‌دهند که بسیاری از کاربران ممکن است انتظار داشته باشند. .IP \[bu] 2 \f[B]\-h\f[R], \f[B]\-\-help=[man|no\-man]\f[R]: نمایش صفحه راهنما (manpage) ابزار. به‌طور پیش‌فرض، تلاش می‌کند صفحه‌بند راهنما (manpager) را برای این ابزار فراخوانی کند، با این حال در صورت شکست، خلاصه‌ای کوتاه از ابزار را نمایش می‌دهد. این همان رفتاری است که در صورت تعیین آرگومان \[lq]man\[rq] برای گزینه رخ می‌دهد، اما اگر \[lq]man\[rq] به‌طور صریح درخواست شود، ابزار خطاهای ناشی از man را روی stderr ارائه می‌دهد. اگر گزینه \[lq]no\-man\[rq] مشخص شود، یا فراخوانی manpager با شکست مواجه شود، گزینه‌های کوتاه روی stdout چاپ خواهند شد. .RS 2 .PP استفاده موفقیت‌آمیز از ویژگی صفحات راهنما نیازمند آن است که صفحات راهنما نصب شده باشند یا در \f[I]MANPATH\f[R] قرار داشته باشند؛ برای جزئیات بیشتر man(1) را ببینید. .RE .IP \[bu] 2 \f[B]\-v\f[R], \f[B]\-\-version\f[R]: نمایش اطلاعات نسخه این ابزار، tctiهای پشتیبانی‌شده و خروج. .IP \[bu] 2 \f[B]\-V\f[R], \f[B]\-\-verbose\f[R]: افزایش اطلاعاتی که ابزار در حین اجرا روی کنسول چاپ می‌کند. هنگام استفاده از این گزینه، نام فایل و شماره خط چاپ می‌شوند. .IP \[bu] 2 \f[B]\-Q\f[R], \f[B]\-\-quiet\f[R]: بی‌صدا کردن خروجی عادی ابزار روی stdout. .IP \[bu] 2 \f[B]\-Z\f[R], \f[B]\-\-enable\-errata\f[R]: فعال‌سازی اعمال اصلاحیه‌های اشکالات (errata fixups). زمانی مفید است که لازم باشد یک اصلاحیه اشکال روی دستورهای ارسال‌شده به TPM اعمال شود. تعریف متغیر محیطی TPM2TOOLS_ENABLE_ERRATA نیز معادل این گزینه است. .IP \[bu] 2 \f[B]\-z\f[R], \f[B]\-\-pwd\-session\f[R]: استفاده از نشست گذرواژه (password session) به جای نشست HMAC برای احراز هویت. یک گذرواژه به صورت متن‌آشکار (clear text) به TPM ارسال می‌شود تا اقدام را مجاز کند. این گزینه می‌تواند برای جلوگیری از بروز مشکل در زمان استفاده از نشست‌های بدون سالت (unsalted) در حالت OpenSSL FIPS استفاده شود. اگر از مقادیر auth استفاده می‌شود، باید از یک نشست دارای سالت (salted session) برای احراز هویت استفاده شود. .IP \[bu] 2 \f[B]\-R\f[R], \f[B]\-\-autoflush\f[R]: فعال‌سازی تخلیه خودکار (autoflush) برای اشیاء گذرا (transient objects) ایجادشده توسط دستور. اگر یک شیء والد از یک فایل زمینه (context file) بارگیری شود، شیء والد گذرای آن نیز تخلیه (flush) خواهد شد. تخلیه خودکار همچنین در صورتی که متغیر محیطی TPM2TOOLS_AUTOFLUSH روی yes یا true تنظیم شده باشد، فعال می‌شود. اطلاعاتی که بسیاری از کاربران ممکن است انتظار داشته باشند..SH "پیکربندی TCTI (TCTI Configuration)" TCTI یا \[lq]Transmission Interface\[rq] (رابط انتقال) سازوکار ارتباطی با TPM است. می‌توان TCTIها را برای برقراری ارتباط با TPMها در بسترهای مختلف تغییر داد. .PP برای واپایش TCTI، ابزارها موارد زیر را در نظر می‌گیرند: .IP "1." 3 گزینهٔ خط فرمان \f[B]\-T\f[R] یا \f[B]\-\-tcti\f[R] .IP "2." 3 متغیر محیطی: \f[I]TPM2TOOLS_TCTI\f[R]. .PP \f[B]نکته:\f[R] گزینهٔ خط فرمان همواره بر متغیر محیطی اولویت داشته و آن را بازنویسی می‌کند. .PP TCTIهای شناخته‌شدهٔ فعلی عبارتند از: .IP \[bu] 2 tabrmd \- مدیر منابع، تحت عنوان \c .UR https://github.com/tpm2-software/tpm2-abrmd tabrmd .UE \c \&. توجه داشته باشید که tabrmd و abrmd به‌عنوان نام tcti مترادف هستند. .IP \[bu] 2 mssim \- معمولاً برای برقراری ارتباط با شبیه‌ساز نرم‌افزاری TPM استفاده می‌شود. .IP \[bu] 2 device \- هنگام برقراری ارتباط مستقیم با فایل دستگاه TPM استفاده می‌شود. .IP \[bu] 2 none \- هیچ اتصالی با TPM برقرار نمی‌کند. برخی ابزارها امکان استفاده از گزینه‌های بدون نیاز به TPM (off\-tpm) را فراهم کرده و بنابراین از عدم استفاده از TCTI پشتیبانی می‌کنند. ابزارهایی که از آن پشتیبانی نمی‌کنند، در صورت تلاش برای استفاده بدون اتصال TCTI با خطا مواجه می‌شوند. از \f[I]هیچ\f[R] گزینه‌ای پشتیبانی نمی‌کند و \f[I]باید\f[R] دقیقاً به صورت متن \[lq]none\[rq] ارائه شود. .PP آرگومان‌های گزینهٔ خط فرمان یا متغیر محیطی به شکل زیر هستند: .PP \f[CR]:\f[R] .PP مشخص کردن یک رشتهٔ خالی برای هر یک از \f[CR]\f[R] یا \f[CR]\f[R] به ترتیب منجر به استفاده از مقدار پیش‌فرض برای آن بخش خواهد شد. .SS "پیش‌فرض‌های TCTI (TCTI Defaults)" هنگامی که یک TCTI مشخص نشده باشد، TCTI پیش‌فرض با استفاده از معناشناسی \f[I]dlopen(3)\f[R] جستجو می‌شود. ابزارها به دنبال TCTIهای \f[I]tabrmd\f[R]، \f[I]device\f[R] و \f[I]mssim\f[R] \f[B]دقیقاً به همین ترتیب\f[R] گشته و \f[B]از نخستین مورد یافت‌شده استفاده می‌کنند\f[R]. می‌توانید با استفاده از گزینهٔ \f[B]\-v\f[R] برای چاپ اطلاعات نسخه، بررسی کنید که کدام TCTI به عنوان پیش‌فرض انتخاب خواهد شد. جفت کلید-مقدار \[lq]default\-tcti\[rq] مشخص می‌کند که کدام‌یک از TCTIهای یادشده پیش‌فرض است. .SS "TCTIهای سفارشی (Custom TCTIs)" هر TCTI که رابط پویای TCTI را پیاده‌سازی کند، قابل بارگذاری است. ابزارها در داخل از \f[I]dlopen(3)\f[R] استفاده می‌کنند و مقدار خام \f[I]tcti\-name\f[R] برای جستجو به کار می‌رود. بنابراین، این مقدار می‌تواند مسیری به کتابخانهٔ اشتراکی یا نام کتابخانه‌ای باشد که بر اساس معناشناسی \f[I]dlopen(3)\f[R] درک می‌شود. .SH "گزینه‌های TCTI (TCTI OPTIONS)" این مجموعه گزینه‌ها برای پیکربندی ماژول‌های مختلف TCTI شناخته‌شده و موجود به کار می‌روند: .IP \[bu] 2 \f[B]device\f[R]: برای TCTI دستگاه (device TCTI)، فایل دستگاه نویسه‌ای TPM جهت استفاده توسط TCTI دستگاه می‌تواند مشخص شود. پیش‌فرض \f[I]/dev/tpm0\f[R] است. .RS 2 .PP مثال: \f[B]\-T device:/dev/tpm0\f[R] یا \f[B]export \f[BI]TPM2TOOLS_TCTI\f[B]=\[lq]device:/dev/tpm0\[rq]\f[R] .RE .IP \[bu] 2 \f[B]mssim\f[R]: برای TCTI شبیه‌ساز (mssim TCTI)، نام دامنه یا نشانی IP و شماره درگاهی که توسط شبیه‌ساز استفاده می‌شود قابل تعیین است. پیش‌فرض‌ها 127.0.0.1 و 2321 هستند. .RS 2 .PP مثال: \f[B]\-T mssim:host=localhost,port=2321\f[R] یا \f[B]export \f[BI]TPM2TOOLS_TCTI\f[B]=\[lq]mssim:host=localhost,port=2321\[rq]\f[R] .RE .IP \[bu] 2 \f[B]abrmd\f[R]: برای TCTI نوع abrmd، قالب رشتهٔ پیکربندی مجموعه‌ای از جفت‌های سادهٔ کلید-مقدار است که با نویسهٔ `,' از هم جدا می‌شوند. هر رشتهٔ کلید و مقدار با یک نویسهٔ `=' جدا می‌گردد. .RS 2 .IP \[bu] 2 TCTI نوع abrmd از دو کلید پشتیبانی می‌کند: .RS 2 .IP "1." 3 `bus_name' : نام سرویس tabrmd روی گذرگاه (یک رشته). .IP "2." 3 `bus_type' : نوع نمونهٔ dbus (یک رشته) که به `session' و `system' محدود می‌شود. .RE .PP مشخص کردن نام tcti مربوط به tabrmd و رشتهٔ پیکربندی \f[CR]bus_name=com.example.FooBar\f[R]: .IP .EX \[rs]\-\-tcti=tabrmd:bus_name=com.example.FooBar .EE .PP مشخص کردن tcti پیش‌فرض (abrmd) و رشتهٔ پیکربندی \f[CR]bus_type=session\f[R]: .IP .EX \[rs]\-\-tcti:bus_type=session .EE .PP \f[B]نکته:\f[R] نام‌های abrmd و tabrmd مترادف هستند. ماژول‌های مختلف TCTI شناخته‌شده. .RE.SH "مثال‌ها (EXAMPLES)" .IP .EX tpm2_createprimary \-C o \-c prim.ctx \-Q tpm2_create \-C prim.ctx \-c key.ctx \-u key.pub \-r key.priv \-G ecc256:ecdh \-Q tpm2_ecephemeral \-u ecc.q \-t ecc.ctr ecc256 tpm2_ecdhkeygen \-u ecdh.pub \-o ecdh.priv \-c key.ctx tpm2_zgen2phase \-c key.ctx \-\-static\-public ecdh.pub \-\-ephemeral\-public ecc.q \[rs] \-t 0 \-\-output\-Z1 z1.bin \-\-output\-Z2 z2.bin .EE .SH "وضعیت خروج (EXIT STATUS)" ابزارها می‌توانند هر یک از کدهای زیر را بازگردانند: .IP \[bu] 2 0 \- موفقیت. .IP \[bu] 2 1 \- خطای عمومی نامشخص. .IP \[bu] 2 2 \- خطای مدیریت گزینه‌ها. .IP \[bu] 2 3 \- خطای احراز هویت. .IP \[bu] 2 4 \- خطای مربوط به TCTI. .IP \[bu] 2 5 \- طرح‌واره پشتیبانی‌نشده. مربوط به tpm2_testparams. .SH "گزارش باگ‌ها (BUGS)" \c .UR https://github.com/tpm2-software/tpm2-tools/issues مشکلات گیت‌هاب (Github Issues) .UE \c .SH "راهنما (HELP)" مشاهدهٔ \c .UR https://lists.linuxfoundation.org/mailman/listinfo/tpm2 فهرست پستی .UE \c .SH "مجوز (LICENSE)" این اثر تحت \c .UR https://creativecommons.org/licenses/by/4.0 مجوز بین‌المللی Creative Commons Attribution 4.0 (CC BY 4.0) .UE \c \& منتشر شده است.