Rolle `crowdsec`
Quelle: pkr-lab/pkr-lab-docs/capulus/capulus-ansible/rollen/crowdsec.md
Rolle crowdsec
Brute-Force-Schutz für SSH und Traefik-Logs.
| Läuft gegen | controlplane-0 |
| Tags | crowdsec, security |
| Quellcode | roles/crowdsec |
Variablen
Defaults aus defaults/main.yml. Überschreiben in group_vars/ oder host_vars/.
| Variable | Default | Bedeutung |
|---|---|---|
crowdsec_repo_key_fingerprint |
<verdeckt> |
– |
crowdsec_collections |
[crowdsecurity/sshd, crowdsecurity/linux, crowdsecurity/traefik] |
– |
crowdsec_traefik_log_glob |
/var/log/containers/*traefik*.log |
– |
Ablauf
- gnupg für die schlüsselbehandlung installieren
- verzeichnis für apt-keyrings anlegen
- prüfen ob der keyring des crowdsec-repositorys existiert
- schlüssel des crowdsec-repositorys herunterladen
- temporäres gnupg-home anlegen
- schlüssel des crowdsec-repositorys in einen keyring umwandeln
- heruntergeladenen schlüssel des crowdsec-repositorys entfernen
- fingerprint des crowdsec-keyrings lesen
- temporäres gnupg-home entfernen
- fingerprint des crowdsec-repository-schlüssels prüfen
- apt-repository für crowdsec eintragen
- paket crowdsec installieren
- dienst crowdsec aktivieren und starten
- warten bis die lokale crowdsec-api verbindungen annimmt
- paket crowdsec-firewall-bouncer installieren (iptables-backend, passend zu ufw)
- dienst crowdsec-firewall-bouncer aktivieren und starten
- crowdsec-collections installieren
- sicherstellen dass das verzeichnis acquisition.d existiert
- acquisition-konfiguration für ssh-logs ablegen (journald)
- acquisition-konfiguration für traefik-logs ablegen
- cidr-whitelist für lan und tailscale ablegen
- handler sofort ausführen, damit acquisition und whitelist vor der prüfung wirken
- prüfen dass der firewall-bouncer bei der lokalen api registriert ist
- warnen wenn kein bouncer registriert ist
Handler
- crowdsec neu starten
Templates
acquis-ssh.yaml.j2acquis-traefik.yaml.j2whitelist.yaml.j2
Fehlersuche
Allgemeines Vorgehen bei Rollen: ansible-playbook <playbook>.yml --limit <host> --tags <tag> --check --diff -vvv zeigt Änderungen ohne sie anzuwenden (make <ziel>-check bei den Playbooks mit Dry-Run). Die Rollenübersicht mit Make-Zielen: Rollen.
sudo systemctl status crowdsec crowdsec-firewall-bouncer
sudo cscli metrics
sudo cscli decisions list
sudo cscli bouncers list
sudo cscli alerts list
| Symptom | Ursache | Lösung |
|---|---|---|
Playbook bricht ab: Der Fingerprint von …crowdsec…keyring.gpg weicht ab |
Repository-Schlüssel stimmt nicht mit crowdsec_repo_key_fingerprint überein |
Schlüssel nicht vertrauen, Ursache klären, Fingerprint nur nach Prüfung anpassen |
| Warnung „no bouncer registered“ | Firewall-Bouncer nicht an der lokalen API registriert | sudo cscli bouncers list, Bouncer-Dienst neu starten |
| Eigene IP wird gesperrt | Whitelist (local-whitelist.yaml) enthält das Netz nicht |
sudo cscli decisions delete --ip <ip>, Whitelist anpassen (CrowdSec) |
| Keine Erkennungen für SSH oder Traefik | Acquisition-Dateien (/etc/crowdsec/acquis.d/ssh.yaml, traefik.yaml) greifen nicht |
sudo cscli metrics, Log-Quellen prüfen |
Allgemeine Fehlersuche: Host-Troubleshooting, zentrale Fehlersuche.