Integrations / fail2ban
Feed a HoneyLabs blocklist into fail2ban
fail2ban normally bans an address after it fails against your own logs. A jail fed from a list bans the addresses HoneyLabs sensors already caught, before they reach your server. The setup is a jail with no log filter and a cron job that loads the plain-text feed into it.
The result

Setup
- 01
Save a query
Sign in (free) and save the HoneyLabs query you want the feed to track on the feeds page. Any lookup query works: a port, an ASN, a tag, or a boolean combination. The feed returns the source IPs currently matching it, so a tighter query means a tighter blocklist.
Lookup query# Example saved queries and what they feed you port:22 AND NOT tag:scanner # SSH brute-forcers, known researchers removed tag:scanner # every recognized scanner IP cve:CVE-2024-4577 # IPs probing one specific CVE asn:14061 AND port:445 # SMB scans out of DigitalOcean - 02
Mint a feed token
On the same page, mint a feed URL for the saved query. The token alone authorizes the fetch, with no cookie or header, so the URL can go straight into an appliance. Give every consumer its own token so you can revoke a leaked URL without breaking the others.
Feed URL# Your feed URL looks like https://honeylabs.net/feed/<token> # plain text, a list of IPs https://honeylabs.net/feed/<token>.csv # ip,first_seen,last_seen,events,asn,country https://honeylabs.net/feed/<token>.json # same fields as JSON - 03
Create a list-fed jail
The jail exists only to hold bans, so its filter matches nothing and its logpath is /dev/null. Bans go through the normal fail2ban machinery: same ban action, same unban timer, visible in fail2ban-client status.
Config file# /etc/fail2ban/filter.d/honeylabs.conf [Definition] failregex = ignoreregex = # /etc/fail2ban/jail.d/honeylabs.conf [honeylabs] enabled = true filter = honeylabs logpath = /dev/null banaction = iptables-allports bantime = 6h # reload fail2ban-client reload - 04
Cron the feed into the jail
Every 30 minutes, pull the list and ban each IP. banip is idempotent, so re-banning an already-banned IP is a no-op, and bantime keeps the set self-cleaning: an IP that drops out of the feed unbans itself when its timer expires.
crontab# /etc/cron.d/honeylabs-fail2ban */30 * * * * root curl -fsS 'https://honeylabs.net/feed/<token>' \ | while read -r ip; do fail2ban-client set honeylabs banip "$ip" >/dev/null; done # Verify fail2ban-client status honeylabs
Worth knowing
- Banning one IP at a time is fine up to a few thousand entries. For larger lists, the ipset recipe on the integrations page scales better: one kernel set, one iptables rule.
- Match bantime to your cron interval or longer, otherwise bans expire between refreshes.
The feed comes as a plain list of IPs, as CSV or as JSON. Any token can be revoked without touching the others, and responses are cached at the edge for five minutes, so a short refresh interval costs nothing. Create a feed on the feeds page, or see the other integrations.