SQ(1) دستورهای کاربری SQ(1) نام (NAME) sq-key-generate - تولید یک کلید جدید خلاصه دستور (SYNOPSIS) sq key generate [OPTIONS] توضیحات (DESCRIPTION) تولید یک کلید جدید. تولید کلید پیش‌نیاز دریافت پیام‌های رمزنگاری‌شده و ایجاد امضاها است. این فرآیند چند پارامتر دارد، اما مقادیر پیش‌فرض معقولی برای اکثر کاربران ارائه شده است. هنگام تولید کلید، یک گواهی ابطال اضطراری نیز تولید می‌شود. در صورتی که کلید گم شود یا لو برود (به خطر بیفتد)، این گواهی می‌تواند استفاده شود. این گواهی در کنار کلید ذخیره می‌شود. این رفتار را می‌توان با استفاده از آرگومان `--rev-cert` تغییر داد. به‌طور پیش‌فرض، کلید پس از ۳ سال منقضی می‌شود. این زمان را می‌توان با استفاده از آرگومان `--expiration` تغییر داد. دستور `sq key generate` به زمان مرجعِ تعیین‌شده با آرگومان سطح‌بالای `--time` پایبند است. این دستور زمان ایجاد کلید اصلی، تمامی زیرکلیدها و امضاهای پیوند (binding) را روی این زمان مرجع تنظیم می‌کند. گزینه‌ها (OPTIONS) گزینه‌های زیردستور (Subcommand options) --allow-non-canonical-userids شناسه‌های کاربری که در قالب متعارف (canonical) نیستند را رد نمی‌کند شناسه‌های کاربری متعارف به شکل `Name (Comment) ` هستند. --can-authenticate افزودن یک زیرکلید با قابلیت احراز هویت (پیش‌فرض) --can-encrypt=PURPOSE افزودن یک زیرکلید با قابلیت رمزنگاری [پیش‌فرض: universal] زیرکلیدهای با قابلیت رمزنگاری می‌توانند برای رمزنگاری انتقال (transport)، رمزنگاری ذخیره‌سازی (storage) یا هر دو، یعنی سراسری (universal)، مناسب علامت‌گذاری شوند. [مقادیر ممکن: transport, storage, universal] --can-sign افزودن یک زیرکلید با قابلیت امضا (پیش‌فرض) --cannot-authenticate عدم افزودن زیرکلید با قابلیت احراز هویت --cannot-encrypt عدم افزودن زیرکلید با قابلیت رمزنگاری --cannot-sign عدم افزودن زیرکلید با قابلیت امضا --cipher-suite=CIPHER-SUITE انتخاب الگوریتم‌های رمزنگاری برای کلید مقدار پیش‌فرض را می‌توان در فایل پیکربندی با استفاده از تنظیم `key.generate.cipher-suite` تغییر داد. [پیش‌فرض: cv25519] [مقادیر ممکن: rsa2k, rsa3k, rsa4k, cv25519, cv448, mldsa65-ed25519, mldsa87-ed448] --email=ADDRESS افزودن یک نشانی رایانامه (ایمیل) به عنوان شناسه کاربر به کلید --encryption-algorithm=ALGORITHM انتخاب الگوریتم رمزنگاری برای کلیدهای رمزنگاری در صورت تعیین، این الگوریتم برای کلیدهای با قابلیت رمزنگاری استفاده می‌شود. این پارامتر بر پارامتر مجموعه‌رمز (cipher suite) اولویت دارد. [مقادیر ممکن: rsa2k, rsa3k, rsa4k, elgamal2k, elgamal3k, cv25519, x25519, x448, nistp256, nistp384, nistp521, brainpoolp256, brainpoolp384, brainpoolp512, mlkem768-x25519, mlkem1024-x448] --expiration=EXPIRATION تنظیم زمان انقضا EXPIRATION یا یک تاریخ در قالب ISO 8601 همراه با زمان اختیاری است، یا یک مدت‌زمان سفارشی. مدت‌زمان به شکل `N[ymwds]` است که در آن حروف به ترتیب نمایانگر سال، ماه، هفته، روز و ثانیه هستند. به عنوان روش جایگزین، کلیدواژه `never` هیچ زمان انقضایی تنظیم نمی‌کند. [پیش‌فرض: 3y] --name=NAME افزودن یک نام به عنوان شناسه کاربر به کلید --new-password-file=PASSWORD_FILE فایل حاوی گذرواژه برای رمزنگاری داده‌های کلید خصوصی توجه داشته باشید که کل محتوای فایل کلید، از جمله فاصله‌ها و خط جدید انتهایی، به عنوان گذرواژه استفاده خواهد شد. --no-userids ایجاد یک کلید بدون هیچ شناسه کاربری --output=FILE نوشتن کلید در فایل مشخص‌شده در صورت عدم تعیین، کلید در مخزن کلید (key store) ذخیره می‌شود. --own-key علامت‌گذاری کلید به عنوان کلید شخصی کلید تازه‌تولیدشده به همراه تمام شناسه‌های کاربری‌اش به عنوان احراز هویت‌شده و به عنوان یک معرفی‌کننده کاملاً مورد اعتماد (fully trusted introducer) علامت‌گذاری می‌شود. --profile=PROFILE انتخاب استاندارد OpenPGP برای کلید همگام با توسعه OpenPGP، نسخه‌های جدیدی در دسترس قرار خواهند گرفت. این گزینه نسخه OpenPGP مورد استفاده برای کلید تازه تولیدشده را انتخاب می‌کند. در حال حاضر، sq از دو نمایه RFC9580 و RFC4880 پشتیبانی می‌کند. در حال حاضر مقدار پیش‌فرض RFC4880 است. با این حال، با گسترش بیشتر پشتیبانی از RFC9580، این پیش‌فرض در نسخه‌های آینده sq تغییر خواهد کرد. مقدار پیش‌فرض را می‌توان در فایل پیکربندی با استفاده از تنظیم `key.generate.profile` تغییر داد. [پیش‌فرض: rfc4880] [مقادیر ممکن: rfc9580, rfc4880] --rev-cert=FILE نوشتن گواهی ابطال اضطراری در FILE هنگامی که کلید در مخزن کلید ذخیره می‌شود، گواهی ابطال به‌طور پیش‌فرض در $HOME/.local/share/sequoia/revocation-certificates ذخیره می‌شود. هنگامی که `--output` مشخص شود، گواهی ابطال در فایل مشخص‌شده توسط `--rev-cert` نوشته می‌شود. اگر `--output` برابر با `-` باشد، این گزینه نیز نباید `-` باشد. --shared-key علامت‌گذاری کلید به عنوان یک کلید اشتراکی کلید تازه‌تولیدشده همراه با تمام شناسه‌های کاربری‌اش به عنوان احراز هویت‌شده علامت‌گذاری می‌شود، اما نه به عنوان یک معرفی‌کننده مورد اعتماد. علاوه بر این، فراداده کلید نشان خواهد داد که این یک کلید اشتراکی است. اگر قصد دارید این کلید را با دیگران به اشتراک بگذارید، از این گزینه استفاده کنید. در حالت عادی، نباید داده‌های کلید را به اشتراک بگذارید. نمونه‌ای از مواردی که ممکن است بخواهید این کار را انجام دهید، یک صندوق پستی اشتراکی است. --signing-algorithm=ALGORITHM انتخاب الگوریتم رمزنگاری برای کلیدهای امضا در صورت تنظیم، این الگوریتم برای کلیدهای مورد استفاده برای امضا به کار می‌رود. این شامل کلیدهای دارای قابلیت امضا، احراز هویت و صدور گواهی است. این پارامتر بر پارامتر مجموعه‌رمز (cipher suite) اولویت دارد. [مقادیر ممکن: rsa2k, rsa3k, rsa4k, dsa2k, dsa3k, cv25519, ed25519, ed448, nistp256, nistp384, nistp521, brainpoolp256, brainpoolp384, brainpoolp512, mldsa65-ed25519, mldsa87-ed448, slhdsa128s, slhdsa128f, slhdsa256s] --userid=USERID افزودن یک شناسه کاربر به کلید این شناسه کاربر می‌تواند نام و نشانی رایانامه را با هم ترکیب کند، می‌تواند به صورت اختیاری شامل یک توضیح (comment) باشد، یا حتی در صورت استفاده از `--allow-non-canonical-userids` به شکل آزاد باشد. با این حال، استدلال و تصمیم‌گیری درباره شناسه‌های کاربری که حاوی اطلاعات متفاوتی مانند نام و نشانی رایانامه هستند دشوارتر است، بنابراین امروزه استفاده از شناسه‌های کاربری مجزا برای نام و نشانی رایانامه ترجیح داده می‌شود. در صورت تردید، استفاده از `--name` و `--email` را ترجیح دهید. --without-password عدم محافظت از داده‌های کلید خصوصی با گذرواژه گزینه‌های عمومی (Global options) برای شرح گزینه‌های عمومی، sq(1) را ببینید. مثال‌ها (EXAMPLES) تولید یک کلید و ذخیره آن در مخزن کلید. sq key generate --own-key --name Alice --email \ alice@example.org تولید یک کلید و ذخیره آن در یک فایل به جای مخزن کلید. sq key generate --own-key --name Alice --email \ alice@example.org --output alice-priv.pgp --rev-cert \ alice-priv.rev همچنین ببینید (SEE ALSO) sq(1), sq-key(1). برای مستندات کامل، را ببینید. نسخه (VERSION) 1.4.0 Sequoia PGP 1.4.0 SQ(1)