security_file_certgen(8) System Manager's Manual security_file_certgen(8)

security_file_certgen - تولیدکننده گواهینامه SSL برای اسکوئید (Squid)

نسخه 1.1

security_file_certgen [-cdhv] [-s directory -M size ] [-b fs_block_size ]

security_file_certgen یک فایل اجرایی باینری نصب‌شده است.

از آنجا که تولید و امضای گواهینامه‌های SSL زمان‌بر است، اسکوئید (Squid) می‌تواند از این دستیار کمکی به‌عنوان یک فرآیند خارجی برای مدیریت این کار استفاده کند. ارتباط از طریق سوکت‌های TCP متصل به رابط لوپ‌بک (loopback) انجام می‌شود. این برنامه کمکی می‌تواند از یک حافظه نهان (کش) دیسک برای گواهینامه‌ها استفاده کند تا زمان پاسخ‌دهی به درخواست‌های مکرر را بهبود بخشد. همچنین می‌تواند بدون کش کار کرده و در هر درخواست، گواهینامه‌های جدید تولید نماید.

اندازه بلوک سیستم‌فایل بر حسب بایت. برای پردازش اندازه طبیعی گواهینامه روی دیسک مورد نیاز است. مقدار پیش‌فرض 2048 بایت است. پسوندهای زیر پذیرفته می‌شوند: B, KB, MB, GB. هنگامی که هیچ پسوندی تعیین نشده باشد، B فرض می‌شود.
راه‌اندازی اولیه پایگاه‌داده ذخیره‌سازی SSL و خروج. نیازمند گزینه‌های -s و -M برای تعیین محل ذخیره‌سازی و اندازه در حال ایجاد است.
نوشتن اطلاعات اشکال‌زدایی (دیباگ) در stderr.
نمایش راهنمای فایل باینری و نحو خط فرمان با استفاده از stderr.
مسیر دایرکتوری پایگاه‌داده ذخیره‌سازی SSL. نیازمند گزینه -M است.
حداکثر اندازه ذخیره‌سازی دیسک گواهینامه SSL. همان پسوندهای پشتیبانی‌شده توسط گزینه -b می‌توانند استفاده شوند.
نمایش جزئیات نسخه فایل باینری با استفاده از stderr.

خطاهای SSL پس از تغییر CA

گواهینامه‌ها در این پایگاه‌داده به‌صورت امضاشده ذخیره می‌شوند. پس از هرگونه تغییر در مرجع صدور گواهی (CA) امضاکننده در squid.conf، حتماً پایگاه‌داده گواهینامه‌ها را پاک کرده و دوباره راه‌اندازی اولیه کنید.

زنجیره گواهینامه (Certificate chaining)

نسخه‌های 1.0 تا 1.1 این دستیار کمکی، گواهینامه‌های زنجیره‌ای CA میانی را اضافه نمی‌کنند. کلاینت باید زنجیره کامل اعتماد را از CA ریشه تا آخرین گواهینامه تولیدشده توسط این برنامه داشته باشد. امضا با یک CA میانی مستلزم نصب هر دو CA عمومی ریشه و میانی روی کلاینت‌ها است.

پیش از اینکه این برنامه کمکی بتواند با ذخیره‌سازی روی دیسک استفاده شود، ناحیه ذخیره‌سازی برای گواهینامه‌های جدید باید به‌صورت دستی راه‌اندازی اولیه شود. این کار از طریق خط فرمان و با استفاده از پارامتر -c انجام می‌گیرد.

برای نمونه:

/usr/lib/squid/security_file_certgen -c -s /var/cache/squid/ssl_db -M 4MB

گواهینامه‌ها در این پایگاه‌داده به‌صورت امضاشده ذخیره می‌شوند. پس از هرگونه تغییر در مرجع صدور گواهی (CA) امضاکننده در squid.conf، حتماً پایگاه‌داده گواهینامه‌ها را پاک کرده و مجدداً راه‌اندازی اولیه نمایید.

برای پیکربندی ساده می‌توان از مقادیر پیش‌فرض برنامه کمکی استفاده کرد. تنها گزینه‌های پورت شنود HTTP برای فعال‌سازی تولید و تنظیم گواهینامه CA امضاکننده مورد نیاز است.

برای نمونه:

http_port 3128 ssl-bump generate-host-certificates=on dynamic_cert_mem_cache_size=4MB cert=/etc/squid/ssl_cert/example.com.pem

برای پیکربندی سفارشی‌تر، محل دایرکتوری و اندازه ذخیره‌سازی گواهینامه برنامه کمکی را می‌توان با دستورالعمل پیکربندی sslcrtd_program تغییر داد. همچنین تعداد فرآیندهای کمکی در حال اجرا را می‌توان با دستورالعمل پیکربندی ssl_crtd_children تنظیم کرد.

برای نمونه:

sslcrtd_program /usr/lib/squid/security_file_certgen -s /var/cache/squid/ssl_db -M 4MB
sslcrtd_children 5

برای فعالیت بدون ذخیره‌سازی روی دیسک، برنامه کمکی باید صراحتاً بدون پارامترهای -s و -M پیکربندی شود.

برای نمونه:

sslcrtd_program /usr/lib/squid/security_file_certgen

این برنامه توسط Christos Tsantilas <christos@chtsanti.net> نوشته شده است.

این صفحه راهنما توسط Christos Tsantilas <christos@chtsanti.net> و Amos Jeffries <amosjeffries@squid-cache.org> نوشته شده است.


* Copyright (C) 1996-2026 The Squid Software Foundation and contributors
*
* نرم‌افزار اسکوئید (Squid) تحت مجوز GPLv2+ توزیع می‌شود و شامل
* مشارکت‌های افراد و سازمان‌های متعددی است.
* لطفاً برای جزئیات به فایل‌های COPYING و CONTRIBUTORS مراجعه کنید.

پرسش‌ها درباره استفاده از این برنامه را می‌توان به فهرست پستی کاربران اسکوئید <squid-users@lists.squid-cache.org> ارسال کرد.

گزارش‌های باگ باید به زبان انگلیسی ارسال شوند. برای مشاهده جزئیات مواردی که باید در گزارش باگ خود بگنجانید به https://wiki.squid-cache.org/SquidFaq/BugReporting مراجعه کنید.

باگ‌ها یا وصله‌های اصلاحی را با استفاده از https://bugs.squid-cache.org گزارش دهید.

باگ‌های امنیتی جدی را به باگ‌های اسکوئید <squid-bugs@lists.squid-cache.org> گزارش دهید.

ایده‌ها برای بهبودهای جدید را به فهرست پستی توسعه‌دهندگان اسکوئید <squid-dev@lists.squid-cache.org> ارسال نمایید.

squid(8), GPL(7),
ویکی پرسش‌های متداول اسکوئید (Squid FAQ wiki) https://wiki.squid-cache.org/SquidFaq
راهنمای پیکربندی اسکوئید (Squid Configuration Manual) http://www.squid-cache.org/Doc/config