نام (NAME)

qcatool - ابزار خط فرمان برای معماری رمزنگاری کیوت (QCA)

توضیحات (DESCRIPTION)

برنامه qcatool یک ابزار خط فرمان برای انجام عملیات‌های مختلف رمزنگاری با استفاده از معماری رمزنگاری کیوت (QCA) است. همچنین می‌توان از qcatool برای آزمایش و اشکال‌زدایی QCA استفاده کرد.

نحوه استفاده (USAGE)

برنامه qcatool دارای طیف وسیعی از گزینه‌ها و دستورها است. شما در هر بار فقط می‌توانید یک دستور را اجرا کنید، اما می‌توانید از چندین گزینه، یک گزینه یا هیچ گزینه‌ای استفاده کنید.

گزینه‌ها (OPTIONS)

همان‌طور که در بالا اشاره شد، همه این موارد اختیاری هستند و می‌توانند با یکدیگر ترکیب شوند.

--pass=PASSWORD: گذرواژه مورد استفاده را مشخص می‌کند. به جز در موارد آزمایشی، احتمالاً استفاده از این گزینه ایده بدی است، زیرا هر کسی می‌تواند آرگومان‌های ارائه‌شده به یک برنامه خط فرمان را بخواند.
--newpass=PASSWORD: گذرواژه جدید را برای تغییر گذرواژه با دستورهای key changepass و keybundle changepass مشخص می‌کند. به جز در موارد آزمایشی، احتمالاً استفاده از این گزینه ایده بدی است، زیرا هر کسی می‌تواند آرگومان‌های ارائه‌شده به یک برنامه خط فرمان را بخواند.
--nonroots=CERTIFICATES: گواهی‌های اضافی و غیرقابل‌اعتماد را مشخص می‌کند که در صورت امکان برقراری اعتماد مناسب، ممکن است در مسیر اعتماد (trust path) استفاده شوند.
--roots=CERTIFICATES: گواهی‌های اضافی را مشخص می‌کند که می‌توانند به عنوان گواهی‌های معتمد (ریشه یا root) استفاده شوند.
--nosys: استفاده از گواهی‌های ریشه استاندارد ارائه‌شده توسط سیستم‌عامل را غیرفعال می‌کند.
--noprompt: درخواست تعاملی برای گذرواژه‌ها/عبارت‌های عبور را غیرفعال می‌کند. اگر عبارت عبور را در خط فرمان (با --pass یا --newpass) ارائه ندهید، در صورت نیاز به گذرواژه/عبارت عبور، این گزینه باعث می‌شود qcatool دستور را لغو کند.
--ordered: هنگام نمایش فیلدهای اطلاعاتی گواهی (Distinguished Name و Subject Alternative Name)، آن‌ها را به همان ترتیبی که در گواهی وجود دارند نشان می‌دهد، نه با ترتیبی مرتب‌شده و کاربرپسند.
--debug: خروجی‌های اضافی را برای کمک به اشکال‌زدایی فعال می‌کند.
--log-file=FILENAME: ثبت لاگ در فایل مشخص‌شده.
--log-level=LEVEL: ثبت لاگ در سطح مشخص‌شده. سطح لاگ می‌تواند بین 0 (هیچ) و 8 (بیشترین) باشد.
--nobundle: هنگام امضای S/MIME، زنجیره گواهی امضاکننده را درون امضا قرار نمی‌دهد. این کار حجم خروجی امضا را کاهش می‌دهد، اما مستلزم آن است که گیرنده برای تأیید صحت آن، تمام گواهی‌های لازم را در اختیار داشته باشد.

دستورها (COMMANDS)

help, --help, -h: نمایش اطلاعات راهنما و نحوه استفاده.
version, --version, -v: نمایش اطلاعات نسخه.
plugins: فهرست کردن افزونه‌های موجود. از گزینه --debug برای دریافت اطلاعات بیشتر درباره افزونه‌های یافت‌شده و مواردی که با موفقیت بارگذاری شده‌اند استفاده کنید.
config save [provider]: ذخیره پیکربندی ارائه‌دهنده (provider). از این دستور برای نوشتن پیکربندی پیش‌فرض ارائه‌دهنده در حافظه پایدار استفاده کنید تا بتوانید بعداً آن را به صورت دستی ویرایش کنید.
config edit [provider]: ویرایش پیکربندی ارائه‌دهنده. تغییرات در حافظه پایدار ذخیره می‌شوند.
key make rsa|dsa [bits]: ایجاد یک جفت‌کلید.
key changepass [K]: افزودن/تغییر/حذف عبارت عبور یک کلید.
cert makereq [K]: ایجاد درخواست گواهی (CSR).
cert makeself [K]: ایجاد گواهی خودامضا (self-signed).
cert makereqadv [K]: نسخه پیشرفته دستور 'makereq'.
cert makeselfadv [K]: نسخه پیشرفته دستور 'makeself'.
cert validate [C]: اعتبارسنجی گواهی.
keybundle make [K] [C]: ایجاد یک دسته کلید (keybundle).
keybundle extract [X]: استخراج گواهی(ها) و کلید.
keybundle changepass [X]: تغییر عبارت عبور یک دسته کلید.
keystore list-stores: فهرست کردن تمام مخازن کلید (keystores) موجود.
keystore list [storeName]: فهرست کردن محتوای یک مخزن کلید.
keystore monitor: پایش در دسترس بودن مخزن کلید.
keystore export [E]: برون‌بری محتوای یک مدخل از مخزن کلید.
keystore exportref [E]: برون‌بری ارجاع یک مدخل از مخزن کلید.
keystore addkb [storeName] [cert.p12]: افزودن یک دسته کلید به مخزن کلید.
keystore addpgp [storeName] [key.asc]: افزودن یک کلید PGP به مخزن کلید.
keystore remove [E]: حذف یک شیء از مخزن کلید.
show cert [C]: بررسی یک گواهی.
show req [req.pem]: بررسی یک درخواست گواهی (CSR).
show crl [crl.pem]: بررسی یک لیست ابطال گواهی (CRL).
show kb [X]: بررسی یک دسته کلید.
show pgp [P|S]: بررسی یک کلید PGP.
message sign pgp|pgpdetach|smime [X|S]: امضای یک پیام.
message encrypt pgp|smime [C|P]: رمزگذاری یک پیام.
message signencrypt [S] [P]: امضا و رمزگذاری PGP یک پیام.
message verify pgp|smime: تأیید صحت یک پیام.
message decrypt pgp|smime ((X) ...): رمزگشایی یک پیام (S/MIME به X نیاز دارد).
message exportcerts: برون‌بری گواهی‌ها از پیام S/MIME.

آرگومان‌ها (ARGUMENTS)

آرگومان‌های دستورها به شرح زیر هستند:

K = کلید خصوصی (private key).

C = گواهی (certificate).

X = دسته کلید (key bundle).

P = کلید عمومی PGP.

S = کلید مخفی PGP.

E = مدخل عمومی (generic entry).

این موارد باید توسط یک نام فایل یا یک ارجاع به مخزن کلید ("store:obj") مشخص شوند.

نویسنده (AUTHOR)

برنامه qcatool توسط Justin Karneges به عنوان بخشی از QCA نوشته شده است. این صفحه راهنما توسط Brad Hards نوشته شده است.