README.TXT
===============================================================================
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 File | Import | External Agent Definition... 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 Blacklists / 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-S 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.
  
   
CONTACT INFORMATION
-------------------------------------------------------------------------------
Please consider that Vamsoft does not provide technical support for setting 
up and using this agent. For all support matters please contact the author of 
the agent (st@hcw.at).

If your question or comment is related to ORF in general, please feel free to 
contact our Technical Support.

  http://vamsoft.com/r?support