.\" Automatically generated by Pandoc 3.5
.\"
.TH "tpm2tss\-genkey" "1" "OCTOBER 2020" "tpm2\-tss\-engine" "General Commands Manual"
.SH "نام (NAME)"
tpm2tss\-genkey \- تولید کلیدهای TPM برای tpm2\-tss\-engine
.SH "خلاصه دستور (SYNOPSIS)"
\f[B]tpm2tss\-genkey\f[R] [\f[I]گزینه‌ها\f[R]] <\f[I]نام_فایل\f[R]>
.SH "توضیحات (DESCRIPTION)"
دستور \f[B]tpm2tss\-genkey\f[R] یک کلید در داخل TPM 2.0 که از طریق پشته نرم‌افزاری tpm2tss متصل است ایجاد می‌کند.
این کلیدها می‌توانند یک کلید RSA برای رمزگشایی یا امضا، یا یک کلید ECC برای امضاهای ECDSA باشند.
.PP
این ابزار از گزینه OPENSSL_CONF برای تعیین پارامترهای کنترلی ویژه موتور پشتیبانی می‌کند.
برای جزئیات درباره فایل‌های پیکربندی openssl به \f[CR]man(5) config\f[R] مراجعه کنید.
.SH "آرگومان‌ها (ARGUMENTS)"
دستور \f[CR]tpm2tss\-genkey\f[R] برای ذخیره اطلاعات کلید TPM حاصل، انتظار یک نام فایل را دارد.
سپس این فایل می‌تواند با استفاده از دستور زیر در OpenSSL بارگذاری شود:
\f[CR]openssl pkeyutl \-engine tpm2tss \-keyform engine \-inkey <filename>\f[R].
.SH "گزینه‌ها (OPTIONS)"
.IP \[bu] 2
\f[CR]\-a <algorithm>\f[R], \f[CR]\-\-alg <algorithm>\f[R]: الگوریتم کلید عمومی (rsa، ecdsa) (پیش‌فرض: rsa)
.IP \[bu] 2
\f[CR]\-c <curve>\f[R], \f[CR]\-\-curve <curve>\f[R]: در صورت انتخاب الگوریتم ecdsa، منحنی برای ecc (پیش‌فرض: nist_p256)
.IP \[bu] 2
\f[CR]\-u <file>\f[R], \f[CR]\-\-public <file>\f[R]: کلید عمومی (TPM2B_PUBLIC) برای وارد کردن.
نیازمند \f[CR]\-r\f[R] است.
.IP \[bu] 2
\f[CR]\-r <file>\f[R], \f[CR]\-\-private <file>\f[R]: کلید خصوصی (رمزگذاری‌شده) (TPM2B_PRIVATE) برای وارد کردن.
نیازمند \f[CR]\-u\f[R] است.
.IP \[bu] 2
\f[CR]\-e <exponent>\f[R], \f[CR]\-\-exponent <exponent>\f[R]: در صورت انتخاب الگوریتم rsa، توان برای rsa (پیش‌فرض: 65537)
.IP \[bu] 2
\f[CR]\-h\f[R], \f[CR]\-\-help\f[R]: چاپ پیام راهنما
.IP \[bu] 2
\f[CR]\-o <password>\f[R], \f[CR]\-\-ownerpw <password>\f[R]: گذرواژه برای سلسله‌مراتب مالک (پیش‌فرض: هیچ)؛ دستور کنترلی پیکربندی OpenSSL:
\f[CR]SET_OWNERAUTH\f[R]
.IP \[bu] 2
\f[CR]\-p <password>\f[R], \f[CR]\-\-password <password>\f[R]: گذرواژه برای کلید ایجاد‌شده (پیش‌فرض: هیچ)
.IP \[bu] 2
\f[CR]\-P <handle>\f[R], \f[CR]\-\-parent <handle>\f[R]: هندل مشخص برای کلید والد (پیش‌فرض: هیچ)
.IP \[bu] 2
\f[CR]\-s <keysize>\f[R], \f[CR]\-\-keysize <keysize>\f[R]: در صورت انتخاب الگوریتم rsa، اندازه کلید به بیت (پیش‌فرض: 2048)
.IP \[bu] 2
\f[CR]\-v\f[R], \f[CR]\-\-verbose\f[R]: چاپ پیام‌ها با جزئیات کامل
.IP \[bu] 2
\f[CR]\-W <password>\f[R], \f[CR]\-\-parentpw <password>\f[R]: گذرواژه برای کلید والد (پیش‌فرض: هیچ)؛ دستور کنترلی پیکربندی OpenSSL:
\f[CR]SET_PARENTAUTH\f[R]
.IP \[bu] 2
\f[CR]\-t <tcti\-conf>\f[R], \f[CR]\-\-tcti <tcti\-conf>\f[R]: رشته پیکربندی TCTI (پیش‌فرض: هیچ)؛ دستور کنترلی پیکربندی OpenSSL:
\f[CR]SET_TCTI\f[R]
.SH "مثال‌ها (EXAMPLES)"
اطلاعات موتور را می‌توان با دستور زیر دریافت کرد:
.IP
.EX
$ openssl engine \-t \-c tpm2tss
.EE
.PP
توالی دستورات زیر با استفاده از TPM یک کلید RSA ایجاد می‌کند، کلید عمومی را صادر می‌نماید، یک فایل داده را رمزگذاری کرده و با استفاده از TPM آن را رمزگشایی می‌کند:
.IP
.EX
$ tpm2tss\-genkey \-a rsa \-s 2048 mykey
$ openssl rsa \-engine tpm2tss \-inform engine \-in mykey \-pubout \-outform pem \-out mykey.pub
$ openssl pkeyutl \-pubin \-inkey mykey.pub \-in mydata \-encrypt \-out mycipher
$ openssl pkeyutl \-engine tpm2tss \-keyform engine \-inkey mykey \-decrypt \-in mycipher \-out mydata
.EE
.PP
توالی دستورات زیر با استفاده از TPM یک کلید RSA ایجاد می‌کند، کلید عمومی را صادر می‌نماید، یک فایل داده را با استفاده از TPM امضا کرده و امضا را اعتبارسنجی می‌کند:
.IP
.EX
$ tpm2tss\-genkey \-a rsa \-s 2048 mykey
$ openssl rsa \-engine tpm2tss \-inform engine \-in mykey \-pubout \-outform pem \-out mykey.pub
$ openssl pkeyutl \-engine tpm2tss \-keyform engine \-inkey mykey \-sign \-in mydata \-out mysig
$ openssl pkeyutl \-engine tpm2tss \-keyform engine \-inkey mykey \-verify \-in mydata \-sigfile mysig
.EE
.PP
توالی دستورات زیر با استفاده از TPM یک کلید ECDSA ایجاد می‌کند، کلید عمومی را صادر می‌نماید، یک فایل داده را با استفاده از TPM امضا کرده و امضا را اعتبارسنجی می‌کند:
.IP
.EX
$ tpm2tss\-genkey \-a ecdsa \-c nist_p256 mykey
$ openssl pkeyutl \-engine tpm2tss \-keyform engine \-inkey mykey \-sign \-in mydata \-out mysig
$ openssl pkeyutl \-engine tpm2tss \-keyform engine \-inkey mykey \-verify \-in mydata \-sigfile mysig
.EE
.SH "مقادیر بازگشتی (RETURNS)"
۰ در صورت موفقیت یا ۱ در صورت شکست.
.SH "نویسنده (AUTHOR)"
نوشته‌شده توسط Andreas Fuchs.
.SH "حق نشر (COPYRIGHT)"
حق نشر tpm2tss متعلق به (C) 2017\-2018 Fraunhofer SIT است و توسط Infineon Technologies AG حمایت مالی شده است.
.PP
مجوز BSD 3\-clause.
.SH "همچنین ببینید (SEE ALSO)"
openssl(1)