SIPban

Description

Program to stop SIP scanning attacks using live monitoring of the Asterisk AMI security Events and use iptables to block remote ip address.

The program use AMI (Asterisk manager Interface, with the security profile, obtain events related to SIP authorization on PJSIP and SIP channels.

Tested with Asterisk version 16.3.0 (C) 1999 - 2018, Digium, Inc. and others.

Install

The service use iptables, you need the "root" user of your system

1. Download file

   git clone https://github.com/elpop/sipban.git
   

2. Install perl dependecies:

   a) Ubuntu/Debian

   sudo apt-get install libproc-pid-file-perl libconfig-simple-perl libnet-whois-ip-perl libtime-hires-perl libtie-cache-perl
   

   b) Redhat/CentOS/Fedora

   sudo dnf install perl-Proc-PID-File perl-Config-Simple perl-Net-Whois-IP perl-Time-HiRes perl-Tie-Cache
   

3. Copy configuration files

    cd sipban
    cp sipban.pl /usr/local/bin/.
    cp etc/sipban.conf /etc/.
    cp etc/sipban.wl /etc/.
   

4. Edit and add /etc/asterisk/manager.conf acording our sample on sipban/etc/asterisk/manager.conf

   Use "asterisk -rx'manager reload'" after change the manager configuration file.

5. Install the launch scripts

   a) for init.d

   cp etc/init.d/sipban /etc/init.d/.
   chkconfig --level 345 sipban on
   /etc/init.d/sipban start
   

   b) for systemd

   cp etc/systemd/system/sipban.service /etc/systemd/system/.
   systemctl enable sipban
   service sipban start
   

Configure

1. In the file /etc/asterisk/manager.conf we put this configuration:

   [general]
   enabled = yes
   
   port = 5038
   bindaddr = 127.0.0.1
   
   [sipban]
   secret = getout
   writetimeout = 100000
   read = security
   write = system,command
   

2. The /etc/sipban.conf contains the parameters of the service:

   # SipBan Configuration File
   
   # Parameters to connect to Asterisk AMI
   [ami]
   port = "5038"
   user = "sipban"
   pass = "getout"
   host = "127.0.0.1"
   ping = 600
   
   # Port to send commands
   [control]
   port = "4451"
   
   # Timers
   [timer]
   ban = 86400
   
   #Iptables rules actions config
   [iptables]
   path  = "/sbin/"
   chain = "sipban-udp"
   # to block udp port 5060, you can block all but test
   # with caution to avoid lost total access to your system.
   scope = "-p udp --dport 5060"
   rule  = "REJECT --reject-with icmp-port-unreachable"
   #rule  = "DROP"
   white_list = "/etc/sipban.wl"
   dump = "/etc/sipban.dump"
   
   # Log file
   [log]
   file = "/var/log/sipban.log"
   
   # Invite Flood Attacks
   [flood]
   count=30
   interval=10
   

   The file is sefl explanatory. only take in count the "timer->ban" parameter are seconds (default 86400 = 1 day).

   The "iptables->rule" option is how iptables respond to the attack, you can choose "REJECT" or "DROP"

   The flood section will block based on the number (count) of invites received of a period of (inteval) seconds. In the default configuration if there are 30 SIP Invites from the same IP on the course of 30 seconds it will block the offender.

3. The White List is on /etc/sipban.wl. This file contains the ip address you don't want to block (one ip per line). You can change the location modify the sipban configuration file.

4. The sipban.dump file is a temp one to save the ip's and ban timers in case of mantinance.

5. You can reach via Telnet with the port 4451 (you can change in the "control->port" pararmeter).

Operation

1. The service are fully automatic, but you can control through the port 4451 (or another defined on /etc/sipban.conf), v.g.:

   [root@pbx ~]# telnet localhost 4451
   Trying ::1...
   telnet: connect to address ::1: Connection refused
   Trying 127.0.0.1...
   Connected to localhost.
   Escape character is '^]'.
       
   Sipban
   use 'help' for more commands
   sipban>
    
   sipban>help
       
   Commands:
       
   block                => List blocked ip address
   block {ip address}   => block ip address
   unblock [ip address] => unblock ip address
   flush                => Dump the blocked IP's and clear rules on chain sipban-udp
   restore              => If exists a dump file restore the rules from it
   ping                 => Send ping to Asterisk AMI
   uptime               => show the program uptime
   whois                => show the WHOIS info of a given ip
   wl                   => show white list ip address
   exit/quit            => exit console session
       
   sipban>
   

2. The log files reside on the file "/var/log/sipban.log"

   [root@pbx ~]# tail -f /var/log/sipban.log 
   [2019-06-12 12:01:50] SipBan Start
   [2019-06-12 12:01:50] WHITE LIST => 127.0.0.1
   [2019-06-12 12:01:55] BLOCK => 221.121.138.167
   [2019-06-12 12:01:59] BLOCK => 77.247.110.158
   [2019-06-12 12:02:01] BLOCK => 102.165.39.82
   [2019-06-12 12:02:06] BLOCK => 102.165.32.36
   [2019-06-12 12:02:07] BLOCK => 102.165.49.34
   [2019-06-12 12:02:08] BLOCK => 77.247.109.243
   ...   
   

3. You can check the iptables rules with "iptables -S sipban-udp"

   [root@pbx ~]# iptables -S sipban-udp
   -N sipban-udp
   -A sipban-udp -s 221.121.138.167/32 -j DROP 
   -A sipban-udp -s 77.247.110.158/32 -j DROP 
   -A sipban-udp -s 102.165.39.82/32 -j DROP 
   -A sipban-udp -s 102.165.32.36/32 -j DROP 
   -A sipban-udp -s 102.165.49.34/32 -j DROP 
   -A sipban-udp -s 77.247.109.243/32 -j DROP 
   ...
   -A sipban-udp -j RETURN 
   

Docker

Our friend Federico Pereira ([email protected]), make the docker image of SipBan, the instructions are on the README.md on the docker directory.

To-do

• IPv6 support
• IP Class blocking

Author

Fernando Romo ([email protected])

License

GNU GENERAL PUBLIC LICENSE Version 3
https://www.gnu.org/licenses/gpl-3.0.en.html
See LICENSE.txt

Sponsor the project

Please sponsor this project, to pay my high debt on credit cards :)