clamav-milter.conf(5) Clam AntiVirus clamav-milter.conf(5)

clamav-milter.conf - پرونده پیکربندی برای clamav-milter

پرونده clamav-milter.conf حاوی گزینه‌های پیکربندی برای clamav-milter(8) است.

این پرونده از توضیحات و گزینه‌های دارای آرگومان تشکیل شده است. هر خطی که با نماد هش (#) آغاز شود توسط تجزیه‌کننده نادیده گرفته می‌شود. گزینه‌ها و آرگومان‌ها به حروف بزرگ و کوچک حساس هستند و به شکل Option Argument نوشته می‌شوند. آرگومان‌ها از انواع زیر هستند:

مقدار بولی (yes/no یا true/false یا 1/0).
رشته متنی بدون نویسه‌های فاصله خالی.
اندازه بر حسب بایت. می‌توانید از اصلاح‌کننده‌های 'M' یا 'm' برای مگابایت و 'K' یا 'k' برای کیلوبایت استفاده کنید.
عدد صحیح بدون علامت.

اگر این گزینه تنظیم شده باشد، clamav-milter اجرا نخواهد شد.
رابطی را تعریف می‌کند که از طریق آن با sendmail ارتباط برقرار می‌کنیم. این گزینه اجباری است!
قالب‌های ممکن عبارتند از:
[[unix|local]:]/path/to/file - برای مشخص کردن یک سوکت دامنه یونیکس
inet:port@[hostname|ip-address] - برای مشخص کردن یک سوکت ipv4
inet6:port@[hostname|ip-address] - برای مشخص کردن یک سوکت ipv6
پیش‌فرض: تنظیم‌نشده
مالکیت گروهی را برای سوکت میلتر (یونیکس) تعیین می‌کند.
پیش‌فرض: غیرفعال (گروه اصلی کاربری که clamd را اجرا می‌کند)
مجوزهای دسترسی روی سوکت میلتر (یونیکس) را روی حالت مشخص‌شده تنظیم می‌کند.
پیش‌فرض: غیرفعال (پیروی از umask)
حذف سوکت بی‌استفاده پس از خاموش شدن نادرست.
پیش‌فرض: yes
اجرا تحت عنوان یک کاربر دیگر (برای کارکرد این گزینه، clamav-milter باید توسط ریشه/root آغاز شده باشد)
پیش‌فرض: تنظیم‌نشده (امتیازات کاهش نمی‌یابند)
انتظار برای دریافت داده از clamd پس از این مدت زمان (بر حسب ثانیه) منقضی می‌شود.
پیش‌فرض: 120
عدم انشعاب (fork) به پس‌زمینه.
پیش‌فرض: no
تغییر ریشه (Chroot) به دایرکتوری مشخص‌شده. عملیات Chroot بلافاصله پس از خواندن فایل پیکربندی و پیش از کاهش امتیازات انجام می‌شود.
پیش‌فرض: تنظیم‌نشده (بدون chroot)
نوشتن شناسه فرایند (PID) دیمن در فایل مشخص‌شده.
پیش‌فرض: غیرفعال
مسیر اختیاری برای دایرکتوری موقت سراسری.
پیش‌فرض: وابسته به سیستم (معمولاً /tmp یا /var/tmp).

سوکت clamd را برای اتصال جهت پویش مشخص می‌کند. این گزینه اجباری است! نحو:
ClamdSocket unix:path
ClamdSocket tcp:host:port
نحو نخست یک سوکت محلی یونیکس را مشخص می‌کند (به مسیر مطلق نیاز دارد)، به عنوان مثال:
ClamdSocket unix:/run/clamav/clamd.sock
نحو دوم یک سوکت محلی یا دوردست tcp را مشخص می‌کند: میزبان می‌تواند یک نام میزبان یا یک نشانی ip باشد؛ فیلد ":port" تنها برای نشانی‌های IPv6 الزامی است، در غیر این صورت پیش‌فرض آن 3310 است، به عنوان مثال:
ClamdSocket tcp:192.168.0.1
این گزینه می‌تواند چندین بار با سوکت‌های مختلف یا حتی با همان سوکت تکرار شود: سرورهای clamd به روش نوبت‌گردشی (round-robin) انتخاب خواهند شد.
پیش‌فرض: بدون پیش‌فرض

پیام‌های ارسال‌شده از این میزبان‌ها/شبکه‌ها پویش نخواهند شد. این گزینه یک جفت نام میزبان/ماسک را در قالب نشانه‌گذاری CIDR دریافت می‌کند و می‌تواند چندین بار تکرار شود. اگر "/mask" حذف شود، یک میزبان فرض می‌شود. برای تعیین یک ایمیل غیر smtp که از مبدا محلی تولید شده است، از کلمه کلیدی "local" استفاده کنید.
پیش‌فرض: تنظیم‌نشده (پویش همه‌چیز بدون در نظر گرفتن مبدا)
این گزینه فایلی را مشخص می‌کند که حاوی فهرستی از عبارت‌های منظم پایه POSIX است. نشانی‌هایی (فرستاده شده به یا از - در زیر ببینید) که با این regexها مطابقت دارند پویش نخواهند شد. به صورت اختیاری هر خط می‌تواند با رشته "From:" یا "To:" آغاز شود (توجه: بدون فاصله خالی پس از دونقطه) که مشخص می‌کند به ترتیب فرستنده یا گیرنده مجاز است. اگر این فیلد وجود نداشته باشد، "To:" فرض می‌شود. خطوطی که با #، : یا ! شروع می‌شوند نادیده گرفته می‌شوند.
پیش‌فرض: تنظیم‌نشده (هیچ استثنایی اعمال نمی‌شود)
پیام‌های کاربران احراز هویت‌شده SMTP که با این عبارت منظم گسترش‌یافته POSIX (مشابه egrep) مطابقت دارند پویش نخواهند شد. به عنوان یک جایگزین، فایلی حاوی فهرستی ساده (غیر regex) از نام‌ها (یک نام در هر خط) می‌تواند با استفاده از پیشوند "file:" مشخص شود؛ مانند SkipAuthenticated file:/etc/good_guys. توجه: این نام ورود AUTH است!
پیش‌فرض: تنظیم‌نشده (بدون مجازسازی بر اساس احراز هویت SMTP)
پیام‌های بزرگ‌تر از این مقدار پویش نخواهند شد. اطمینان حاصل کنید که این مقدار کوچک‌تر یا مساوی با StreamMaxLength در clamd.conf باشد.
پیش‌فرض: 100M

گروه گزینه‌های زیر فرآیند تحویل را در شرایط مختلف کنترل می‌کند. اقدامات زیر در دسترس هستند:
- Accept: پیام برای تحویل پذیرفته می‌شود
- Reject: بلافاصله تحویل رد می‌شود (یک خطای 5xx به طرف مقابل بازگردانده می‌شود)
- Defer: یک پیام شکست موقت (4xx) به طرف مقابل بازگردانده می‌شود
- Blackhole (برای OnFail در دسترس نیست): مانند Accept است اما پیام حذف و محو می‌شود
- Quarantine (برای OnFail در دسترس نیست): مانند Accept است اما پیام به جای تحویل داده شدن، قرنطینه می‌شود. نکته: در Sendmail صف قرنطینه می‌تواند از طریق mailq -qQ بررسی شود. در Postfix این اقدام باعث می‌شود پیام در وضعیت تعلیق (hold) قرار گیرد.

اقدامی که باید روی پیام‌های پاک انجام شود (بیشتر برای آزمایش کاربرد دارد)
پیش‌فرض: Accept
اقدامی که باید روی پیام‌های آلوده انجام شود
پیش‌فرض: Quarantine
اقدامی که باید در شرایط خطا انجام شود (شامل عدم موفقیت در تخصیص ساختارهای داده، در دسترس نبودن پویشگرها، وقفه زمانی شبکه، پاسخ‌های ناشناخته پویشگر و موارد مشابه)
پیش‌فرض: Defer
این گزینه به شما امکان می‌دهد دلیل رد مشخصی را برای پیام‌های آلوده تعیین کنید و بنابراین تنها همراه با "OnInfected Reject" کاربرد دارد. رشته "%v" در صورت وجود با نام ویروس جایگزین خواهد شد.
پیش‌فرض: وابسته به MTA
اگر این گزینه روی "Replace" (یا "Yes") تنظیم شود، هدرهای "X-Virus-Scanned" و "X-Virus-Status" به هر پیام پردازش‌شده پیوست می‌شوند و احتمالاً جایگزین هدرهای موجود خواهند شد. اگر روی Add تنظیم شود، هدرهای X-Virus احتمالاً در بالای هدرهای موجود اضافه می‌شوند. توجه داشته باشید که در حالی که "Replace" می‌تواند امضاهای DKIM را مخدوش کند، "Add" ممکن است procmail و فیلترهای مشابه را دچار سردرگمی کند.
پیش‌فرض: no
هنگامی که AddHeader در حال استفاده است، این گزینه به شما امکان می‌دهد نام میزبان گزارش‌شده را تعیین کنید. این امر ممکن است برای جلوگیری از افشای نام‌های داخلی مطلوب باشد. در صورت عدم تنظیم، نام واقعی دستگاه استفاده می‌شود.
پیش‌فرض: غیرفعال
اجرای یک دستور (احتمالاً با جستجو در PATH) هنگام یافتن یک پیام آلوده. پارامترهای زیر به همین ترتیب به برنامه فراخوانی‌شده ارسال می‌شوند: نام ویروس، شناسه صف (queue id)، فرستنده، مقصد، موضوع، شناسه پیام، تاریخ پیام. نکته ۱: این کار مستلزم در دسترس بودن ماکروهای MTA است (LogInfected را در زیر ببینید). نکته ۲: فرایند در زمینه clamav-milter فراخوانی می‌شود. نکته ۳: clamav-milter منتظر خروج فرایند می‌ماند. برای جلوگیری از تأخیرهای غیرضروری در تحویل ایمیل، سریع عمل کنید یا از fork استفاده نمایید.
پیش‌فرض: غیرفعال

فعال‌سازی گزارش‌گیری در فایل انتخاب‌شده.
پیش‌فرض: no
غیرفعال‌سازی قفل سیستمی که از اجرای همزمان چند نمونه clamd با یک فایل پیکربندی یکسان جلوگیری می‌کند.
پیش‌فرض: no
محدود کردن اندازه فایل گزارش. اگر حجم فایل از SIZE بیشتر شود، گزارش‌گیر به طور خودکار غیرفعال می‌شود. مقدار 0 این محدودیت را غیرفعال می‌کند.
پیش‌فرض: 1M
ثبت زمان برای هر پیام در گزارش.
پیش‌فرض: no
استفاده از سیستم ثبت گزارش سیستم‌عامل (می‌تواند همراه با LogFile کار کند).
پیش‌فرض: no
نوع پیام‌های syslog را مشخص می‌کند - لطفاً برای نام‌های facility به 'man syslog' مراجعه کنید.
پیش‌فرض: LOG_LOCAL6
فعال‌سازی گزارش‌گیری با جزئیات کامل (verbose).
پیش‌فرض: no
این گزینه به شما امکان می‌دهد آنچه را که هنگام آلوده بودن پیام ثبت می‌شود، تنظیم کنید. مقادیر ممکن عبارتند از: Off (پیش‌فرض - هیچ‌چیزی ثبت نمی‌شود)، Basic (اطلاعات حداقلی ثبت می‌شود)، Full (اطلاعات کامل با جزئیات ثبت می‌شود)
نکته: برای اینکه این مورد در sendmail به درستی کار کند، مطمئن شوید که ماکروهای msg_id، mail_addr، rcpt_addr و i در eom در دسترس هستند. به عبارت دیگر خطی مانند: Milter.macros.eom={msg_id}, {mail_addr}, {rcpt_addr}, i را به فایل .cf خود اضافه کنید. همچنین می‌توانید از این ماکرو استفاده کنید: define(`confMILTER_MACROS_EOM', `{msg_id}, {mail_addr}, {rcpt_addr}, i')
برنامه Postfix باید با تنظیمات پیش‌فرض به خوبی کار کند.
پیش‌فرض: غیرفعال
این گزینه به شما امکان می‌دهد آنچه را که هنگام نیافتن تهدید در پیام پویش‌شده ثبت می‌شود، تنظیم کنید.
برای مقادیر ممکن و هشدارها، به LogInfected مراجعه کنید.
برای اشکال‌زدایی مفید است اما حجم فایل گزارش را به شدت افزایش می‌دهد.
پیش‌فرض: غیرفعال
این گزینه بر رفتار LogInfected، LogClean و VirusAction هنگام پویش پیامی با چند گیرنده تأثیر می‌گذارد:
اگر SupportMultipleRecipients خاموش باشد (پیش‌فرض)، تنها یک ورودی گزارش برای پیام ایجاد می‌شود و در صورتی که پیام مخرب تشخیص داده شود، دستور مشخص‌شده توسط VirusAction فقط یک بار اجرا می‌گردد. در هر دو حالت تنها آخرین گیرنده گزارش می‌شود.
اگر SupportMultipleRecipients روشن باشد، برای هر گیرنده یک خط گزارش ثبت می‌شود و دستور تعیین‌شده توسط VirusAction نیز برای هر گیرنده یک بار اجرا می‌گردد.
نکته: با وجود اینکه فعال کردن این گزینه احتمالاً ایده خوبی است، مقدار پیش‌فرض آن در حال حاضر به دلایل تاریخی و سازگاری با گذشته روی off تنظیم شده است.
پیش‌فرض: no

تمام گزینه‌هایی که اندازه را بیان می‌کنند به حداکثر ۴ گیگابایت محدود هستند. مقادیر فراتر از آن به مقدار حداکثر بازنشانی خواهند شد.

/etc/clamav/clamav-milter.conf

aCaB <acab@clamav.net>

clamav-milter(8), clamd(8), clamd.conf(5)

February 25, 2009 ClamAV 1.5.4