GreenArrow Email Software Documentation

fail2ban Integration

fail2ban is software which provides an IPS (intrusion prevention system). It scans log files for malicious activity, such as failed logins, and takes actions, such as updating a firewall’s configuration to block offending IPs.

This page shows how we use fail2ban for Cloud customers to block IPs with repeated SMTP login failures.

Since fail2ban is third party software, we do not support it for On-Premise customers, but you’re welcome to use the documentation below as a resource for setting it up.

These instructions were tested in CentOS 7.x and 8.x installations that use iptables. They may require modification for other environments.

  1. Install and enable fail2ban if not already present. This step is outside the scope of this document, but there are some resources like this one available on the topic.

  2. Create a filter so that fail2ban will know how to parse GreenArrow’s log files:

    echo "[Definition]
    failregex = smtpd: smtp-auth authentication failure from \(<HOST>\) for username" > /etc/fail2ban/filter.d/greenarrow-smtpd.conf

  3. Configure fail2ban to check GreenArrow’s SMTP log files for login failures:

    echo "
    enabled  = true
    filter   = greenarrow-smtpd
    action   = iptables-allports[name=SMTP]
    logpath  = /var/hvmail/log/qmail-smtpd*/current" >> /etc/fail2ban/jail.local

  4. Restart fail2ban:

    service fail2ban restart

Copyright © 2012–2024 GreenArrow Email