.\" Automatically generated by Pandoc 3.6.1 .\" .TH "tpm2_rsadecrypt" "1" "" "tpm2\-tools" "راهنمای دستورهای عمومی" .SH "نام (NAME)" tpm2_rsadecrypt \- انجام عملیات رمزگشایی RSA با استفاده از TPM .SH "خلاصه دستور (SYNOPSIS)" \f[B]tpm2_rsadecrypt\f[R] [\f[I]OPTIONS\f[R]] [\f[I]ARGUMENT\f[R]] .SH "توضیحات (DESCRIPTION)" دستور \f[B]tpm2_rsadecrypt\f[R](1) عملیات رمزگشایی RSA را بر روی محتویات فایل با استفاده از طرح لایه‌گذاری (padding scheme) مشخص‌شده طبق استاندارد IETF RFC 3447 (PKCS#1) انجام می‌دهد. در صورت عدم تعیین، آرگومان خط فرمان به‌طور پیش‌فرض \f[I]stdin\f[R] خواهد بود. .PP کلید ارجاع‌داده‌شده توسط key\-context \f[B]باید\f[R] دارای شرایط زیر باشد: .IP "1." 3 یک کلید RSA باشد .IP "2." 3 صفت \f[I]decrypt\f[R] در مشخصه‌های آن \f[B]تنظیم (SET)\f[R] شده باشد. .SH "گزینه‌ها (OPTIONS)" .IP \[bu] 2 \f[B]\-c\f[R], \f[B]\-\-key\-context\f[R]=\f[I]OBJECT\f[R]: .RS 2 .PP شیء بافتاری که به بخش عمومی کلید RSA برای استفاده در رمزگشایی اشاره می‌کند. می‌تواند یک فایل یا یک شماره دستگیره (handle) باشد. بخش \[lq]قالب شیء بافتار (Context Object Format)\[rq] را ببینید. .RE .IP \[bu] 2 \f[B]\-p\f[R], \f[B]\-\-auth\f[R]=\f[I]AUTH\f[R]: .RS 2 .PP مقدار اختیاری احراز هویت برای استفاده از کلید مشخص‌شده با \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 مسیر اختیاری فایل خروجی برای ذخیره داده‌های رمزگشایی‌شده در آن. حالت پیش‌فرض، چاپ داده‌های رمزگذاری‌شده دودویی در \f[I]STDOUT\f[R] است. .RE .IP \[bu] 2 \f[B]\-s\f[R], \f[B]\-\-scheme\f[R]=\f[I]FORMAT\f[R]: .RS 2 .PP اختیاری، طرح لایه‌گذاری را تعیین می‌کند (پیش‌فرض rsaes است). .IP \[bu] 2 null \- مقدار TPM_ALG_NULL که در صورت تنظیم، از طرح خود کلید استفاده می‌کند. .IP \[bu] 2 rsaes \- مقدار TPM_ALG_RSAES که معادل RSAES_PKCSV1.5 است. .IP \[bu] 2 oaep \- مقدار TPM_ALG_OAEP که معادل RSAES_OAEP است. .RE .IP \[bu] 2 \f[B]\-l\f[R], \f[B]\-\-label\f[R]=\f[I]FILE\f[R] یا \f[I]STRING\f[R]: .RS 2 .PP اختیاری، داده‌های برچسب (label) را تعیین می‌کند. TPM نیاز دارد که آخرین بایت برچسب صفر باشد؛ این موضوع به‌صورت داخلی در ابزار مدیریت می‌شود. هیچ بایت صفر تعبیه‌شده دیگری نمی‌تواند وجود داشته باشد، در غیر این صورت TPM برچسب شما را کوتاه (truncate) خواهد کرد. .RE .IP \[bu] 2 \f[B]\-\-cphash\f[R]=\f[I]FILE\f[R] .RS 2 .PP مسیر فایل برای ثبت درهم‌سازی پارامترهای دستور. این مورد معمولاً با عنوان cpHash شناخته می‌شود. نکته: هنگامی که این گزینه انتخاب شود، این ابزار در واقع دستور را اجرا نخواهد کرد، بلکه صرفاً یک cpHash بازمی‌گرداند. .RE .IP \[bu] 2 \f[B]ARGUMENT\f[R] آرگومان خط فرمان که فایل حاوی داده‌های مورد نظر برای رمزگشایی را مشخص می‌کند. .SS "مراجع (REFERENCES)" .SH "قالب شیء بافتار (Context Object Format)" نوع یک شیء بافتار، چه دستگیره (handle) باشد و چه نام فایل، بر اساس منطق زیر \f[I]به‌ترتیب\f[R] تعیین می‌شود: .IP \[bu] 2 اگر آرگومان مسیر یک فایل باشد، آن فایل به عنوان یک شیء گذرا (transient object) بازیابی‌شده TPM بارگذاری می‌شود. .IP \[bu] 2 اگر آرگومان یک تطابق \f[I]پیشوندی (prefix)\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) در نظر گرفته شده و مستقیماً استفاده خواهد شد._OBJECT_..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]: به‌طور پیش‌فرض، زمانی که گذرواژه‌ها فاقد پیشوند باشند، در قالب رشته (string) در نظر گرفته می‌شوند. .SS "رشته (String)" یک گذرواژه رشته‌ای که با پیشوند \[lq]str:\[rq] یا نبود آن (رشته خام بدون پیشوند) مشخص می‌شود، تفسیر نشده و مستقیماً برای احراز هویت به کار می‌رود. .SS "مثال‌ها (Examples)" .IP .EX foobar str:foobar .EE .SS "رشته هگزادسیمال (Hex\-string)" یک گذرواژه بر پایه رشته هگز (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 # برای ارسال گذرواژه با دستور echo از طریق stdin: 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)" جهت استفاده از یک فایل زمینه نشست (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] ارسال authvalue از نوع \f[I]HEX\f[R] با مقدار 0x11223344: .IP .EX session:session.ctx+hex:11223344 .EE.SS "مجوزهای PCR (PCR Authorizations)" شما می‌توانید با استفاده از پیشوند \[lq]pcr:\[rq] و ریززبان 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 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) برای احراز هویت استفاده شود. .IP \[bu] 2 \f[B]\-R\f[R], \f[B]\-\-autoflush\f[R]: فعال‌سازی تخلیهٔ خودکار (autoflush) برای شیءهای گذرا (transient objects) ایجادشده توسط دستور. اگر یک شیء والد از یک فایل زمینه (context) بارگیری شود، شیء والد گذرا نیز تخلیه خواهد شد. تخلیهٔ خودکار همچنین می‌تواند در صورتی فعال شود که متغیر محیطی 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 مشخص نشده باشد، 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 سفارشی هر 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 تعیین نام 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)" .SS ایجاد یک کلید RSA و بارگذاری آن .IP .EX tpm2_createprimary \-c primary.ctx tpm2_create \-C primary.ctx \-Grsa2048 \-u key.pub \-r key.priv tpm2_load \-C primary.ctx \-u key.pub \-r key.priv \-c key.ctx .EE .SS رمزنگاری با استفاده از RSA .IP .EX echo \[dq]my message\[dq] > msg.dat tpm2_rsaencrypt \-c key.ctx \-o msg.enc msg.dat .EE.SS رمزگشایی با استفاده از RSA .IP .EX tpm2_rsadecrypt \-c key.ctx \-o msg.ptext msg.enc cat msg.ptext my message .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 مسائل گیت‌هاب (Github Issues) .UE \c .SH "راهنما (HELP)" مشاهدهٔ \c .UR https://lists.linuxfoundation.org/mailman/listinfo/tpm2 فهرست پستی (Mailing List) .UE \c .SH "مجوز (LICENSE)" این اثر تحت \c .UR https://creativecommons.org/licenses/by/4.0 مجوز بین‌المللی Creative Commons Attribution 4.0 (CC BY 4.0) .UE \c \& منتشر شده است.