.\" Automatically generated by Pandoc 3.6.1 .\" .TH "tpm2_getekcertificate" "1" "" "tpm2\-tools" "General Commands Manual" .SH "نام (NAME)" tpm2_getekcertificate \- دریافت گواهی کلید تاییدیه TPM2 (EK) .SH "خلاصه دستور (SYNOPSIS)" \f[B]tpm2_getekcertificate\f[R] [\f[I]گزینه‌ها\f[R]] [\f[I]آرگومان\f[R]] .SH "توضیحات (DESCRIPTION)" \f[B]tpm2_getekcertificate\f[R](1) \- دریافت گواهی کلید تاییدیه (EK)\&. گواهی یا در اندیس‌های NV مشخص‌شده توسط TCG در TPM یا روی سرور میزبانی گواهی تاییدیه سازنده TPM موجود است\&. شرایط تعیین محل جستجوی گواهی در ادامه آمده است: .IP "1." 3 اندیس NV (NV\-Index): .RS 4 .PP محل جستجوی پیش‌فرض هنگامی که \f[B]آرگومان\f[R] مشخص نشده باشد\&. .RE .IP "2." 3 سرور گواهی EK اینتل (Intel\-EK\-certificate\-server): .RS 4 .PP محل جستجو هنگامی که گواهی EK در اندیس NV یافت نشود، بیت tpmEPSgenerated برابر CLEAR باشد و سازنده TPM نیز INTC باشد\&. .RE .IP "3." 3 سرور صدور مجدد گواهی EK اینتل (Intel\-EK\-Re\-certification\-server): .RS 4 .PP محل جستجو هنگامی که گواهی EK در اندیس NV یافت نشود، بیت tpmEPSgenerated برابر SET باشد و سازنده TPM نیز INTC باشد\&. .PP نکته: .PP در این عملیات، اطلاعاتی پیرامون نرم‌افزار اضافی که باید به عنوان بخشی از سرویس تامین مجدد/صدور مجدد گواهی اجرا شود، ارائه می‌شود\&. .PP پس از تکمیل فرآیند تامین مجدد/صدور مجدد گواهی، گواهی‌های EK را می‌توان با اجرای نمونه دیگری از \f[B]tpm2_getekcertificate\f[R] از اندیس‌های NV خواند\&. .RE .IP "4." 3 سرور عمومی یا دیگر سرورهای گواهی EK: .RS 4 .PP محل جستجو هنگامی که \f[B]آرگومان\f[R] آدرس وب میزبانی گواهی EK را مشخص کند\&. .RE .SH "گزینه‌ها (OPTIONS)" .IP \[bu] 2 \f[B]\-o\f[R]، \f[B]\-\-ek\-certificate\f[R]=\f[I]FILE\f[R] یا \f[I]STDOUT\f[R]: .RS 2 .PP فایل ذخیره‌سازی گواهی کلید تاییدیه (EK)\&. هنگامی که گواهی‌های EK در اندیس‌های TPM NV یافت شوند، این گزینه را می‌توان چندین بار مشخص کرد تا گواهی‌های RSA و ECC کلید تاییدیه به ترتیب ذخیره شوند\&. اگر گواهی‌های EK بیشتری در اندیس‌های TPM NV یافت شوند و تنها یک فایل خروجی مشخص شده باشد، ابزار هشدار خواهد داد\&. اگر این گزینه مشخص نشود، تمامی گواهی‌های EK دریافت‌شده چه از میزبانی وب سازنده یا از اندیس‌های TPM NV، به خروجی استاندارد (stdout) ارسال می‌شوند\&. .RE .IP \[bu] 2 \f[B]\-X\f[R]، \f[B]\-\-allow\-unverified\f[R]: .RS 2 .PP تلاش برای اتصال به سرور تامین سازنده TPM را بدون اعتبارسنجی گواهی سرور مشخص می‌کند\&. این گزینه در صورت یافت شدن گواهی‌های EK روی اندیس‌های TPM NV بی‌تاثیر است\&. .PP \f[B]هشدار\f[R]: این گزینه فقط باید روی پلتفرم‌هایی با گواهی‌های قدیمی‌تر CA استفاده شود\&. .RE .IP \[bu] 2 \f[B]\-u\f[R]، \f[B]\-\-ek\-public\f[R]=\f[I]FILE\f[R]: .RS 2 .PP مسیر فایل برای بخش عمومی کلید تاییدیه را در قالب tss مشخص می‌کند\&. .RE .IP \[bu] 2 \f[B]\-x\f[R]، \f[B]\-\-offline\f[R]: .RS 2 .PP این گزینه ابزار را برای کار در حالت آفلاین نشانه‌گذاری می‌کند\&. به این صورت که گواهی‌ها را می‌توان برای کلیدهای عمومی ارائه‌شده EK که متعلق به پلتفرم در حال اجرای ابزار نیستند دریافت کرد\&. در تامین کارخانه‌ای چندین پلتفرم که به صورت جداگانه به اینترنت متصل نیستند مفید است\&. در چنین سناریویی، یک سرور واحد تامین متصل به اینترنت می‌تواند از این ابزار در این حالت استفاده کند\&. این گزینه ابزار را وادار می‌کند تا به دنبال گواهی‌های EK روی اندیس‌های NV نگردد\&. .RE .IP \[bu] 2 \f[B]\[en]raw\f[R]: .RS 2 .PP ابزار را تنظیم می‌کند تا گواهی EK را همان‌گونه که از منبع دریافت شده (NV یا میزبانی وب) به صورت خام خروجی دهد\&. .RE .IP \[bu] 2 \f[B]\-E\f[R]، \f[B]\-\-encoding\f[R]=\f[I]ENCODING\f[R]: .RS 2 .PP قالب کدگذاری مورد استفاده را به صراحت مشخص می‌کند\&. به طور معمول، روش پیش‌فرض روش مورد استفاده اینتل است مگر اینکه یک AMD fTPM شناسایی شود، که در این صورت از کدگذاری مخصوص AMD استفاده می‌شود\&. برای AMD از `a' و برای Intel از `i' استفاده کنید\&. .RE .IP \[bu] 2 \f[B]\-t\f[R]، \f[B]\-\-x509\-trunc\f[R]: .RS 2 .PP این گزینه ابزار را تنظیم می‌کند تا گواهی‌های خوانده‌شده از اندیس‌های TPM NV را با یک تجزیه‌کننده X509 تحلیل کرده و داده‌های اضافی پایانی را پیش از خروجی کوتاه و حذف کند\&. هنگام کار با TPMهایی که گواهی‌ها را به همراه داده‌های اضافی تا یک طول ثابت پد می‌کنند مفید است\&. .RE .IP \[bu] 2 \f[B]آرگومان (ARGUMENT)\f[R]: آرگومان خط فرمان آدرس URL درگاه گواهی EK را مشخص می‌کند\&. این کار ابزار را وادار می‌کند که به دنبال گواهی‌های EK در اندیس‌های NV نگردد\&. .SS "مراجع (References)" .SH "گزینه‌های عمومی (COMMON OPTIONS)" این مجموعه از گزینه‌ها میان بسیاری از برنامه‌ها مشترک هستند و اطلاعاتی را ارائه می‌دهند که بسیاری از کاربران انتظار دارند\&. .IP \[bu] 2 \f[B]\-h\f[R]، \f[B]\-\-help=[man|no\-man]\f[R]: نمایش صفحه راهنمای ابزار\&. به صورت پیش‌فرض، تلاش می‌کند تا صفحه‌بند راهنما را برای ابزار فراخوانی کند؛ با این حال، در صورت شکست، خلاصه کوتاهی از ابزار را نمایش می‌دهد\&. این رفتار مشابه زمانی است که آرگومان گزینه \[lq]man\[rq] مشخص شده باشد، اما اگر \[lq]man\[rq] صریح درخواست شود، ابزار خطاهای man را در stderr ارائه می‌دهد\&. اگر گزینه \[lq]no\-man\[rq] مشخص شود، یا صفحه‌بند راهنما شکست بخورد، گزینه‌های کوتاه در 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]: استفاده از نشست گذرواژه به جای نشست HMAC برای احراز هویت\&. یک گذرواژه متن آشکار برای مجوزدهی به عملیات به TPM ارسال می‌شود\&. این گزینه می‌تواند برای جلوگیری از مشکلات ناشی از نشست‌های بدون سالت (unsalted) در حالت FIPS اوپن‌اس‌اس‌ال استفاده شود\&. اگر مقادیر auth به کار گرفته شوند، باید از یک نشست با سالت برای احراز هویت استفاده شود\&. .IP \[bu] 2 \f[B]\-R\f[R]، \f[B]\-\-autoflush\f[R]: فعال‌سازی تخلیه خودکار (autoflush) برای اشیاء گذرا (transient) ایجادشده با دستور\&. اگر یک شیء والد از یک فایل زمینه بارگذاری شود، شیء والد گذرا نیز تخلیه خواهد شد\&. تخلیه خودکار همچنین زمانی فعال می‌شود که متغیر محیطی 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 دستگاه، فایل دستگاه نویسه‌ای 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 مترادف هستند\&. .RE .SH "نکات (NOTES)" هنگامی که گزینه پرگویی (verbose) مشخص شده باشد، اطلاعات اشکال‌زدایی اضافی curl با تنظیم حالت curl به verbose ارائه می‌شود؛ برای اطلاعات بیشتر به \c .UR https://curl.haxx.se/libcurl/c/CURLOPT_VERBOSE.html .UE \c \ مراجعه کنید\&. .SH "مثال‌ها (EXAMPLES)" .SS "دریافت گواهی EK از سرور سازنده TPM با ارائه کلید عمومی EK" .IP .EX tpm2_createek \-G rsa \-u ek.pub \-c key.ctx tpm2_getekcertificate \-X \-o ECcert.bin \-u ek.pub \[rs] https://tpm.manufacturer.com/ekcertserver/ .EE .SS "دریافت گواهی EK از سرور اینتل در صورت پیدا نشدن گواهی در حافظه NV" .IP .EX tpm2_createek \-G rsa \-u ek.pub \-c key.ctx tpm2_getekcertificate \-X \-o ECcert.bin \-u ek.pub .EE .SS "دریافت گواهی EK از سرور اینتل برای یک پلتفرم آفلاین" .IP .EX tpm2_getekcertificate \-X \-x \-o ECcert.bin \-u ek.pub .EE .SS "دریافت گواهی EK فقط از اندیس‌های TPM NV (در غیر این صورت با شکست مواجه می‌شود)" .IP .EX tpm2_getekcertificate \-o ECcert.bin .EE .SS "دریافت گواهی EK از اندیس‌های TPM NV برای یک کلید عمومی EK (در غیر این صورت با شکست مواجه می‌شود)" .IP .EX tpm2_createek \-G ecc384 \-u ek_ecc384.pub \-c ek_ecc384.ctx tpm2_getekcertificate \-o ek_ecc384.cert \-u ek_ecc384.pub .EE .SS "دریافت چندین گواهی EK فقط از اندیس‌های TPM NV (در غیر این صورت با شکست مواجه می‌شود)" .IP .EX tpm2_getekcertificate \-o RSA_EK_cert.bin \-o ECC_EK_cert.bin .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 مجوز بین‌المللی کریتیو کامنز ارجاع 4.0 (CC BY 4.0) .UE \c \ منتشر شده است\&.