نام (NAME)

sq-verify - بررسی اعتبار پیام‌های امضاشده یا امضاهای مجزا

خلاصه دستور (SYNOPSIS)

sq verify [OPTIONS] FILE

توضیحات (DESCRIPTION)

پیام‌های امضاشده یا امضاهای مجزا (detached) را اعتبارسنجی می‌کند.

هنگام بررسی اعتبار پیام‌های امضاشده، پیام در stdout یا فایلی که به `--output` داده شده است نوشته می‌شود.

هنگامی که یک پیام مجزا بررسی می‌شود، هیچ خروجی‌ای تولید نمی‌گردد. امضاهای مجزا اغلب برای امضای بسته‌های نرم‌افزاری به کار می‌روند.

اعتبارسنجی تنها در صورتی موفقیت‌آمیز است که هیچ امضای نادرستی وجود نداشته باشد و تعداد امضاهای با موفقیت تأییدشده به آستانه پیکربندی‌شده با پارامتر `--signatures` برسد. اگر اعتبارسنجی با شکست مواجه شود، برنامه با وضعیت خروجی نشان‌دهنده خطا خاتمه می‌یابد و فایل خروجی حذف می‌شود. اگر خروجی به stdout ارسال شده باشد، ۲۵ مبی‌بایت (MiB) آخر پیام مسدود و بازداشته می‌شود (در نتیجه، اگر پیام از ۲۵ مبی‌بایت کوچک‌تر باشد، هیچ خروجی‌ای تولید نمی‌شود).

یک امضا زمانی احراز هویت شده تلقی می‌شود که هویت امضاکننده قابل تأیید باشد. اگر امضاکننده از طریق `--signer-file` ارائه شود، احراز هویت شده در نظر گرفته می‌شود. در غیر این صورت، امضاکننده با استفاده از شبکه اعتماد (Web of Trust) جستجو و احراز هویت می‌شود. اگر حداقل یک شناسه کاربر (User ID) بتواند به‌طور کامل احراز هویت شود، امضا احراز هویت شده در نظر گرفته می‌شود. اگر امضا حاوی یک زیربسته Signer User ID باشد، تنها همان شناسه کاربر در نظر گرفته خواهد شد. توجه: نیازی نیست شناسه کاربر خودامضا (self-signed) باشد.

عملیات معکوس این دستور، `sq sign` است.

اگر به دنبال یک برنامه مستقل برای اعتبارسنجی امضاهای مجزا هستید، استفاده از sequoia-sqv را مد نظر قرار دهید.

دستور `sq verify` زمان مرجع تنظیم‌شده توسط آرگومان سطح بالای `--time` را رعایت می‌کند. در صورت تنظیم، پیام را بر اساس زمان مرجع به‌جای زمان کنونی بررسی می‌کند.

گزینه‌ها (OPTIONS)

گزینه‌های زیردستور (Subcommand options)

--cleartext: اعتبارسنجی یک پیام امضاشده با متن خام (cleartext)
--message: اعتبارسنجی یک پیام با امضای درون‌خطی (inline)
--output=FILE: نوشتن در FILE یا در صورت عدم ذکر، ارسال به stdout

: [پیش‌فرض: -]

--signature-file=SIG: اعتبارسنجی یک فایل امضای مجزا (detached)
--signatures=N: تنظیم آستانه تعداد امضاهای معتبر به N

: اگر این آستانه برآورده نشود، پیام اعتبارسنجی‌شده تلقی نخواهد شد.
: [پیش‌فرض: 1]

--signer=FINGERPRINT|KEYID: الزام وجود امضا از گواهی با اثرانگشت یا شناسه کلید مشخص‌شده
--signer-domain=DOMAIN: الزام وجود امضا از گواهی‌ای که شناسه کاربر آن شامل آدرس ایمیلی برای دامنه مشخص‌شده باشد
--signer-email=EMAIL: الزام وجود امضا از گواهی‌ای که شناسه کاربر آن شامل آدرس ایمیل مشخص‌شده باشد
--signer-file=PATH: الزام وجود امضا از گواهی خوانده‌شده از PATH
--signer-userid=USERID: الزام وجود امضا از گواهی با شناسه کاربر مشخص‌شده
FILE: خواندن از FILE یا از stdin در صورتی که FILE برابر با '-' باشد

: [پیش‌فرض: -]

گزینه‌های سراسری (Global options)

برای مشاهده توضیحات گزینه‌های عمومی به sq(1) مراجعه کنید.

مثال‌ها (EXAMPLES)

اعتبارسنجی یک پیام امضاشده:

sq verify --message document.pgp

اعتبارسنجی یک امضای مجزا:

sq verify --signature-file=document.sig document.txt

اعتبارسنجی یک پیام بر اساس تاریخ ۱۹ ژوئن ۲۰۲۴ در نیمه‌شب UTC:

sq verify --time 2024-06-19 --message document.pgp

همچنین ببینید (SEE ALSO)

sq(1).

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

نسخه (VERSION)

1.4.0