| SQ(1) | User Commands | SQ(1) |
نام (NAME)
sq-key-revoke - ابطال یک گواهی
خلاصه دستور (SYNOPSIS)
sq key revoke [گزینهها]
توضیحات (DESCRIPTION)
یک گواهی را باطل میکند.
یک گواهی ابطال برای یک گواهی ایجاد میکند.
اگر `--revoker` یا `--revoker-file` ارائه شده باشد، از آن کلید برای ایجاد گواهی ابطال استفاده میشود. اگر آن کلید با گواهیای که در حال باطل شدن است متفاوت باشد، این کار منجر به یک ابطال شخص ثالث (third-party revocation) خواهد شد. این حالت معمولاً تنها زمانی مفید است که مالک گواهی، آن کلید را به عنوان باطلکننده تعیینشده (designated revoker) مشخص کرده باشد.
دستور `sq key revoke` از زمان مرجع تعیینشده توسط آرگومان سطح بالای `--time` پیروی میکند. در صورت تنظیم، هنگام تعیین اینکه چه کلیدهایی معتبر هستند، به جای زمان فعلی از زمان مشخصشده استفاده میکند و زمان ایجاد گواهی ابطال را نیز به جای زمان فعلی، روی زمان مرجع تنظیم میکند.
گزینهها (OPTIONS)
گزینههای زیردستور (Subcommand options)
- --cert=FINGERPRINT|KEYID
- باطل کردن کلید دارای اثرانگشت یا شناسه کلید مشخصشده
- --cert-email=EMAIL
- باطل کردن کلیدی که یکی از شناسههای کاربری آن شامل آدرس ایمیل مشخصشده است
- --cert-file=PATH
- باطل کردن کلید خواندهشده از PATH
- --cert-userid=USERID
- باطل کردن کلید دارای شناسه کاربری مشخصشده
- --message=MESSAGE
- یک متن توضیحی کوتاه
- این متن به مشاهدهکنندهٔ گواهی ابطال نشان داده میشود و دلیل باطل شدن گواهی را توضیح میدهد. برای نمونه، اگر آلیس کلید جدیدی ایجاد کرده باشد، یک گواهی ابطال از نوع `superseded` برای کلید قدیمی خود ایجاد میکند و ممکن است پیام `I've created a new certificate, $FINGERPRINT, please use that in the future.` را در آن قرار دهد.
- --output=FILE
- نوشتن در FILE مشخصشده
- در صورت عدم تعیین، و اگر گواهی از مخزن گواهیها خوانده شده باشد، گواهی تغییریافته را به مخزن گواهی وارد (import) میکند. در صورت عدم تعیین، و اگر گواهی از یک فایل خوانده شده باشد، گواهی تغییریافته را در stdout مینویسد.
- --reason=REASON
- دلیل ابطال
- اگر دلیل ابطال در گذشته رخ داده است، باید آن را با استفاده از آرگومان `--time` مشخص کنید. این به پیادهسازیهای OpenPGP اجازه میدهد تا با دقت بیشتری درباره دادهها و مواردی که اعتبارشان به اعتبار این گواهی وابسته است، تصمیمگیری کنند.
- [مقادیر ممکن: compromised، superseded، 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) علامتگذاری میشود. اگر مصرفکنندهٔ امضا یک نشانهگذاری حیاتی را متوجه نشود، از امضا صرفنظر خواهد کرد. این نشانهگذاری به عنوان خوانا برای انسان (human readable) علامتگذاری میشود.
گزینههای عمومی (Global options)
برای مشاهدهٔ توضیحات گزینههای عمومی، sq(1) را ببینید.
مثالها (EXAMPLES)
باطل کردن کلید آلیس، با قید اینکه یک گواهی جدید وجود دارد.
sq key revoke --cert EB28F26E2739A4870ECC47726F0073F60FD0CBF0 \
--reason superseded --message \
"My new cert is C5999E8191BF7B503653BE958B1F7910D01F86E5"
باطل کردن کلید، با اعلام اینکه دادههای کلید مخفی افشا شده و به خطر افتاده است (compromised).
sq key revoke --cert EB28F26E2739A4870ECC47726F0073F60FD0CBF0 \
--reason compromised --message \
"Computer attacked, secret key material compromised"
همچنین ببینید (SEE ALSO)
برای مستندات کامل، به https://book.sequoia-pgp.org مراجعه کنید.
نسخه (VERSION)
1.4.0
| 1.4.0 | Sequoia PGP |