SQ(1)                            User Commands                           SQ(1)

نام (NAME)
       sq-key-subkey-add - افزودن یک زیرکلید جدید به یک گواهی

خلاصه دستور (SYNOPSIS)
       sq key subkey add [گزینه‌ها]

توضیحات (DESCRIPTION)
       افزودن یک زیرکلید جدید به یک گواهی.

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

       گزینه --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 پیروی می‌کند. این دستور زمان ساخت زیرکلید را روی زمان مشخص‌شده
       قرار می‌دهد.

گزینه‌ها (OPTIONS)
   گزینه‌های زیردستور (Subcommand options)
       --can-authenticate
              افزودن یک زیرکلید با قابلیت اصالت‌سنجی

       --can-encrypt=PURPOSE
              افزودن یک زیرکلید با قابلیت رمزنگاری [پیش‌فرض: universal]

              زیرکلیدهای دارای قابلیت رمزنگاری را می‌توان برای رمزنگاری انتقال،
              رمزنگاری ذخیره‌سازی، یا هر دو، یعنی عمومی (universal) مشخص کرد.

              [مقادیر مجاز: transport, storage, universal]

       --can-sign
              افزودن یک زیرکلید با قابلیت امضا

       --cert=FINGERPRINT|KEYID
              افزودن یک زیرکلید به کلید با اثرانگشت یا شناسه کلید مشخص‌شده

       --cert-email=EMAIL
              افزودن یک زیرکلید به کلیدی که یک شناسه کاربری آن شامل آدرس
              رایانامه مشخص‌شده است

       --cert-file=PATH
              افزودن یک زیرکلید به کلید خوانده‌شده از PATH

       --cert-userid=USERID
              افزودن یک زیرکلید به کلید با شناسه کاربری مشخص‌شده

       --cipher-suite=CIPHER-SUITE
              انتخاب الگوریتم‌های رمزنگاری برای زیرکلید

              مقدار پیش‌فرض را می‌توان در فایل پیکربندی با استفاده از تنظیم
              `key.generate.cipher-suite` تغییر داد.

              [پیش‌فرض: cv25519]

              [مقادیر مجاز: rsa2k, rsa3k, rsa4k, cv25519, cv448,
              mldsa65-ed25519, mldsa87-ed448]

       --expiration=EXPIRATION
              تنظیم زمان انقضا

              مقدار EXPIRATION یا یک تاریخ در قالب ISO 8601 همراه با زمان
              اختیاری است یا یک مدت‌زمان سفارشی. یک مدت‌زمان به شکل `N[ymwds]`
              است که در آن حروف به ترتیب نشان‌دهنده سال، ماه، هفته، روز و ثانیه
              هستند. همچنین، کلمه کلیدی `never` هیچ زمان انقضایی تنظیم نمی‌کند.

              [پیش‌فرض: never]

       --new-password-file=PASSWORD_FILE
              فایل حاوی گذرواژه برای رمزنگاری داده‌های کلید خصوصی

              توجه داشته باشید که کل فایل به عنوان گذرواژه استفاده خواهد شد،
              از جمله هرگونه نویسه فاصله مانند خط جدید پایانی.

       --output=FILE
              نوشتن در FILE مشخص‌شده

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

       --without-password
              محافظت نکردن از داده‌های کلید خصوصی زیرکلید با گذرواژه

   گزینه‌های عمومی (Global options)
       برای مشاهده شرح گزینه‌های عمومی، sq(1) را ببینید.

مثال‌ها (EXAMPLES)
       افزودن یک زیرکلید جدید با قابلیت امضا به کلید Alice.

              sq key subkey add --can-sign \
                     --cert=EB28F26E2739A4870ECC47726F0073F60FD0CBF0

همچنین ببینید (SEE ALSO)
       sq(1), sq-key(1), sq-key-subkey(1).

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

نسخه (VERSION)
       1.4.0

Sequoia PGP                          1.4.0                               SQ(1)