RAZOR-WHITELIST(5) User Contributed Perl Documentation RAZOR-WHITELIST(5)NAME
"razor-whitelist" - Format for Vipul's Razor Whitelist
DESCRIPTION
The razor whitelist is a list of email addresses and body signatures. Emails that match the whitelist are not processed by any of the
Razor Agents. That is, They are not checked, reported, or revoked. In the case of razor-check(1), they are instantly marked as non-spam.
LOCATION
The razor whitelist is usually "<razorhome>/razor-whitelist". The "whitelist" parameter in razor-agent.conf(5) should point to this file.
If the "whitelist" parameter in razor-agent.conf(5) is missing, "whitelist" is not used.
FORMAT
Each whitelist rule is placed on a line of its own. Lines that begin in a `#' character are considered to be comments and are ignored by
the parser. A rule contains the name of a header and the string to match against the header, separated by whitespace. Here are some
examples:
to bugtraq@securityfocus.com
cc a.list@somewhere.net
These rules imply that when a mail contains "bugtraq@securityfocus.com" in its `to' and `cc' headers, it should be whitelisted. It's worth
noting that a match occurs if the address string matches any part of the address.
from @mydomain.com
A special rule called `sha1' can be used for whitelisting signatures. For example:
sha1 75f8bcc2357366bbfa9c6ab0b6e5648ed0cf7083
whitelists a message with the body of `test'.
AUTHORS
Vipul Ved Prakash <mail@vipul.net>, and Chad Norwood <chad@samo.org>
SEE ALSO razor-agents(1), razor-agent.conf(5), razor-check(1), razor-admin(1), razor-report(1), razor-revoke(1)LICENSE
This is free software, distributed under the Artistic License 2.0.
perl v5.14.2 2008-07-21 RAZOR-WHITELIST(5)
Check Out this Related Man Page
RAZOR-AGENT.CONF(1) User Contributed Perl Documentation RAZOR-AGENT.CONF(1)NAME
"razor-agent.conf" - Configuration file for Razor Agents
DESCRIPTION
"razor-agent.conf" is a configuration file read by the razor agents, which include razor-check(1), razor-admin(1), razor-report(1), and
razor-revoke(1). The format is "attribute = value" pairs, one pair per line. Lines that begin with `#' are treated as comments.
ATTRIBUTES
Following attributes can be specified:
razorhome
Directory where Razor Agents look for files. All files in "razor-agent.conf" without a full path will be relative to "razorhome". The
default is "/etc/razor/" for root, and "~/.razor/" for every other user. If "razorhome" does not exist, it will be created.
logfile
Log file for the Razor Agents. The default is "razor-agent.log".
debuglevel
Controls the amount of messages written to logfile. It is an integer between 0 and 20. For Example, a value of 1 logs only startup
and error messages, 5 includes every transaction with the server, and 14 is extremely verbose information intended for debugging use
only. NOTE: 15 and higher create debug files on your filesystem -- do not use unless you know what you are doing. The default is 5.
identity
Specify an identify file to use for storing a newly registered identity during razor-admin(1). For razor-report(1) and
razor-revoke(1), use this identity when authenticating with Razor Servers. If not specified, "<razorhome>/identity-<user>" is used.
listfile_nomination
File where Razor Nomination Servers are listed, in order of closest TCP ping time. Nomination Servers are used by razor-report(1) and
razor-revoke(1). This file is created automatically. The default is "servers.nomination.lst".
listfile_catalogue
File where Razor Catalogue Servers are listed, in order of closest TCP ping time. Catalogue Servers are used by razor-check(1). This
file is created automatically. The default is "servers.catalogue.lst".
listfile_discovery
File where Razor Discovery Servers are listed, in random order. This file is created automatically using DNS. The default is
"servers.discovery.lst".
rediscovery_wait_dns
Max time in seconds Razor Agents will wait before computing a new "listfile_discovery" using DNS. The default is 604800, which is 7
days.
rediscovery_wait
Max time in seconds Razor Agents will wait before computing a new "listfile_nomination" and a new "listfile_catalogue". The default is
172800, which is 2 days.
turn_off_discovery
Turns off closest host discovery. When set to 1, "listfile_catalogue" and "listfile_nomination" will not be updated and
"listfile_discovery" is not read or updated. The default is 0.
ignorelist
Automatically ignore mailing list posts. If set to 0, mailing list posts will be handled like all other mail. The default is 0.
whitelist
Name of whitelist file. Razor Agents can consult a whitelist of addresses and SHA1 hashes before checking a mail with Razor Servers.
If the address/hash is found on the whitelist, the mail is marked `not spam', without checking against the server. The format of the
whitelist can be found in razor-whitelist(5) manpage. The default is "razor-whitelist".
min_cf
When checking spam, the server optionally returns a spam confidence value ranging from 0 (not confident) to 100 (absolutely or 100%
confident). To be considered spam, the server's spam confidence value must be greater than or equal to "min_cf". "min_cf" can be a
number or an expression containing ac, the average confidence published by a Razor Server. Examples: 0, 60, 100, ac, ac + 10, ac - 20.
If an expression evaluates to less than 0 it becomes 0, likewise those greater than 100 become 100. The default is "ac".
report_headers
When reporting spam, the entire email (headers and body) is sent to a Razor Nomination Server. When set to 0, all the headers are
removed except headers beginning with "Content-" before sending, and a special header beginning with "X-Razor2" is added to note this
action. The default is 1.
AUTHORS
Vipul Ved Prakash, <mail@vipul.net> and 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)perl v5.12.1 2005-06-10 RAZOR-AGENT.CONF(1)