123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443 |
- <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
- <html>
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-15">
- <title>CommuniGate Pro: ARM Research Labs Sniffer Antispam Plugin</title>
- <link rel="stylesheet" href="GuideStyle.css" type="text/css" />
- <link rel="stylesheet" href="AdminStyle.css" type="text/css" />
- </head>
-
- <body>
-
- <table border="0" cellPadding="0" cellSpacing="0" width="100%">
-
- <tr>
- <td class="tabBodyOuter">
-
- <table class="tabBody" width="100%" cellspacing="0"
- cellpadding="0">
- <tr>
-
- <td>
-
- <h1>ARM Research Labs Sniffer Plugin for CommuniGate
- Pro</h1>
-
- <div class="guideTOC">
- <ul>
-
- <table class="tabBody" width="100%" cellspacing="0"
- cellpadding="0">
-
- <li><a href="#Download">Download the Sniffer Plugin</a>
-
- <li><a href="#Install" name=Install>Installation</a>
-
- <ul>
-
- <li><a href="#WIN32">Installing on a MS Windows
- 200x/NT/XP/9x system</a>
-
- <li><a href="#Linux">Installing on a Linux
- system</a>
-
- <li><a href="#FreeBSD">Installing on a FreeBSD
- system</a>
-
- <li><a href="#OpenBSD">Installing on an OpenBSD
- system</a>
-
- <li><a href="#Source">Installing from source</a>
-
- </ul>
-
- <li><a href="#Upgrading">Upgrading to a newer
- version</a>
-
- <li><a href="#Config">Configuring the Sniffer
- Plugin</a>
-
- <li><a href="#Test">Testing the Sniffer Plugin</a>
-
- <li><a href="#Options">Command line options</a>
-
- <li><a href="#Integrate">Integrating the Sniffer
- Plugin with CommuniGate Pro</a>
-
- <li><a href="#Update">Updating the spam definitions
- database</a>
-
- </ul>
- </div>
- </td>
- </tr>
-
- </table>
- </tr>
- </table>
- </tr>
- </td>
- </table>
-
- <p><b>Note:</b> The ARM Research Labs Sniffer Plugin is not available
- on platforms. Before you order the Sniffer License, make sure that
- the available versions of the Sniffer Plugin software run on your
- CommuniGate Pro Server platform.</p>
-
- <h2><hr><a name="Download"></a>Download the ARM Research Labs Sniffer Plugins</h2>
- <dl><dd>
- <p>ARM Research Labs Sniffer antispam plugins are available for certain platforms only.</p>
-
- <table class="guideTable" border=1 cellspacing=0 cellpadding=1>
-
- <tr bgcolor="#cccccc">
- <th nowrap rowspan=2 width=50%>Operating System</th>
- <th nowrap rowspan=2>CPU</th>
- <th nowrap colspan=2>Download</th>
- </tr>
-
- <tr bgcolor="#cccccc">
- <th nowrap>via<br>http</th>
- <th nowrap>via<br>ftp</th>
- </tr>
-
- <tr>
- <td align=center>Microsoft Windows NT/2000/XP<BR>Microsoft Windows 95/98</td>
- <td align=center>x86</td>
- <td align=center><a HREF="http://www.armresearch.com/message-sniffer/download/CGPSNF-Win32-Intel.zip">
- <img src="DownLoad.gif" border=0 width=16 height=16></a></td>
- <td align=center><img src="DisabledDownLoad.gif" border=0 width=16 height=16></td>
- </tr>
-
- <tr>
- <td align=center rowspan=2>Linux (RedHat/Fedora/CentOS, Ubuntu, SuSE)</TD>
- <td align=center>x86</td>
- <td align=center><a
- HREF="http://www.armresearch.com/message-sniffer/download/CGPSNF-Linux-Intel.tar.gz">
- <img src="DownLoad.gif" border=0 width=16 height=16></a></td>
- <td align=center><img src="DisabledDownLoad.gif" border=0 width=16 height=16></td>
-
- <tr>
- <td align=center>x86_64</td>
- <td align=center><a href="http://www.armresearch.com/message-sniffer/download/CGPSNF-Linux-x86_64.tar.gz">
- <img src="DownLoad.gif" border=0 width=16 height=16></a></td>
- <td align=center><img src="DisabledDownLoad.gif" border=0 width=16 height=16></td>
- </tr>
-
- <tr>
- <td align=center rowspan=2>FreeBSD 7.x</td>
- <td align=center>x86</td>
- <td align=center><a href="http://www.armresearch.com/message-sniffer/download/CGPSNF-FreeBSD7.x-Intel.tar.gz">
- <img src="DownLoad.gif" border=0 width=16 height=16></a></td>
- <td align=center><img src="DisabledDownLoad.gif" border=0 width=16 height=16></td>
-
- <tr>
- <td align=center>x86_64</td>
- <td align=center><a href="http://www.armresearch.com/message-sniffer/download/CGPSNF-FreeBSD7.x-x86_64.tar.gz">
- <img src="DownLoad.gif" border=0 width=16 height=16></a></td>
- <td align=center><img src="DisabledDownLoad.gif" border=0 width=16 height=16></td>
-
- </tr>
-
- <tr>
- <td align=center rowspan=2>OpenBSD 4.4 or later</td>
- <td align=center>x86</td>
- <td align=center><a href="http://www.armresearch.com/message-sniffer/download/CGPSNF-OpenBSD4.4-Intel.tar.gz">
- <img src="DownLoad.gif" border=0 width=16 height=16></a></td>
- <td align=center><img src="DisabledDownLoad.gif" border=0 width=16 height=16></td>
-
- <tr>
- <td align=center>x86_64</td>
- <td align=center><a href="http://www.armresearch.com/message-sniffer/download/CGPSNF-OpenBSD4.4-x86_64.tar.gz">
- <img src="DownLoad.gif" border=0 width=16 height=16></a></td>
- <td align=center><img src="DisabledDownLoad.gif" border=0 width=16 height=16></td>
-
- </tr>
-
- <tr>
- <td align=center>Source for Linux/FreeBSD/OpenBSD</td>
- <td align=center>Any</td>
- <td align=center><a HREF="http://www.armresearch.com/message-sniffer/download/snf4cgp.tar.gz">
- <img src="DownLoad.gif" border=0 width=16 height=16></a></td>
- <td align=center><img src="DisabledDownLoad.gif" border=0 width=16 height=16></td>
- </tr>
-
- </table>
-
- </dl>
-
- <p>Downloads by ftp are not available</p>
- <p>The current version of the Plugin is VERSION.</p>
- <p>The current version of the ARM Research Labs Sniffer Engine is 3.0.11.</p>
-
- <h3><hr/><a name=Upgrading></a>Upgrading to a newer version.</h3>
- <p>When upgrading the Plugin to a newer version, do the following:</p>
-
- <ul>
-
- <li>Stop any running copy of the Sniffer Plugin application via
- CommuniGate Pro WebAdmin interface.
-
- <li>Install and configure the new version of the Sniffer Plugin as
- described in this document.
-
- </ul>
-
- <h3><hr><a name="WIN32"></a>Installing on a MS Windows 200x/NT/XP/9x system.</h3>
- <ul>
- <li>Open the command-line interface window and
- change the current directory to the CommuniGate Pro <I>base directory</I>.
- <li>Use any "unzip"-compatible tool to unpack the
- <tt>CGPSNF-Win32-Intel.zip</tt> file. The <tt>CGPSNF</tt> directory will be created inside the <I>base directory</I>.
- <li>Proceed with <a HREF="#Config">Configuring the Sniffer Plugin</a>.
- </ul>
-
- <h3><hr><a name=Linux></a>Installing on a Linux system.</h3>
- <ul>
- <li>Log in as a super-user (root).
- <li>Change the current directory to the CommuniGate Pro <I>base directory</I>.
- <li>Unpack the Plugin archive with the <tt>tar</tt> command:<tt><br>
- tar -xzf CGPSNF-Linux-Intel.tar.gz</tt><br>
- The <tt>CGPSNF</tt> directory will be created inside the <I>base directory</I>.
- <li>Proceed with <a HREF="#Config">Configuring the Sniffer Plugin</a>.
- </ul>
-
- <h3><hr><a name=FreeBSD></a>Installing on a FreeBSD system.</h3>
- <ul>
- <li>Log in as a super-user (root).
- <li>Change the current directory to the CommuniGate Pro <I>base directory</I>.
- <li>Unpack the Plugin archive with the <tt>tar</tt> command:<tt><br>
- tar -xzf CGPSNF-FreeBSD-Intel.tar.gz</tt><br>
- The <tt>CGPSNF</tt> directory will be created inside the <I>base directory</I>.
- <li>Proceed with <a HREF="#Config">Configuring the Sniffer Plugin</a>.
- </ul>
-
- <h3><hr><a name=OpenBSD></a>Installing on an OpenBSD system.</h3>
- <ul>
- <li>Log in as a super-user (root).
- <li>Change the current directory to the CommuniGate Pro <I>base directory</I>.
- <li>Unpack the Plugin archive with the <tt>tar</tt> command:<tt><br>
- tar -xzf CGPSNF-OpenBSD-Intel.tar.gz</tt><br>
- The <tt>CGPSNF</tt> directory will be created inside the <I>base directory</I>.
- <li>Proceed with <a HREF="#Config">Configuring the Sniffer Plugin</a>.
- </ul>
-
- <h3><hr><a name=Source></a>Installing from source.</h3>
- You can build the Sniffer Plugin from source:
- <ul>
- <li>Download the <tt>snf4cgp.tar.gz</tt>.
- <li>Extract the sources with the command:<tt><br>
- tar -xzf snf4cgptar.gz</tt><br>
- This creates a directory <tt>snf4cgp-X.Y.Z</tt>, where X.Y.Z is the
- version of the module.
- <li>Change directory to <tt>snf4cgp-X.Y.Z</tt>:<tt><br>
- cd snf4cgp-X.Y.Z</tt><br>
- <li>Configure and build the system:<tt><br>
- ./configure<br>
- make</tt><br>
- <li>Become super-user (root).
- <li>Create the Sniffer Plugin:<tt><br> make
- module</tt><br> This creates a Plugin archive
- named <tt>CGPSNF-X.Y.Z-MODULE.tar.gz</tt>.
- <li>Proceed with <a HREF="#Install">Installing the Sniffer
- Plugin</a> for your system, using the Plugin archive that was
- created.
- </ul>
-
- <h3><hr><a name=Config></a>Configuring the Sniffer Plugin.</h3>
-
- <p>In the module directory (<tt>/var/CommuniGate/CGPSNF</tt> on a
- Linux or Linux-like system):</p>
- <ul>
- <li>Copy the configuration file <tt><br>
- snf_engine.xml.sample</tt><br> to <tt><br>
- snf_engine.xml</tt><br> and customize as
- needed. Please see the <a href="http://www.armresearch.com">ARM
- Research Labs web site</a> for documentation on
- the <tt>snf_engine.xml</tt> configuration file.<br>
-
- <li>Copy <tt><br>
- identity.xml.sample</tt><br> to <tt><br>
- identity.xml</tt><br> and edit to include the
- license ID and authentication attributes of
- the <tt><identity> element</tt>.<br>
-
- <li>Copy <tt><br>
- getRulebase.sample</tt><br> to <tt><br>
- getRulebase</tt><br> and edit to include the
- license ID and authentication:
-
- <ul>
- <li>Change the line <tt><br>
- AUTHENTICATION=authenticationxx</tt><br>
- to <tt><br>
- AUTHENTICATION=YOUR_AUTHENTICATION</tt><br>
- where <tt>YOUR_AUTHENTICATION</tt> is authentication code
- obtained from ARM Research Labs.</LI>
-
- <li>Change the line <tt><br>
- LICENSE_ID=licenseid</tt><br> to <tt><br>
- LICENSE_ID=YOUR_LICENSE_ID</tt><br>
- where <tt>YOUR_LICENSE_ID</tt> is license ID obtained from
- ARM Research Labs.</LI>
-
- </ul>
-
- <li>Make <tt>getRulebase</tt> executable:<tt><br>
- chmod 755 getRulebase</tt><br>
-
- <li>Copy <tt><br>
- GBUdbIgnoreList.txt.sample</tt><br> to <tt><br>
- GBUdbIgnoreList.txt</tt><br> and customize as
- needed. Please see the
- <a href="http://www.armresearch.com">ARM Research Labs web
- site</a> for documentation on the <tt>GBUdbIgnoreList.txt</tt>
- file.<br>
-
- <li>Download the Sniffer database:
- <ul>
- <li>Create the file <tt>UpdateReady.txt</tt> in the plugin directory:<tt><br>
- touch UpdateReady.txt</tt><br>
- </LI>
- <li>Run the <tt>getRulebase</tt> script in the plugin
- directory:<tt><br>
- ./getRulebase</tt><br>
- This downloads the Sniffer database to the plugin directory.
- </ul>
-
- The <B><tt>CGPSNF</tt></B> program automatically updates the
- Sniffer database as needed.
-
- <li>Proceed with <a HREF="#Test">Testing the Sniffer Plugin</a>.
- </ul>
-
- <h3><hr><a name=Test></a>Testing the Sniffer Plugin.</h3>
- <p>On Windows System:</p>
-
- <ul>
- <li> Change to the module directory:<tt><br>
- cd \CommuniGatePro\CGPSNF</tt><br>
-
- <li>Launch the <tt>CGPSNF.exe</tt> application by typing:<tt><br>
- CGPSNF.exe</tt><br>
- It will report the Plugin version number and build date.<br>
-
- <li>Type:<tt><br>
- 1 FILE junkmsg.msg</tt><br>
- The plugin should report that the file is spam.
- <li>Quit <tt>CGPSNF.exe</tt> by typing Ctrl-Z.
- </ul>
-
- <p>On a Unix System:</p>
- <ul>
- <li> Change to the module directory:<tt><br>
- cd /var/CommuniGate/CGPSNF</tt><br>
-
- <li>Launch the <tt>CGPSNF</tt> application by typing:<tt><br>
- ./CGPSNF</tt><br>
- It will report the Plugin version number and build date.<br>
-
- <li>Type:<tt><br>
- 1 FILE junkmsg.txt</tt><br>
- the plugin should report that the file is spam.
-
- <li>Quit <tt>CGPSNF</tt> by typing Ctrl-D.
- </ul>
-
- <h3><hr><a name="Options"></a>Command Line Options</h3>
- <dl>
- <dd>
- The Sniffer Plugin supports the following command-line option
- (parameters):
-
- <dl>
- <p><dt><tt>path_to_config_file</tt></dt></p>
-
- <dd>This option tells the Plugin to read the configuration from
- <tt>path_to_config_file</tt>.
- </dd>
-
- </dl>
-
- </dl>
-
-
- <h3><hr><a name=Integrate></a>Integrating the Sniffer Plugin with CommuniGate Pro.</h3>
-
- Please check
- the <a HREF="http://www.communigate.com/CommuniGatePro/VirusScan.html#Launch">External
- Filters</a> section of the CommuniGate Pro manual.
-
- <p>Open the General page in the Settings section of the WebAdmin
- Interface and click the Helpers link. Create the Helper as follows:</p>
-
-
- <center class="WebAdmin"><form action="Null.html">
- <table class="settingsBox" cellpadding="3" width="90%">
- <caption>Content Filtering</caption>
-
- <tr><td BGCOLOR="#EEEEEE">
- <table class="settingsBox" WIDTH="100%" BORDER="0" CELLSPACING=1 CELLPADDING=0>
- <tr>
- <td align="right"><select name="U3"><option value="0">Disabled</option><option value="1" selected="selected">Enabled</option></select></td>
- <td><input name="N3" value="ARM Sniffer" size="15" maxlength="200" type="text" /></td>
- <td colspan=2 align=center></td>
- </tr><tr>
- <td align="right" width="25%">Log Level:</td><td><select name="L3"><option value="0">Crashes Only</option><option value="1">Failures</option><option value="2">Major & Failures</option><option value="3">Problems</option><option value="4" selected="selected">Low Level</option><option value="5">All Info</option></select></td>
- <td align="right" width="25%">Program Path:</td><td><input name="P3"
- value="CGPSNF/CGPSNF" size="30" maxlength="255" type="text" /></td>
-
- </tr><tr>
- <td align=RIGHT>Time-out:</td><td><select name="T0"><option VALUE=0>disabled<option VALUE="15">15 seconds<option VALUE="30">30 seconds<option VALUE="60">minute<option VALUE="120">2 minutes<option VALUE="180">3 minutes<option VALUE="300" SELECTED>5 minutes<option VALUE="600">10 minutes<option VALUE="900">15 minutes<option VALUE="1800">30 minutes<option VALUE="3600">hour</select></td>
- <td align=RIGHT>Auto-Restart:</td><td><select name="A0"><option VALUE=0>disabled<option VALUE="5">5 seconds<option VALUE="7">7 seconds<option VALUE="10">10 seconds<option VALUE="15">15 seconds<option VALUE="30">30 seconds<option VALUE="60" SELECTED>minute<option VALUE="120">2 minutes<option VALUE="180">3 minutes<option VALUE="300">5 minutes<option VALUE="600">10 minutes<option VALUE="900">15 minutes<option VALUE="1800">30 minutes<option VALUE="3600">hour<option VALUE="7200">2 hours<option VALUE="10800">3 hours<option VALUE="21600">6 hours</select></td>
- </tr>
- </table></td></tr>
- </table></FORM></center>
-
-
-
- <B>Note:</B> For Windows system the Program Path shold be
- <tt>CGPSNF\CGPSNF.exe</tt><br>
- <B>Note:</B> On some versions of FreeBSD system you may need to
- specify the full path to the program,
- i.e. <tt>/var/CommuniGate/CGPSNF/CGPSNF</tt>
-
- <p>The recommended Scanning Rule is as follows:</p>
-
- <center class="WebAdmin"><form action="Null.html">
- <table class="settingsBox" cellpadding="3" width="90%">
- <tr align="left">
- <th>Data</th>
- <th>Operation</th>
- <th>Parameter</th>
- </tr>
- <tr>
- <td>
- <select name="c2"><option VALUE="0" selected>---<option VALUE="12">Message Size</select>
- </td><td>
- <select name="o2"><option VALUE="0" selected>is<option VALUE="4">greater than</select>
- </td><td>
- <INPUT TYPE="text" name="p2" VALUE="" SIZE="20" MAXLENGTH="1024">
- </td>
- </tr>
-
- <tr align="left">
- <th>Action</th>
- <th colspan="2">Parameter</th>
- </tr>
- <tr valign=TOP>
- <td><select name="a0"><option VALUE="0">---<option VALUE="6">Stop Processing<option VALUE="17" selected>ExternalFilter</select>
- </td><td><textarea name="r0" rows="4" cols="40">ARM Sniffer</textarea>
- </td>
- </tr>
- <tr valign=top>
- <td><select name="a1"><option value="0" selected>---<option value="7">Stop Processing</select></td>
- <td colspan="2"><textarea name="r1" rows="4" cols="40"></textarea></td>
- </tr>
-
- </table></form></center>
-
- <hr/>
-
- </body>
- </html>
|