| SQ(1) | User Commands | SQ(1) |
نام (NAME)
sq-cert-list - فهرست کردن گواهیها و شناسههای کاربری
خلاصه دستور (SYNOPSIS)
sq cert list [گزینهها] FINGERPRINT|KEYID|PATTERN
توضیحات (DESCRIPTION)
فهرست کردن گواهیها و شناسههای کاربری.
گواهیها و شناسههای کاربریای (user ID) را که با یک پرسوجو مطابقت دارند، قابل استفاده بوده و امکان احراز هویت آنها وجود دارد فهرست میکند. بهطور پیشفرض، اتصالات (جفتهای گواهی و شناسه کاربری) باید کاملاً احراز هویت شده باشند. اگر هیچ گواهی یا اتصالی با پرسوجو مطابقت نداشته باشد، دستور یک کد خروج غیرصفر بازمیگرداند.
اگر هیچ پرسوجویی ارائه نشود، تمام اتصالاتی که قابل استفاده بوده و امکان احراز هویت آنها وجود دارد فهرست میشوند. در صورتی که چنین اتصالاتی وجود نداشته باشد، دستور همچنان با موفقیت خاتمه مییابد.
بهطور پیشفرض، گواهیهای غیرقابلاستفاده؛ یعنی آنهایی که طبق شیوهنامه (policy) معتبر نیستند، ابطال شدهاند، یا هنوز فعال نیستند، نادیده گرفته میشوند. به همین ترتیب، خودامضاهای شناسه کاربری و گواهیگذاریهایی (certifications) که بر اساس شیوهنامه معتبر نباشند، و شناسههای کاربری ابطالشده نیز نادیده گرفته میشوند.
گزینهها (OPTIONS)
گزینههای زیرفرمان
- --amount=AMOUNT
- میزان اعتماد (trust) مورد نیاز
- مقدار ۱۲۰ نشاندهنده احراز هویت کامل است؛ مقادیر کمتر از ۱۲۰ نشاندهنده احراز هویت جزئی هستند. هنگامی که `--certification-network` ارسال شود، این مقدار بهطور پیشفرض ۱۲۰۰ خواهد بود؛ یعنی این دستور تلاش میکند ۱۰ مسیر را بیابد.
- --cert=FINGERPRINT|KEYID
- فهرست کردن گواهیها با اثرانگشت (fingerprint) یا شناسه کلید (key ID) مشخصشده
- نکته: اثرانگشتها و شناسههای کلید، شناسههای خوداحرازگر هستند. بنابراین، گواهی با اثرانگشت یا شناسه کلید مشخصشده، احراز هویت شده در نظر گرفته میشود؛ و نیازی به احراز هویت هیچ شناسه کاربریای نیست.
- --cert-domain=DOMAIN
- فهرست کردن اتصالاتی با شناسههای کاربری که حاوی یک نشانی ایمیل در دامنه مشخصشده هستند
- دامنه یک شناسه کاربری در صورت وجود، از نشانی ایمیل استخراج شده و با انجام عادیسازی puny-code یکدست میشود.
- --cert-email=EMAIL
- فهرست کردن اتصالاتی با شناسههای کاربری که حاوی نشانی ایمیل مشخصشده هستند
- نشانیهای ایمیل ابتدا با انجام عادیسازی puny-code روی دامنه و تبدیل بخش محلی (local part) به حروف کوچک در اصطلاحاً empty locale عادیسازی میشوند.
- --cert-grep=PATTERN
- فهرست کردن اتصالاتی با یک شناسه کاربری که حاوی الگو باشد
- یک جستجوی زیررشته بدون حساسیت به بزرگی و کوچکی حروف انجام میدهد. یکسانسازی حروف (case-folding) در empty locale انجام میشود.
- --cert-userid=USERID
- فهرست کردن اتصالاتی با شناسه کاربری مشخصشده
- شناسه کاربری باید دقیقاً مطابقت داشته باشد.
- --certification-network
- در نظر گرفتن شبکه بهعنوان یک شبکه گواهیگذاری (certification network)
- بهطور معمول، سازوکار احراز هویت شبکه Web of Trust را بهصورت یک شبکه احراز هویت در نظر میگیرد که در آن یک صدور گواهی تنها به این معناست که اتصال صحیح است، نه اینکه با هدف باید مانند یک معرف مورد اعتماد (trusted introducer) رفتار شود. در یک شبکه گواهیگذاری، اهداف گواهیها بهعنوان معرفهای مورد اعتماد با عمق نامحدود در نظر گرفته میشوند و هرگونه عبارت باقاعده (regular expression) نادیده گرفته میشود. نکته: میزان اعتماد بدون تغییر باقی میماند. بیشتر الگوریتمهای موسوم به مسیریابی PGP به این شکل عمل میکنند.
- --gossip
- در نظر گرفتن همه گواهیها بهعنوان ریشههای اعتماد غیرقابلاطمینان
- این گزینه برای پی بردن به دیدگاه دیگران درباره یک گواهی (یعنی شایعه یا شنیدهها) مفید است. به عبارت دیگر، این گزینه مسیرهای دلخواهی را به یک گواهی خاص پیدا میکند.
- شایعه (gossip) در شناسایی روشهای جایگزین برای احراز هویت یک گواهی کاربرد دارد. برای نمونه، فرض کنید Ed میخواهد گواهی Laura را احراز هویت کند، اما پرسیدن مستقیم از او مقدور یا ساده نیست. Ed متوجه میشود که Micah گواهی Laura را تأیید کرده است، اما Ed هنوز گواهی Micah را احراز هویت نکرده است. اگر Ed تمایل داشته باشد به Micah بهعنوان یک معرف مورد اعتماد تکیه کند، و احراز هویت گواهی Micah سادهتر از احراز هویت گواهی Laura باشد، در این صورت Ed روش سادهتری را برای احراز هویت گواهی Laura پیدا کرده است.
- از نسخه 1.1.0 پایدار است.
- --show-paths
- نمایش دلیل احراز هویت یک اتصال
- بهطور پیشفرض، فقط میزان احراز هویت اتصالِ شناسه کاربری و گواهی (مقداری بین ۰ و ۱۲۰) نمایش داده میشود. این گزینه خروجی را تغییر میدهد تا با نمایش مسیرها از ریشههای اعتماد به اتصالات، نحوه محاسبه آن مقدار را نیز نشان دهد.
- --unusable
- نمایش اتصالاتی که غیرقابلاستفاده هستند
- بهطور معمول، گواهیها و اتصالات غیرقابلاستفاده نمایش داده نمیشوند. این گزینه اتصالات را لحاظ میکند، حتی اگر به دلیل اینکه آنها (یا گواهیها) طبق شیوهنامه معتبر نیستند، ابطال شدهاند، یا هنوز فعال نیستند، غیرقابلاستفاده شده باشند.
- این گزینه تنها به همراه `--gossip` معنا دارد، زیرا اتصالات غیرقابلاستفاده همچنان احراز هویتنشده تلقی میشوند.
- از نسخه 1.1.0 پایدار است.
-
FINGERPRINT|KEYID|PATTERN - فهرست کردن گواهیهای منطبق با الگو
- اگر به نظر برسد که الگو یک اثرانگشت یا شناسه کلید است، طوری با آن رفتار میشود که گویی به `--cert` داده شده است که بر اساس اثرانگشت گواهی مطابقت داده میشود. در غیر این صورت، طوری رفتار میشود که گویی به `--cert-grep` داده شده است که بر اساس شناسههای کاربری مطابقت داده میشود.
گزینههای عمومی
برای شرح گزینههای عمومی، sq(1) را ببینید.
مثالها (EXAMPLES)
فهرست کردن تمام اتصالات شناسههای کاربری که شامل یک نشانی ایمیل از 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
همچنین ببینید (SEE ALSO)
برای مستندات کامل https://book.sequoia-pgp.org را ببینید.
| 1.4.0 | Sequoia PGP |