.TH SQ 1 1.4.0 "Sequoia PGP" "User Commands"
.SH "نام (NAME)"
sq\-pki\-authenticate \- احراز هویت یک پیوند
.SH "خلاصه دستور (SYNOPSIS)"
.br
\fBsq pki authenticate\fR [\fIOPTIONS\fR]  
.SH "توضیحات (DESCRIPTION)"
احراز هویت یک پیوند (binding).
.PP
احراز هویت یک پیوند (یک گواهی و User ID) با جستجوی مسیری از ریشه‌های اعتماد (trust roots) به پیوند مشخص‌شده در شبکهٔ اعتماد (Web of Trust). از آنجا که تصدیق‌ها ممکن است بیانگر عدم قطعیت باشند (یعنی تصدیق‌ها ممکن است دارای نشان اعتماد جزئی یا حاشیه‌ای باشند)، ممکن است به چندین مسیر نیاز باشد.
.PP
اگر هیچ پیوندی نتواند تا سطح مشخص‌شده احراز هویت شود (به‌طور پیش‌فرض: احراز هویت کامل، یعنی میزان اعتماد ۱۲۰)، خطایی برگردانده می‌شود.
.PP
اگر هرگونه مسیر معتبری به پیوند یافت شود، صرف‌نظر از این که برای احراز هویت پیوند کافی باشند یا خیر، در stdout چاپ می‌شوند.
.PP

.SH "گزینه‌ها (OPTIONS)"
.SS "گزینه‌های زیرفرمان (Subcommand options)"
.TP
\fB\-\-amount\fR=\fIAMOUNT\fR
میزان اعتماد مورد نیاز
.IP
مقدار ۱۲۰ نشان‌دهندهٔ احراز هویت کامل است؛ مقادیر کمتر از ۱۲۰ نشان‌دهندهٔ احراز هویت جزئی هستند. هنگامی که `\-\-certification\-network` ارسال شود، این مقدار به‌طور پیش‌فرض ۱۲۰۰ خواهد بود؛ یعنی این دستور تلاش می‌کند ۱۰ مسیر پیدا کند.
.TP
\fB\-\-cert\fR=\fIFINGERPRINT|KEYID\fR
استفاده از گواهی‌های دارای اثر انگشت (fingerprint) یا شناسه کلید (key ID) مشخص‌شده
.TP
\fB\-\-certification\-network\fR
شبکه را به عنوان یک شبکهٔ تصدیق (certification network) در نظر می‌گیرد
.IP
به‌طور معمول، سازوکار احراز هویت با شبکهٔ Web of Trust به عنوان یک شبکهٔ احراز هویت رفتار می‌کند که در آن یک تصدیق تنها به این معنی است که پیوند درست است، نه اینکه هدف باید به عنوان یک معرّف مورد اعتماد (trusted introducer) تلقی شود. در یک شبکهٔ تصدیق، هدف‌های تصدیق‌ها به عنوان معرف‌های مورد اعتماد با عمق نامحدود در نظر گرفته می‌شوند و هرگونه عبارت منظم (regular expression) نادیده گرفته می‌شود. توجه: میزان اعتماد بدون تغییر باقی می‌ماند. این شیوهٔ کارکردِ بیشتر الگوریتم‌های به‌اصطلاح مسیر‌یابی PGP است.
.TP
\fB\-\-email\fR=\fIEMAIL\fR
احراز هویت نشانی ایمیل مشخص‌شده
.IP
این گزینه بررسی می‌کند که آیا احراز هویت یک شناسهٔ کاربر (user ID) با نشانی ایمیل مشخص‌شده امکان‌پذیر است یا خیر. شناسه‌های کاربری نیازی به خودامضاشده (self-signed) بودن ندارند. برای احراز هویت یک user ID که فقط حاوی نشانی ایمیل مشخص‌شده است، از `\-\-userid <EMAIL>` استفاده کنید.
.TP
\fB\-\-gossip\fR
همهٔ گواهی‌ها را به عنوان ریشه‌های اعتماد غیرقابل‌اطمینان در نظر می‌گیرد
.IP
این گزینه برای فهمیدن نظر دیگران دربارهٔ یک گواهی (یعنی شایعه یا شنیده‌ها) مفید است. به عبارت دیگر، این گزینه مسیرهای دلخواهی را به یک گواهی خاص پیدا می‌کند.
.IP
شایعه (Gossip) در شناسایی راه‌های جایگزین برای احراز هویت یک گواهی مفید است. برای نمونه، تصور کنید Ed می‌خواهد گواهی Laura را احراز هویت کند، اما پرسش مستقیم از او دشوار یا نامناسب است. Ed متوجه می‌شود که Micah گواهی Laura را تصدیق کرده است، اما Ed هنوز گواهی Micah را احراز هویت نکرده است. اگر Ed مایل باشد به Micah به عنوان یک معرّف مورد اعتماد تکیه کند، و احراز هویت گواهی Micah آسان‌تر از احراز هویت گواهی Laura باشد، در این صورت Ed راه آسان‌تری را برای احراز هویت گواهی Laura یاد گرفته است.
.IP
پایدار از نسخهٔ 1.1.0.
.TP
\fB\-\-show\-paths\fR
نمایش دلیل احراز هویت شدن یک پیوند
.IP
به‌طور پیش‌فرض، فقط میزان احراز هویت پیوند یک گواهی و شناسهٔ کاربر (مقداری بین ۰ تا ۱۲۰) نمایش داده می‌شود. این گزینه خروجی را تغییر می‌دهد تا با نمایش مسیرها از ریشه‌های اعتماد به پیوندها، نحوهٔ محاسبهٔ آن مقدار را نیز نشان دهد.
.TP
\fB\-\-unusable\fR
نمایش پیوندهایی که غیرقابل‌استفاده هستند
.IP
به‌طور معمول، گواهی‌ها و پیوندهای غیرقابل‌استفاده نشان داده نمی‌شوند. این گزینه پیوندها را در نظر می‌گیرد، حتی اگر به دلیل این که خودشان (یا گواهی‌ها) مطابق خط‌مشی (policy) معتبر نیستند، باطل شده‌اند، یا فعال نیستند، غیرقابل‌استفاده باشند.
.IP
این گزینه تنها همراه با `\-\-gossip` معنا دارد، زیرا پیوندهای غیرقابل‌استفاده همچنان احراز هویت‌نشده تلقی می‌شوند.
.IP
پایدار از نسخهٔ 1.1.0.
.TP
\fB\-\-userid\fR=\fIUSERID\fR
احراز هویت شناسهٔ کاربری (user ID) مشخص‌شده
.IP
شناسهٔ کاربری مشخص‌شده نیازی به خودامضاشده بودن ندارد.
.SS "گزینه‌های عمومی (Global options)"
برای شرح گزینه‌های عمومی، \fBsq\fR(1) را ببینید.
.SH "مثال‌ها (EXAMPLES)"
.PP

.PP
احراز هویت یک پیوند مشخص.
.PP
.nf
.RS
sq pki authenticate \-\-cert \\
.RE
.RS
.RS
EB28F26E2739A4870ECC47726F0073F60FD0CBF0 \-\-userid \\
.RE
.RE
.RS
.RS
"Alice <alice@example.org>"
.RE
.RE
.PP
.fi

.PP
بررسی این که آیا می‌توان هر شناسهٔ کاربری با نشانی ایمیل مشخص‌شده را برای گواهی داده‌شده احراز هویت کرد یا خیر.
.PP
.nf
.RS
sq pki authenticate \-\-cert \\
.RE
.RS
.RS
EB28F26E2739A4870ECC47726F0073F60FD0CBF0 \-\-email \\
.RE
.RE
.RS
.RS
alice@example.org
.RE
.RE
.fi
.SH "همچنین ببینید (SEE ALSO)"
.nh
\fBsq\fR(1), \fBsq\-pki\fR(1).
.hy
.PP
برای مستندات کامل، <https://book.sequoia\-pgp.org> را ببینید.
.SH "نسخه (VERSION)"
1.4.0