SQ(1) دستورهای کاربر SQ(1)

sq-cert - مدیریت گواهی‌ها

sq cert import [OPTIONS] FILE
sq cert export [OPTIONS]
sq cert list [OPTIONS] FINGERPRINT|KEYID|PATTERN
sq cert lint [OPTIONS]

مدیریت گواهی‌ها.

ما از اصطلاح «گواهی» (certificate) یا به‌کوتاهی «cert» برای اشاره به کلیدهای OpenPGP که حاوی اطلاعات محرمانه (کلید خصوصی) نیستند، استفاده می‌کنیم. این زیردستور ابزارهای پایه‌ای برای تولید و مدیریت این گواهی‌ها فراهم می‌آورد.

در مقابل، ما از اصطلاح «کلید» (key) برای اشاره به کلیدهای OpenPGP که شامل اطلاعات محرمانه هستند استفاده می‌کنیم. برای انجام عملیات روی کلیدها، `sq key` را ببینید.

وارد کردن گواهی‌ها به مخزن محلی گواهی‌ها.

صادر کردن گواهی‌ها از مخزن محلی گواهی‌ها.

اگر چندین شرط تعیین شده باشد، در صورتی که حداقل یکی از آن‌ها مطابقت داشته باشد، گواهی بازگردانده می‌شود.

این دستور اصالت گواهی‌ها را به هیچ وجه بررسی نمی‌کند. پیش از استفاده از گواهی‌ها، حتماً آن‌ها را اعتبارسنجی و اصالت‌سنجی کنید.

هنگام تطبیق با زیرکلیدها (subkeys) یا شناسه‌های کاربری (User IDs)، مؤلفه باید با توجه به شیوه‌نامه (policy) دارای یک خودامضای (self signature) معتبر باشد.

اگر معیارهای جستجو تعیین شده باشند و هیچ‌یک با گواهی‌ها تطابق نداشته باشند، دستور با شکست مواجه می‌شود. توجه: این بدان معناست که اگر مخزن گواهی خالی باشد و هیچ معیار جستجویی تعیین نشده باشد، عملیات با موفقیت پایان می‌یابد.

فهرست کردن گواهی‌ها و شناسه‌های کاربری.

فهرست کردن گواهی‌ها و شناسه‌های کاربری که با پرس‌وجو تطابق دارند، قابل استفاده هستند و امکان اصالت‌سنجی آن‌ها وجود دارد. به‌طور پیش‌فرض، اتصالات (جفت‌های گواهی و شناسهٔ کاربری) باید به‌طور کامل اصالت‌سنجی شده باشند. اگر هیچ گواهی یا اتصالی با پرس‌وجو مطابقت نداشته باشد، دستور با کد خروج غیرصفر بازمی‌گردد.

اگر هیچ پرس‌وجویی ارائه نشود، تمام اتصالاتی که قابل استفاده بوده و امکان احراز اصالت آن‌ها وجود دارد فهرست می‌شوند. در صورتی که چنین اتصالاتی وجود نداشته باشد، دستور همچنان با موفقیت پایان می‌یابد.

به‌طور پیش‌فرض، گواهی‌های غیرقابل‌استفاده، یعنی مواردی که با توجه به شیوه‌نامه نامعتبرند، باطل شده‌اند، یا فعال نیستند، نادیده گرفته می‌شوند. به همین ترتیب، خودامضاها و گواهی‌گذاری‌های شناسه کاربری که با توجه به شیوه‌نامه نامعتبر هستند و همچنین شناسه‌های کاربری باطل‌شده نادیده گرفته می‌شوند.

بررسی گواهی‌ها برای یافتن مشکلات.

دستور `sq cert lint` گواهی‌های ارائه‌شده را برای مشکلات مرتبط با SHA-1 زیر بررسی می‌کند:


- آیا ابطال یک گواهی از SHA-1 استفاده می‌کند یا خیر.


- آیا خودامضای فعلی برای یک User ID ابطال‌نشده از SHA-1 استفاده می‌کند یا خیر.


- آیا امضای پیوند زیرکلید فعلی برای یک زیرکلید ابطال‌نشده و فعال، از SHA-1 استفاده می‌کند یا خیر.


- آیا امضای پیوند کلید اصلی («backsig») برای یک زیرکلید ابطال‌نشده و فعال، از SHA-1 استفاده می‌کند یا خیر.

پیام‌های عیب‌یابی در stderr چاپ می‌شوند. در پایان، آماری نمایش داده می‌شود. این قابلیت هنگام بررسی یک دسته‌کلید (keyring) بسیار مفید است. اگر `--fix` مشخص شده باشد و حداقل یک مورد قابل رفع باشد، گواهی‌های اصلاح‌شده در stdout چاپ می‌شوند.

این ابزار در حال حاضر از کارت‌های هوشمند پشتیبانی نمی‌کند. اما اگر تنها زیرکلیدها روی کارت هوشمند قرار داشته باشند، این ابزار ممکن است همچنان بتواند گواهی را تا حدی ترمیم کند. به‌ویژه، قادر خواهد بود هرگونه مشکل مربوط به خودامضاهای User ID و امضاهای پیوند زیرکلید را برای زیرکلیدهای با قابلیت رمزنگاری رفع کند، اما قادر به تولید امضاهای پیوند کلید اصلی جدید برای زیرکلیدهای با قابلیت امضا نخواهد بود.

وارد کردن یک گواهی.

sq cert import juliet.pgp

صادر کردن گواهی‌های دارای User ID شامل نشانی ایمیل.

sq cert export --cert-email=alice@example.org

صادر کردن گواهی‌هایی که دارای یک User ID با *یکی* از نشانی‌های ایمیل (نه هر دو!) باشند.

sq cert export --cert-email=alice@example.org \
--cert-email=bob@example.org

صادر کردن تمام گواهی‌ها.

sq cert export --all

فهرست کردن تمام اتصالات شناسه‌های کاربری که حاوی یک نشانی ایمیل از example.org بوده و امکان اصالت‌سنجی آن‌ها وجود دارد.

sq cert list @example.org

فهرست کردن تمام اتصالات اصالت‌سنجی‌شده برای شناسه‌های کاربری شامل یک نشانی ایمیل خاص.

sq cert list --cert-email=alice@example.org

فهرست کردن تمام مسیرهای منتهی به گواهی‌های شامل یک نشانی ایمیل خاص.

sq cert list --gossip --show-paths \
--cert-email=alice@example.org

جمع‌آوری آمار دربارهٔ گواهی‌های موجود در یک دسته‌کلید (keyring).

sq cert lint --cert-file certs.pgp

اصلاح کلیدی با مشکلات شناخته‌شده.

sq key export --cert EB28F26E2739A4870ECC47726F0073F60FD0CBF0 \
| sq cert lint --fix --cert-file=- \
| sq cert import

sq(1), sq-cert-import(1), sq-cert-export(1), sq-cert-list(1), sq-cert-lint(1).

برای مستندات کامل https://book.sequoia-pgp.org را ببینید.

1.4.0

1.4.0 Sequoia PGP