.TH SQ 1 1.4.0 "Sequoia PGP" "User Commands" .SH "نام (NAME)" sq\-key \- مدیریت کلیدها .SH "خلاصه دستور (SYNOPSIS)" .br \fBsq key list\fR [\fIOPTIONS\fR] \fIFINGERPRINT|KEYID|PATTERN\fR .br \fBsq key generate\fR [\fIOPTIONS\fR] .br \fBsq key rotate\fR [\fIOPTIONS\fR] .br \fBsq key import\fR [\fIOPTIONS\fR] \fIKEY_FILE\fR .br \fBsq key export\fR [\fIOPTIONS\fR] .br \fBsq key delete\fR [\fIOPTIONS\fR] .br \fBsq key password\fR [\fIOPTIONS\fR] .br \fBsq key expire\fR [\fIOPTIONS\fR] .br \fBsq key revoke\fR [\fIOPTIONS\fR] .br \fBsq key userid\fR [\fIOPTIONS\fR] \fISUBCOMMAND\fR .br \fBsq key subkey\fR [\fIOPTIONS\fR] \fISUBCOMMAND\fR .br \fBsq key approvals\fR [\fIOPTIONS\fR] \fISUBCOMMAND\fR .SH "توضیحات (DESCRIPTION)" مدیریت کلیدها. .PP ما از واژه «کلید» (key) برای اشاره به کلیدهای OpenPGP که حاوی داده‌های محرمانه هستند استفاده می‌کنیم. این زیردستور ابزارهای پایه‌ای برای تولید و دستکاری کلیدها را فراهم می‌کند. .PP در مقابل، از اصطلاح «گواهی» (certificate) یا به‌اختصار «cert» برای اشاره به کلیدهای OpenPGP که فاقد داده‌های محرمانه هستند استفاده می‌نماییم. برای انجام عملیات روی گواهی‌ها، `sq cert` را ببینید. .PP .SH "زیردستورها (SUBCOMMANDS)" .SS "sq key list" فهرست کردن کلیدهای مدیریت‌شده توسط مخزن کلید. .PP .SS "sq key generate" تولید یک کلید جدید. .PP تولید کلید پیش‌نیاز دریافت پیام‌های رمزگذاری‌شده و ایجاد امضاها است. پارامترهای اندکی برای این فرایند وجود دارد، اما مقادیر پیش‌فرض معقولی برای بیشتر کاربران در نظر گرفته شده است. .PP هنگام تولید کلید، یک گواهی باطل‌سازی اضطراری نیز تولید می‌شود. در صورت مفقود شدن یا افشای کلید، می‌توان از این گواهی استفاده کرد. این گواهی در کنار کلید ذخیره می‌شود. این رفتار با استفاده از آرگومان `\-\-rev\-cert` قابل تغییر است. .PP به‌طور پیش‌فرض، کلید پس از ۳ سال منقضی می‌شود. این مقدار با استفاده از آرگومان `\-\-expiration` قابل تغییر است. .PP دستور `sq key generate` زمان مرجع تعیین‌شده توسط آرگومان سطح‌بالای `\-\-time` را رعایت می‌کند. این دستور زمان ایجاد کلید اصلی، زیرکلیدها و امضاهای اتصال را روی این زمان مرجع تنظیم می‌نماید. .PP .SS "sq key rotate" چرخش (تغییر دوره‌ای) یک گواهی. .PP یک گواهی جدید جهت جایگزینی با گواهی موجود تولید می‌کند. .PP گواهی جدید همان قابلیت‌های گواهی قبلی را خواهد داشت. این مورد می‌تواند با استفاده از آرگومان‌های `\-\-can\-sign`، `\-\-cannot\-sign` و غیره بازنویسی شود. نکته: گواهی جدید ممکن است ساختاری متفاوت از گواهی قبلی داشته باشد؛ برای نمونه، اگر کلید اصلی گواهی قبلی هم دارای قابلیت صدور گواهی و هم امضا علامت‌گذاری شده باشد، کلید اصلی گواهی جدید دارای قابلیت صدور گواهی خواهد بود و یک زیرکلید برای امضا خواهد داشت. .PP به‌طور پیش‌فرض، اعتبار گواهی پس از ۳ سال منقضی می‌شود. این مقدار با استفاده از آرگومان `\-\-expiration` قابل تغییر است. .PP گواهی جدید همان شناسه‌های کاربری خودامضاشدهٔ گواهی قبلی را خواهد داشت. شناسه‌های کاربری باطل‌شده نادیده گرفته می‌شوند. .PP گواهی جدید و گواهی قبلی یکدیگر را به‌صورت متقابل به عنوان معرفی‌کنندگان معتمدِ نامحدود تأیید خواهند کرد. .PP گواهی جدید به همان شیوه‌ای پیوند داده خواهد شد که گواهی قبلی پیوند یافته بود. این رفتار می‌تواند با استفاده از آرگومان‌های `\-\-own\-key` یا `\-\-shared\-key` بازنویسی شود. .PP گواهی جدید همان گواهی‌هایی را تأیید خواهد کرد که توسط گواهی قبلی تأیید شده بودند؛ بدین معنا که تأییدیه‌های گواهی قبلی بازپخش خواهند شد. برای اطلاعات بیشتر `sq pki vouch replay` را ببینید. .PP یک گواهی باطل‌سازی صادر خواهد شد که نشان می‌دهد گواهی قبلی بازنشسته شده و باید به جای آن از گواهی جدید استفاده شود. این گواهی به‌طور پیش‌فرض پس از ۱۸۲ روز اجرایی می‌شود. این مدت با استفاده از آرگومان `\-\-retire\-in` قابل تغییر یا متوقف‌سازی است. .PP هنگام استفاده از `\-\-output`، گواهی جدید به همراه تمامی گواهی‌های به‌روزرسانی‌شدهٔ دیگر در فایل مشخص‌شده نوشته می‌شوند. .PP پایدار از نسخه 1.2.0. .PP .SS "sq key import" وارد کردن کلیدها به مخزن کلید. .PP .SS "sq key export" صادر کردن کلیدها از مخزن کلید. .PP داده‌های کلید محرمانهٔ مرتبط با یک گواهی را صادر می‌کند. توجه داشته باشید که حتی در صورت در دسترس بودن داده‌های کلید محرمانه، ممکن است امکان برون‌بری آن‌ها وجود نداشته باشد؛ به عنوان مثال، داده‌های کلید محرمانه که روی ماژول امنیت سخت‌افزاری (HSM) ذخیره شده‌اند، معمولاً از دستگاه قابل برون‌بری نیستند. .PP روی تمام گواهی‌های مشخص‌شده پیمایش می‌کند و هر کلیدی (کلید اصلی و زیرکلیدها) را که شامل داده‌های کلید محرمانه باشد صادر می‌کند. در صورتی که هر یک از گواهی‌های مشخص‌شده حاوی اطلاعات کلید محرمانه نباشد، یک خطا بازگردانده می‌شود. .PP اگر می‌خواهید تنها یک کلید خاص و نه تمامی کلیدهای مرتبط با یک گواهی را صادر کنید، از `sq key subkey export` استفاده نمایید. .PP .SS "sq key delete" حذف داده‌های کلید محرمانهٔ یک گواهی. .PP .SS "sq key password" تغییر گذرواژهٔ محافظت‌کننده از داده‌های کلید محرمانه. .PP داده‌های کلید محرمانه می‌توانند با یک گذرواژه محافظت شوند. این زیردستور گذرواژه را تغییر داده یا پاک می‌کند. .PP برای حذف گذرواژه، یا از `\-\-clear` استفاده کنید یا هنگام درخواست گذرواژهٔ جدید، یک گذرواژه با طول صفر (خالی) وارد نمایید. .PP اگر کلیدی با گذرواژه محافظت شده باشد و گذرواژهٔ صحیح با استفاده از آرگومان `\-\-password\-file` ارائه نشده باشد، از کاربر برای وارد کردن گذرواژه درخواست می‌شود. به همین ترتیب، اگر گذرواژهٔ جدید ارائه نشده باشد، از کاربر سؤال خواهد شد. .PP .SS "sq key expire" تغییر زمان انقضای یک گواهی. .PP این زیردستور زمان انقضای یک گواهی را تغییر می‌دهد. برای تغییر زمان انقضای یک زیرکلید به‌صورت مجزا، از زیردستور `sq key subkey expire` استفاده کنید. .PP .SS "sq key revoke" باطل‌سازی یک گواهی. .PP یک گواهی باطل‌سازی برای یک گواهی ایجاد می‌کند. .PP اگر `\-\-revoker` یا `\-\-revoker\-file` مشخص شده باشد، از آن کلید برای ایجاد گواهی باطل‌سازی استفاده می‌شود. اگر آن کلید با گواهی‌ای که در حال باطل‌شدن است متفاوت باشد، به یک باطل‌سازی شخص ثالث منجر خواهد شد. این حالت معمولاً تنها در صورتی سودمند است که مالک گواهی، کلید مذکور را به عنوان باطل‌کنندهٔ معین (designated revoker) تعیین کرده باشد. .PP دستور `sq key revoke` زمان مرجع تعیین‌شده توسط آرگومان سطح‌بالای `\-\-time` را رعایت می‌کند. در صورت تنظیم بودن، هنگام تشخیص اعتبار کلیدها به‌جای زمان فعلی از زمان مشخص‌شده استفاده می‌کند و زمان ایجاد گواهی باطل‌سازی را نیز به‌جای زمان فعلی روی زمان مرجع تنظیم می‌نماید. .PP.SS "sq key userid" مدیریت شناسه‌های کاربری. .PP افزودن شناسه‌های کاربری به یک کلید، یا ابطال آن‌ها. .PP .SS "sq key subkey" مدیریت زیرکلیدها. .PP افزودن زیرکلیدهای جدید به یک گواهی موجود، تغییر تاریخ انقضای آن‌ها، و ابطال آن‌ها. .SS "sq key approvals" مدیریت تأییدیه‌های گواهی‌گذاری. .PP دارندگان کلید می‌توانند گواهی‌گذاری‌های شخص ثالث مرتبط با گواهی خود را تأیید کنند. این زیردستور، تأییدیه‌ها را مدیریت می‌کند. .PP برای جلوگیری از حملات طغیان گواهی (certificate flooding attacks)، کارسازهای مدرن کلید از توزیع مهارنشده‌ی گواهی‌گذاری‌های شخص ثالث بر روی گواهی‌ها ممانعت می‌کنند. برای آن‌که به دارنده کلید اجازه داده شود اطلاعاتی را که با گواهی او توزیع می‌شود کنترل کند، این کارسازهای کلید تنها گواهی‌گذاری‌های شخص ثالثی را توزیع می‌کنند که دارنده کلید صراحتاً آن‌ها را تأیید کرده باشد. .PP .SH "مثال‌ها (EXAMPLES)" .SS "sq key list" .PP .PP فهرست کردن کلیدهای مدیریت‌شده توسط کارساز مخزن کلید. .PP .nf .RS sq key list .RE .PP .fi .PP فهرست کردن کلیدهای مدیریت‌شده توسط کارساز مخزن کلید با شناسه کاربری در example.org. .PP .nf .RS sq key list \-\-cert\-domain=example.org .RE .fi .PP .SS "sq key generate" .PP .PP تولید یک کلید و ذخیره آن در مخزن کلید. .PP .nf .RS sq key generate \-\-own\-key \-\-name Alice \-\-email \\ .RE .RS .RS alice@example.org .RE .RE .PP .fi .PP تولید یک کلید و ذخیره آن در یک فایل به‌جای مخزن کلید. .PP .nf .RS sq key generate \-\-own\-key \-\-name Alice \-\-email \\ .RE .RS .RS alice@example.org \-\-output alice\-priv.pgp \-\-rev\-cert \\ .RE .RE .RS .RS alice\-priv.rev .RE .RE .fi .PP .SS "sq key rotate" .PP .PP چرخش گواهی Alice. .PP .nf .RS sq key rotate \-\-cert EB28F26E2739A4870ECC47726F0073F60FD0CBF0 .RE .fi .PP .SS "sq key import" .PP .PP وارد کردن کلیدها به مخزن کلید. .PP .nf .RS sq key import alice\-secret.pgp .RE .fi .PP .SS "sq key export" .PP .PP برون‌بری گواهی Alice به همراه تمام داده‌های کلید محرمانه موجود. .PP .nf .RS sq key export \-\-cert EB28F26E2739A4870ECC47726F0073F60FD0CBF0 .RE .PP .fi .PP برون‌بری گواهی Alice مشخص‌شده با نشانی رایانامه به همراه تمام داده‌های کلید محرمانه موجود. .PP .nf .RS sq key export \-\-cert\-email alice@example.org .RE .fi .PP.SS "sq key delete" .PP .PP حذف هرگونه کلید مخفی مرتبط با گواهی Alice. .PP .nf .RS sq key delete \-\-cert EB28F26E2739A4870ECC47726F0073F60FD0CBF0 .RE .PP .fi .PP حذف هرگونه کلید مخفی مرتبط با گواهی Alice که بر اساس شناسه کاربری (user ID) انتخاب شده است. .PP .nf .RS sq key delete \-\-cert\-email=alice@example.org .RE .fi .PP .SS "sq key password" .PP .PP تغییر گذرواژه تمام کلیدهای Alice به گذرواژه موجود در فایل مشخص‌شده. .PP .nf .RS sq key password \-\-new\-password\-file password\-file.txt \-\-cert \\ .RE .RS .RS EB28F26E2739A4870ECC47726F0073F60FD0CBF0 .RE .RE .PP .fi .PP حذف محافظت با گذرواژه برای تمام کلیدهای Alice. .PP .nf .RS sq key password \-\-password\-file password\-file.txt \\ .RE .RS .RS \-\-clear\-password \-\-cert \\ .RE .RE .RS .RS EB28F26E2739A4870ECC47726F0073F60FD0CBF0 .RE .RE .fi .PP .SS "sq key expire" .PP .PP تغییر تاریخ انقضای گواهی Alice به یک سال آینده. .PP .nf .RS sq key expire \-\-expiration 1y \-\-cert \\ .RE .RS .RS EB28F26E2739A4870ECC47726F0073F60FD0CBF0 .RE .RE .PP .fi .PP تغییر گواهی Alice به‌گونه‌ای که هرگز منقضی نشود. .PP .nf .RS sq key expire \-\-expiration never \-\-cert \\ .RE .RS .RS EB28F26E2739A4870ECC47726F0073F60FD0CBF0 .RE .RE .fi .PP .SS "sq key revoke" .PP .PP ابطال کلید Alice با مشخص کردن این‌که گواهی جدیدی جایگزین شده است. .PP .nf .RS sq key revoke \-\-cert EB28F26E2739A4870ECC47726F0073F60FD0CBF0 \\ .RE .RS .RS \-\-reason superseded \-\-message \\ .RE .RE .RS .RS "My new cert is C5999E8191BF7B503653BE958B1F7910D01F86E5" .RE .RE .PP .fi .PP ابطال کلید با مشخص کردن این‌که محتوای کلید مخفی افشا شده و به خطر افتاده است. .PP .nf .RS sq key revoke \-\-cert EB28F26E2739A4870ECC47726F0073F60FD0CBF0 \\ .RE .RS .RS \-\-reason compromised \-\-message \\ .RE .RE .RS .RS "Computer attacked, secret key material compromised" .RE .RE .fi .PP.SH "همچنین ببینید (SEE ALSO)" .nh \fBsq\fR(1), \fBsq\-key\-list\fR(1), \fBsq\-key\-generate\fR(1), \fBsq\-key\-rotate\fR(1), \fBsq\-key\-import\fR(1), \fBsq\-key\-export\fR(1), \fBsq\-key\-delete\fR(1), \fBsq\-key\-password\fR(1), \fBsq\-key\-expire\fR(1), \fBsq\-key\-revoke\fR(1), \fBsq\-key\-userid\fR(1), \fBsq\-key\-subkey\fR(1), \fBsq\-key\-approvals\fR(1). .hy .PP برای مستندات کامل، را ببینید. .SH "نسخه (VERSION)" 1.4.0