نام (NAME)

puppet-ssl - مدیریت کلیدها و گواهی‌های SSL برای کلاینت‌های SSL در OpenVox

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

مدیریت کلیدها و گواهی‌های SSL برای کلاینت‌هایی که نیاز به برقراری ارتباط با یک زیرساخت OpenVox دارند.

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

puppet ssl action [-h|--help] [-v|--verbose] [-d|--debug] [--localca] [--target CERTNAME]

گزینه‌ها (OPTIONS)

--help: چاپ این پیام راهنما.
--verbose: چاپ اطلاعات بیشتر.
--debug: فعال‌سازی اشکال‌زدایی کامل.
--localca پاک‌سازی گواهی CA و CRL محلی نیز انجام شود.
--target CERTNAME پاک‌سازی گواهی دستگاه مشخص‌شده به‌جای گواهی این میزبان.

اقدامات (ACTIONS)

bootstrap: انجام تمامی مراحل لازم برای درخواست و بارگیری یک گواهی کلاینت. اگر امضای خودکار (autosigning) غیرفعال باشد، پاپت هر waitforcert ثانیه برای امضا شدن گواهی‌اش منتظر می‌ماند. برای اینکه تنها یک بار تلاش شود و هرگز انتظار کشیده نشود، مقدار زمان را 0 تعیین کنید. از آنجا که waitforcert یکی از تنظیمات پاپت است، می‌توان آن را به صورت یک بازه زمانی، مانند 30s، 5m، 1h مشخص کرد.
submit_request: تولید یک درخواست امضای گواهی (CSR) و ارسال آن به CA. اگر یک جفت کلید خصوصی و عمومی از پیش وجود داشته باشد، از آن‌ها برای تولید CSR استفاده خواهد شد؛ در غیر این صورت، یک جفت کلید جدید تولید می‌شود. اگر پیش‌تر یک CSR با certname مشخص‌شده ارسال شده باشد، این عملیات با شکست مواجه خواهد شد.
generate_request: تولید یک درخواست امضای گواهی (CSR). اگر یک جفت کلید خصوصی و عمومی وجود داشته باشد، از آن‌ها برای تولید CSR استفاده خواهد شد؛ در غیر این صورت یک جفت کلید جدید تولید می‌شود.
download_cert: بارگیری یک گواهی برای این میزبان. اگر کلید خصوصی فعلی با گواهی بارگیری‌شده مطابقت داشته باشد، گواهی ذخیره شده و برای درخواست‌های بعدی استفاده خواهد شد. اگر در حال حاضر گواهی دیگری وجود داشته باشد، بازنویسی می‌شود.
verify: بررسی می‌کند که کلید خصوصی و گواهی موجود و منطبق باشند، گواهی توسط یک CA معتبر صادر شده باشد، و وضعیت ابطال را بررسی می‌کند.
clean: حذف فایل‌های مرتبط با کلید خصوصی و گواهی برای این میزبان. اگر --localca مشخص شده باشد، نسخهٔ محلی گواهی(های) CA و بستهٔ CRL این میزبان نیز حذف می‌شود. اگر --target CERTNAME مشخص شده باشد، فایل‌های مربوط به دستگاه مشخص‌شده روی این میزبان به‌جای خود میزبان حذف خواهند شد.
show: چاپ نسخهٔ متنی کامل گواهی این میزبان.