'\" t
.\"     Title: ssh-tpm-add
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2026-08-10
.\"    Manual: ssh-tpm-add manual
.\"    Source: ssh-tpm-agent v0.9.0
.\"  Language: Persian
.\"
.TH "SSH\-TPM\-ADD" "1" "2026-08-10" "ssh\-tpm\-agent v0.9.0" "ssh\-tpm\-add manual"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH "نام (NAME)"
ssh\-tpm\-add \- کلیدهای خصوصی را به ssh\-tpm\-agent اضافه می‌کند
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBssh\-tpm\-add\fP [\fB\-c\fP]
.sp
\fBssh\-tpm\-add\fP [\fB\-c\fP] [\fIPATH\fP .\|.\|.]
.SH "توضیحات (DESCRIPTION)"
.sp
دستور \fBssh\-tpm\-add\fP کلیدهای خصوصی محافظت‌شده توسط TPM (TPM-wrapped) را به \fBssh\-tpm\-agent\fP(1) اضافه می‌کند. هر کلیدی که به‌عنوان آرگومان مشخص شود، به عامل در حال اجرا اضافه خواهد شد.
.sp
این دستور نیازمند آن است که متغیر محیطی \fBSSH_TPM_AUTH_SOCK\fP به یک سوکت دامنه یونیکس (UNIX domain socket) فعال که عاملی روی آن در حال شنود است، اشاره کند.
.sp
اگر هیچ فایلی مشخص نشود، این برنامه تلاش می‌کند کلیدهای پیش‌فرض \fB~/.ssh/id_ecdsa.tpm\fP و \fB~/.ssh/id_rsa.tpm\fP را بارگذاری کند.
.SH "گزینه‌ها (OPTIONS)"
.sp
\fB\-c\fP
.RS 4
نشان می‌دهد که هویت‌های اضافه‌شده باید پیش از استفاده برای احراز هویت، مورد تأیید قرار گیرند. تأیید توسط \fBssh\-tpm\-agent\fP(1) از طریق \fBSSH_ASKPASS\fP انجام می‌شود. تأیید موفقیت‌آمیز به جای متنی که در درخواست‌کننده وارد می‌شود، با وضعیت خروج صفر از برنامهٔ askpass اعلام می‌گردد. این رفتار مشابه گزینهٔ \fB\-c\fP در \fBssh\-add\fP(1) است.
.RE
.SH "محیط (ENVIRONMENT)"
.sp
\fBSSH_TPM_AUTH_SOCK\fP
.RS 4
مسیر یک سوکت دامنه یونیکس (unix\-domain socket) را برای برقراری ارتباط با عامل مشخص می‌کند.
.sp
پیش‌فرض \fI/var/tmp/ssh\-tpm\-agent.sock\fP است.
.RE
.SH "فایل‌ها (FILES)"
.sp
\fI~/ssh/id_rsa.tpm\fP, \fI~/ssh/id_ecdsa.tpm\fP
.RS 4
شامل کلیدهای خصوصی ssh مورد استفاده توسط \fBssh\-tpm\-agent\fP است. این‌ها فایل‌های کلید TPM 2.0 TSS هستند و به‌طور امن توسط TPM محافظت شده‌اند. این فایل‌ها می‌توانند به‌صورت عمومی به اشتراک گذاشته شوند زیرا تنها توسط همان TPM که در آن ساخته شده‌اند قابل استفاده هستند؛ با این حال، احتمالاً بهتر است این کار انجام نشود.
.RE
.sp
\fI~/ssh/id_rsa.pub\fP, \fI~/ssh/id_ecdsa.pub\fP
.RS 4
شامل کلیدهای عمومی ssh است. این کلیدها را می‌توان به‌صورت عمومی به اشتراک گذاشت و قالبی مشابه کلیدهای ایجادشده توسط \fBssh\-keygen\fP(1) دارند.
.RE
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBssh\-add\fP(1), \fBssh\-agent\fP(1), \fBssh\fP(1), \fBssh\-tpm\-keygen\fP(1), \fBssh\-keygen\fP(1)
.SH "یادداشت‌ها، استانداردها و موارد دیگر (NOTES, STANDARDS AND OTHER)"
.sp
.URL "https://www.hansenpartnership.com/draft\-bottomley\-tpm2\-keys.html" "مشخصات ASN.1 برای فایل‌های کلید TPM 2.0" ""