| SQ(1) | User Commands | SQ(1) |
نام (NAME)
sq-pki-vouch-add - گواهی‌کردن یک شناسه کاربر برای یک گواهی
خلاصه دستور (SYNOPSIS)
sq pki vouch add [OPTIONS]
توضیحات (DESCRIPTION)
گواهی‌کردن یک شناسه کاربر (User ID) برای یک گواهی (Certificate).
با استفاده از یک تصدیق (certification)، دارنده کلید می‌تواند صحت تعلق قانونی یک گواهی به یک شناسه کاربر را تایید و تضمین (vouch) کند. در زمینه رایانامه‌ها، این بدان معناست که همان هویت، کنترل کلید و نشانی رایانامه را به‌طور همزمان در دست دارد. این نوع تصدیق‌ها اساس و پایه «شبکه اعتماد» (Web of Trust) را تشکیل می‌دهند.
این دستور، گواهی را به همراه تصدیق جدید صادر می‌کند. گواهی به‌روزشده باید توزیع شود؛ ترجیحاً با ارسال آن به دارنده‌ی گواهی جهت تایید. همچنین `sq key approvals` را ببینید.
به‌طور پیش‌فرض، یک تصدیق پس از ۱۰ سال منقضی می‌شود. با استفاده از آرگومان `--expiration` می‌توان دوره‌های اعتبار مشخصی را تعریف کرد. این گزینه امکان تعیین یک زمان مشخص برای پایان اعتبار یا تعیین مدت زمان اعتبار را فراهم می‌کند.
دستور `sq pki vouch add` از زمان مرجع تعیین‌شده توسط آرگومان سطح بالای `--time` پیروی می‌کند. این دستور زمان ایجاد تصدیق را بر روی زمان مرجع تنظیم می‌کند.
گزینه‌ها (OPTIONS)
گزینه‌های زیردستور (Subcommand options)
- --add-email=EMAIL
- استفاده از یک شناسه کاربر با نشانی رایانامه مشخص‌شده
- شناسه کاربر تنها از نشانی رایانامه تشکیل می‌شود. نیازی نیست که نشانی رایانامه در یک شناسه کاربر خودامضاشده وجود داشته باشد.
- --add-userid=USERID
- استفاده از شناسه کاربر مشخص‌شده
- شناسه کاربر مشخص‌شده نیازی به خودامضاشدن ندارد.
- از آنجا که استفاده از یک شناسه کاربر غیرخودامضا معمولاً یک اشتباه است، برای استفاده از آن باید صراحتاً از این گزینه استفاده کنید.
- --all
- استفاده از تمام شناسه‌های کاربر خودامضاشده
- --allow-non-canonical-userids
- رد نکردن شناسه‌های کاربر جدیدی که در قالب استاندارد (canonical) نیستند
- شناسه‌های کاربر استاندارد به صورت `Name (Comment) <localpart@example.org>` هستند.
- --amount=AMOUNT
- تنظیم میزان اعتماد
- مقدارهای بین ۱ تا ۱۲۰ معنادار هستند. مقدار ۱۲۰ به معنای اعتماد کامل است. مقادیر کمتر از ۱۲۰ درجه اعتماد را مشخص می‌کنند. مقدار ۶۰ معمولاً برای اعتماد نسبی استفاده می‌شود.
- [پیش‌فرض: full]
- --cert=FINGERPRINT|KEYID
- استفاده از گواهی‌های دارای اثرانگشت یا شناسه کلید مشخص‌شده
- --cert-file=PATH
- خواندن گواهی‌ها از PATH
- --certifier=FINGERPRINT|KEYID
- ایجاد تصدیق با استفاده از کلید دارای اثرانگشت یا شناسه کلید مشخص‌شده
- --certifier-email=EMAIL
- ایجاد تصدیق با استفاده از کلیدی که یکی از شناسه‌های کاربر آن شامل نشانی رایانامه مشخص‌شده باشد
- --certifier-file=PATH
- ایجاد تصدیق با استفاده از کلید خوانده‌شده از PATH
- --certifier-self
- ایجاد تصدیق با استفاده از کلید تصدیق پیش‌فرض شما
- این گزینه از گواهی‌های تعیین‌شده در فایل پیکربندی ذیل `pki.vouch.certifier-self` به‌عنوان کلید تصدیق استفاده می‌کند.
- در حال حاضر، هیچ کلید تصدیق پیش‌فرضی وجود ندارد.
- --certifier-userid=USERID
- ایجاد تصدیق با استفاده از کلید دارای شناسه کاربر مشخص‌شده
- --email=EMAIL
- استفاده از یک شناسه کاربر که تنها شامل نشانی رایانامه است، در صورتی که آن نشانی در یک شناسه کاربر خودامضاشده وجود داشته باشد
- --expiration=EXPIRATION
- تنظیم زمان انقضا
- مقدار EXPIRATION یا یک تاریخ با قالب ISO 8601 همراه با زمان اختیاری است، یا یک بازه زمانی سفارشی. بازه زمانی به صورت `N[ymwds]` مشخص می‌شود که در آن حروف به ترتیب بیانگر سال، ماه، هفته، روز و ثانیه هستند. همچنین کلیدواژه `never` زمانی برای انقضا تعیین نمی‌کند.
- مقدار پیش‌فرض را می‌توان در فایل پیکربندی با استفاده از تنظیم `pki.vouch.expiration` تغییر داد.
- [پیش‌فرض: 10y]
- --local
- محلی کردن تصدیق
- به‌طور معمول، تصدیق‌های محلی برون‌ریزی (export) نمی‌شوند.
- --non-revocable
- علامت‌گذاری تصدیق به عنوان غیرقابل‌ابطال
- بدین معنا که بعداً نمی‌توانید این تصدیق را باطل کنید. این گزینه معمولاً فقط باید همراه با تعیین زمان انقضا به کار رود.
- --output=FILE
- نوشتن خروجی در FILE، یا در stdout در صورت عدم تعیین
- --signature-notation NAME VALUE
- افزودن یک نشانه‌گذاری (notation) به امضا
- نام یک نشانه‌گذاری تعریف‌شده توسط کاربر باید به قالب `name@a.domain.you.control.org` باشد. اگر نام نشانه‌گذاری با `!` آغاز شود، آن نشانه‌گذاری به عنوان حیاتی (critical) علامت‌گذاری می‌شود. چنانچه دریافت‌کننده‌ی امضا یک نشانه‌گذاری حیاتی را تشخیص ندهد، امضا را نادیده خواهد گرفت. این نشانه‌گذاری به عنوان قابل خواندن برای انسان (human readable) علامت‌گذاری می‌شود.
- --userid=USERID
- استفاده از شناسه کاربر خودامضاشده‌ی مشخص‌شده
- شناسه کاربر مشخص‌شده باید خودامضا باشد.
- --userid-by-email=EMAIL
- استفاده از شناسه کاربر خودامضاشده با نشانی رایانامه مشخص‌شده
گزینه‌های عمومی (Global options)
برای توضیحات درباره گزینه‌های عمومی، sq(1) را ببینید.
مثال‌ها (EXAMPLES)
آلیس (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
همچنین ببینید (SEE ALSO)
sq(1), sq-pki(1), sq-pki-vouch(1).
برای مستندات کامل، https://book.sequoia-pgp.org را ببینید.
| 1.4.0 | Sequoia PGP |