نام (NAME)

razor-agent.conf - فایل پیکربندی برای کارگزارهای Razor

توضیحات (DESCRIPTION)

"razor-agent.conf" یک فایل پیکربندی است که توسط کارگزارهای razor خوانده می‌شود، شامل razor-check(1)، razor-admin(1)، razor-report(1) و razor-revoke(1). قالب این فایل به صورت جفت‌های "attribute = value" است، یک جفت در هر خط. خطوطی که با `#' شروع می‌شوند به عنوان توضیح (کامنت) در نظر گرفته می‌شوند.

ویژگی‌ها (ATTRIBUTES)

ویژگی‌های زیر را می‌توان تعیین کرد:

razorhome: دایرکتوری که کارگزارهای Razor فایل‌ها را در آن جستجو می‌کنند. تمام فایل‌های موجود در "razor-agent.conf" بدون مسیر کامل، نسبت به "razorhome" سنجیده خواهند شد. مقدار پیش‌فرض برای کاربر root برابر "/etc/razor/" و برای سایر کاربران "~/.razor/" است. اگر "razorhome" وجود نداشته باشد، ایجاد خواهد شد.
logfile: فایل لاگ برای کارگزارهای Razor. مقدار پیش‌فرض "razor-agent.log" است.
debuglevel: میزان پیام‌های نوشته‌شده در فایل لاگ را کنترل می‌کند. این مقدار یک عدد صحیح بین 0 تا 20 است. برای مثال، مقدار 1 تنها پیام‌های راه‌اندازی و خطاها را ثبت می‌کند، 5 شامل تمام تراکنش‌ها با سرور است، و 14 اطلاعات بسیار باجزئیات و پرحجم است که فقط برای اشکال‌زدایی در نظر گرفته شده است. نکته: مقادیر 15 و بالاتر فایل‌های اشکال‌زدایی روی سیستم‌فایل شما ایجاد می‌کنند -- از آن‌ها استفاده نکنید مگر اینکه دقیقاً بدانید چه می‌کنید. مقدار پیش‌فرض 5 است.
identity: یک فایل شناسه (identity) را جهت ذخیره شناسه تازه ثبت‌شده در حین اجرای razor-admin(1) مشخص می‌کند. برای razor-report(1) و razor-revoke(1)، از این شناسه هنگام احراز هویت با سرورهای Razor استفاده می‌شود. اگر مشخص نشود، از "<razorhome>/identity-<user>" استفاده خواهد شد.
listfile_nomination: فایلی که در آن سرورهای معرفی Razor (Razor Nomination Servers) به ترتیب نزدیک‌ترین زمان پینگ TCP فهرست شده‌اند. سرورهای معرفی توسط razor-report(1) و razor-revoke(1) استفاده می‌شوند. این فایل به صورت خودکار ایجاد می‌شود. مقدار پیش‌فرض "servers.nomination.lst" است.
listfile_catalogue: فایلی که در آن سرورهای کاتالوگ Razor (Razor Catalogue Servers) به ترتیب نزدیک‌ترین زمان پینگ TCP فهرست شده‌اند. سرورهای کاتالوگ توسط razor-check(1) استفاده می‌شوند. این فایل به صورت خودکار ایجاد می‌شود. مقدار پیش‌فرض "servers.catalogue.lst" است.
listfile_discovery: فایلی که در آن سرورهای کشف Razor (Razor Discovery Servers) با ترتیبی تصادفی فهرست شده‌اند. این فایل به صورت خودکار با استفاده از DNS ایجاد می‌شود. مقدار پیش‌فرض "servers.discovery.lst" است.
rediscovery_wait_dns: حداکثر زمان به ثانیه که کارگزارهای Razor پیش از محاسبه یک "listfile_discovery" جدید با استفاده از DNS منتظر می‌مانند. مقدار پیش‌فرض 604800 (۷ روز) است.
rediscovery_wait: حداکثر زمان به ثانیه که کارگزارهای Razor پیش از محاسبه مجدد "listfile_nomination" جدید و "listfile_catalogue" جدید منتظر می‌مانند. مقدار پیش‌فرض 172800 (۲ روز) است.
turn_off_discovery: کشف نزدیک‌ترین میزبان را غیرفعال می‌کند. هنگامی که روی 1 تنظیم شود، "listfile_catalogue" و "listfile_nomination" به‌روزرسانی نخواهند شد و "listfile_discovery" خوانده یا به‌روزرسانی نمی‌شود. مقدار پیش‌فرض 0 است.
ignorelist: نادیده‌گرفتن خودکار پیام‌های فهرست‌های پستی (mailing list). اگر روی 0 تنظیم شود، با پیام‌های فهرست‌های پستی مانند سایر ایمیل‌ها رفتار خواهد شد. مقدار پیش‌فرض 0 است.
whitelist: نام فایل فهرست سفید (whitelist). کارگزارهای Razor می‌توانند پیش از بررسی یک ایمیل با سرورهای Razor، به یک فهرست سفید از آدرس‌ها و هش‌های SHA1 مراجعه کنند. اگر آدرس/هش در فهرست سفید یافت شود، ایمیل بدون بررسی در برابر سرور به عنوان `not spam' علامت‌گذاری می‌شود. قالب فهرست سفید را می‌توانید در صفحه راهنمای razor-whitelist(5) بیابید. مقدار پیش‌فرض "razor-whitelist" است.
min_cf: هنگام بررسی هرزنامه، سرور می‌تواند مقداری برای میزان اطمینان از هرزنامه بودن در بازه 0 (عدم اطمینان) تا 100 (اطمینان کامل یا ۱۰۰٪) بازگرداند. برای اینکه پیامی هرزنامه تلقی شود، مقدار اطمینان سرور از هرزنامه بودن باید بزرگتر یا مساوی با "min_cf" باشد. "min_cf" می‌تواند یک عدد یا عبارتی شامل ac (میانگین اطمینان منتشر شده توسط یک سرور Razor) باشد. مثال‌ها: 0, 60, 100, ac, ac + 10, ac - 20. اگر مقدار یک عبارت کمتر از 0 ارزیابی شود برابر با 0 خواهد بود، و به همین ترتیب مقادیر بیشتر از 100 به 100 تبدیل می‌شوند. مقدار پیش‌فرض "ac" است.
report_headers: هنگام گزارش هرزنامه، کل ایمیل (سرآیندها و بدنه) به یک سرور معرفی Razor ارسال می‌شود. هنگامی که روی 0 تنظیم شود، پیش از ارسال، تمام سرآیندها به جز مواردی که با "Content-" آغاز می‌شوند حذف شده و یک سرآیند ویژه که با "X-Razor2" شروع می‌شود برای ثبت این اقدام اضافه می‌گردد. مقدار پیش‌فرض 1 است.

نویسندگان (AUTHORS)

Vipul Ved Prakash, <mail@vipul.net> و Chad Norwood <chad@samo.org>

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

razor-agents(1)، razor-check(1)، razor-admin(1)، razor-report(1)، razor-revoke(1)، razor-whitelist(5)