.\" Automatically generated by Pandoc 3.6.1 .\" .TH "tpm2_unseal" "1" "" "tpm2\-tools" "General Commands Manual" .SH "نام (NAME)" tpm2_unseal \- بازگردانی یک بلوک داده در یک شیء بارگذاری‌شدهٔ TPM به صورت متن آشکار .SH "خلاصه دستور (SYNOPSIS)" \f[B]tpm2_unseal\f[R] [\f[I]OPTIONS\f[R]] .SH "توضیحات (DESCRIPTION)" دستور \f[B]tpm2_unseal\f[R](1) یک بلوک داده (data blob) را در یک شیء بارگذاری‌شدهٔ TPM بازمی‌گرداند. بلوک داده به صورت متن آشکار (clear) بازگردانده می‌شود. داده‌ها در زمان ایجاد شیء با استفاده از ابزار \f[B]tpm2_create\f[R] پلمپ (seal) شده‌اند. چنین شیئی که برای پلمپ داده‌ها در نظر گرفته شده است، باید از نوع \f[I]TPM_ALG_KEYEDHASH\f[R] باشد. .SH "گزینه‌ها (OPTIONS)" .IP \[bu] 2 \f[B]\-c\f[R], \f[B]\-\-object\-context\f[R]=\f[I]OBJECT\f[R]: .RS 2 .PP بافتار شیء (context) برای شیء بارگذاری‌شده. .RE .IP \[bu] 2 \f[B]\-p\f[R], \f[B]\-\-auth\f[R]=\f[I]AUTH\f[R]: .RS 2 .PP مقدار احراز هویت (auth) اختیاری برای استفاده با کلید مشخص‌شده توسط \f[B]\-c\f[R]. .RE .IP \[bu] 2 \f[B]\-o\f[R], \f[B]\-\-output\f[R]=\f[I]FILE\f[R]: .RS 2 .PP نام فایل خروجی حاوی داده‌های پلمپ‌گشایی‌شده (unsealed). در صورت عدم تعیین، پیش‌فرض \f[I]STDOUT\f[R] است. .RE .IP \[bu] 2 \f[B]\-\-cphash\f[R]=\f[I]FILE\f[R] .RS 2 .PP مسیر فایل برای ثبت درهم‌سازی پارامترهای دستور. این مقدار معمولاً cpHash نامیده می‌شود. نکته: هنگامی که این گزینه انتخاب شود، این ابزار در واقع دستور را اجرا نخواهد کرد، بلکه صرفاً مقدار cpHash را بازمی‌گرداند؛ مگر اینکه rphash نیز مورد نیاز باشد. .RE .IP \[bu] 2 \f[B]\-\-rphash\f[R]=\f[I]FILE\f[R] .RS 2 .PP مسیر فایل برای ثبت درهم‌سازی پارامترهای پاسخ. این مقدار معمولاً rpHash نامیده می‌شود. .RE .IP \[bu] 2 \f[B]\-S\f[R], \f[B]\-\-session\f[R]=\f[I]FILE\f[R]: .RS 2 .PP نشست ایجادشده با استفاده از \f[B]tpm2_startauthsession\f[R]. می‌توان چندین مورد از این گزینه را مشخص کرد. به عنوان مثال، می‌توانید یک نشست برای حسابرسی (auditing) و نشست دیگری برای رمزنگاری/رمزگشایی پارامترها داشته باشید. .RE .SS "مراجع (REFERENCES)" .SH "قالب شیء بافتار (CONTEXT OBJECT FORMAT)" نوع یک شیء بافتار، خواه یک دستگیره (handle) باشد یا نام فایل، بر اساس منطق زیر \f[I]به‌ترتیب\f[R] تعیین می‌شود: .IP \[bu] 2 اگر آرگومان مسیر یک فایل باشد، فایل به عنوان یک شیء گذرا (transient object) بازیابی‌شدهٔ TPM بارگذاری می‌شود. .IP \[bu] 2 اگر آرگومان با یکی از موارد زیر از طریق \f[I]پیشوند\f[R] مطابقت داشته باشد: .RS 2 .IP \[bu] 2 owner: سلسله‌مراتب مالک (owner hierarchy) .IP \[bu] 2 platform: سلسله‌مراتب پلتفرم (platform hierarchy) .IP \[bu] 2 endorsement: سلسله‌مراتب تصدیق (endorsement hierarchy) .IP \[bu] 2 lockout: شیء ماندگار کنترل قفل‌شدگی (lockout control persistent object) .RE .IP \[bu] 2 اگر آرگومان بتواند به عنوان یک عدد بارگذاری شود، با آن مانند یک دستگیره رفتار خواهد شد (مانند\ 0x81010013) و مستقیماً استفاده می‌شود..SH "قالب‌بندی مجوزدهی (Authorization Formatting)" مجوزدهی برای استفاده از یک شیء در TPM2.0 می‌تواند به ۳ شکل مختلف باشد: ۱. گذرواژه (Password) ۲. کد HMAC ۳. نشست‌ها (Sessions) .PP \f[B]نکته:\f[R] \[lq]در صورت عدم تعیین، مجوزدهی به‌طور پیش‌فرض بر روی \f[B]گذرواژه خالی (EMPTY PASSWORD)\f[R] تنظیم می‌شود\[rq]. .PP برای احراز هویت با مقادیر auth، دستورهای ابزار به‌طور ضمنی یک نشست HMAC تولید می‌کنند. بنابراین گذرواژه‌ها به‌صورت رمزگذاری‌نشده منتقل نمی‌شوند. این موضوع برای گذرواژه‌های تعریف‌شده برای اشیاء صدق نمی‌کند. در این مورد، باید از یک نشست HMAC استفاده شود (رجوع کنید به tpm2_startauthsession(1)). .SS "گذرواژه‌ها (Passwords)" گذرواژه‌ها با استفاده از شناسه‌های پیشوندی به شکل‌های زیر تفسیر می‌شوند. .PP \f[B]نکته\f[R]: به‌طور پیش‌فرض، گذرواژه‌ها در صورتی که پیشوندی نداشته باشند در قالب رشته فرض می‌شوند. .SS "رشته (String)" یک گذرواژه رشته‌ای که با پیشوند \[lq]str:\[rq] یا عدم حضور آن (رشته خام بدون پیشوند) مشخص می‌شود، تفسیر نشده و مستقیماً برای مجوزدهی به کار می‌رود. .SS "مثال‌ها (Examples)" .IP .EX foobar str:foobar .EE .SS "رشته هگزادسیمال (Hex\-string)" یک گذرواژه رشته هگزادسیمال که با پیشوند \[lq]hex:\[rq] مشخص می‌شود، از فرم شانزده‌شانزدهی (هگزادسیمال) به فرم آرایه بایتی تبدیل می‌شود؛ بنابراین امکان استفاده از گذرواژه‌هایی با نویسه‌های غیرقابل چاپ و/یا ناسازگار با ترمینال را فراهم می‌سازد. .SS "مثال (Example)" .IP .EX hex:1122334455667788 .EE .SS "فایل (File)" یک گذرواژه مبتنی بر فایل که با پیشوند \[lq]file:\[rq] مشخص می‌شود، باید مسیر فایلی حاوی گذرواژه برای خوانده شدن توسط ابزار یا یک \[lq]\-\[rq] جهت استفاده از stdin باشد. ذخیره گذرواژه‌ها در فایل‌ها از نشت اطلاعات جلوگیری می‌کند؛ چرا که گذرواژه‌های ارسال‌شده به‌عنوان گزینه می‌توانند از طریق فهرست فرآیندها یا قابلیت‌های متداول تاریخچه شل خوانده شوند. .SS "مثال‌ها (Examples)" .IP .EX # جهت استفاده از stdin و دریافت اعلان file:\- # جهت استفاده از یک فایل از طریق مسیر آن file:path/to/password/file # جهت ارسال گذرواژه از طریق stdin با دستور echo: echo foobar | tpm2_tool \-p file:\- # جهت استفاده از here\-string در bash از طریق stdin: tpm2_tool \-p file:\- <<< foobar .EE .SS "نشست‌ها (Sessions)" هنگام استفاده از یک نشست خط‌مشی (policy session) جهت مجوزدهی برای استفاده از یک شیء، آرگومان گزینه را با کلمه کلیدی \f[I]session\f[R] پیشوندگذاری کنید. سپس مسیر یک فایل نشست را که با tpm2_startauthsession(1) ایجاد شده است مشخص نمایید. در صورت نیاز، اگر نشست مستلزم ارسال یک مقدار auth همراه با دستگیره نشست باشد (مانند گذرواژه خط‌مشی یا policy password)، یک علامت + و یک رشته را طبق آنچه در بخش \f[B]گذرواژه‌ها (Passwords)\f[R] شرح داده شد ضمیمه کنید. .SS "مثال‌ها (Examples)" برای استفاده از یک فایل بافتار نشست (session context) به نام \f[I]session.ctx\f[R]: .IP .EX session:session.ctx .EE .PP برای استفاده از یک فایل بافتار نشست به نام \f[I]session.ctx\f[R] \f[B]و\f[R] ارسال authvalue با مقدار mypassword: .IP .EX session:session.ctx+mypassword .EE .PP برای استفاده از یک فایل بافتار نشست به نام \f[I]session.ctx\f[R] \f[B]و\f[R] ارسال مقدار \f[I]HEX\f[R] authvalue برابر با 0x11223344: .IP .EX session:session.ctx+hex:11223344 .EE.SS "مجوزهای PCR (PCR Authorizations)" شما می‌توانید با استفاده از پیشوند \[lq]pcr:\[rq] و ریززبان (minilanguage) مربوط به PCR، یک خط‌مشی PCR را برآورده کنید. ریززبان PCR به صورت زیر است: \f[CR]=\f[R] .PP مشخصه PCR در بخش \[lq]PCR bank specifiers\[rq] مستند شده است. .PP مقدار \f[CR]raw\-pcr\-file\f[R] یک آرگومان \f[B]اختیاری\f[R] است که شامل خروجی محتویات خام PCR به همان صورتی است که توسط \f[I]tpm2_pcrread(1)\f[R] بازگردانده می‌شود. .PP مشخص‌کننده‌های بانک PCR .SS "مثال‌ها (Examples)" برای برآورده کردن یک خط‌مشی PCR از sha256 روی بانک‌های 0، 1، 2 و 3 از مشخصه‌ای به این صورت استفاده کنید: .IP .EX pcr:sha256:0,1,2,3 .EE .PP مشخص کردن \f[I]AUTH\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. هنگامی مفید است که نیاز باشد اصلاح errata روی دستورات ارسال‌شده به TPM اِعمال شود. تعریف متغیر محیطی TPM2TOOLS_ENABLE_ERRATA معادل آن است. .IP \[bu] 2 \f[B]\-z\f[R]، \f[B]\-\-pwd\-session\f[R]: استفاده از نشست گذرواژه (password session) به جای یک نشست HMAC برای احراز هویت. یک گذرواژه متنی آشکار به TPM ارسال می‌شود تا عملیات مجاز گردد. این گزینه می‌تواند برای جلوگیری از بروز مشکل در هنگام استفاده از نشست‌های unsalted در حالت OpenSSL FIPS به کار رود. اگر از مقادیر auth استفاده می‌شود، باید از یک نشست salted برای احراز هویت استفاده شود. .IP \[bu] 2 \f[B]\-R\f[R]، \f[B]\-\-autoflush\f[R]: فعال‌سازی autoflush برای اشیاء گذارای (transient) ایجاد شده توسط دستور. اگر یک شیء والد از یک فایل context بارگذاری شود، شیء والد گذرا نیز flush خواهد شد. تخلیه خودکار (autoflush) همچنین در صورتی که متغیر محیطی TPM2TOOLS_AUTOFLUSH روی yes یا true تنظیم شده باشد فعال می‌شود. اطلاعاتی که ممکن است بسیاری از کاربران انتظار داشته باشند. .SH "پیکربندی TCTI (TCTI Configuration)" رابط TCTI یا \[lq]رابط انتقال\[rq] (Transmission Interface) سازوکار ارتباطی با 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 مقداردهی اولیه نشود. برخی ابزارها امکان استفاده از گزینه‌های 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، می‌توان فایل دستگاه نویسه‌ای 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، می‌توان نام دامنه یا نشانی 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 مشخص کردن نام tabrmd tcti و رشتهٔ پیکربندیِ \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 primary.ctx \-Q tpm2_pcrread \-Q \-o pcr.bin sha256:0,1,2,3 tpm2_createpolicy \-Q \-\-policy\-pcr \-l sha256:0,1,2,3 \-f pcr.bin \-L pcr.policy echo \[aq]secret\[aq] \f[B]|\f[R] tpm2_create \-C primary.ctx \-L pcr.policy \-i\-\[rs] \-u seal.pub \-r seal.priv \-c seal.ctx \-Q tpm2_unseal \-c seal.ctx \-p pcr:sha256:0,1,2,3 .EE.SH "کدهای بازگشتی (RETURNS)" ابزارها می‌توانند هر یک از کدهای زیر را بازگردانند: .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 مسائل گیت‌هاب .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 International License (CC BY 4.0) .UE \c \& منتشر شده است.