Integrations / CrowdSec

Import a HoneyLabs blocklist into CrowdSec

CrowdSec accepts outside intelligence as decisions, the same object its own scenarios produce, and your bouncers enforce them. cscli decisions import reads a plain list of values, and the HoneyLabs text feed is such a list.

The result

cscli importing the HoneyLabs feed into CrowdSec: 234 decisions created, then listed as 24-hour bans that any installed bouncer enforces.
Captured on our lab instance. The frame shows the top left of the screen; open it for the rest.

Setup

  1. 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
  2. 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
  3. 03

    Import the feed as decisions

    Pull the text feed and import it. The values format reads a bare list of IPs. Set the duration to your refresh interval or longer so decisions do not expire between runs.

    Terminal
    curl -fsS 'https://honeylabs.net/feed/<token>' -o /tmp/honeylabs.txt
    cscli decisions import -i /tmp/honeylabs.txt --format values --duration 24h
    
    # Verify
    cscli decisions list | head
  4. 04

    Schedule the refresh

    A daily import with a 24h duration keeps the decision set tracking the feed: IPs that stop matching your query age out on their own.

    crontab
    # /etc/cron.d/honeylabs-crowdsec
    0 6 * * * root curl -fsS 'https://honeylabs.net/feed/<token>' -o /tmp/honeylabs.txt \
      && cscli decisions import -i /tmp/honeylabs.txt --format values --duration 24h

Worth knowing

  • Existing bouncers (firewall, nginx, Traefik) enforce imported decisions automatically; nothing else to configure.
  • Re-importing the same IP refreshes its decision rather than duplicating it.

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.