.\" Automatically generated by Pandoc 3.6.1 .\" .TH "tpm2_rsaencrypt" "1" "" "tpm2\-tools" "General Commands Manual" .SH "نام (NAME)" tpm2_rsaencrypt \- انجام عملیات رمزنگاری RSA با استفاده از TPM .SH "خلاصه دستور (SYNOPSIS)" \f[B]tpm2_rsaencrypt\f[R] [\f[I]OPTIONS\f[R]] [\f[I]ARGUMENT\f[R]] .SH "توضیحات (DESCRIPTION)" دستور \f[B]tpm2_rsaencrypt\f[R](1) عملیات رمزنگاری RSA را بر روی محتوای داده‌های فایل با استفاده از طرح پدینگ مشخص‌شده مطابق با 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]encrypt\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 جهت استفاده در رمزنگاری اشاره می‌کند. .RE .IP \[bu] 2 \f[B]\-o\f[R], \f[B]\-\-output\f[R]=\f[I]FILE\f[R]: .RS 2 .PP مسیر اختیاری فایل خروجی برای ذخیره داده‌های رمزنگاری‌شده. پیش‌فرض، چاپ داده‌های رمزنگاری‌شدهٔ باینری در stdout است. .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 اختیاری، داده‌های برچسب را تعیین می‌کند. می‌تواند یک رشته یا مسیر فایل باشد. واحد TPM الزام می‌داند که آخرین بایت برچسب صفر باشد؛ این موضوع در داخل ابزار مدیریت می‌شود. هیچ بایت صفر درون‌گذاری‌شدهٔ دیگری نمی‌تواند وجود داشته باشد، در غیر این صورت TPM برچسب شما را کوتاه خواهد کرد. .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]پیشوندی\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 می‌تواند به ۳ شکل مختلف باشد: ۱. گذرواژه ۲. 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 مثال‌ها .IP .EX foobar str:foobar .EE .SS رشته هگزادسیمال (Hex\-string) یک گذرواژه رشته هگز، که با پیشوند \[lq]hex:\[rq] مشخص می‌شود، از فرم هگزادسیمال به فرم آرایه بایت تبدیل می‌شود، و بدین ترتیب امکان استفاده از گذرواژه‌های حاوی نویسه‌های غیرقابل‌چاپ و/یا ناسازگار با ترمینال را فراهم می‌کند. .SS مثال .IP .EX hex:1122334455667788 .EE .SS فایل (File) یک گذرواژه مبتنی بر فایل، که با پیشوند \[lq]file:\[rq] تعیین می‌شود، باید مسیر فایلی حاوی گذرواژه جهت خوانده شدن توسط ابزار یا یک \[lq]\-\[rq] برای استفاده از stdin باشد. ذخیره گذرواژه‌ها در فایل از نشت اطلاعات جلوگیری می‌کند؛ گذرواژه‌هایی که به عنوان گزینه (option) ارسال می‌شوند می‌توانند از طریق فهرست فرآیندها یا قابلیت‌های متداول تاریخچه شل خوانده شوند. .SS مثال‌ها .IP .EX # جهت استفاده از stdin و دریافت اعلان ورودی file:\- # جهت استفاده از یک فایل از طریق مسیر file:path/to/password/file # جهت ارسال یک گذرواژه با دستور echo از طریق stdin: echo foobar | tpm2_tool \-p file:\- # جهت استفاده از bash here\-string از طریق 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 مثال‌ها برای استفاده از یک فایل زمینه نشست با نام \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)" می‌توانید یک سیاست PCR را با استفاده از پیشوند \[lq]pcr:\[rq] و ریززبان (minilanguage) 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 روی بانک‌های ۰، ۱، ۲ و ۳ از مشخص‌کننده‌ای به شکل زیر استفاده کنید: .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 استفادهٔ موفقیت‌آمیز از ویژگی manpages مستلزم آن است که صفحات راهنما نصب شده باشند یا در مسیر \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]: استفاده از نشست گذرواژه به جای نشست 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 تنظیم شده باشد، autoflush فعال می‌شود. اطلاعاتی که ممکن است بسیاری از کاربران انتظار داشته باشند. .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 \- طرح‌واره (scheme) پشتیبانی‌نشده. قابل اعمال برای 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 \& منتشر شده است.