Agent name : PTR Blacklist Agent
Definition by : Simon Taeuber (st@hcw.at)
Last update : May 26, 2008

DESCRIPTION
-------------------------------------------------------------------------------
This external agent can be used to blacklist individual PTR names.

How Does It Work?

The agent looks up the PTR record and compares it with the variables listed in
its config file. If a word from the configuration file matches with the PTR
record of the host, the agent returns exit code 1 (hit). If no PTR record was
found, the agent returns exit code 2. If the PTR record exists but there are
no matches on the blacklist, it returns exit code 0.

Exit Code 0 -> No match
Exit Code 1 -> PTR matches with PTRBL
Exit Code 2 -> No PTR record was found

INSTALLATION
-------------------------------------------------------------------------------
Microsoft .NET framework has to be installed in order to get the agent work.
To install the agent, simply extract the contents of the zip file to an
arbitrary folder.

Importing agent definitions

1) Start the ORF Administration Tool.
2) Select Configuration | Import | External Agent Definitions from the menu.
3) Select the ptrbl.xml agent definition file in the file dialog and
click Open.
4) Click the OK button in the Importing Agent Definitions dialog.

Personalization

1) Select Configuration / Filtering - On arrival / External agents, select
the PTR Blacklist Agent and click Modify.
2) Select the Run tab.
3) In the Agent Executable edit box, enter the location of the
command-line executable of the agent (ResolvePTR.exe) on your system.
4) Do not edit any of the options in the In the Parameters edit box.
5) Click OK and press CTRL + U to apply the configuration changes.

CONFIGURING THE PTR BLACKLIST
-------------------------------------------------------------------------------
When the agent runs for the first time, the configuration file (PTRBL.txt)
will be created under c:\windows\system32\

You can edit this file to add keywords to the list, e.g.

Configuration File
###########
somedomain
gmx
dynamic
residential
###########

If a mail is sent from from somedomain with PTR smtp.somedomain.com, the agent
returns exit code 1 and blacklists the mail.


DOWNLOAD
-------------------------------------------------------------------------------

CONTACT INFORMATION
-------------------------------------------------------------------------------
For all support matters please contact the author of
the agent (st@hcw.at).