| tpm2_certifyX509certutil(1) | General Commands Manual | tpm2_certifyX509certutil(1) |
نام (NAME)
tpm2_certifyX509certutil - ابزار کمکی گواهی‌های X.509 برای TPM2
خلاصه دستور (SYNOPSIS)
tpm2_certifyX509certutil [گزینه‌ها]
توضیحات (DESCRIPTION)
دستور tpm2_certifyX509certutil(1) یک گواهی جزئی تولید می‌کند که به عنوان سومین پارامتر ورودی برای دستور TPM2_certifyX509 مناسب است. داده‌های گواهی در یک پرونده با قالب DER نوشته می‌شوند و می‌توان آن‌ها را با استفاده از ابزار openssl asn1parse به صورت زیر بررسی کرد:
-
openssl asn1parse -in partial_cert.der -inform DER
گزینه‌ها (OPTIONS)
گزینه‌های موجود عبارتند از:
- •
- -o, --outcert=STRING: پرونده خروجی که گواهی در آن نوشته خواهد شد. مقدار پیش‌فرض partial_cert.der است. پارامتر اختیاری.
- •
- -d, --days=NUMBER: تعداد روزهایی که گواهی از امروز معتبر خواهد بود. مقدار پیش‌فرض 3560 (۱۰ سال) است. پارامتر اختیاری.
- •
- -i, --issuer=STRING: مدخل صادرکننده (ISSUER) برای گواهی در قالب زیر: –issuer=“C=US;O=org;OU=Org unit;CN=cname” فیلدهای پشتیبانی‌شده عبارتند از:
- •
- C - “Country” (کشور)، حداکثر اندازه = 2
- •
- O - “Org” (سازمان)، حداکثر اندازه = 8
- •
- OU - “Org Unit” (واحد سازمانی)، حداکثر اندازه = 8
- •
- CN - “Common Name” (نام معمول)، حداکثر اندازه = 8
- فیلدها باید با نقطه-ویرگول (semicolon) از یکدیگر جدا شوند. برای معتبر بودن گزینه، حداقل یک فیلد پشتیبانی‌شده الزامی است. پارامتر اختیاری.
- •
- -s, --subject=STRING: موضوع (SUBJECT) برای گواهی در قالب زیر: –subject=“C=US;O=org;OU=Org unit;CN=cname” فیلدهای پشتیبانی‌شده عبارتند از:
- •
- C - “Country” (کشور)، حداکثر اندازه = 2
- •
- O - “Org” (سازمان)، حداکثر اندازه = 8
- •
- OU - “Org Unit” (واحد سازمانی)، حداکثر اندازه = 8
- •
- CN - “Common Name” (نام معمول)، حداکثر اندازه = 8
- فیلدها باید با نقطه-ویرگول (semicolon) از یکدیگر جدا شوند. برای معتبر بودن گزینه، حداقل یک فیلد پشتیبانی‌شده الزامی است. پارامتر اختیاری.
- •
- ARGUMENT هیچ آرگومانی نیاز نیست.
مراجع (References)
گزینه‌های عمومی (COMMON OPTIONS)
این مجموعه از گزینه‌ها میان بسیاری از برنامه‌ها مشترک بوده و اطلاعات مورد انتظار کاربران را فراهم می‌کنند.
- •
- -h, --help=[man|no-man]: نمایش صفحه راهنمای ابزار. به‌طور پیش‌فرض، تلاش می‌کند صفحه‌خوان راهنما (manpager) را برای ابزار فراخوانی کند، با این حال در صورت شکست، خلاصه کوتاهی از ابزار را نمایش می‌دهد. این رفتار مشابه زمانی است که آرگومان گزینه “man” مشخص شده باشد، اما اگر صراحتاً “man” درخواست شود، ابزار خطاهای man را در خروجی خطای استاندارد (stderr) گزارش می‌کند. اگر گزینه “no-man” مشخص شود یا فراخوانی manpager شکست بخورد، گزینه‌های کوتاه در خروجی استاندارد (stdout) چاپ خواهند شد.
استفاده موفقیت‌آمیز از قابلیت صفحات راهنما نیازمند نصب بودن صفحات راهنما یا قرار داشتن آن‌ها در مسیر MANPATH است؛ برای جزئیات بیشتر man(1) را ببینید.
- •
- -v, --version: نمایش اطلاعات نسخه برای این ابزار، TCTIهای پشتیبانی‌شده و خروج.
- •
- -V, --verbose: افزایش اطلاعاتی که ابزار در حین اجرا در کنسول چاپ می‌کند. هنگام استفاده از این گزینه، نام پرونده و شماره خط چاپ می‌شوند.
- •
- -Q, --quiet: ساکت کردن خروجی عادی ابزار به خروجی استاندارد (stdout).
- •
- -Z, --enable-errata: فعال‌سازی اعمال اصلاحات مربوط به اشکالات شناخته‌شده (errata fixups). زمانی مفید است که نیاز باشد یک اصلاحیه خطا روی دستورات ارسالی به TPM اعمال گردد. تعریف متغیر محیطی TPM2TOOLS_ENABLE_ERRATA نیز معادل این عمل است.
- •
- -z, --pwd-session: استفاده از نشست گذرواژه به‌جای نشست HMAC برای احراز هویت. یک گذرواژه متن‌آشکار به TPM ارسال می‌شود تا انجام عملیات را مجاز کند. از این گزینه می‌توان برای جلوگیری از مشکلات ناشی از نشست‌های بدون سالت (unsalted) در حالت OpenSSL FIPS استفاده کرد. اگر مقادیر auth به کار گرفته شوند، باید از یک نشست با سالت (salted) برای احراز هویت استفاده شود.
- •
- -R, --autoflush: فعال‌سازی تخلیه خودکار (autoflush) برای اشیاء گذرا (transient) ایجادشده با این دستور. اگر یک شیء والد از یک پرونده زمینه بارگذاری شود، شیء والد گذرا نیز تخلیه خواهد شد. تخلیه خودکار همچنین زمانی فعال می‌شود که متغیر محیطی TPM2TOOLS_AUTOFLUSH روی yes یا true تنظیم شده باشد.
مثال‌ها (EXAMPLES)
-
tpm2 certifyX509certutil -o partial_cert.der -d 356
کدهای بازگشتی (RETURNS)
ابزارها می‌توانند هر یک از کدهای زیر را برگردانند:
- •
- 0 - موفقیت‌آمیز.
- •
- 1 - خطای عمومی و نامشخص.
- •
- 2 - خطای پردازش گزینه‌ها.
- •
- 3 - خطای احراز هویت.
- •
- 4 - خطای مرتبط با TCTI.
- •
- 5 - طرح‌واره پشتیبانی‌نشده. مربوط به tpm2_testparams.
اشکالات (BUGS)
راهنما (HELP)
نگاه کنید به فهرست پستی (Mailing List)
مجوز (LICENSE)
این اثر تحت مجوز بین‌المللی کریتیو کامنز ارجاع 4.0 (CC BY 4.0) منتشر شده است.
| tpm2-tools |