نام (NAME)

sq-network-wkd-publish - انتشار گواهی‌ها در یک دایرکتوری کلید وب (WKD)

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

sq network wkd publish [OPTIONS] DEST

توضیحات (DESCRIPTION)

انتشار گواهی‌ها در یک دایرکتوری کلید وب (Web Key Directory).

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

معمولاً یک WKD روی یک وب‌سرور ذخیره می‌شود. اگر `--rsync` داده شود، این دستور سلسله‌مراتب‌های دایرکتوری WKD از راه دور را با استفاده از rsync(1) مدیریت می‌کند.

برای درج یک گواهی جدید در WKD، از `--cert` استفاده کنید.

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

نکته: برای به‌روزرسانی یک سلسله‌مراتب WKD، ابتدا در یک مکان موقت روی ماشین محلی کپی می‌شود، گواهی‌های جدید یا به‌روزرسانی‌های گواهی در نسخهٔ محلی درج می‌شوند، و سپس سلسله‌مراتب به مکان اصلی خود بازگردانده می‌شود. از آنجا که این یک عملیات اتمیک نیست، باید مراقب بود تا از به‌روزرسانی‌های هم‌روند جلوگیری شود.

گزینه‌ها (OPTIONS)

گزینه‌های زیردستور

--all: انتشار گواهی‌های احرازهویت‌شده با شناسه‌کاربری منطبق بر دامنه

: استفاده از تمام گواهی‌هایی که شناسهٔ کاربریِ منطبق با دامنهٔ داده‌شده به پارامتر `--domain` دارند و می‌توانند به‌طور کامل احراز هویت شوند.

--cert=FINGERPRINT|KEYID: استفاده از گواهی‌ها با اثر انگشت یا شناسهٔ کلید (key ID) مشخص‌شده
--cert-email=EMAIL: استفاده از گواهی‌هایی که یک شناسهٔ کاربری آن‌ها شامل نشانی ایمیل مشخص‌شده باشد
--cert-file=PATH: خواندن گواهی‌ها از PATH
--cert-userid=USERID: استفاده از گواهی‌ها با شناسهٔ کاربری مشخص‌شده
--create: ایجاد سلسله‌مراتب WKD در صورتی که هنوز وجود نداشته باشد
--domain=FQDN: تولید یک WKD برای یک نام دامنه کاملاً معین (FQDN) جهت ایمیل
--method=METHOD: انتخاب نوع سلسله‌مراتب WKD جهت ایجاد

: روش پیشرفته (advanced) که پیش‌فرض است و باید ترجیح داده شود، روی یک دامنهٔ جداگانه میزبانی می‌شود (مانند openpgpkey.example.org).
: روش مستقیم (direct) روی همان دامنه میزبانی می‌شود (مانند example.org).
: [مقادیر ممکن: advanced، direct]

--rsync: استفاده از rsync(1) برای دسترسی به DEST
--rsync-path=RSYNC: مسیر دستور rsync محلی برای استفاده؛ مستلزم --rsync است
DEST: مکان WKD روی ماشین محلی یا دوردست

: اگر --rsync داده شود، این مقدار همان‌گونه که هست به rsync(1) ارسال می‌شود.

گزینه‌های عمومی

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

مثال‌ها (EXAMPLES)

ایجاد یک سلسله‌مراتب جدید WKD در دایرکتوری محلی `public_html` و درج گواهی Alice.

sq network wkd publish --create \

--cert=EB28F26E2739A4870ECC47726F0073F60FD0CBF0 \

--domain=example.org public_html

افزودن گواهی Bob به سلسله‌مراتب موجود WKD در دایرکتوری محلی `public_html`.

sq network wkd publish \

--cert=511257EBBF077B7AEDAE5D093F68CB84CE537C9A \

--domain=example.org public_html

افزودن تمام گواهی‌های دارای یک شناسهٔ کاربری احرازهویت‌شده در example.org به سلسله‌مراتب موجود WKD.

sq network wkd publish --domain=example.org --all public_html

تازه‌سازی تمام گواهی‌های موجود در سلسله‌مراتب WKD در دایرکتوری محلی `public_html` از مخزن گواهی.

sq network wkd publish --domain=example.org public_html

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

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

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

نسخه (VERSION)

1.4.0