2005-07-06 23:10:19 +00:00
|
|
|
|
__ _ _ ___ _
|
|
|
|
|
/ _|__ _(_) |_ ) |__ __ _ _ _
|
|
|
|
|
| _/ _` | | |/ /| '_ \/ _` | ' \
|
|
|
|
|
|_| \__,_|_|_/___|_.__/\__,_|_||_|
|
|
|
|
|
|
|
|
|
|
=============================================================
|
2005-09-20 16:37:44 +00:00
|
|
|
|
Fail2Ban (version 0.5.4) 2005/09/13
|
2005-07-06 23:10:19 +00:00
|
|
|
|
=============================================================
|
|
|
|
|
|
|
|
|
|
Fail2Ban scans log files like /var/log/pwdfail and bans IP
|
|
|
|
|
that makes too many password failures. It updates firewall
|
2005-07-13 10:01:01 +00:00
|
|
|
|
rules to reject the IP address. These rules can be defined by
|
|
|
|
|
the user. Fail2Ban can read multiple log files such as sshd
|
2005-08-06 19:43:43 +00:00
|
|
|
|
or Apache web server ones.
|
2005-07-06 23:10:19 +00:00
|
|
|
|
|
|
|
|
|
This is my first Python program. Moreover, English is not my
|
|
|
|
|
mother tongue...
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
More details:
|
|
|
|
|
-------------
|
|
|
|
|
|
|
|
|
|
Fail2Ban is rather simple. I have a home server connected to
|
|
|
|
|
the Internet which runs apache, samba, sshd, ... I see in my
|
|
|
|
|
logs that people are trying to log into my box using "manual"
|
|
|
|
|
brute force or scripts. They try 10, 20 and sometimes more
|
|
|
|
|
user/password (without success anyway). In order to
|
|
|
|
|
discourage these script kiddies, I wanted that sshd refuse
|
|
|
|
|
login from a specific ip after 3 password failures. After
|
|
|
|
|
some Google searches, I found that sshd was not able of that.
|
|
|
|
|
So I search for a script or program that do it. I found
|
|
|
|
|
nothing :-( So I decide to write mine and to learn Python :-)
|
|
|
|
|
|
|
|
|
|
For each sections defined in the configuration file, Fail2Ban
|
|
|
|
|
tries to find lines which match the failregex. Then it
|
|
|
|
|
retrieves the message time using timeregex and timepattern.
|
|
|
|
|
It finally gets the ip and if it has already done 3 or more
|
|
|
|
|
password failures in the last banTime, the ip is banned for
|
2005-07-13 10:01:01 +00:00
|
|
|
|
banTime using a firewall rule. This rule is set by the user
|
|
|
|
|
in the configuration file. Thus, Fail2Ban can be adapted for
|
|
|
|
|
lots of firewall. After banTime, the rule is deleted. Notice
|
|
|
|
|
that if no "plain" ip is available, Fail2Ban try to do DNS
|
|
|
|
|
lookup in order to found one or several ip's to ban.
|
2005-07-06 23:10:19 +00:00
|
|
|
|
|
|
|
|
|
Sections can be freely added so it is possible to monitor
|
|
|
|
|
several daemons at the same time.
|
|
|
|
|
|
|
|
|
|
Runs on my server and does its job rather well :-) The idea
|
|
|
|
|
is to make fail2ban usable with daemons and services that
|
2005-07-13 10:01:01 +00:00
|
|
|
|
require a login (sshd, telnetd, ...) and with different
|
|
|
|
|
firewalls.
|
2005-07-06 23:10:19 +00:00
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Installation:
|
|
|
|
|
-------------
|
|
|
|
|
|
|
|
|
|
Require: python-2.3 (http://www.python.org)
|
|
|
|
|
|
|
|
|
|
To install, just do:
|
|
|
|
|
|
2005-09-20 16:37:44 +00:00
|
|
|
|
> tar xvfj fail2ban-0.5.4.tar.bz2
|
|
|
|
|
> cd fail2ban-0.5.4
|
2005-07-06 23:10:19 +00:00
|
|
|
|
> python setup.py install
|
|
|
|
|
|
2005-07-23 19:15:22 +00:00
|
|
|
|
This will install Fail2Ban into /usr/lib/fail2ban. The fail2ban
|
|
|
|
|
executable is placed into /usr/bin.
|
2005-07-06 23:10:19 +00:00
|
|
|
|
|
2005-09-09 21:15:41 +00:00
|
|
|
|
Gentoo: ebuilds are available on the website.
|
|
|
|
|
Debian: Fail2Ban is in Debian unstable.
|
|
|
|
|
RedHat: packages are available on the website.
|
2005-07-06 23:10:19 +00:00
|
|
|
|
|
|
|
|
|
Fail2Ban should now be correctly installed. Just type:
|
|
|
|
|
|
2005-07-23 19:15:22 +00:00
|
|
|
|
> fail2ban -h
|
2005-07-06 23:10:19 +00:00
|
|
|
|
|
|
|
|
|
to see if everything is alright. You can configure fail2ban
|
|
|
|
|
with a config file. Copy config/fail2ban.conf.default to
|
|
|
|
|
/etc/fail2ban.conf.
|
|
|
|
|
|
2005-07-23 19:15:22 +00:00
|
|
|
|
You can use the initd script available in config/. Copy
|
|
|
|
|
<dist>-initd to /etc/init.d/fail2ban. Gentoo users must copy
|
|
|
|
|
gentoo-confd to /etc/conf.d/fail2ban. You can start fail2ban:
|
2005-07-06 23:10:19 +00:00
|
|
|
|
|
|
|
|
|
> /etc/init.d/fail2ban start
|
2005-07-23 19:15:22 +00:00
|
|
|
|
|
|
|
|
|
Gentoo users can add it to the default runlevel:
|
|
|
|
|
|
2005-07-06 23:10:19 +00:00
|
|
|
|
> rc-update add fail2ban default
|
|
|
|
|
|
|
|
|
|
Configuration:
|
|
|
|
|
--------------
|
|
|
|
|
|
|
|
|
|
You can configure fail2ban using the file /etc/fail2ban.conf
|
|
|
|
|
or using command line options. Command line options override
|
|
|
|
|
the value stored in fail2ban.conf. Here are the command line
|
|
|
|
|
options:
|
|
|
|
|
|
2005-08-06 19:43:43 +00:00
|
|
|
|
-b start in background
|
|
|
|
|
-d start in debug mode
|
2005-07-06 23:10:19 +00:00
|
|
|
|
-c <FILE> read configuration file FILE
|
|
|
|
|
-p <FILE> create PID lock in FILE
|
|
|
|
|
-h display this help message
|
|
|
|
|
-i <IP(s)> IP(s) to ignore
|
2005-08-06 19:43:43 +00:00
|
|
|
|
-k kill a currently running instance
|
2005-07-06 23:10:19 +00:00
|
|
|
|
-r <VALUE> allow a max of VALUE password failure
|
|
|
|
|
-t <TIME> ban IP for TIME seconds
|
|
|
|
|
-v verbose. Use twice for greater effect
|
2005-07-13 10:01:01 +00:00
|
|
|
|
-V print software version
|
2005-07-06 23:10:19 +00:00
|
|
|
|
|
|
|
|
|
Contact:
|
|
|
|
|
--------
|
|
|
|
|
|
|
|
|
|
You need some new features, you found bugs or you just
|
|
|
|
|
appreciate this program, you can contact me at :
|
|
|
|
|
|
2005-07-13 10:01:01 +00:00
|
|
|
|
Website: http://fail2ban.sourceforge.net
|
2005-07-06 23:10:19 +00:00
|
|
|
|
|
|
|
|
|
Cyril Jaquier: <lostcontrol@users.sourceforge.net>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Thanks:
|
|
|
|
|
-------
|
|
|
|
|
|
|
|
|
|
K<EFBFBD>vin Drapel, Marvin Rouge, Sireyessire, Robert Edeker,
|
2005-09-09 21:15:41 +00:00
|
|
|
|
Tom Pike, Iain Lea, Andrey G. Grozin, Yaroslav Halchenko,
|
|
|
|
|
Jonathan Kamens, Stephen Gildea
|
2005-07-06 23:10:19 +00:00
|
|
|
|
|
|
|
|
|
License:
|
|
|
|
|
--------
|
|
|
|
|
|
|
|
|
|
Fail2Ban is free software; you can redistribute it
|
|
|
|
|
and/or modify it under the terms of the GNU General Public
|
|
|
|
|
License as published by the Free Software Foundation; either
|
|
|
|
|
version 2 of the License, or (at your option) any later
|
|
|
|
|
version.
|
|
|
|
|
|
|
|
|
|
Fail2Ban is distributed in the hope that it will be
|
|
|
|
|
useful, but WITHOUT ANY WARRANTY; without even the implied
|
|
|
|
|
warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
|
|
|
|
|
PURPOSE. See the GNU General Public License for more
|
|
|
|
|
details.
|
|
|
|
|
|
|
|
|
|
You should have received a copy of the GNU General Public
|
|
|
|
|
License along with Fail2Ban; if not, write to the Free
|
|
|
|
|
Software Foundation, Inc., 59 Temple Place, Suite 330,
|
|
|
|
|
Boston, MA 02111-1307 USA
|