madscientist
/
PKG-SNF4CGP-NIX
Прати 1
Волим 0
Креирај огранак 0
Код Дискусије 0 Захтеви за спајање 0 Издања 0 Вики Activity
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
28 Комити
1 Грана
Дрво: fba7b6c7b5
Гране Ознаке
${ item.name }
Create branch ${ searchTerm }
from 'fba7b6c7b5'
${ noResults }
PKG-SNF4CGP-NIX/SNF4CGP_Developer_Package/Doc/default.html

default.html 16KB
Датотека Blame Историја

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435 
  1. <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">

  2. <html>

  3. <head>

  4. <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-15">

  5. <title>CommuniGate Pro: ARM Research Labs Sniffer Antispam Plugin</title>

  6. <link rel="stylesheet" href="GuideStyle.css" type="text/css" />

  7. <link rel="stylesheet" href="AdminStyle.css" type="text/css" />

  8. </head>

  9. 

  10. <body>

  11. 

  12.   <table border="0" cellPadding="0" cellSpacing="0" width="100%">

  13. 

  14.     <tr>

  15.       <td class="tabBodyOuter">

  16. 

  17. 	<table class="tabBody" width="100%" cellspacing="0"

  18. 	      cellpadding="0">

  19. 	  <tr>

  20. 

  21. 	    <td>

  22. 

  23. 	      <h1>ARM Research Labs Sniffer Plugin for CommuniGate

  24. 	      Pro</h1>

  25. 

  26. 		<div class="guideTOC">

  27. 		  <ul>

  28. 

  29. 		<table class="tabBody" width="100%" cellspacing="0"

  30. 		  cellpadding="0">

  31. 

  32. 		  <li><a href="#Download">Download the Sniffer Plugin</a>

  33. 

  34. 		  <li><a href="#Install" name=Install>Installation</a>

  35. 

  36. 		  <ul>

  37. 

  38. 		    <li><a href="#WIN32">Installing on a MS Windows

  39. 		    200x/NT/XP/9x system</a>

  40. 

  41. 		    <li><a href="#Linux">Installing on a Linux

  42. 		    system</a>

  43. 

  44. 		    <li><a href="#FreeBSD">Installing on a FreeBSD

  45. 		    system</a>

  46. 

  47. 		    <li><a href="#OpenBSD">Installing on an OpenBSD

  48. 		    system</a>

  49. 

  50. 		    <li><a href="#Source">Installing from source</a>

  51. 

  52. 		  </ul>

  53. 

  54. 		  <li><a href="#Upgrading">Upgrading to a newer

  55. 		  version</a>

  56. 

  57. 		  <li><a href="#Config">Configuring the Sniffer

  58. 		  Plugin</a>

  59. 

  60. 		  <li><a href="#Test">Testing the Sniffer Plugin</a>

  61. 

  62. 		  <li><a href="#Options">Command line options</a>

  63. 

  64. 		  <li><a href="#Integrate">Integrating the Sniffer

  65. 		  Plugin with CommuniGate Pro</a>

  66. 

  67. 		  <li><a href="#Update">Updating the spam definitions

  68. 		  database</a>

  69. 

  70. 		</ul>

  71. 	      </div>

  72. 	      </td>

  73. 	    </tr>

  74. 

  75. 	  </table>

  76. 	</tr>

  77.       </table>

  78.     </tr>

  79.   </td>

  80. </table>

  81. 

  82. <p><b>Note:</b> The ARM Research Labs Sniffer Plugin is not available

  83. on platforms.  Before you order the Sniffer License, make sure that

  84. the available versions of the Sniffer Plugin software run on your

  85. CommuniGate Pro Server platform.</p>

  86. 

  87. <h2><hr><a name="Download"></a>Download the ARM Research Labs Sniffer Plugins</h2>

  88. <dl><dd>

  89.   <p>ARM Research Labs Sniffer antispam plugins are available for certain platforms only.</p>

  90. 

  91.   <table class="guideTable" border=1 cellspacing=0 cellpadding=1>

  92. 

  93.     <tr bgcolor="#cccccc">

  94.        <th nowrap rowspan=2 width=50%>Operating System</th>

  95.        <th nowrap rowspan=2>CPU</th>

  96.        <th nowrap colspan=2>Download</th>

  97.     </tr>

  98. 

  99.     <tr bgcolor="#cccccc">

  100.        <th nowrap>via<br>http</th>

  101.        <th nowrap>via<br>ftp</th>

  102.     </tr>

  103. 

  104.     <tr>

  105.        <td align=center>Microsoft Windows NT/2000/XP<BR>Microsoft Windows 95/98</td>

  106.        <td align=center>x86</td>

  107.        <td align=center><a HREF="http://www.armresearch.com/message-sniffer/download/CGPSNF-Win32-Intel.zip">

  108. 	   <img src="DownLoad.gif" border=0 width=16 height=16></a></td>

  109.        <td align=center><img src="DisabledDownLoad.gif" border=0 width=16 height=16></td>

  110.     </tr>

  111. 

  112.     <tr>

  113.        <td align=center rowspan=2>Linux (RedHat/Fedora/CentOS, Ubuntu, SuSE)</TD>

  114.        <td align=center>x86</td>

  115.        <td align=center><a

  116.        HREF="http://www.armresearch.com/message-sniffer/download/CGPSNF-Linux-Intel.tar.gz">

  117. 	   <img src="DownLoad.gif" border=0 width=16 height=16></a></td>

  118.        <td align=center><img src="DisabledDownLoad.gif" border=0 width=16 height=16></td>

  119. 

  120.        <tr>

  121.        <td align=center>x86_64</td>

  122.        <td align=center><a href="http://www.armresearch.com/message-sniffer/download/CGPSNF-Linux-x86_64.tar.gz">

  123. 	   <img src="DownLoad.gif" border=0 width=16 height=16></a></td>

  124.        <td align=center><img src="DisabledDownLoad.gif" border=0 width=16 height=16></td>

  125.     </tr>

  126. 

  127.     <tr>

  128.        <td align=center rowspan=2>FreeBSD 7.x</td>

  129.        <td align=center>x86</td>

  130.        <td align=center><a href="http://www.armresearch.com/message-sniffer/download/CGPSNF-FreeBSD7.x-Intel.tar.gz">

  131. 	   <img src="DownLoad.gif" border=0 width=16 height=16></a></td>

  132.        <td align=center><img src="DisabledDownLoad.gif" border=0 width=16 height=16></td>

  133. 

  134.        <tr>

  135.        <td align=center>x86_64</td>

  136.        <td align=center><a href="http://www.armresearch.com/message-sniffer/download/CGPSNF-FreeBSD7.x-x86_64.tar.gz">

  137. 	   <img src="DownLoad.gif" border=0 width=16 height=16></a></td>

  138.        <td align=center><img src="DisabledDownLoad.gif" border=0 width=16 height=16></td>

  139. 

  140.     </tr>

  141. 

  142.     <tr>

  143.        <td align=center rowspan=2>OpenBSD 4.4 or later</td>

  144.        <td align=center>x86</td>

  145.        <td align=center><a href="http://www.armresearch.com/message-sniffer/download/CGPSNF-OpenBSD4.4-Intel.tar.gz">

  146. 	   <img src="DownLoad.gif" border=0 width=16 height=16></a></td>

  147.        <td align=center><img src="DisabledDownLoad.gif" border=0 width=16 height=16></td>

  148. 

  149.        <tr>

  150.        <td align=center>x86_64</td>

  151.        <td align=center><a href="http://www.armresearch.com/message-sniffer/download/CGPSNF-OpenBSD4.4-x86_64.tar.gz">

  152. 	   <img src="DownLoad.gif" border=0 width=16 height=16></a></td>

  153.        <td align=center><img src="DisabledDownLoad.gif" border=0 width=16 height=16></td>

  154. 

  155.     </tr>

  156. 

  157.   </table>

  158. 

  159. </dl>

  160. 

  161. <p>Downloads by ftp are not available</p>

  162. <p>The current version of the Plugin is 0.1.0.</p>

  163. <p>The current version of the ARM Research Labs Sniffer Engine is 3.0.11.</p>

  164. 

  165. <h3><hr/><a name=Upgrading></a>Upgrading to a newer version.</h3>

  166. <p>When upgrading the Plugin to a newer version, do the following:</p>

  167. 

  168. <ul>

  169. 

  170.    <li>Stop any running copy of the Sniffer Plugin application via

  171.    CommuniGate Pro WebAdmin interface.

  172. 

  173.    <li>Install and configure the new version of the Sniffer Plugin as

  174.    described in this document.

  175. 

  176. </ul>

  177. 

  178. <h3><hr><a name="WIN32"></a>Installing on a MS Windows 200x/NT/XP/9x system.</h3>

  179. <ul>

  180.     <li>Open the command-line interface window and 

  181. 	change the current directory to the CommuniGate Pro <I>base directory</I>.

  182.     <li>Use any &quot;unzip&quot;-compatible tool to unpack the

  183.      <tt>CGPSNF-Win32-Intel.zip</tt> file. The <tt>CGPSNF</tt> directory will be created inside the <I>base directory</I>. 

  184.     <li>Proceed with <a HREF="#Config">Configuring the Sniffer Plugin</a>.

  185. </ul>

  186. 

  187. <h3><hr><a name=Linux></a>Installing on a Linux system.</h3>

  188. <ul>

  189.     <li>Log in as a super-user (root).

  190.     <li>Change the current directory to the CommuniGate Pro <I>base directory</I>.

  191.     <li>Unpack the Plugin archive with the <tt>tar</tt> command:<tt><br>

  192.         &nbsp;&nbsp;tar -xzf CGPSNF-Linux-Intel.tar.gz</tt><br>

  193.         The <tt>CGPSNF</tt> directory will be created inside the <I>base directory</I>. 

  194.     <li>Proceed with <a HREF="#Config">Configuring the Sniffer Plugin</a>.

  195. </ul>

  196. 

  197. <h3><hr><a name=FreeBSD></a>Installing on a FreeBSD system.</h3>

  198. <ul>

  199.     <li>Log in as a super-user (root).

  200.     <li>Change the current directory to the CommuniGate Pro <I>base directory</I>.

  201.     <li>Unpack the Plugin archive with the <tt>tar</tt> command:<tt><br>

  202.         &nbsp;&nbsp;tar -xzf CGPSNF-FreeBSD-Intel.tar.gz</tt><br>

  203.         The <tt>CGPSNF</tt> directory will be created inside the <I>base directory</I>. 

  204.     <li>Proceed with <a HREF="#Config">Configuring the Sniffer Plugin</a>.

  205. </ul>

  206. 

  207. <h3><hr><a name=OpenBSD></a>Installing on an OpenBSD system.</h3>

  208. <ul>

  209.     <li>Log in as a super-user (root).

  210.     <li>Change the current directory to the CommuniGate Pro <I>base directory</I>.

  211.     <li>Unpack the Plugin archive with the <tt>tar</tt> command:<tt><br>

  212.         &nbsp;&nbsp;tar -xzf CGPSNF-OpenBSD-Intel.tar.gz</tt><br>

  213.         The <tt>CGPSNF</tt> directory will be created inside the <I>base directory</I>. 

  214.     <li>Proceed with <a HREF="#Config">Configuring the Sniffer Plugin</a>.

  215. </ul>

  216. 

  217. <h3><hr><a name=Source></a>Installing from source.</h3>

  218. You can build the Sniffer Plugin from source:

  219. <ul>

  220.     <li>Download the <tt>snf4cgp-X.Y.Z.tar.gz</tt>, where X.Y.Z is the

  221.     version.

  222.     <li>Extract the sources with the command:<tt><br>

  223.         &nbsp;&nbsp;tar -xzf snf4cgp-X.Y.Z.tar.gz</tt><br>

  224.     This creates a directory <tt>snf4cgp-X.Y.Z</tt>.

  225.     <li>Change directory to <tt>snf4cgp-X.Y.Z</tt>:<tt><br>

  226.         &nbsp;&nbsp;cd snf4cgp-X.Y.Z</tt><br>

  227.     <li>Configure and build the system:<tt><br>

  228.         &nbsp;&nbsp;./configure<br>

  229.         &nbsp;&nbsp;./make</tt><br>

  230.     <li>Become super-user (root).

  231.     <li>Create the Sniffer Plugin:<tt><br> &nbsp;&nbsp;make

  232.         module</tt><br> This creates a Plugin archive

  233.         named <tt>CGPSNF-X.Y.Z-MODULE.tar.gz</tt>.

  234.     <li>Proceed with <a HREF="#Install">Installing the Sniffer

  235.     Plugin</a> for your system, using the Plugin archive that was

  236.     created.

  237. </ul>

  238. 

  239. <h3><hr><a name=Config></a>Configuring the Sniffer Plugin.</h3>

  240. 

  241. <p>In the module directory (<tt>/var/CommuniGate/CGPSNF</tt> on a

  242.   Linux or Linux-like system):</p>

  243. <ul>

  244.     <li>Copy the configuration file <tt><br>

  245.       &nbsp;&nbsp;snf_engine.xml.sample</tt><br> to <tt><br>

  246.       &nbsp;&nbsp;snf_engine.xml</tt><br> and customize as

  247.       needed.  Please see the <a href="http://www.armresearch.com">ARM

  248.       Research Labs web site</a> for documentation on

  249.       the <tt>snf_engine.xml</tt> configuration file.<br>

  250. 

  251.     <li>Copy <tt><br>

  252.       &nbsp;&nbsp;identity.xml.sample</tt><br> to <tt><br>

  253.       &nbsp;&nbsp;identity.xml</tt><br> and edit to include the

  254.       license ID and authentication attributes of

  255.       the <tt>&lt;identity&gt; element</tt>.<br>

  256. 

  257.     <li>Copy <tt><br>

  258.       &nbsp;&nbsp;getRulebase.sample</tt><br> to <tt><br>

  259.       &nbsp;&nbsp;getRulebase</tt><br> and edit to include the

  260.       license ID and authentication:

  261. 

  262.       <ul>

  263. 	<li>Change the line <tt><br>

  264. 	    &nbsp;&nbsp;AUTHENTICATION=authenticationxx</tt><br>

  265. 	    to <tt><br>

  266. 	    &nbsp;&nbsp;AUTHENTICATION=YOUR_AUTHENTICATION</tt><br>

  267. 	    where <tt>YOUR_AUTHENTICATION</tt> is authentication code

  268. 	    obtained from ARM Research Labs.</LI>

  269. 

  270. 	<li>Change the line <tt><br>

  271. 	    &nbsp;&nbsp;LICENSE_ID=licenseid</tt><br> to <tt><br>

  272. 	    &nbsp;&nbsp;LICENSE_ID=YOUR_LICENSE_ID</tt><br>

  273. 	    where <tt>YOUR_LICENSE_ID</tt> is license ID obtained from

  274. 	    ARM Research Labs.</LI>

  275. 

  276.       </ul>

  277. 

  278.     <li>Make <tt>getRulebase</tt> executable:<tt><br>

  279.       &nbsp;&nbsp;chmod 755 getRulebase</tt><br>

  280. 

  281.     <li>Copy <tt><br>

  282.       &nbsp;&nbsp;GBUdbIgnoreList.txt.sample</tt><br> to <tt><br>

  283.       &nbsp;&nbsp;GBUdbIgnoreList.txt</tt><br> and customize as

  284.       needed.  Please see the

  285.       <a href="http://www.armresearch.com">ARM Research Labs web

  286.       site</a> for documentation on the <tt>GBUdbIgnoreList.txt</tt>

  287.       file.<br>

  288. 

  289.     <li>Download the Sniffer database:

  290.       <ul>

  291. 	<li>Create the file <tt>UpdateReady.txt</tt> in the plugin directory:<tt><br>

  292. 	    &nbsp;&nbsp;touch UpdateReady.txt</tt><br>

  293. 	</LI>

  294. 	<li>Run the <tt>getRulebase</tt> script in the plugin

  295. 	  directory:<tt><br>

  296. 	    &nbsp;&nbsp;./getRulebase</tt><br>

  297. 	  This downloads the Sniffer database to the plugin directory.

  298.       </ul>

  299. 

  300.       The <B><tt>CGPSNF</tt></B> program automatically updates the

  301.       Sniffer database as needed.

  302. 

  303.     <li>Proceed with <a HREF="#Test">Testing the Sniffer Plugin</a>.

  304. </ul>

  305. 

  306. <h3><hr><a name=Test></a>Testing the Sniffer Plugin.</h3>

  307. <p>On Windows System:</p>

  308. 

  309. <ul>

  310.     <li> Change to the module directory:<tt><br>

  311. 	&nbsp;&nbsp;cd \CommuniGatePro\CGPSNF</tt><br>

  312. 

  313.     <li>Launch the <tt>CGPSNF.exe</tt> application by typing:<tt><br>

  314.       &nbsp;&nbsp;CGPSNF.exe</tt><br>

  315.       It will report the Plugin version number and build date.<br>

  316. 

  317.     <li>Type:<tt><br>

  318.        &nbsp;&nbsp;1 FILE junkmsg.msg</tt><br>

  319.        The plugin should report that the file is spam.

  320.     <li>Quit <tt>CGPSNF.exe</tt> by typing Ctrl-Z.  

  321. </ul>

  322. 

  323. <p>On a Unix System:</p>

  324.   <ul>

  325.     <li> Change to the module directory:<tt><br>

  326. 	&nbsp;&nbsp;cd /var/CommuniGate/CGPSNF</tt><br>

  327. 

  328.     <li>Launch the <tt>CGPSNF</tt> application by typing:<tt><br>

  329.       &nbsp;&nbsp;./CGPSNF</tt><br>

  330.       It will report the Plugin version number and build date.<br>

  331. 

  332.     <li>Type:<tt><br>

  333.        &nbsp;&nbsp;1 FILE junkmsg.txt</tt><br>

  334.        the plugin should report that the file is spam.

  335. 

  336.     <li>Quit <tt>CGPSNF</tt> by typing Ctrl-D.  

  337. </ul>

  338. 

  339. <h3><hr><a name="Options"></a>Command Line Options</h3>

  340. <dl>

  341.   <dd>

  342.     The Sniffer Plugin supports the following command-line option

  343.     (parameters):

  344. 

  345.     <dl>

  346.       <p><dt><tt>path_to_config_file</tt></dt></p>

  347. 

  348.       <dd>This option tells the Plugin to read the configuration from

  349. 	<tt>path_to_config_file</tt>.

  350.       </dd>

  351. 

  352.     </dl>

  353. 

  354. </dl>

  355. 

  356. 

  357. <h3><hr><a name=Integrate></a>Integrating the Sniffer Plugin with CommuniGate Pro.</h3>

  358. 

  359. Please check

  360. the <a HREF="http://www.communigate.com/CommuniGatePro/VirusScan.html#Launch">External

  361. Filters</a> section of the CommuniGate Pro manual.

  362. 

  363. <p>Open the General page in the Settings section of the WebAdmin

  364. Interface and click the Helpers link.  Create the Helper as follows:</p>

  365. 

  366. 

  367. <center class="WebAdmin"><form action="Null.html">

  368. <table  class="settingsBox" cellpadding="3" width="90%">

  369.   <caption>Content Filtering</caption>

  370. 

  371. <tr><td BGCOLOR="#EEEEEE">

  372. <table class="settingsBox" WIDTH="100%" BORDER="0" CELLSPACING=1 CELLPADDING=0>

  373.  <tr>

  374.   <td align="right"><select name="U3"><option value="0">Disabled</option><option value="1" selected="selected">Enabled</option></select></td>

  375.   <td><input name="N3" value="ARM Sniffer" size="15" maxlength="200" type="text" /></td>

  376.   <td colspan=2 align=center></td>

  377.  </tr><tr>

  378.   <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 &amp; Failures</option><option value="3">Problems</option><option value="4" selected="selected">Low Level</option><option value="5">All Info</option></select></td>

  379.   <td align="right" width="25%">Program Path:</td><td><input name="P3"

  380.     value="CGPSNF/CGPSNF" size="30" maxlength="255" type="text" /></td>

  381. 

  382.  </tr><tr>

  383.   <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>

  384.   <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>

  385.  </tr>

  386. </table></td></tr>

  387. </table></FORM></center>

  388. 

  389. 

  390. 

  391. <B>Note:</B> For Windows system the Program Path shold be

  392. <tt>CGPSNF\CGPSNF.exe</tt><br>

  393. <B>Note:</B> On some versions of FreeBSD system you may need to

  394. specify the full path to the program,

  395. i.e. <tt>/var/CommuniGate/CGPSNF/CGPSNF</tt>

  396. 

  397. <p>The recommended Scanning Rule is as follows:</p>

  398. 

  399. <center class="WebAdmin"><form action="Null.html">

  400. <table class="settingsBox" cellpadding="3" width="90%">

  401.         <tr align="left">

  402. 	   <th>Data</th>

  403. 	   <th>Operation</th>

  404. 	   <th>Parameter</th>

  405. 	</tr>

  406. <tr>

  407.  <td>

  408.   <select name="c2"><option VALUE="0" selected>---<option VALUE="12">Message Size</select>

  409.  </td><td>

  410.   <select name="o2"><option VALUE="0" selected>is<option VALUE="4">greater than</select>

  411.  </td><td>

  412.   <INPUT TYPE="text" name="p2" VALUE="" SIZE="20" MAXLENGTH="1024">

  413.  </td>

  414. </tr>

  415. 

  416. <tr align="left">

  417. 	   <th>Action</th>

  418. 	   <th colspan="2">Parameter</th>

  419. 	</tr>

  420. <tr valign=TOP>

  421.  <td><select name="a0"><option VALUE="0">---<option VALUE="6">Stop Processing<option VALUE="17" selected>ExternalFilter</select>

  422.  </td><td><textarea name="r0" rows="4" cols="40">ARM Sniffer</textarea>

  423.  </td>

  424. </tr>

  425. <tr valign=top>

  426.  <td><select name="a1"><option value="0" selected>---<option value="7">Stop Processing</select></td>

  427.  <td colspan="2"><textarea name="r1" rows="4" cols="40"></textarea></td>

  428. </tr>

  429. 

  430. </table></form></center>

  431. 

  432. <hr/>

  433. 

  434. </body>

  435. </html>