.TH SQ 1 1.4.0 "Sequoia PGP" "دستورهای کاربر (User Commands)"
.SH "نام (NAME)"
sq\-pki\-link\-add \- پیوند دادن یک گواهی و یک شناسه کاربر
.SH "خلاصه دستور (SYNOPSIS)"
.br
\fBsq pki link add\fR [\fIOPTIONS\fR]  
.SH "توضیحات (DESCRIPTION)"
پیوند دادن یک گواهی و یک شناسه کاربر (User ID).
.PP
این کار باعث می‌شود `sq` پیوند میان گواهی و شناسه کاربر را معتبر در نظر بگیرد. به عنوان مثال، اگر اطمینان دارید که یک گواهی مشخص باید با Alice مرتبط باشد، این کار را انجام می‌دهید. توجه: این کار گواهی را به عنوان معرفی‌کننده مورد اعتماد (trusted introducer) تلقی نمی‌کند؛ تنها پیوند را معتبر می‌داند. برای مجاز کردن یک گواهی به عنوان معرفی‌کننده مورد اعتماد از `sq pki link authorize` استفاده کنید.
.PP
یک پیوند را می‌توان با استفاده از `sq pki link retract` پس گرفت.
.PP
این دستور شبیه به `sq pki vouch add` است، اما تصدیق‌هایی که ایجاد می‌کند با استفاده از ریشه اعتماد (trust root) دایرکتوری گواهی انجام می‌شود، نه یک کلید دلخواه. علاوه بر این، گواهی‌ها به عنوان غیرقابل‌صدور (non\-exportable) علامت‌گذاری می‌شوند. مورد اول مدیریت تصدیق‌ها را آسان‌تر می‌کند، به‌ویژه زمانی که کلید تصدیق کاربر آفلاین است. و مورد دوم با کاهش احتمال لو رفتن بخش‌هایی از گراف اجتماعی کاربر هنگام همرسانی گواهی، حریم خصوصی کاربر را بهبود می‌بخشد.
.PP
به‌طور پیش‌فرض، یک پیوند هرگز منقضی نمی‌شود. این رفتار را می‌توان با استفاده از آرگومان `\-\-expiration` لغو کرد.
.PP
دستور `sq pki link add` زمان مرجع تعیین‌شده توسط آرگومان سطح بالای `\-\-time` را رعایت می‌کند و زمان ایجاد پیوند را برابر با زمان مرجع قرار می‌دهد.
.PP


.SH "گزینه‌ها (OPTIONS)"
.SS "گزینه‌های زیردستور (Subcommand options)"
.TP
\fB\-\-add\-email\fR=\fIEMAIL\fR
استفاده از شناسه کاربری با نشانی ایمیل مشخص‌شده
.IP
شناسه کاربر تنها از نشانی ایمیل تشکیل می‌شود. نشانی ایمیل الزامی ندارد که در یک شناسه کاربر خودامضاشده (self\-signed) آمده باشد.
.TP
\fB\-\-add\-userid\fR=\fIUSERID\fR
استفاده از شناسه کاربر مشخص‌شده
.IP
شناسه کاربر مشخص‌شده نیازی ندارد که خودامضا باشد.
.IP
از آنجا که استفاده از شناسه کاربری که خودامضا نیست اغلب یک اشتباه است، برای استفاده از آن باید صراحتاً این گزینه را مشخص کنید.
.TP
\fB\-\-all\fR
استفاده از همه شناسه‌های کاربر خودامضاشده
.TP
\fB\-\-allow\-non\-canonical\-userids\fR
رد نکردن شناسه‌های کاربری جدیدی که در قالب استاندارد (canonical) نیستند
.IP
شناسه‌های کاربر استاندارد به صورت `Name (Comment) <localpart@example.org>` هستند.
.TP
\fB\-\-amount\fR=\fIAMOUNT\fR
تنظیم میزان اعتماد
.IP
مقدارهای بین 1 و 120 معنادار هستند. مقدار 120 به معنای اعتماد کامل است. مقدارهای کمتر از 120 درجه اعتماد را نشان می‌دهند. معمولاً مقدار 60 برای اعتماد نسبی استفاده می‌شود.
.IP
[پیش‌فرض: \fBfull\fR]
.TP
\fB\-\-cert\fR=\fIFINGERPRINT|KEYID\fR
استفاده از گواهی‌های دارای اثرانگشت یا شناسه کلید (key ID) مشخص‌شده
.TP
\fB\-\-cert\-special\fR=\fISPECIAL\fR
استفاده از گواهی‌های مشخص‌شده با نام ویژه
.IP
[مقدارهای ممکن: \fBpublic\-directories\fR، \fBkeys.openpgp.org\fR، \fBkeys.mailvelope.com\fR، \fBproton.me\fR، \fBwkd\fR، \fBdane\fR، \fBautocrypt\fR، \fBweb\fR]
.TP
\fB\-\-email\fR=\fIEMAIL\fR
استفاده از شناسه کاربری که تنها شامل نشانی ایمیل است، در صورتی که نشانی ایمیل در یک شناسه کاربر خودامضاشده آمده باشد
.TP
\fB\-\-expiration\fR=\fIEXPIRATION\fR
تنظیم زمان انقضا
.IP
مقدار EXPIRATION یا یک تاریخ با قالب ISO 8601 همراه با زمان اختیاری است یا یک مدت‌زمان سفارشی. مدت‌زمان به صورت `N[ymwds]` مشخص می‌شود که حروف به ترتیب نمایانگر سال، ماه، هفته، روز و ثانیه هستند. همچنین، کلمه کلیدی `never` هیچ زمان انقضایی تعیین نمی‌کند.
.IP
[پیش‌فرض: \fBnever\fR]
.TP
\fB\-\-recreate\fR
ایجاد مجدد امضا حتی اگر پارامترها تغییری نکرده باشند
.IP
اگر پارامترهای پیوند تغییر نکرده باشند و در نتیجه نیازی به ایجاد امضا نباشد، از این عملیات صرف‌نظر می‌شود. این پرچم می‌تواند برای واداشتن برنامه به ایجاد مجدد امضا در هر صورت استفاده شود.
.TP
\fB\-\-signature\-notation\fR \fINAME\fR \fIVALUE\fR
افزودن یک نشانه‌گذاری (notation) به امضا
.IP
نام نشانه‌گذاری تعریف‌شده توسط کاربر باید به صورت `name@a.domain.you.control.org` باشد. اگر نام نشانه‌گذاری با `!` آغاز شود، نشانه‌گذاری به عنوان بحرانی (critical) علامت‌گذاری می‌شود. اگر پردازش‌کننده یک امضا نشانه‌گذاری بحرانی را درک نکند، از امضا صرف‌نظر خواهد کرد. این نشانه‌گذاری به عنوان خوانا برای انسان مشخص می‌شود.
.TP
\fB\-\-temporary\fR
پذیرش موقت پیوند
.IP
یک پیوند با اعتماد کامل بین یک گواهی و یک یا چند شناسه کاربر برای مدت یک هفته ایجاد می‌کند. پس از آن، پیوند به‌طور خودکار به یک پیوند با اعتماد نسبی (میزان اعتماد = 40) تنزل می‌یابد.
.TP
\fB\-\-userid\fR=\fIUSERID\fR
استفاده از شناسه کاربر خودامضاشده مشخص‌شده
.IP
شناسه کاربر مشخص‌شده باید خودامضا باشد.
.TP
\fB\-\-userid\-by\-email\fR=\fIEMAIL\fR
استفاده از شناسه کاربر خودامضاشده با نشانی ایمیل مشخص‌شده
.SS "گزینه‌های عمومی (Global options)"
برای شرح گزینه‌های عمومی، \fBsq\fR(1) را ببینید.
.SH "مثال‌ها (EXAMPLES)"
.PP

.PP
پیوند دادن گواهی EB28F26E2739A4870ECC47726F0073F60FD0CBF0 با نشانی
ایمیل alice@example.org.
.PP
.nf
.RS
sq pki link add \\
.RE
.RS
.RS
\-\-cert=EB28F26E2739A4870ECC47726F0073F60FD0CBF0 \\
.RE
.RE
.RS
.RS
\-\-email=alice@example.org
.RE
.RE
.PP
.fi

.PP
ابتدا بررسی گواهی EB28F26E2739A4870ECC47726F0073F60FD0CBF0.
.PP
.nf
.RS
sq inspect \-\-cert=EB28F26E2739A4870ECC47726F0073F60FD0CBF0
.RE
.PP
.fi

.PP
سپس، پذیرش موقت گواهی
EB28F26E2739A4870ECC47726F0073F60FD0CBF0 با تمام شناسه‌های کاربر
خودامضاشده آن برای مدت یک هفته.
.PP
.nf
.RS
sq pki link add \-\-expiration=1w \\
.RE
.RS
.RS
\-\-cert=EB28F26E2739A4870ECC47726F0073F60FD0CBF0 \-\-all
.RE
.RE
.PP
.fi

.PP
پس از اطمینان، پذیرش دائمی گواهی
EB28F26E2739A4870ECC47726F0073F60FD0CBF0 با تمام شناسه‌های کاربر
خودامضاشده آن.
.PP
.nf
.RS
sq pki link add \\
.RE
.RS
.RS
\-\-cert=EB28F26E2739A4870ECC47726F0073F60FD0CBF0 \-\-all
.RE
.RE
.fi
.SH "همچنین ببینید (SEE ALSO)"
.nh
\fBsq\fR(1), \fBsq\-pki\fR(1), \fBsq\-pki\-link\fR(1).
.hy
.PP
برای مستندات کامل <https://book.sequoia\-pgp.org> را ببینید.
.SH "نسخه (VERSION)"
1.4.0