| SQ(1) | User Commands | SQ(1) |
نام (NAME)
sq-key-userid-revoke - ابطال یک شناسه کاربری
خلاصه دستور (SYNOPSIS)
sq key userid revoke [OPTIONS]
توضیحات (DESCRIPTION)
ابطال یک شناسه کاربری.
یک گواهی ابطال برای یک شناسه کاربری ایجاد می‌کند.
اگر `--revoker` یا `--revoker-file` مشخص شده باشد، از آن کلید برای ایجاد گواهی ابطال استفاده می‌شود. اگر آن کلید با گواهی‌ای که در حال باطل شدن است متفاوت باشد، این کار منجر به یک ابطال شخص ثالث (third-party revocation) خواهد شد. این حالت معمولاً تنها زمانی کاربرد دارد که مالک گواهی، آن کلید را به عنوان باطل‌کنندهٔ تعیین‌شده (designated revoker) مشخص کرده باشد.
برای ابطال یک شناسه کاربری، گواهی باید تحت شیوه‌نامهٔ فعلی معتبر باشد. اگر گواهی تحت شیوه‌نامهٔ فعلی معتبر نیست، باطل کردن کل گواهی یا اصلاح آن را با استفاده از `sq cert lint` پس از بررسی یکپارچگی گواهی مد نظر قرار دهید. اگر گواهی تحت شیوه‌نامهٔ فعلی معتبر است، اما شناسه کاربری‌ای که می‌خواهید باطل کنید معتبر نیست، همچنان می‌توانید با استفاده از `--add-userid` آن شناسه کاربری را باطل کنید.
دستور `sq key userid revoke` به زمان مرجع تعیین‌شده توسط آرگومان سطح بالای `--time` پایبند است. در صورت تنظیم، هنگام تعیین کلیدهای معتبر، به جای زمان فعلی از زمان مشخص‌شده استفاده می‌کند و زمان ایجاد گواهی ابطال را نیز به جای زمان فعلی روی زمان مرجع تنظیم می‌نماید.
گزینه‌ها (OPTIONS)
گزینه‌های زیردستور (Subcommand options)
- --add-email=EMAIL
- استفاده از یک شناسه کاربری با نشانی رایانامهٔ مشخص‌شده
- شناسه کاربری تنها شامل نشانی رایانامه است. نشانی رایانامه نیازی نیست در یک شناسه کاربری خودامضاشده وجود داشته باشد.
- --add-userid=USERID
- استفاده از شناسه کاربری مشخص‌شده
- شناسه کاربری مشخص‌شده نیازی ندارد که خودامضاشده باشد.
- از آنجا که استفاده از یک شناسه کاربری که خودامضا نیست اغلب یک اشتباه است، برای پذیرش صریح این موضوع باید از این گزینه استفاده کنید.
- --allow-non-canonical-userids
- رد نکردن شناسه‌های کاربری جدیدی که در قالب استاندارد (canonical) نیستند
- شناسه‌های کاربری استاندارد به شکل `Name (Comment) <localpart@example.org>` هستند.
- --cert=FINGERPRINT|KEYID
- ابطال شناسه کاربری از کلیدی با اثرانگشت یا شناسه کلید مشخص‌شده
- --cert-email=EMAIL
- ابطال شناسه کاربری از کلیدی که شناسه‌های کاربری آن شامل نشانی رایانامهٔ مشخص‌شده باشد
- --cert-file=PATH
- ابطال شناسه کاربری از کلید خوانده‌شده از PATH
- --cert-userid=USERID
- ابطال شناسه کاربری از کلیدی با شناسه کاربری مشخص‌شده
- --email=EMAIL
- استفاده از یک شناسه کاربری که فقط شامل نشانی رایانامه است، در صورتی که این نشانی رایانامه در یک شناسه کاربری خودامضاشده آمده باشد
- --message=MESSAGE
- یک متن توضیحی کوتاه
- این متن به مشاهده‌کنندهٔ گواهی ابطال نمایش داده می‌شود و دلیل باطل شدن گواهی را توضیح می‌دهد. برای نمونه، اگر Alice سازمان را ترک کرده باشد، ممکن است بیان کند که در عوض با چه کسی باید تماس گرفته شود.
- --output=FILE
- نوشتن در FILE مشخص‌شده
- در صورت عدم تعیین، و چنانچه گواهی از مخزن گواهی‌ها خوانده شده باشد، گواهی اصلاح‌شده را به مخزن گواهی‌ها وارد (import) می‌کند. در صورت عدم تعیین، و چنانچه گواهی از یک فایل خوانده شده باشد، گواهی اصلاح‌شده را در stdout می‌نویسد.
- --reason=REASON
- علت ابطال
- اگر علت ابطال در گذشته رخ داده است، باید آن را با استفاده از آرگومان `--time` مشخص کنید. این کار به پیاده‌سازی‌های OpenPGP امکان می‌دهد با دقت بیشتری درباره ساختارهایی که اعتبارشان به اعتبار شناسه کاربری وابسته است استدلال و تصمیم‌گیری کنند.
- [مقادیر ممکن: retired، unspecified]
- --revoker=FINGERPRINT|KEYID
- استفاده از کلیدی با اثرانگشت یا شناسه کلید مشخص‌شده برای ایجاد گواهی ابطال
- امضای گواهی ابطال با استفاده از کلید مشخص‌شده. به طور پیش‌فرض، از گواهی‌ای که در حال ابطال است استفاده می‌شود. با استفاده از این گزینه، ایجاد یک ابطال شخص ثالث امکان‌پذیر است.
- --revoker-email=EMAIL
- استفاده از کلیدی که شناسه‌های کاربری آن شامل نشانی رایانامه مشخص‌شده است برای ایجاد گواهی ابطال
- امضای گواهی ابطال با استفاده از کلید مشخص‌شده. به طور پیش‌فرض، از گواهی‌ای که در حال ابطال است استفاده می‌شود. با استفاده از این گزینه، ایجاد یک ابطال شخص ثالث امکان‌پذیر است.
- --revoker-file=PATH
- خواندن کلید از PATH برای ایجاد گواهی ابطال
- امضای گواهی ابطال با استفاده از کلید مشخص‌شده. به طور پیش‌فرض، از گواهی‌ای که در حال ابطال است استفاده می‌شود. با استفاده از این گزینه، ایجاد یک ابطال شخص ثالث امکان‌پذیر است.
- --revoker-userid=USERID
- استفاده از کلیدی با شناسه کاربری مشخص‌شده برای ایجاد گواهی ابطال
- امضای گواهی ابطال با استفاده از کلید مشخص‌شده. به طور پیش‌فرض، از گواهی‌ای که در حال ابطال است استفاده می‌شود. با استفاده از این گزینه، ایجاد یک ابطال شخص ثالث امکان‌پذیر است.
- --signature-notation NAME VALUE
- افزودن یک یادداشت (notation) به امضا
- نام یادداشت تعریف‌شده توسط کاربر باید به شکل `name@a.domain.you.control.org` باشد. اگر نام یادداشت با یک `!` شروع شود، آن یادداشت به عنوان حیاتی (critical) علامت‌گذاری می‌شود. اگر مصرف‌کنندهٔ امضا یک یادداشت حیاتی را درک نکند، امضا را نادیده خواهد گرفت. یادداشت به عنوان خوانا برای انسان نشانه‌گذاری می‌شود.
- --userid=USERID
- استفاده از شناسه کاربری خودامضاشدهٔ مشخص‌شده
- شناسه کاربری مشخص‌شده باید خودامضاشده باشد.
- --userid-by-email=EMAIL
- استفاده از شناسه کاربری خودامضاشده با نشانی رایانامهٔ مشخص‌شده
گزینه‌های عمومی (Global options)
برای شرح گزینه‌های عمومی، sq(1) را ببینید.
مثال‌ها (EXAMPLES)
از رده خارج کردن یک شناسه کاربری روی کلید Alice.
sq key userid revoke --cert \
EB28F26E2739A4870ECC47726F0073F60FD0CBF0 --userid \
"Alice <alice@example.org>" --reason retired --message \
"No longer at example.org."
همچنین ببینید (SEE ALSO)
sq(1), sq-key(1), sq-key-userid(1).
برای مستندات کامل، https://book.sequoia-pgp.org را ببینید.
نسخه (VERSION)
1.4.0
| 1.4.0 | Sequoia PGP |