Gecko [ www.thearyasamaj.org ]

Name	Size	Permission
ftpasswd.html	14.61 KB	-rw-r--r--
ftpmail.html	8 KB	-rw-r--r--
ftpquota.html	10.9 KB	-rw-r--r--
index.html	9.04 KB	-rw-r--r--
mod_auth_otp.html	16.5 KB	-rw-r--r--
mod_ban.html	22.53 KB	-rw-r--r--
mod_copy.html	4.85 KB	-rw-r--r--
mod_ctrls_admin.html	15.05 KB	-rw-r--r--
mod_deflate.html	6.89 KB	-rw-r--r--
mod_digest.html	12.92 KB	-rw-r--r--
mod_dnsbl.html	6.1 KB	-rw-r--r--
mod_dynmasq.html	3.26 KB	-rw-r--r--
mod_exec.html	23.89 KB	-rw-r--r--
mod_geoip.html	17.06 KB	-rw-r--r--
mod_ifsession.html	11.02 KB	-rw-r--r--
mod_ifversion.html	4.96 KB	-rw-r--r--
mod_ldap.html	32.32 KB	-rw-r--r--
mod_load.html	2.97 KB	-rw-r--r--
mod_log_forensic.html	9.78 KB	-rw-r--r--
mod_qos.html	2.62 KB	-rw-r--r--
mod_quotatab.html	25.02 KB	-rw-r--r--
mod_quotatab_file.html	2.23 KB	-rw-r--r--
mod_quotatab_ldap.html	2.63 KB	-rw-r--r--
mod_quotatab_radius.html	2.08 KB	-rw-r--r--
mod_quotatab_sql.html	10.93 KB	-rw-r--r--
mod_radius.html	22.11 KB	-rw-r--r--
mod_ratio.html	6.99 KB	-rw-r--r--
mod_readme.html	2.69 KB	-rw-r--r--
mod_rewrite.html	30.06 KB	-rw-r--r--
mod_sftp.html	93.71 KB	-rw-r--r--
mod_sftp_pam.html	5.47 KB	-rw-r--r--
mod_sftp_sql.html	5.63 KB	-rw-r--r--
mod_shaper.html	23.28 KB	-rw-r--r--
mod_site_misc.html	5.81 KB	-rw-r--r--
mod_snmp.html	42.38 KB	-rw-r--r--
mod_sql.html	62.81 KB	-rw-r--r--
mod_sql_odbc.html	10.2 KB	-rw-r--r--
mod_sql_passwd.html	24.44 KB	-rw-r--r--
mod_sql_sqlite.html	2.95 KB	-rw-r--r--
mod_statcache.html	8.29 KB	-rw-r--r--
mod_tls.html	85.34 KB	-rw-r--r--
mod_tls_fscache.html	2.73 KB	-rw-r--r--
mod_tls_memcache.html	3.91 KB	-rw-r--r--
mod_tls_redis.html	3.6 KB	-rw-r--r--
mod_tls_shmcache.html	6.78 KB	-rw-r--r--
mod_unique_id.html	3.54 KB	-rw-r--r--
mod_wrap.html	12.38 KB	-rw-r--r--
mod_wrap2.html	24.83 KB	-rw-r--r--
mod_wrap2_file.html	4.69 KB	-rw-r--r--
mod_wrap2_redis.html	5.33 KB	-rw-r--r--
mod_wrap2_sql.html	8.33 KB	-rw-r--r--

Code Editor : mod_dnsbl.html

<!DOCTYPE html>
<html>
<head>
<title>ProFTPD module mod_dnsbl</title>
</head>

<hr>
<center>
<h2>ProFTPD module <code>mod_dnsbl</code></h2>
</center>
<hr>

A DNS blacklist is a way in which the DNS can be used to "blacklist"
sites/addresses that have been deemd to be "bad" in some way. These
blacklists are often used by email servers, for determining and rejecting
email sent by addresses known to be sources of spam. More information
on DNS blacklists can be found here:
<pre>
 <a href="http://en.wikipedia.org/wiki/DNSBL">http://en.wikipedia.org/wiki/DNSBL</a>
</pre>

While DNS blacklists are well known for use by email servers, it is also
possible to use them for other means, such as ways of checking whether an
FTP client's address should be allowed or rejected by an FTP server. Thus
the <code>mod_dnsbl</code> module was written for ProFTPD, for such a purpose.

The <code>mod_dnsbl</code> module is not compiled by default; build/installation
instructions are discussed <a href="#Installation">here</a>.

The most current version of <code>mod_dnsbl</code> is distributed with the
ProFTPD source code.

<h2>Author</h2>

Please contact TJ Saunders &lt;tj at castaglia.org&gt; with any
questions, concerns, or suggestions regarding this module.

<h2>Directives</h2>
<ul>
 <li><a href="#DNSBLDomain">DNSBLDomain</a>
 <li><a href="#DNSBLEngine">DNSBLEngine</a>
 <li><a href="#DNSBLLog">DNSBLLog</a>
 <li><a href="#DNSBLPolicy">DNSBLPolicy</a>
</ul>

<hr>
<h3><a name="DNSBLDomain">DNSBLDomain</a></h3>
Syntax: DNSBLDomain domain 
Default: None 
Context: server config, <code>&lt;VirtualHost&gt;</code>, <code>&lt;Global&gt;</code> 
Module: mod_dnsbl 
Compatibility: 1.3.1rc1 and later

The <code>DNSBLDomain</code> directive is used to configure the DNS name of
a DNS blacklist site, to be consulted when determining whether
<code>mod_dnsbl</code> should allow or reject an FTP connection. This
directive can be used multiple times, to configure multiple different DNS
blacklist sites. When checking these sites, the <code>mod_dnsbl</code> module
will check each <code>DNSBLDomain</code>, in the order they appear in the
<code>proftpd.conf</code> file.

Example:
<pre>
 DNSBLDomain sbl.spamhaus.org
 DNSBLDomain xbl.spamhaus.org
</pre>

<hr>
<h3><a name="DNSBLEngine">DNSBLEngine</a></h3>
Syntax: DNSBLEngine on|off 
Default: None 
Context: server config, <code>&lt;VirtualHost&gt;</code>, <code>&lt;Global&gt;</code> 
Module: mod_dnsbl 
Compatibility: 1.3.1rc1 and later

The <code>DNSBLEngine</code> directive toggles the use of DNS blacklists for
access control for FTP client connections (e.g. <code>mod_dnsbl</code>).
This is usually used inside a <code>&lt;VirtualHost&gt;</code> section to
enable DNS blacklist use for a particular virtual host. By default
<code>mod_dnsbl</code> is disabled for both the main server and all configured
virtual hosts.

<hr>
<h3><a name="DNSBLLog">DNSBLLog</a></h3>
Syntax: DNSBLLog file 
Default: None 
Context: server config, <code>&lt;VirtualHost&gt;</code>, <code>&lt;Global&gt;</code> 
Module: mod_dnsbl 
Compatibility: 1.3.1rc1 and later

The <code>DNSBLLog</code> directive is used to specify a log file for
<code>mod_dnsbl</code>'s reporting on a per-server basis. The file
parameter given must be the full path to the file to use for logging.

Note that this path must not be to a world-writable directory and,
unless <code>AllowLogSymlinks</code> is explicitly set to on
(generally a bad idea), the path must not be a symbolic link.

<hr>
<h3><a name="DNSBLPolicy">DNSBLPolicy</a></h3>
Syntax: DNSBLPolicy "allow,deny"|"deny,allow" 
Default: None 
Context: server config, <code>&lt;VirtualHost&gt;</code>, <code>&lt;Global&gt;</code> 
Module: mod_dnsbl 
Compatibility: 1.3.1rc1 and later

The <code>DNSBLPolicy</code> directive determines whether the
<code>mod_dnsbl</code> module (if enabled) will allow a connection by default
or not.

If <code>DNSBLPolicy</code> is configured using "allow,deny", then
the <code>mod_dnsbl</code> module will allow the connection, unless
the connecting client is blacklisted by any of the configured
<code>DNSBLDomain</code> sites.

If <code>DNSBLPolicy</code> is configured using "deny,allow", then
the <code>mod_dnsbl</code> module will not allow the connection,
unless the connecting client is listed by any of the configured
<code>DNSBLDomain</code> sites.

<hr> 
<h2><a name="Installation">Installation</a></h2>
The <code>mod_dnsbl</code> module is distributed with ProFTPD. Simply follow
the normal steps for using third-party modules in ProFTPD:
<pre>
 $ ./configure --with-modules=mod_dnsbl
 $ make
 $ make install
</pre>
Alternatively, <code>mod_dnsbl</code> can be built as a DSO module:
<pre>
 $ ./configure --enable-dso --with-shared=mod_dnbsl ...
</pre>
Then follow the usual steps:
<pre>
 $ make
 $ make install
</pre>

Logging 
The <code>mod_dnbsl</code> module supports different forms of logging. The
main module logging is done via the <code>DNSBLLog</code> directive.
For debugging purposes, the module also uses <a href="../howto/Tracing.html">trace logging</a>, via the module-specific log channels:
<ul>
 <li>dnsbl
</ul>
Thus for trace logging, to aid in debugging, you would use the following in
your <code>proftpd.conf</code>:
<pre>
 TraceLog /path/to/ftpd/trace.log
 Trace dnsbl:20
</pre>
This trace logging can generate large files; it is intended for debugging use
only, and should be removed from any production configuration.

<hr>

${this.title}

Code Editor : mod_dnsbl.html