نام (NAME)

sq-network-search - دریافت گواهی‌ها با استفاده از تمام سرویس‌های شبکه پشتیبانی‌شده

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

sq network search [OPTIONS] QUERY

توضیحات (DESCRIPTION)

دریافت گواهی‌ها با استفاده از تمام سرویس‌های شبکه پشتیبانی‌شده.

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

کشف گواهی‌های مرتبط مفید است: گواهی‌های جایگزین از گردش کلیدها پشتیبانی می‌کنند، گواهی‌های منقضی‌شده امکان اعتبارسنجی امضاهای انجام‌شده در گذشته را فراهم می‌سازند، و کشف گواهی‌های ابطال‌شده برای دستیابی به اطلاعات ابطال اهمیت دارد. سازوکار PKI به انتخاب گواهی درست کمک خواهد کرد؛ به `sq pki` مراجعه کنید.

به‌طور پیش‌فرض، هر گواهی بازگردانده‌شده در مخزن محلی گواهی‌ها ذخیره می‌شود. با استفاده از گزینه `--output` می‌توان این رفتار را تغییر داد.

هنگامی که یک گواهی از یک کارساز کلید اعتبارسنج (در حال حاضر محدود به فهرستی از کارسازهای شناخته‌شده: `hkps://keys.openpgp.org`، `hkps://keys.mailvelope.com` و `hkps://mail-api.proton.me`)، از طریق WKD، DANE یا https دریافت شده و به مخزن محلی گواهی‌ها وارد می‌شود، شناسه‌های کاربری (User IDs) نیز با یک کلید محلی مختص کارساز گواهی می‌شوند. آن گواهی پراکسی نیز به نوبه خود توسط ریشه اعتماد محلی به عنوان یک CA با حداقل میزان اعتماد (میزان اعتماد: ۱ از ۱۲۰) گواهی می‌شود. میزان اعتماد به CA کارساز کلید پراکسی را می‌توان طبق معمول با استفاده از `sq pki link add` یا `sq pki link retract` تنظیم کرد.

گزینه‌ها (OPTIONS)

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

--all: دریافت به‌روزرسانی‌ها برای تمام گواهی‌های شناخته‌شده
--iterations=N: تکرار برای یافتن به‌روزرسانی‌ها و گواهی‌های مرتبط

: مقدار پیش‌فرض را می‌توان در فایل پیکربندی با استفاده از تنظیم `network.search.iterations` تغییر داد.
: [پیش‌فرض: 3]

--output=FILE: نوشتن در FILE (یا خروجی استاندارد در صورت عدم تعیین) به جای وارد کردن به مخزن گواهی‌ها
--server=URI: تنظیم یک کارساز کلید برای استفاده (می‌تواند چندین بار مشخص شود)

: مقدار پیش‌فرض را می‌توان در فایل پیکربندی با استفاده از تنظیم `network.keyserver.servers` تغییر داد.
: [پیش‌فرض: hkps://keys.openpgp.org, hkps://mail-api.proton.me, hkps://keys.mailvelope.com, hkps://keyserver.ubuntu.com, hkps://sks.pod01.fleetstreetops.com]

--use-dane=ENABLE: استفاده از DANE برای جستجوی گواهی‌ها

: مقدار پیش‌فرض را می‌توان در فایل پیکربندی با استفاده از تنظیم `network.search.use-dane` تغییر داد.
: [پیش‌فرض: true]
: [مقادیر مجاز: true, false]

--use-wkd=ENABLE: استفاده از WKD برای جستجوی گواهی‌ها

: مقدار پیش‌فرض را می‌توان در فایل پیکربندی با استفاده از تنظیم `network.search.use-wkd` تغییر داد.
: [پیش‌فرض: true]
: [مقادیر مجاز: true, false]

QUERY: دریافت گواهی(ها) با استفاده از QUERY

: این مقدار می‌تواند یک اثر انگشت، یک KeyID، یک نشانی رایانامه، یا یک نشانی اینترنتی https باشد.

گزینه‌های عمومی (Global options)

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

مثال‌ها (EXAMPLES)

جستجو برای گواهی امضای اصلی Qubes.

sq network search 427F11FD0FAA4B080123F01CDDFA1A3E36879494

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

sq network search alice@example.org

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

sq(1), sq-network(1).

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

نسخه (VERSION)

1.4.0