Skip to content

Add Flowtriq DDoS detection parser and scenarios - #1836

Open
jacob-masse wants to merge 4 commits into
crowdsecurity:masterfrom
jacob-masse:add-flowtriq-integration
Open

Add Flowtriq DDoS detection parser and scenarios#1836
jacob-masse wants to merge 4 commits into
crowdsecurity:masterfrom
jacob-masse:add-flowtriq-integration

Conversation

@jacob-masse

Copy link
Copy Markdown

Adds parser and scenarios for Flowtriq DDoS detection alerts. When Flowtriq detects an attack, CrowdSec can parse the alert logs and create ban decisions against attacker source IPs, propagating protection across all connected bouncers.

What's included

  • Parser (jacob-masse/flowtriq-logs): Parses Flowtriq CEF syslog alerts, extracting source IP, destination IP, attack type, severity, pps, bps, and confidence level. Builds on the existing crowdsecurity/cef-logs raw parser.

  • Scenarios:

    • jacob-masse/flowtriq-ddos-attack: Trigger-based ban when Flowtriq reports an attack with high or critical confidence
    • jacob-masse/flowtriq-repeated-attacker: Leaky bucket (capacity 2, leak 30m) to catch repeated attackers across multiple incidents
  • Collection (jacob-masse/flowtriq): Bundles the parser and both scenarios

About Flowtriq

Flowtriq is a DDoS detection platform that analyzes network traffic via sFlow/NetFlow/IPFIX and detects volumetric attacks. The FTAgent can output structured alerts in Syslog CEF format for SIEM integration.

Acquisition example

---
source: syslog
listen_addr: 0.0.0.0
listen_port: 514
labels:
  type: cef

FlyingDove2493 and others added 3 commits June 25, 2026 15:28
Adds CEF log parser, DDoS attack trigger scenario, and repeated
attacker leaky bucket scenario for Flowtriq DDoS detection platform.
- Remove source_ip (src), protocol (proto), source_port (spt),
  destination_port (dpt) fields that don't exist in Flowtriq CEF output
- Map cs2 to severity instead of confidence
- Add source_count (cnt) and incident_id (cs3) fields
- Change scenario groupby/filter from source_ip to destination_ip
  since Flowtriq CEF reports the target node, not individual attackers
- Filter on severity instead of confidence in scenario triggers
- Update documentation to reflect actual extracted metadata
@blotus

blotus commented Jul 8, 2026

Copy link
Copy Markdown
Member

Hello,

Thanks for the PR. You are currently missing automated tests for your parser and scenario.

Parser test covers CEF log parsing for DDoS Attack Detected,
DDoS Attack Detected (critical), and DDoS Attack Resolved events.
Scenario test validates the trigger-based ban fires for high/critical
severity attacks.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants