Aller au contenu

CrowdSec

Couche : Services LXC · Où : LXC edge (Docker Compose, avec Traefik) · Version : v1.8.1 (image épinglée par digest)

À quoi elle sert ici et pourquoi ce choix

Analyse le journal d'accès de Traefik, détecte les comportements hostiles (scans, CVE HTTP, force brute) et fait bannir les adresses par le bouncer de Traefik. Le composant AppSec applique un WAF avec des règles de « virtual patching ». Choix cohérent avec un front public exposé : protection en bordure sans agent sur chaque service.

Où elle tourne et comment elle est déployée

Conteneur du Compose pad-edge, rôle edge-traefik-crowdsec. L'API locale (LAPI, 8080) et AppSec (7422) restent internes au réseau Docker du LXC ; seule la métrique (6060) est publiée sur l'IP du LXC. L'enrôlement au cloud CrowdSec est désactivé.

Version épinglée

Image pad_images.crowdsec dans infra/ansible/inventories/prod/group_vars/all/versions.yml. Collections installées : crowdsecurity/traefik, crowdsecurity/http-cve, crowdsecurity/appsec-virtual-patching, crowdsecurity/appsec-generic-rules (liste dans infra/ansible/roles/edge-traefik-crowdsec/defaults/main.yml).

Le WAF (AppSec) charge une seule configuration, crowdsecurity/appsec-default (crowdsec-acquis-appsec.yaml.j2). N'y ajoutez pas crowdsecurity/virtual-patching et crowdsecurity/generic-rules ensemble : ils déclarent tous deux la règle d'identifiant 100 et CrowdSec quitte au démarrage (« duplicated rule id 100 »), en boucle de redémarrage.

Fichiers de configuration dans le dépôt

  • infra/ansible/roles/edge-traefik-crowdsec/templates/crowdsec-acquis-traefik.yaml.j2 et crowdsec-acquis-appsec.yaml.j2.
  • .../crowdsec-config.yaml.local.j2, crowdsec.env.j2, compose.yml.j2.
  • Clé du bouncer : crowdsec_bouncer_key dans secrets/edge.example.yaml (modèle).

Interactions avec les autres briques

  • Lit logs/traefik/access.log (monté en lecture seule) produit par Traefik edge.
  • Reçoit les requêtes à examiner de la part du plugin bouncer (mode live).
  • Ses métriques sont scrapées par VictoriaMetrics (job crowdsec).

Sécurité

  • Pas de port LAPI ou AppSec publié hors du réseau Docker.
  • crowdsecAppsecFailureBlock: true : une requête rejetée par AppSec est bloquée.
  • crowdsecAppsecUnreachableBlock: false : si AppSec est indisponible, le trafic n'est pas coupé (disponibilité d'abord).
  • no-new-privileges ; clé du bouncer dans SOPS.

Supervision

  • Alertes CrowdSecAlertsBurst, CrowdSecDecisionsHigh, CrowdSecNoMetrics : CrowdSec.
  • Dashboard pad-security.

Opérations courantes

# sur le LXC edge
docker compose exec crowdsec cscli decisions list
docker compose exec crowdsec cscli metrics
docker compose exec crowdsec cscli decisions delete --ip <adresse>   # débannir

Pièges connus

  • Un faux positif banni un joueur derrière une IP partagée : vérifier cscli decisions list avant tout.
  • Les journaux Traefik sont retenus 7 jours (access_log_retention_days).
  • AppSec et flux binaires : le WAF AppSec interprète le protobuf de gRPC comme une attaque (403 sur /management.ManagementService/GetServerKey, netbird up en échec). Les routeurs vpn-grpc et vpn-relay passent par edge-vpn-stream : bans IP de la LAPI seulement (crowdsec-bouncer-ip), sans AppSec. Ces 403 en rafale avaient fait bannir l'IP de l'opérateur par http-generic-403-bf (tout le site en 403 pendant 4 h).
  • Lever un ban : docker exec pad-edge-crowdsec-1 cscli decisions delete --ip <IP> sur le LXC edge (cscli decisions list pour voir le scénario en cause).

Documentation officielle

docs.crowdsec.net

Retour à l'index des composants