نام (NAME)

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

خلاصه دستور (SYNOPSIS)

sq pki vouch add [OPTIONS]
sq pki vouch authorize [OPTIONS]
sq pki vouch list [OPTIONS]
sq pki vouch replay [OPTIONS]

توضیحات (DESCRIPTION)

مدیریت گواهی‌ها (certifications).

یک تأییدیه یا ضمانت (vouch) بیانیه‌ای بالقوه عمومی است مبنی بر اینکه چیزی درست است. در OpenPGP دو نوع اصلی از بیانیه‌ها وجود دارد که می‌توانید صادر کنید: صدور گواهی (certifications) و اعطای اختیارات (authorizations).

می‌توانید تصدیق کنید که یک گواهی (certificate) متعلق به نهادی خاص است. این کار چیزی درباره قابل اعتماد بودن آن نهاد بیان نمی‌کند. به عنوان مثال، ممکن است `bob@nsa.gov` را برای یک گواهی معین تأیید کنید. این صرفاً بدان معناست که فکر می‌کنید شخصِ پشت آدرس ایمیل `bob@nsa.gov` واقعاً آن گواهی را تحت کنترل دارد. این بیانیه‌ای مفید است، حتی اگر به آن شخص برای اقدام در جهت منافعتان اعتماد نداشته باشید.

در روشی دیگر، می‌توانید اعلام کنید که به نظر شما یک گواهی، یک «معرف مورد اعتماد» (trusted introducer) منطقی است. معرف مورد اعتماد شخص ثالثی است که به او اجازه می‌دهید معرف دیگران باشد. به عنوان مثال، بانک شما ممکن است یک مرجع صدور گواهی (CA) داشته باشد. اگر اثرانگشت (fingerprint) آن CA را تأیید کنید، می‌توانید به آن اختیار دهید تا اقدام به صدور گواهی کند. این بدان معناست که sq از آن گواهی‌ها تقریباً طوری استفاده خواهد کرد که گویی خودتان آن‌ها را صادر کرده‌اید. این ویژگی کارآمد است زیرا اکنون می‌توانید هر یک از کارکنان بانک را احراز هویت کنید.

اعطای اختیار به یک معرف مورد اعتماد، قدرت زیادی به آن می‌دهد. می‌توانید با محدود کردن اختیارات اعطایی، این قدرت را مهار کنید؛ برای مثال مشخص کنید که این معرف تنها مجاز است شناسه‌های کاربری (user ID) دارای آدرس ایمیل در یک یا چند دامنه خاص را تأیید کند. به این ترتیب، می‌توانید از مواردی که منافع شما و یک CA هم‌سو است بهره ببرید و خود را از اقدامات بالقوه مخرب محافظت کنید. برای مثال، می‌توانید به CA بانکتان اجازه دهید شناسه‌های کاربری دارای آدرس ایمیل در `bank.com` را تأیید کند. سپس sq هرگونه گواهی دیگری را که توسط آن CA صادر شود نادیده خواهد گرفت.

زیردستورها (SUBCOMMANDS)

sq pki vouch add

تأیید یک شناسه کاربری (User ID) برای یک گواهی.

با استفاده از یک گواهی (certification)، دارنده کلید می‌تواند صحت این موضوع را که گواهی دیگری به طور قانونی به یک شناسه کاربری تعلق دارد تضمین کند (vouch). در زمینه ایمیل‌ها، این یعنی همان هویت، کنترل کلید و آدرس ایمیل را در دست دارد. این نوع گواهی‌ها مبنای شبکه اعتماد (Web of Trust) را تشکیل می‌دهند.

این دستور گواهی را به همراه گواهیِ جدید صادر می‌کند. گواهی به‌روزشده باید توزیع شود، ترجیحاً با ارسال آن به دارنده گواهی برای دریافت تأیید. همچنین `sq key approvals` را ببینید.

به‌طور پیش‌فرض یک گواهی پس از ۱۰ سال منقضی می‌شود. با استفاده از آرگومان `--expiration` می‌توان دوره‌های اعتبار خاصی را تعیین کرد. این آرگومان امکان تعیین یک نقطه زمانی برای پایان اعتبار یا مدت‌زمان اعتبار را فراهم می‌کند.

دستور `sq pki vouch add` از زمان مرجع تعیین‌شده توسط آرگومان سطح بالای `--time` تبعیت می‌کند. این دستور زمان ایجاد گواهی را روی زمان مرجع تنظیم می‌کند.

sq pki vouch authorize

علامت‌گذاری یک گواهی به عنوان معرف مورد اعتماد (trusted introducer).

گواهی‌ای ایجاد می‌کند مبنی بر این که صادرکننده، آن گواهی را یک معرف مورد اعتماد می‌داند. معرف مورد اعتماد نام دیگری برای مرجع صدور گواهی (CA) است. هنگامی که یک کاربر به یک معرف مورد اعتماد اتکا می‌کند، گواهی‌های صادرشده توسط آن معرف مورد اعتماد را معتبر تلقی می‌کند. یک معرف مورد اعتماد می‌تواند معرف‌های مورد اعتماد دیگری را نیز تعیین کند.

در حالت عادی، یک معرف مورد اعتماد قدرت بسیار زیادی دارد. این قدرت را می‌توان به چند روش محدود کرد:

- امکان تعیین معرف‌های بعدی را می‌توان با استفاده از پارامتر `--depth` محدود کرد.

- میزان اعتماد به یک معرف را می‌توان با استفاده از پارامتر `--amount` تغییر داد.

- شناسه‌های کاربری که یک معرف می‌تواند تأیید کند را می‌توان با استفاده از پارامتر `--domain` بر اساس دامنه یا با استفاده از پارامتر `--regex` با یک عبارت منظم محدود کرد.

این سازوکارها به عنوان مثال به Alice اجازه می‌دهند بگوید که مایل است به CA متعلق به example.org اعتماد کند، اما فقط برای شناسه‌های کاربری که آدرس ایمیلی در example.org دارند.

به‌طور پیش‌فرض یک تفویض اختیار پس از ۱۰ سال منقضی می‌شود. برای تغییر این مقدار از آرگومان `--expiration` استفاده کنید.

این زیردستور از زمان مرجع تعیین‌شده توسط آرگومان سطح بالای `--time` تبعیت می‌کند. این دستور زمان ایجاد گواهی را روی زمان مرجع تنظیم می‌کند.

sq pki vouch list

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

اگر آرگومان certifier ارائه شود، گواهی‌های صادرشده توسط گواهی مشخص‌شده نشان داده می‌شوند. اگر آرگومان certificate ارائه شود، گواهی‌های مربوط به گواهی مشخص‌شده نشان داده می‌شوند. اگر هر دو ارائه شوند، گواهی‌های مربوط به گواهی مشخص‌شده که توسط صادرکننده مشخص‌شده ایجاد شده‌اند، نشان داده می‌شوند.

این دستور همه گواهی‌ها را فهرست می‌کند، نه فقط گواهی‌های فعال را.

از آنجا که گواهی‌ها به گواهیِ تأییدشده مرتبط هستند و نه به گواهی صادرکننده، این فهرست احتمالاً ناقص است.

پایدار از نسخه 1.2.0.

sq pki vouch replay

بازپخش تأییدیه‌ها.

این دستور تأییدیه‌های صادرشده توسط یک گواهی را با استفاده از گواهی دیگری بازپخش (مجدداً اعمال) می‌کند. این ویژگی عمدتاً زمانی مفید است که یک گواهی را جایگزین می‌کنید و می‌خواهید گواهی جدید همان تأییدیه‌هایی را داشته باشد که با گواهی قدیمی صادر کرده بودید.

از آنجا که گواهی‌ها به گواهیِ تأییدشده پیوند دارند و نه به گواهی صادرکننده، این دستور ممکن است همه گواهی‌هایی را که منبع تاکنون صادر کرده بازپخش نکند.

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

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

پایدار از نسخه 1.2.0.

مثال‌ها (EXAMPLES)

sq pki vouch

صدور گواهی برای EB28F26E2739A4870ECC47726F0073F60FD0CBF0 جهت alice@example.org.

sq pki vouch add \

--certifier=E7FC51AD886BBB5C4F44C3D7A9DA14F3E740F63F \

--cert=EB28F26E2739A4870ECC47726F0073F60FD0CBF0 \

--email=alice@example.org

تأیید EB28F26E2739A4870ECC47726F0073F60FD0CBF0 به عنوان معرف مورد اعتماد برای example.org.

sq pki vouch authorize \

--certifier=E7FC51AD886BBB5C4F44C3D7A9DA14F3E740F63F \

--cert=EB28F26E2739A4870ECC47726F0073F60FD0CBF0 \

--domain=example.org --all

sq pki vouch add

آلیس (Alice) تأیید می‌کند که باب (Bob) کنترل 3F68CB84CE537C9A و bob@example.org را در اختیار دارد.

sq pki vouch add \

--certifier=EB28F26E2739A4870ECC47726F0073F60FD0CBF0 \

--cert=511257EBBF077B7AEDAE5D093F68CB84CE537C9A \

--email=bob@example.org

آلیس تأیید می‌کند که باب کنترل 3F68CB84CE537C9A و bob@bobs.lair.net را که یک شناسه کاربری خودامضاشده نیست، در اختیار دارد.

sq pki vouch add \

--certifier=EB28F26E2739A4870ECC47726F0073F60FD0CBF0 \

--cert=511257EBBF077B7AEDAE5D093F68CB84CE537C9A \

--add-email=bob@bobs.lair.net

sq pki vouch authorize

تأیید اینکه E7FC51AD886BBB5C4F44C3D7A9DA14F3E740F63F یک معرف مورد اعتماد برای example.org و example.com است.

sq pki vouch authorize \

--certifier=EB28F26E2739A4870ECC47726F0073F60FD0CBF0 \

--cert=E7FC51AD886BBB5C4F44C3D7A9DA14F3E740F63F \

--domain=example.org --domain=example.com --all

sq pki vouch list

فهرست کردن گواهی‌های صادرشده توسط آلیس.

sq pki vouch list \

--certifier=EB28F26E2739A4870ECC47726F0073F60FD0CBF0

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

sq pki vouch list \

--certifier=EB28F26E2739A4870ECC47726F0073F60FD0CBF0 \

--cert=511257EBBF077B7AEDAE5D093F68CB84CE537C9A

sq pki vouch replay

آلیس یک گواهی جدید تولید می‌کند و گواهی‌هایی را که با گواهی قدیمی صادر کرده بود با استفاده از گواهی جدید مجدداً اعمال (بازپخش) می‌کند.

sq pki vouch replay \

--source=EB28F26E2739A4870ECC47726F0073F60FD0CBF0 \

--target=C5999E8191BF7B503653BE958B1F7910D01F86E5

همچنین ببینید (SEE ALSO)

sq(1), sq-pki(1), sq-pki-vouch-add(1), sq-pki-vouch-authorize(1), sq-pki-vouch-list(1), sq-pki-vouch-replay(1).

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

نسخه (VERSION)

1.4.0