.TH SQ 1 1.4.0 "Sequoia PGP" "دستورهای کاربر"
.SH "نام (NAME)"
sq\-cert \- مدیریت گواهی‌ها
.SH "خلاصه دستور (SYNOPSIS)"
.br
\fBsq cert import\fR [\fIOPTIONS\fR] \fIFILE\fR
.br
\fBsq cert export\fR [\fIOPTIONS\fR]  
.br
\fBsq cert list\fR [\fIOPTIONS\fR] \fIFINGERPRINT|KEYID|PATTERN\fR
.br
\fBsq cert lint\fR [\fIOPTIONS\fR]  
.SH "توضیحات (DESCRIPTION)"
مدیریت گواهی‌ها.
.PP
ما از اصطلاح «گواهی» (certificate) یا به‌کوتاهی «cert» برای اشاره به کلیدهای OpenPGP که حاوی اطلاعات محرمانه (کلید خصوصی) نیستند، استفاده می‌کنیم. این زیردستور ابزارهای پایه‌ای برای تولید و مدیریت این گواهی‌ها فراهم می‌آورد.
.PP
در مقابل، ما از اصطلاح «کلید» (key) برای اشاره به کلیدهای OpenPGP که شامل اطلاعات محرمانه هستند استفاده می‌کنیم. برای انجام عملیات روی کلیدها، `sq key` را ببینید.
.PP

.SH "زیردستورها (SUBCOMMANDS)"
.SS "sq cert import"
وارد کردن گواهی‌ها به مخزن محلی گواهی‌ها.
.PP

.SS "sq cert export"
صادر کردن گواهی‌ها از مخزن محلی گواهی‌ها.
.PP
اگر چندین شرط تعیین شده باشد، در صورتی که حداقل یکی از آن‌ها مطابقت داشته باشد، گواهی بازگردانده می‌شود.
.PP
این دستور اصالت گواهی‌ها را به هیچ وجه بررسی نمی‌کند. پیش از استفاده از گواهی‌ها، حتماً آن‌ها را اعتبارسنجی و اصالت‌سنجی کنید.
.PP
هنگام تطبیق با زیرکلیدها (subkeys) یا شناسه‌های کاربری (User IDs)، مؤلفه باید با توجه به شیوه‌نامه (policy) دارای یک خودامضای (self signature) معتبر باشد.
.PP
اگر معیارهای جستجو تعیین شده باشند و هیچ‌یک با گواهی‌ها تطابق نداشته باشند، دستور با شکست مواجه می‌شود. توجه: این بدان معناست که اگر مخزن گواهی خالی باشد و هیچ معیار جستجویی تعیین نشده باشد، عملیات با موفقیت پایان می‌یابد.
.PP


.SS "sq cert list"
فهرست کردن گواهی‌ها و شناسه‌های کاربری.
.PP
فهرست کردن گواهی‌ها و شناسه‌های کاربری که با پرس‌وجو تطابق دارند، قابل استفاده هستند و امکان اصالت‌سنجی آن‌ها وجود دارد. به‌طور پیش‌فرض، اتصالات (جفت‌های گواهی و شناسهٔ کاربری) باید به‌طور کامل اصالت‌سنجی شده باشند. اگر هیچ گواهی یا اتصالی با پرس‌وجو مطابقت نداشته باشد، دستور با کد خروج غیرصفر بازمی‌گردد.
.PP
اگر هیچ پرس‌وجویی ارائه نشود، تمام اتصالاتی که قابل استفاده بوده و امکان احراز اصالت آن‌ها وجود دارد فهرست می‌شوند. در صورتی که چنین اتصالاتی وجود نداشته باشد، دستور همچنان با موفقیت پایان می‌یابد.
.PP
به‌طور پیش‌فرض، گواهی‌های غیرقابل‌استفاده، یعنی مواردی که با توجه به شیوه‌نامه نامعتبرند، باطل شده‌اند، یا فعال نیستند، نادیده گرفته می‌شوند. به همین ترتیب، خودامضاها و گواهی‌گذاری‌های شناسه کاربری که با توجه به شیوه‌نامه نامعتبر هستند و همچنین شناسه‌های کاربری باطل‌شده نادیده گرفته می‌شوند.
.PP

.SS "sq cert lint"
بررسی گواهی‌ها برای یافتن مشکلات.
.PP
دستور `sq cert lint` گواهی‌های ارائه‌شده را برای مشکلات مرتبط با SHA\-1 زیر بررسی می‌کند:
.PP
  \- آیا ابطال یک گواهی از SHA\-1 استفاده می‌کند یا خیر.
.PP
  \- آیا خودامضای فعلی برای یک User ID ابطال‌نشده از SHA\-1 استفاده می‌کند یا خیر.
.PP
  \- آیا امضای پیوند زیرکلید فعلی برای یک زیرکلید ابطال‌نشده و فعال، از SHA\-1 استفاده می‌کند یا خیر.
.PP
  \- آیا امضای پیوند کلید اصلی («backsig») برای یک زیرکلید ابطال‌نشده و فعال، از SHA\-1 استفاده می‌کند یا خیر.
.PP
پیام‌های عیب‌یابی در stderr چاپ می‌شوند. در پایان، آماری نمایش داده می‌شود. این قابلیت هنگام بررسی یک دسته‌کلید (keyring) بسیار مفید است. اگر `\-\-fix` مشخص شده باشد و حداقل یک مورد قابل رفع باشد، گواهی‌های اصلاح‌شده در stdout چاپ می‌شوند.
.PP
این ابزار در حال حاضر از کارت‌های هوشمند پشتیبانی نمی‌کند. اما اگر تنها زیرکلیدها روی کارت هوشمند قرار داشته باشند، این ابزار ممکن است همچنان بتواند گواهی را تا حدی ترمیم کند. به‌ویژه، قادر خواهد بود هرگونه مشکل مربوط به خودامضاهای User ID و امضاهای پیوند زیرکلید را برای زیرکلیدهای با قابلیت رمزنگاری رفع کند، اما قادر به تولید امضاهای پیوند کلید اصلی جدید برای زیرکلیدهای با قابلیت امضا نخواهد بود.
.PP


.SH "مثال‌ها (EXAMPLES)"
.SS "sq cert import"
.PP

.PP
وارد کردن یک گواهی.
.PP
.nf
.RS
sq cert import juliet.pgp
.RE
.fi
.PP
.SS "sq cert export"
.PP

.PP
صادر کردن گواهی‌های دارای User ID شامل نشانی ایمیل.
.PP
.nf
.RS
sq cert export \-\-cert\-email=alice@example.org
.RE
.PP
.fi

.PP
صادر کردن گواهی‌هایی که دارای یک User ID با *یکی* از نشانی‌های ایمیل (نه هر دو!) باشند.
.PP
.nf
.RS
sq cert export \-\-cert\-email=alice@example.org \\
.RE
.RS
.RS
\-\-cert\-email=bob@example.org
.RE
.RE
.PP
.fi

.PP
صادر کردن تمام گواهی‌ها.
.PP
.nf
.RS
sq cert export \-\-all
.RE
.fi
.PP
.SS "sq cert list"
.PP

.PP
فهرست کردن تمام اتصالات شناسه‌های کاربری که حاوی یک نشانی ایمیل از example.org بوده و امکان اصالت‌سنجی آن‌ها وجود دارد.
.PP
.nf
.RS
sq cert list @example.org
.RE
.PP
.fi

.PP
فهرست کردن تمام اتصالات اصالت‌سنجی‌شده برای شناسه‌های کاربری شامل یک نشانی ایمیل خاص.
.PP
.nf
.RS
sq cert list \-\-cert\-email=alice@example.org
.RE
.PP
.fi

.PP
فهرست کردن تمام مسیرهای منتهی به گواهی‌های شامل یک نشانی ایمیل خاص.
.PP
.nf
.RS
sq cert list \-\-gossip \-\-show\-paths \\
.RE
.RS
.RS
\-\-cert\-email=alice@example.org
.RE
.RE
.fi
.PP
.SS "sq cert lint"
.PP

.PP
جمع‌آوری آمار دربارهٔ گواهی‌های موجود در یک دسته‌کلید (keyring).
.PP
.nf
.RS
sq cert lint \-\-cert\-file certs.pgp
.RE
.PP
.fi

.PP
اصلاح کلیدی با مشکلات شناخته‌شده.
.PP
.nf
.RS
sq key export \-\-cert EB28F26E2739A4870ECC47726F0073F60FD0CBF0 \\
.RE
.RS
.RS
| sq cert lint \-\-fix \-\-cert\-file=\- \\
.RE
.RE
.RS
.RS
| sq cert import
.RE
.RE
.fi
.SH "همچنین ببینید (SEE ALSO)"
.nh
\fBsq\fR(1), \fBsq\-cert\-import\fR(1), \fBsq\-cert\-export\fR(1), \fBsq\-cert\-list\fR(1), \fBsq\-cert\-lint\fR(1).
.hy
.PP
برای مستندات کامل <https://book.sequoia\-pgp.org> را ببینید.
.SH "نسخه (VERSION)"
1.4.0