نام (NAME)

sq-key-subkey - مدیریت زیرکلیدها

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

sq key subkey add [OPTIONS]
sq key subkey export [OPTIONS]
sq key subkey delete [OPTIONS]
sq key subkey password [OPTIONS]
sq key subkey expire [OPTIONS]
sq key subkey revoke [OPTIONS]
sq key subkey bind [OPTIONS]

توضیحات (DESCRIPTION)

مدیریت زیرکلیدها.

افزودن زیرکلیدهای جدید به یک گواهی موجود، تغییر تاریخ انقضای آن‌ها و ابطالشان.

زیرفرمان‌ها (SUBCOMMANDS)

sq key subkey add

افزودن یک زیرکلید جدید به یک گواهی.

یک زیرکلید دارای یک یا چند قابلیت است.

گزینهٔ `--can-sign` قابلیت امضا را تنظیم می‌کند و به این معناست که کلید ممکن است برای امضا کردن استفاده شود. گزینهٔ `--can-authenticate` قابلیت احراز هویت را تنظیم می‌کند و به این معناست که کلید ممکن است برای احراز هویت (به‌عنوان مثال به‌عنوان کلید SSH) استفاده شود. گزینهٔ `--can-certify` قابلیت صدور گواهی را تنظیم می‌کند و بدین معناست که کلید می‌تواند برای صدور تصدیق‌های شخص ثالث به‌کار رود. این قابلیت‌ها قابل ترکیب با یکدیگر هستند.

گزینهٔ `--can-encrypt=storage` قابلیت رمزنگاری ذخیره‌سازی را تنظیم می‌کند و به این معناست که کلید ممکن است برای رمزنگاری داده‌های ذخیره‌شده استفاده شود. گزینهٔ `--can-encrypt=transport` قابلیت رمزنگاری انتقال را تنظیم می‌کند و به این معناست که کلید ممکن است برای رمزنگاری حین انتقال استفاده شود. گزینهٔ `--can-encrypt=universal` هر دو قابلیت رمزنگاری ذخیره‌سازی و انتقال را تنظیم می‌کند و به این معناست که کلید ممکن است هم برای ذخیره‌سازی و هم انتقال استفاده شود. قابلیت‌های رمزنگاری نباید با قابلیت‌های امضا یا احراز هویت ترکیب شوند.

به‌طور معمول، `sq` از کاربر یک گذرواژه برای رمزنگاری داده‌های کلید مخفی درخواست می‌کند. گذرواژهٔ زیرکلید جدید می‌تواند متفاوت از سایر کلیدها باشد. هنگام استفاده از `--without-password`، ابزار `sq` درخواستی برای گذرواژه نشان نمی‌دهد و زیرکلید را با گذرواژه محافظت نمی‌کند.

به‌طور پیش‌فرض، یک زیرکلید جدید به‌خودی‌خود منقضی نمی‌شود. با این حال، دورهٔ اعتبار آن به اعتبار گواهی محدود است. استفاده از آرگومان `--expiration` امکان تنظیم زمان انقضای متفاوتی را فراهم می‌کند.

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

sq key subkey export

برون‌بری داده‌های کلید مخفی از مخزن کلیدهای مخفی.

داده‌های کلید مخفی را صادر می‌کند. توجه داشته باشید که حتی در صورت در دسترس بودن داده‌های کلید مخفی، ممکن است قابل برون‌بری نباشد؛ برای نمونه، داده‌های کلید مخفی ذخیره‌شده در یک ماژول امنیتی سخت‌افزاری (HSM) معمولاً از داخل دستگاه قابل استخراج نیستند.

کل گواهی صادر می‌شود، اما تنها داده‌های کلید مخفی مربوط به کلید مشخص‌شده برون‌بری می‌گردد. در صورتی که داده‌های کلید مخفی برای کلید مشخص‌شده موجود نباشد، خطایی بازگردانده می‌شود.

اگر می‌خواهید تمام داده‌های کلید مخفی مرتبط با یک گواهی را صادر کنید، از `sq key export` استفاده کنید.

sq key subkey delete

حذف داده‌های کلید مخفی یک گواهی.

برخلاف `sq key delete` که تمام داده‌های کلید مخفی را حذف می‌کند، این فرمان فقط داده‌های کلید مخفی مشخص‌شده را حذف می‌نماید.

اگر داده‌های کلید مخفی توسط چندین دستگاه مدیریت شوند، از تمام آن‌ها حذف خواهد شد.

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

sq key subkey password

تغییر گذرواژهٔ محافظت‌کننده از داده‌های کلید مخفی.

داده‌های کلید مخفی می‌توانند توسط یک گذرواژه محافظت شوند. این زیرفرمان گذرواژهٔ یک یا چند کلید را تغییر داده یا پاک می‌کند.

برای حذف کامل گذرواژه، یا از `--clear` استفاده کنید یا هنگام درخواست گذرواژهٔ جدید، یک گذرواژه با طول صفر (خالی) وارد نمایید.

اگر کلیدی با گذرواژه محافظت شده باشد و گذرواژهٔ صحیح با استفاده از آرگومان `--password-file` ارائه نشده باشد، از کاربر گذرواژه درخواست می‌شود. به همین ترتیب، اگر گذرواژهٔ جدید مشخص نشده باشد، از کاربر پرسیده خواهد شد.

sq key subkey expire

تغییر زمان انقضای یک زیرکلید.

این زیرفرمان زمان انقضای یک کلید را تغییر می‌دهد. برای تغییر زمان انقضای گواهی، از زیرفرمان `sq key expire` استفاده کنید.

تغییر زمان انقضای کلید اصلی معادل تغییر زمان انقضای گواهی است. زمان انقضای یک زیرکلید وابسته به تاریخ انقضای گواهی می‌باشد. ابطال یک کلید فرعی.

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

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

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

sq key subkey bind

پیوند دادن کلیدها از یک گواهی به گواهی دیگر.

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

پس از انجام عملیات، کلید هم به گواهی قدیمی و هم به گواهی جدید متصل خواهد بود. برای حذف اطلاعات کلید محرمانه از گواهی قدیمی، بسته به نیاز از `sq key subkey delete` یا `sq key delete` استفاده کنید. برای باطل کردن کلید یا کلید فرعی قدیمی، به ترتیب از `sq key subkey revoke` یا `sq key revoke` استفاده نمایید.

مثال‌ها (EXAMPLES)

sq key subkey add

افزودن یک کلید فرعی جدید با قابلیت امضا به کلید Alice.

sq key subkey add --can-sign \

--cert=EB28F26E2739A4870ECC47726F0073F60FD0CBF0

sq key subkey export

برون‌بری کلیدهای فرعی Alice با قابلیت‌های امضا و رمزنگاری، بدون کلید اصلی یا کلید فرعی با قابلیت احراز هویت او.

sq key subkey export \

--cert=EB28F26E2739A4870ECC47726F0073F60FD0CBF0 \

--key=42020B87D51877E5AF8D272124F3955B0B8DECC8 \

--key=74DCDEAF17D9B995679EB52BA6E65EA2C8497728

sq key subkey delete

حذف کلید فرعی امضای Alice.

sq key subkey delete \

--cert=EB28F26E2739A4870ECC47726F0073F60FD0CBF0 \

--key=42020B87D51877E5AF8D272124F3955B0B8DECC8

تغییر گذرواژهٔ کلید امضای Alice به گذرواژهٔ موجود در فایل مشخص‌شده.

sq key subkey password --new-password-file=password-file.txt \

--cert=EB28F26E2739A4870ECC47726F0073F60FD0CBF0 \

--key=42020B87D51877E5AF8D272124F3955B0B8DECC8

حذف حفاظت گذرواژه برای کلید امضای Alice.

sq key subkey password --password-file=password-file.txt \

--clear-password \

--cert=EB28F26E2739A4870ECC47726F0073F60FD0CBF0 \

--key=42020B87D51877E5AF8D272124F3955B0B8DECC8

sq key subkey expire

تغییر زمان انقضای زیرکلید احراز هویت Alice به ۶ ماه دیگر.

sq key subkey expire --expiration 6m \

--cert=EB28F26E2739A4870ECC47726F0073F60FD0CBF0 \

--key=0D45C6A756A038670FDFD85CB1C82E8D27DB23A1

sq key subkey revoke

ابطال زیرکلید امضای 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."

اتصال زیرکلید احراز هویت قدیمی Alice به گواهی جدید Alice.

sq key subkey bind .RE

--cert=C5999E8191BF7B503653BE958B1F7910D01F86E5 .RE

--key=0D45C6A756A038670FDFD85CB1C82E8D27DB23A1

اتصال یک کلید عریان (bare key) به گواهی Alice. یک کلید عریان، یک کلید عمومی بدون هیچ مؤلفه یا امضایی است. این قابلیت، کار با کلیدهای خام را ساده می‌کند؛ برای نمونه کلیدهای تولیدشده روی یک کارت OpenPGP، یک دستگاه TPM و غیره.

sq key subkey bind --keyring=bare.pgp .RE

--cert=C5999E8191BF7B503653BE958B1F7910D01F86E5 .RE

--key=B321BA8F650CB16443E06826DBFA98A78CF6562F .RE

--can-encrypt=universal

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

sq(1), sq-key(1), sq-key-subkey-add(1), sq-key-subkey-export(1), sq-key-subkey-delete(1), sq-key-subkey-password(1), sq-key-subkey-expire(1), sq-key-subkey-revoke(1), sq-key-subkey-bind(1).

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

نسخه (VERSION)

1.4.0