نام (NAME)

sq-key-subkey-revoke - ابطال یک زیرکلید

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

sq key subkey revoke [OPTIONS]

توضیحات (DESCRIPTION)

ابطال یک زیرکلید.

یک گواهی ابطال برای یک زیرکلید ایجاد می‌کند.

اگر `--revoker` یا `--revoker-file` مشخص شده باشد، از آن کلید برای ایجاد گواهی ابطال استفاده می‌شود. اگر آن کلید با گواهی‌ای که در حال باطل شدن است متفاوت باشد، این کار به یک ابطال شخص ثالث (third-party revocation) منجر می‌شود. این ویژگی معمولاً تنها در صورتی کاربرد دارد که مالک گواهی، آن کلید را به عنوان باطل‌کنندهٔ تعیین‌شده (designated revoker) مشخص کرده باشد.

دستور `sq key subkey revoke` به زمان مرجع تعیین‌شده توسط آرگومان سطح بالای `--time` پایبند است. در صورت تنظیم، هنگام تعیین معتبر بودن کلیدها به جای زمان فعلی از زمان مشخص‌شده استفاده می‌کند و زمان ایجاد گواهی ابطال را نیز به جای زمان فعلی، بر روی زمان مرجع تنظیم می‌نماید.

گزینه‌ها (OPTIONS)

گزینه‌های زیردستور (Subcommand options)

--cert=FINGERPRINT|KEYID: ابطال زیرکلیدهای مشخص‌شده روی کلید با اثرانگشت یا شناسه کلید مشخص
--cert-email=EMAIL: ابطال زیرکلیدهای مشخص‌شده روی کلیدی که یک شناسه کاربر آن شامل آدرس ایمیل مشخص‌شده باشد
--cert-file=PATH: ابطال زیرکلیدهای مشخص‌شده روی کلید خوانده‌شده از PATH
--cert-userid=USERID: ابطال زیرکلیدهای مشخص‌شده روی کلید با شناسه کاربر مشخص
--key=FINGERPRINT|KEYID: ابطال زیرکلید مشخص‌شده
--message=MESSAGE: یک متن کوتاه و توضیحی

: این متن به مشاهده‌کنندهٔ گواهی ابطال نشان داده می‌شود و دلیل باطل شدن زیرکلید را توضیح می‌دهد. برای نمونه، اگر Alice کلید جدیدی ایجاد کرده باشد، ممکن است یک گواهی ابطال `superseded` برای کلید قدیمی خود ایجاد کند و پیامی مانند "I've created a new subkey, please refresh the certificate." را در آن بگنجاند.

--output=FILE: نوشتن در FILE مشخص‌شده

: اگر مشخص نشود و گواهی از مخزن گواهی‌ها خوانده شده باشد، گواهی تغییریافته را به مخزن گواهی‌ها وارد می‌کند. اگر مشخص نشود و گواهی از یک فایل خوانده شده باشد، گواهی تغییریافته را در 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) علامت‌گذاری می‌شود. چنانچه پردازش‌کنندهٔ امضا یک نشانه‌گذاری حیاتی را تشخیص ندهد، از امضا صرف‌نظر خواهد کرد. این نشانه‌گذاری به عنوان خوانا برای انسان علامت‌گذاری می‌شود.

گزینه‌های عمومی (Global options)

برای توضیح گزینه‌های عمومی، sq(1) را ببینید.

مثال‌ها (EXAMPLES)

ابطال زیرکلید امضای Alice.

sq key subkey revoke \

--cert=EB28F26E2739A4870ECC47726F0073F60FD0CBF0 \

--key=42020B87D51877E5AF8D272124F3955B0B8DECC8 --reason \

retired --message "Subkey rotation."

ابطال زیرکلید امضا و زیرکلیدهای رمزگذاری Alice.

sq key subkey revoke \

--cert=EB28F26E2739A4870ECC47726F0073F60FD0CBF0 \

--key=42020B87D51877E5AF8D272124F3955B0B8DECC8 \

--key=74DCDEAF17D9B995679EB52BA6E65EA2C8497728 --reason \

retired --message "Subkey rotation."

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

sq(1), sq-key(1), sq-key-subkey(1).

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

نسخه (VERSION)

1.4.0

Sequoia PGP