.TH SQ 1 1.4.0 "Sequoia PGP" "User Commands"
.SH "نام (NAME)"
sq\-key\-rotate \- چرخش یک گواهی
.SH "خلاصه دستور (SYNOPSIS)"
.br
\fBsq key rotate\fR [\fIOPTIONS\fR]  
.SH "توضیحات (DESCRIPTION)"
یک گواهی را می‌چرخاند (تمدید یا جایگزین می‌کند).
.PP
گواهی جدیدی را برای جایگزینی گواهی موجود تولید می‌کند.
.PP
گواهی جدید دارای همان قابلیت‌های گواهی پیشین خواهد بود. این رفتار می‌تواند با استفاده از آرگومان‌های `\-\-can\-sign`، `\-\-cannot\-sign` و غیره لغو و بازنویسی شود. نکته: ممکن است گواهی جدید ساختاری متفاوت از گواهی پیشین داشته باشد. برای نمونه، اگر کلید اصلی گواهی پیشین دارای هر دو قابلیت صدور گواهی و امضا باشد، کلید اصلی گواهی جدید فقط دارای قابلیت صدور گواهی خواهد بود و یک زیرکلید امضا خواهد داشت.
.PP
به‌طور پیش‌فرض این گواهی پس از ۳ سال منقضی می‌شود. این مقدار می‌تواند با استفاده از آرگومان `\-\-expiration` تغییر داده شود.
.PP
گواهی جدید دارای همان شناسه‌های کاربری خودامضاشدهٔ گواهی پیشین خواهد بود. شناسه‌های کاربری باطل‌شده نادیده گرفته می‌شوند.
.PP
گواهی جدید و گواهی پیشین، یکدیگر را به‌صورت معرفی‌کننده‌های معتمد نامحدود تصدیق متقابل (cross certify) خواهند کرد.
.PP
گواهی جدید به همان روش گواهی پیشین پیوند داده خواهد شد. این مورد می‌تواند با استفاده از آرگومان `\-\-own\-key` یا `\-\-shared\-key` لغو شود.
.PP
گواهی جدید همان گواهی‌هایی را تصدیق می‌کند که گواهی پیشین تصدیق کرده است؛ یعنی تصدیق‌های گواهی پیشین بازپخش (replay) خواهند شد. برای اطلاعات بیشتر `sq pki vouch replay` را ببینید.
.PP
یک گواهی ابطال صادر خواهد شد که نشان می‌دهد گواهی پیشین بازنشسته شده است و باید به‌جای آن از گواهی جدید استفاده شود. به‌طور پیش‌فرض، این گواهی ظرف ۱۸۲ روز اجرایی خواهد شد. این مقدار می‌تواند با استفاده از آرگومان `\-\-retire\-in` تغییر داده شده یا از صدور آن جلوگیری شود.
.PP
هنگام استفاده از `\-\-output`، گواهی جدید و همچنین تمامی گواهی‌های به‌روزشدهٔ دیگر در فایل مشخص‌شده نوشته می‌شوند.
.PP
پایدار از نسخهٔ 1.2.0.
.PP


.SH "گزینه‌ها (OPTIONS)"
.SS "گزینه‌های زیردستور (Subcommand options)"
.TP
\fB\-\-can\-authenticate\fR
افزودن یک زیرکلید با قابلیت احراز هویت
.TP
\fB\-\-can\-encrypt\fR=\fIPURPOSE\fR
افزودن یک زیرکلید با قابلیت رمزگذاری
.IP
زیرکلیدهای با قابلیت رمزگذاری می‌توانند مناسب برای رمزگذاری انتقال (transport)، رمزگذاری ذخیره‌سازی (storage)، یا هر دو، یعنی سراسری (universal) علامت‌گذاری شوند.
.IP
[مقادیر ممکن: \fBtransport\fR، \fBstorage\fR، \fBuniversal\fR]
.TP
\fB\-\-can\-sign\fR
افزودن یک زیرکلید با قابلیت امضا
.TP
\fB\-\-cannot\-authenticate\fR
عدم افزودن زیرکلید با قابلیت احراز هویت
.TP
\fB\-\-cannot\-encrypt\fR
عدم افزودن زیرکلید با قابلیت رمزگذاری
.TP
\fB\-\-cannot\-sign\fR
عدم افزودن زیرکلید با قابلیت امضا
.TP
\fB\-\-cert\fR=\fIFINGERPRINT|KEYID\fR
استفاده از گواهی‌های دارای اثرانگشت یا شناسه کلید مشخص‌شده
.TP
\fB\-\-cert\-email\fR=\fIEMAIL\fR
استفاده از گواهی‌هایی که شناسهٔ کاربری آن‌ها شامل آدرس ایمیل مشخص‌شده باشد
.TP
\fB\-\-cert\-file\fR=\fIPATH\fR
خواندن گواهی‌ها از PATH
.TP
\fB\-\-cert\-userid\fR=\fIUSERID\fR
استفاده از گواهی‌های دارای شناسهٔ کاربری مشخص‌شده
.TP
\fB\-\-cipher\-suite\fR=\fICIPHER\-SUITE\fR
انتخاب الگوریتم‌های رمزنگاری برای کلید
.IP
مقدار پیش‌فرض را می‌توان در فایل پیکربندی با استفاده از تنظیم `key.generate.cipher\-suite` تغییر داد.
.IP
[پیش‌فرض: \fBcv25519\fR]
.IP
[مقادیر ممکن: \fBrsa2k\fR، \fBrsa3k\fR، \fBrsa4k\fR، \fBcv25519\fR، \fBcv448\fR، \fBmldsa65\-ed25519\fR، \fBmldsa87\-ed448\fR]
.TP
\fB\-\-expiration\fR=\fIEXPIRATION\fR
تنظیم زمان انقضا
.IP
مقدار EXPIRATION یا یک تاریخ قالب‌بندی‌شده بر اساس ISO 8601 همراه با زمان اختیاری است یا یک مدت‌زمان سفارشی. مدت‌زمان به‌صورت `N[ymwds]` مشخص می‌شود که حروف آن به‌ترتیب نشان‌دهندهٔ سال، ماه، هفته، روز و ثانیه هستند. همچنین، کلمهٔ کلیدی `never` هیچ زمان انقضایی تعیین نمی‌کند.
.IP
[پیش‌فرض: \fB3y\fR]
.TP
\fB\-\-new\-password\-file\fR=\fIPASSWORD_FILE\fR
فایل حاوی گذرواژه برای رمزگذاری داده‌های کلید محرمانه
.IP
توجه داشته باشید که کل فایل کلید به‌عنوان گذرواژه استفاده خواهد شد، از جمله هرگونه فاصله خالی پیرامون آن مانند نویسهٔ خط جدید پایانی.
.TP
\fB\-\-output\fR=\fIFILE\fR
نوشتن کلید در فایل مشخص‌شده
.IP
در صورت مشخص نشدن، کلید در مخزن کلید ذخیره می‌شود.
.TP
\fB\-\-own\-key\fR
علامت‌گذاری کلید به‌عنوان کلید شخصی خود
.IP
کلید تازه‌تولیدشده با تمامی شناسه‌های کاربری‌اش، به‌عنوان احرازهویت‌شده و یک معرفی‌کنندهٔ کاملاً مورد اعتماد علامت‌گذاری خواهد شد.
.TP
\fB\-\-profile\fR=\fIPROFILE\fR
انتخاب استاندارد OpenPGP برای کلید
.IP
با تکامل OpenPGP، نسخه‌های جدیدی در دسترس قرار خواهند گرفت. این گزینه نسخهٔ OpenPGP مورد استفاده برای کلید تازه‌تولیدشده را انتخاب می‌کند.
.IP
در حال حاضر sq فقط از یک نسخه پشتیبانی می‌کند: RFC4880. در نتیجه، این نسخه پیش‌فرض است. با این حال، نسخهٔ جدیدتری از این استاندارد با نام RFC9580 وجود دارد، و مقدار پیش‌فرض در نسخه‌های آیندهٔ sq تغییر خواهد کرد.
.IP
مقدار پیش‌فرض را می‌توان در فایل پیکربندی با استفاده از تنظیم `key.generate.profile` تغییر داد.
.IP
[پیش‌فرض: \fBrfc4880\fR]
.IP
[مقادیر ممکن: \fBrfc9580\fR، \fBrfc4880\fR]
.TP
\fB\-\-retire\-in\fR=\fITIME\fR
تنظیم زمانی که گواهی باید بازنشسته شود
.IP
مقدار TIME یا یک تاریخ با قالب‌بندی ISO 8601 همراه با زمان اختیاری است یا یک مدت‌زمان سفارشی. مدت‌زمان به‌شکل `N[ymwds]` مشخص می‌شود که حروف آن به‌ترتیب نشان‌دهندهٔ سال، ماه، هفته، روز و ثانیه هستند. به‌طور جایگزین، کلمهٔ کلیدی `never` از صدور گواهی ابطال صرف‌نظر می‌کند.
.IP
[پیش‌فرض: \fB26w\fR]
.TP
\fB\-\-rev\-cert\fR=\fIFILE\fR
نوشتن گواهی ابطال اضطراری در FILE
.IP
هنگامی که کلید در مخزن کلید ذخیره می‌شود، گواهی ابطال به‌طور پیش‌فرض در $HOME/.local/share/sequoia/revocation\-certificates نگهداری می‌شود.
.IP
هنگامی که `\-\-output` مشخص شده باشد، گواهی ابطال در فایل تعیین‌شده توسط `\-\-rev\-cert` نوشته می‌شود.
.IP
اگر `\-\-output` برابر با `\-` باشد، این گزینه نباید `\-` باشد.
.TP
\fB\-\-shared\-key\fR
علامت‌گذاری کلید به‌عنوان کلید اشتراکی
.IP
کلید تازه‌تولیدشده با تمامی شناسه‌های کاربری‌اش، به‌عنوان احرازهویت‌شده علامت‌گذاری می‌شود، اما نه به‌عنوان معرفی‌کنندهٔ معتمد. علاوه بر این، فرادادهٔ کلید مشخص خواهد کرد که این یک کلید اشتراکی است.
.IP
اگر قصد دارید این کلید را با دیگران به اشتراک بگذارید، از این گزینه استفاده کنید. در شرایط عادی نباید داده‌های کلید را به اشتراک بگذارید. نمونه‌ای که ممکن است بخواهید این کار را انجام دهید، یک صندوق پستی مشترک است.
.TP
\fB\-\-without\-password\fR
عدم محافظت از محتوای کلید محرمانه با گذرواژه
.SS "گزینه‌های سراسری (Global options)"
برای شرح گزینه‌های سراسری \fBsq\fR(1) را ببینید.
.SH "مثال‌ها (EXAMPLES)"
.PP

.PP
چرخش گواهی Alice.
.PP
.nf
.RS
sq key rotate \-\-cert EB28F26E2739A4870ECC47726F0073F60FD0CBF0
.RE
.fi
.SH "همچنین ببینید (SEE ALSO)"
.nh
\fBsq\fR(1)، \fBsq\-key\fR(1).
.hy
.PP
برای مستندات کامل <https://book.sequoia\-pgp.org> را ببینید.
.SH "نسخه (VERSION)"
1.4.0