]> arthur.barton.de Git - ngircd-alex.git/blob - doc/Bopm.txt
Make NJOIN handler more fault-tolerant
[ngircd-alex.git] / doc / Bopm.txt
1
2                      ngIRCd - Next Generation IRC Server
3                            http://ngircd.barton.de/
4
5                (c)2001-2014 Alexander Barton and Contributors.
6                ngIRCd is free software and published under the
7                    terms of the GNU General Public License.
8
9                                 -- BOPM.txt --
10
11
12 I. Introduction
13 ~~~~~~~~~~~~~~~~
14
15 Citing <http://wiki.blitzed.org/BOPM>: "BOPM is an open source open proxy
16 monitor, designed for use with hybrid-based ircds, although it can be used
17 with slight modification on any server which has the ability to show connects
18 to opers and that supports KLINEs."
19
20 Starting with Release 17, ngIRCd supports all required log messages that
21 BOPM requires to be useful.
22
23 II. Installation
24 ~~~~~~~~~~~~~~~~~
25
26 Install BOPM as usual, please see the BOPM documentation for details.
27 Afterwards adjust the following configuration parameters that are important
28 for ngIRCd:
29
30 a) BOPM "IRC" section:
31
32   1) Set "server" and "port" accordingly,
33
34   2) adjust the "oper" line to match an [Operator] block in ngircd.conf,
35
36   3) change "mode" to "+ci" or "+c".
37
38   4) Set "connregex" to the following string, everything in one line(!):
39      "Client connecting: ([^ ]+) \\(([^@]+)@([^\\)]+)\\) \\[([0-9\\.]+)\\].*";
40      and comment out all the other "connregex" examples (that is, prepend a
41      "#" character).
42
43   5) Set "kline" to "GLINE *@%h :Open proxy found on your host!";
44      and comment out all the other "kline" examples.
45
46 b) BOPM "scanner" section:
47
48   Make sure you configure a valid "target_ip" and "target_port" for the
49   configured scanners to test. And please note that you CAN'T USE the port
50   of ngIRCd, because ngIRCd doesn't send any banner message by default!
51
52   So you need a service what sends a banner, so for example POP3, SMTP,
53   IMAP, or SSH daemons should work ...