.if !'po4a'hide' .TH security_file_certgen 8
.
.SH "نام (NAME)"
security_file_certgen \- تولیدکننده گواهینامه SSL برای اسکوئید (Squid)
.PP
نسخه 1.1
.
.SH "خلاصه دستور (SYNOPSIS)"
.if !'po4a'hide' .B security_file_certgen
.if !'po4a'hide' .B "[\-cdhv] [\-s "
directory
.if !'po4a'hide' .B "\-M "
size
.if !'po4a'hide' .B "] [\-b "
fs_block_size
.if !'po4a'hide' .B ]
.
.SH "توضیحات (DESCRIPTION)"
.B security_file_certgen
یک فایل اجرایی باینری نصب‌شده است.
.PP
از آنجا که تولید و امضای گواهینامه‌های SSL زمان‌بر است،
اسکوئید (Squid) می‌تواند از این دستیار کمکی به‌عنوان یک فرآیند خارجی برای مدیریت این کار استفاده کند.
.
ارتباط از طریق سوکت‌های TCP متصل به رابط لوپ‌بک (loopback) انجام می‌شود.
.
این برنامه کمکی می‌تواند از یک حافظه نهان (کش) دیسک برای گواهینامه‌ها استفاده کند تا زمان
پاسخ‌دهی به درخواست‌های مکرر را بهبود بخشد. همچنین می‌تواند بدون کش کار کرده و در هر درخواست،
گواهینامه‌های جدید تولید نماید.
.
.SH "گزینه‌ها (OPTIONS)"
.if !'po4a'hide' .TP 12
.if !'po4a'hide' .B \-b fs_block_size
اندازه بلوک سیستم‌فایل بر حسب بایت. برای پردازش اندازه طبیعی گواهینامه روی دیسک مورد نیاز است.
مقدار پیش‌فرض 2048 بایت است.
پسوندهای زیر پذیرفته می‌شوند:
.B B, KB, MB, GB.
هنگامی که هیچ پسوندی تعیین نشده باشد،
.B B
فرض می‌شود.
.
.if !'po4a'hide' .TP
.if !'po4a'hide' .B \-c
راه‌اندازی اولیه پایگاه‌داده ذخیره‌سازی SSL و خروج. نیازمند گزینه‌های
.B \-s
و
.B \-M
برای تعیین محل ذخیره‌سازی و اندازه در حال ایجاد است.
.
.if !'po4a'hide' .TP
.if !'po4a'hide' .B \-d
نوشتن اطلاعات اشکال‌زدایی (دیباگ) در stderr.
.
.if !'po4a'hide' .TP
.if !'po4a'hide' .B \-h
نمایش راهنمای فایل باینری و نحو خط فرمان با استفاده از stderr.
.
.if !'po4a'hide' .TP
.if !'po4a'hide' .B \-s directory
مسیر دایرکتوری پایگاه‌داده ذخیره‌سازی SSL. نیازمند گزینه
.B \-M
است.
.
.if !'po4a'hide' .TP
.if !'po4a'hide' .B \-M size
حداکثر اندازه ذخیره‌سازی دیسک گواهینامه SSL. همان پسوندهای پشتیبانی‌شده توسط گزینه
.B \-b
می‌توانند استفاده شوند.
.
.if !'po4a'hide' .TP
.if !'po4a'hide' .B \-v
نمایش جزئیات نسخه فایل باینری با استفاده از stderr.
.
.SH "مشکلات شناخته‌شده (KNOWN ISSUES)"
.PP
.B خطاهای SSL پس از تغییر CA
.
.PP
گواهینامه‌ها در این پایگاه‌داده به‌صورت امضاشده ذخیره می‌شوند.
پس از هرگونه تغییر در مرجع صدور گواهی (CA) امضاکننده در squid.conf، حتماً پایگاه‌داده گواهینامه‌ها را پاک کرده و دوباره راه‌اندازی اولیه کنید.
.
.PP
.B زنجیره گواهینامه (Certificate chaining)
.
.PP
نسخه‌های 1.0 تا 1.1 این دستیار کمکی، گواهینامه‌های زنجیره‌ای CA میانی را اضافه نمی‌کنند.
کلاینت باید زنجیره کامل اعتماد را از CA ریشه تا آخرین گواهینامه تولیدشده توسط این برنامه داشته باشد.
.
امضا با یک CA میانی مستلزم نصب هر دو CA عمومی ریشه و میانی روی کلاینت‌ها است.
.
.SH "پیکربندی (CONFIGURATION)"
.PP
پیش از اینکه این برنامه کمکی بتواند با ذخیره‌سازی روی دیسک استفاده شود، ناحیه ذخیره‌سازی برای گواهینامه‌های جدید باید به‌صورت دستی راه‌اندازی اولیه شود.
این کار از طریق خط فرمان و با استفاده از پارامتر
.B \-c
انجام می‌گیرد.
.
.PP
برای نمونه:
.if !'po4a'hide' .RS
.if !'po4a'hide' .B /usr/lib/squid/security_file_certgen \-c \-s /var/cache/squid/ssl_db \-M 4MB
.if !'po4a'hide' .RE
.
.PP
گواهینامه‌ها در این پایگاه‌داده به‌صورت امضاشده ذخیره می‌شوند.
پس از هرگونه تغییر در مرجع صدور گواهی (CA) امضاکننده در squid.conf، حتماً پایگاه‌داده گواهینامه‌ها را پاک کرده و مجدداً راه‌اندازی اولیه نمایید.
.
.PP
برای پیکربندی ساده می‌توان از مقادیر پیش‌فرض برنامه کمکی استفاده کرد.
تنها گزینه‌های پورت شنود HTTP برای فعال‌سازی تولید و تنظیم گواهینامه CA امضاکننده مورد نیاز است.
.
.PP
برای نمونه:
.if !'po4a'hide' .RS
.if !'po4a'hide' .B http_port 3128 ssl-bump generate-host-certificates=on dynamic_cert_mem_cache_size=4MB cert=/etc/squid/ssl_cert/example.com.pem
.if !'po4a'hide' .RE
.
.PP
برای پیکربندی سفارشی‌تر، محل دایرکتوری و اندازه ذخیره‌سازی گواهینامه برنامه کمکی را می‌توان با دستورالعمل پیکربندی
.B sslcrtd_program
تغییر داد. همچنین تعداد فرآیندهای کمکی در حال اجرا را می‌توان با دستورالعمل پیکربندی
.B ssl_crtd_children
تنظیم کرد.
.
.PP
برای نمونه:
.if !'po4a'hide' .RS
.if !'po4a'hide' .B sslcrtd_program /usr/lib/squid/security_file_certgen \-s /var/cache/squid/ssl_db \-M 4MB
.if !'po4a'hide' .br
.if !'po4a'hide' .B sslcrtd_children 5
.if !'po4a'hide' .RE
.
.PP
برای فعالیت بدون ذخیره‌سازی روی دیسک، برنامه کمکی باید صراحتاً بدون پارامترهای
.B \-s
و
.B \-M
پیکربندی شود.
.
.PP
برای نمونه:
.if !'po4a'hide' .RS
.if !'po4a'hide' .B sslcrtd_program /usr/lib/squid/security_file_certgen
.if !'po4a'hide' .RE
.
.SH "نویسندگان (AUTHORS)"
این برنامه توسط
.if !'po4a'hide' .I Christos Tsantilas <christos@chtsanti.net>
نوشته شده است.
.PP
این صفحه راهنما توسط
.if !'po4a'hide' .I Christos Tsantilas <christos@chtsanti.net>
و
.if !'po4a'hide' .I Amos Jeffries <amosjeffries@squid-cache.org>
نوشته شده است.
.
.SH "حق نشر (COPYRIGHT)"
.PP
 * Copyright (C) 1996\-2026 The Squid Software Foundation and contributors
 *
 * نرم‌افزار اسکوئید (Squid) تحت مجوز GPLv2+ توزیع می‌شود و شامل
 * مشارکت‌های افراد و سازمان‌های متعددی است.
 * لطفاً برای جزئیات به فایل‌های COPYING و CONTRIBUTORS مراجعه کنید.
.
.SH "پرسش‌ها (QUESTIONS)"
پرسش‌ها درباره استفاده از این برنامه را می‌توان به
.I فهرست پستی کاربران اسکوئید
.if !'po4a'hide' <squid-users@lists.squid-cache.org>
ارسال کرد.
.
.SH "گزارش باگ‌ها (REPORTING BUGS)"
گزارش‌های باگ باید به زبان انگلیسی ارسال شوند.
برای مشاهده جزئیات مواردی که باید در گزارش باگ خود بگنجانید به https://wiki.squid-cache.org/SquidFaq/BugReporting مراجعه کنید.
.PP
باگ‌ها یا وصله‌های اصلاحی را با استفاده از https://bugs.squid-cache.org گزارش دهید.
.PP
باگ‌های امنیتی جدی را به
.I باگ‌های اسکوئید <squid-bugs@lists.squid-cache.org>
گزارش دهید.
.PP
ایده‌ها برای بهبودهای جدید را به
.I فهرست پستی توسعه‌دهندگان اسکوئید
.if !'po4a'hide' <squid-dev@lists.squid-cache.org>
ارسال نمایید.
.
.SH "همچنین ببینید (SEE ALSO)"
.if !'po4a'hide' .BR squid "(8), "
.if !'po4a'hide' .BR GPL "(7), "
.br
ویکی پرسش‌های متداول اسکوئید (Squid FAQ wiki)
.if !'po4a'hide' https://wiki.squid-cache.org/SquidFaq
.br
راهنمای پیکربندی اسکوئید (Squid Configuration Manual)
.if !'po4a'hide' http://www.squid-cache.org/Doc/config