.TH SQ 1 1.4.0 "Sequoia PGP" "User Commands"
.SH "نام (NAME)"
sq\-key\-subkey \- مدیریت زیرکلیدها
.SH "خلاصه دستور (SYNOPSIS)"
.br
\fBsq key subkey add\fR [\fIOPTIONS\fR]  
.br
\fBsq key subkey export\fR [\fIOPTIONS\fR]  
.br
\fBsq key subkey delete\fR [\fIOPTIONS\fR]  
.br
\fBsq key subkey password\fR [\fIOPTIONS\fR]  
.br
\fBsq key subkey expire\fR [\fIOPTIONS\fR]  
.br
\fBsq key subkey revoke\fR [\fIOPTIONS\fR]  
.br
\fBsq key subkey bind\fR [\fIOPTIONS\fR]  
.SH "توضیحات (DESCRIPTION)"
مدیریت زیرکلیدها.
.PP
افزودن زیرکلیدهای جدید به یک گواهی موجود، تغییر تاریخ انقضای آن‌ها و ابطالشان.

.SH "زیرفرمان‌ها (SUBCOMMANDS)"
.SS "sq key subkey add"
افزودن یک زیرکلید جدید به یک گواهی.
.PP
یک زیرکلید دارای یک یا چند قابلیت است.
.PP
گزینهٔ `\-\-can\-sign` قابلیت امضا را تنظیم می‌کند و به این معناست که کلید ممکن است برای امضا کردن استفاده شود. گزینهٔ `\-\-can\-authenticate` قابلیت احراز هویت را تنظیم می‌کند و به این معناست که کلید ممکن است برای احراز هویت (به‌عنوان مثال به‌عنوان کلید SSH) استفاده شود. گزینهٔ `\-\-can\-certify` قابلیت صدور گواهی را تنظیم می‌کند و بدین معناست که کلید می‌تواند برای صدور تصدیق‌های شخص ثالث به‌کار رود. این قابلیت‌ها قابل ترکیب با یکدیگر هستند.
.PP
گزینهٔ `\-\-can\-encrypt=storage` قابلیت رمزنگاری ذخیره‌سازی را تنظیم می‌کند و به این معناست که کلید ممکن است برای رمزنگاری داده‌های ذخیره‌شده استفاده شود. گزینهٔ `\-\-can\-encrypt=transport` قابلیت رمزنگاری انتقال را تنظیم می‌کند و به این معناست که کلید ممکن است برای رمزنگاری حین انتقال استفاده شود. گزینهٔ `\-\-can\-encrypt=universal` هر دو قابلیت رمزنگاری ذخیره‌سازی و انتقال را تنظیم می‌کند و به این معناست که کلید ممکن است هم برای ذخیره‌سازی و هم انتقال استفاده شود. قابلیت‌های رمزنگاری نباید با قابلیت‌های امضا یا احراز هویت ترکیب شوند.
.PP
به‌طور معمول، `sq` از کاربر یک گذرواژه برای رمزنگاری داده‌های کلید مخفی درخواست می‌کند. گذرواژهٔ زیرکلید جدید می‌تواند متفاوت از سایر کلیدها باشد. هنگام استفاده از `\-\-without\-password`، ابزار `sq` درخواستی برای گذرواژه نشان نمی‌دهد و زیرکلید را با گذرواژه محافظت نمی‌کند.
.PP
به‌طور پیش‌فرض، یک زیرکلید جدید به‌خودی‌خود منقضی نمی‌شود. با این حال، دورهٔ اعتبار آن به اعتبار گواهی محدود است. استفاده از آرگومان `\-\-expiration` امکان تنظیم زمان انقضای متفاوتی را فراهم می‌کند.
.PP
زیرفرمان `sq key subkey add` به زمان مرجع تعیین‌شده توسط آرگومان سطح بالای `\-\-time` پایبند است. این فرمان زمان ایجاد زیرکلید را روی زمان مشخص‌شده تنظیم می‌کند.
.PP


.SS "sq key subkey export"
برون‌بری داده‌های کلید مخفی از مخزن کلیدهای مخفی.
.PP
داده‌های کلید مخفی را صادر می‌کند. توجه داشته باشید که حتی در صورت در دسترس بودن داده‌های کلید مخفی، ممکن است قابل برون‌بری نباشد؛ برای نمونه، داده‌های کلید مخفی ذخیره‌شده در یک ماژول امنیتی سخت‌افزاری (HSM) معمولاً از داخل دستگاه قابل استخراج نیستند.
.PP
کل گواهی صادر می‌شود، اما تنها داده‌های کلید مخفی مربوط به کلید مشخص‌شده برون‌بری می‌گردد. در صورتی که داده‌های کلید مخفی برای کلید مشخص‌شده موجود نباشد، خطایی بازگردانده می‌شود.
.PP
اگر می‌خواهید تمام داده‌های کلید مخفی مرتبط با یک گواهی را صادر کنید، از `sq key export` استفاده کنید.
.PP


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


.SS "sq key subkey password"
تغییر گذرواژهٔ محافظت‌کننده از داده‌های کلید مخفی.
.PP
داده‌های کلید مخفی می‌توانند توسط یک گذرواژه محافظت شوند. این زیرفرمان گذرواژهٔ یک یا چند کلید را تغییر داده یا پاک می‌کند.
.PP
برای حذف کامل گذرواژه، یا از `\-\-clear` استفاده کنید یا هنگام درخواست گذرواژهٔ جدید، یک گذرواژه با طول صفر (خالی) وارد نمایید.
.PP
اگر کلیدی با گذرواژه محافظت شده باشد و گذرواژهٔ صحیح با استفاده از آرگومان `\-\-password\-file` ارائه نشده باشد، از کاربر گذرواژه درخواست می‌شود. به همین ترتیب، اگر گذرواژهٔ جدید مشخص نشده باشد، از کاربر پرسیده خواهد شد.
.PP


.SS "sq key subkey expire"
تغییر زمان انقضای یک زیرکلید.
.PP
این زیرفرمان زمان انقضای یک کلید را تغییر می‌دهد. برای تغییر زمان انقضای گواهی، از زیرفرمان `sq key expire` استفاده کنید.
.PP
تغییر زمان انقضای کلید اصلی معادل تغییر زمان انقضای گواهی است. زمان انقضای یک زیرکلید وابسته به تاریخ انقضای گواهی می‌باشد.
.PP.SS "sq key subkey revoke"
ابطال یک کلید فرعی.
.PP
یک گواهی ابطال برای یک کلید فرعی ایجاد می‌کند.
.PP
اگر `\-\-revoker` یا `\-\-revoker\-file` مشخص شده باشد، از آن کلید برای ایجاد گواهی ابطال استفاده می‌شود. اگر آن کلید با گواهی‌ای که در حال باطل شدن است متفاوت باشد، این کار منجر به یک ابطال شخص ثالث (third\-party revocation) خواهد شد. این ویژگی معمولاً تنها زمانی مفید است که مالک گواهی، کلید مذکور را به عنوان باطل‌کننده تعیین‌شده (designated revoker) مشخص کرده باشد.
.PP
دستور `sq key subkey revoke` از زمان مرجع تعیین‌شده توسط آرگومان سطح بالای `\-\-time` پیروی می‌کند. در صورت تعیین این گزینه، هنگام بررسی کلیدهای معتبر، به جای زمان فعلی از زمان مشخص‌شده استفاده می‌شود و زمان ایجاد گواهی ابطال نیز به جای زمان فعلی، روی زمان مرجع تنظیم می‌گردد.
.PP


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


.SH "مثال‌ها (EXAMPLES)"
.SS "sq key subkey add"
.PP

.PP
افزودن یک کلید فرعی جدید با قابلیت امضا به کلید Alice.
.PP
.nf
.RS
sq key subkey add \-\-can\-sign \\
.RE
.RS
.RS
\-\-cert=EB28F26E2739A4870ECC47726F0073F60FD0CBF0
.RE
.RE
.fi
.PP
.SS "sq key subkey export"
.PP

.PP
برون‌بری کلیدهای فرعی Alice با قابلیت‌های امضا و رمزنگاری، بدون کلید اصلی یا کلید فرعی با قابلیت احراز هویت او.
.PP
.nf
.RS
sq key subkey export \\
.RE
.RS
.RS
\-\-cert=EB28F26E2739A4870ECC47726F0073F60FD0CBF0 \\
.RE
.RE
.RS
.RS
\-\-key=42020B87D51877E5AF8D272124F3955B0B8DECC8 \\
.RE
.RE
.RS
.RS
\-\-key=74DCDEAF17D9B995679EB52BA6E65EA2C8497728
.RE
.RE
.fi
.PP
.SS "sq key subkey delete"
.PP

.PP
حذف کلید فرعی امضای Alice.
.PP
.nf
.RS
sq key subkey delete \\
.RE
.RS
.RS
\-\-cert=EB28F26E2739A4870ECC47726F0073F60FD0CBF0 \\
.RE
.RE
.RS
.RS
\-\-key=42020B87D51877E5AF8D272124F3955B0B8DECC8
.RE
.RE
.fi
.PP.SS "sq key subkey password"
.PP

.PP
تغییر گذرواژهٔ کلید امضای Alice به گذرواژهٔ موجود در فایل مشخص‌شده.
.PP
.nf
.RS
sq key subkey password \-\-new\-password\-file=password\-file.txt \\
.RE
.RS
.RS
\-\-cert=EB28F26E2739A4870ECC47726F0073F60FD0CBF0 \\
.RE
.RE
.RS
.RS
\-\-key=42020B87D51877E5AF8D272124F3955B0B8DECC8
.RE
.RE
.PP
.fi

.PP
حذف حفاظت گذرواژه برای کلید امضای Alice.
.PP
.nf
.RS
sq key subkey password \-\-password\-file=password\-file.txt \\
.RE
.RS
.RS
\-\-clear\-password \\
.RE
.RE
.RS
.RS
\-\-cert=EB28F26E2739A4870ECC47726F0073F60FD0CBF0 \\
.RE
.RE
.RS
.RS
\-\-key=42020B87D51877E5AF8D272124F3955B0B8DECC8
.RE
.RE
.fi
.PP
.SS "sq key subkey expire"
.PP

.PP
تغییر زمان انقضای زیرکلید احراز هویت Alice به ۶ ماه دیگر.
.PP
.nf
.RS
sq key subkey expire \-\-expiration 6m \\
.RE
.RS
.RS
\-\-cert=EB28F26E2739A4870ECC47726F0073F60FD0CBF0 \\
.RE
.RE
.RS
.RS
\-\-key=0D45C6A756A038670FDFD85CB1C82E8D27DB23A1
.RE
.RE
.fi
.PP
.SS "sq key subkey revoke"
.PP

.PP
ابطال زیرکلید امضای Alice.
.PP
.nf
.RS
sq key subkey revoke \\
.RE
.RS
.RS
\-\-cert=EB28F26E2739A4870ECC47726F0073F60FD0CBF0 \\
.RE
.RE
.RS
.RS
\-\-key=42020B87D51877E5AF8D272124F3955B0B8DECC8 \-\-reason \\
.RE
.RE
.RS
.RS
retired \-\-message "Subkey rotation."
.RE
.RE
.PP
.fi

.PP
ابطال زیرکلید امضا و زیرکلیدهای رمزگذاری Alice.
.PP
.nf
.RS
sq key subkey revoke \\
.RE
.RS
.RS
\-\-cert=EB28F26E2739A4870ECC47726F0073F60FD0CBF0 \\
.RE
.RE
.RS
.RS
\-\-key=42020B87D51877E5AF8D272124F3955B0B8DECC8 \\
.RE
.RE
.RS
.RS
\-\-key=74DCDEAF17D9B995679EB52BA6E65EA2C8497728 \-\-reason \\
.RE
.RE
.RS
.RS
retired \-\-message "Subkey rotation."
.RE
.RE
.fi
.PP.SS "sq key subkey bind"
.PP

.PP
اتصال زیرکلید احراز هویت قدیمی Alice به گواهی جدید Alice.
.PP
.nf
.RS
sq key subkey bind \
.RE
.RS
.RS
\-\-cert=C5999E8191BF7B503653BE958B1F7910D01F86E5 \
.RE
.RE
.RS
.RS
\-\-key=0D45C6A756A038670FDFD85CB1C82E8D27DB23A1
.RE
.RE
.PP
.fi

.PP
اتصال یک کلید عریان (bare key) به گواهی Alice. یک کلید عریان، یک کلید عمومی بدون هیچ مؤلفه یا امضایی است. این قابلیت، کار با کلیدهای خام را ساده می‌کند؛ برای نمونه کلیدهای تولیدشده روی یک کارت OpenPGP، یک دستگاه TPM و غیره.
.PP
.nf
.RS
sq key subkey bind \-\-keyring=bare.pgp \
.RE
.RS
.RS
\-\-cert=C5999E8191BF7B503653BE958B1F7910D01F86E5 \
.RE
.RE
.RS
.RS
\-\-key=B321BA8F650CB16443E06826DBFA98A78CF6562F \
.RE
.RE
.RS
.RS
\-\-can\-encrypt=universal
.RE
.RE
.fi
.SH "همچنین ببینید (SEE ALSO)"
.nh
\fBsq\fR(1), \fBsq\-key\fR(1), \fBsq\-key\-subkey\-add\fR(1), \fBsq\-key\-subkey\-export\fR(1), \fBsq\-key\-subkey\-delete\fR(1), \fBsq\-key\-subkey\-password\fR(1), \fBsq\-key\-subkey\-expire\fR(1), \fBsq\-key\-subkey\-revoke\fR(1), \fBsq\-key\-subkey\-bind\fR(1).
.hy
.PP
برای مستندات کامل <https://book.sequoia\-pgp.org> را ببینید.
.SH "نسخه (VERSION)"
1.4.0