SEC.01

Le playbook

Le run démarre en lecture seule : les sondes de reconnaissance décident de la suite. Les étapes qui suivent sont adaptées à la distribution et à l'état trouvés — une vraie machine est rarement propre.

  1. 01reconla distribution : apt (Debian/Ubuntu) ou dnf (RHEL/Fedora/Rocky/Alma)
  2. 02reconCrowdSec déjà installé ? version (allowlists ≥ 1.6.8)
  3. 03reconmoteur et bouncer actifs ?
  4. 04reconports 8080 (LAPI) et 6060 (métriques) déjà pris par autre chose que crowdsec → changer listen_uri
  5. 05recondépôt CrowdSec déjà configuré ?
  6. 06reconbackend pare-feu (bouncer nftables ou iptables) ; fail2ban coexiste
  7. 07reconles sessions SSH ouvertes et l’IP d’administration à ne jamais bloquer
  8. 08agirAjouter le dépôt CrowdSecvérif
  9. 09agirInstaller CrowdSecvérif
  10. 10agirDéplacer la LAPI (seulement si le port 8080 était déjà pris)vérif
  11. 11agirVérifier les collections Linux + SSHvérif
  12. 12agirProtéger l’IP d’admin (seulement si une IP est fournie)vérif
  13. 13agirInstaller le bouncer firewallvérif

SEC.02

Ce qu'elle vérifie

Chaque étape embarque sa propre vérification. Le run ne continue que si elle passe, donc ce que la recette annonce comme fait est ce qui est réellement sur le serveur.

  1. 01Ajouter le dépôt CrowdSecVérifié parls /etc/apt/sources.list.d/ /etc/yum.repos.d/ 2>/dev/null | grep -ci crowdsecattendu : au moins 1
  2. 02Installer CrowdSecVérifié parcscli version && systemctl is-active crowdsecattendu : une version puis active
  3. 03Déplacer la LAPI (seulement si le port 8080 était déjà pris)Vérifié parcscli lapi statusattendu : You can successfully interact with Local API
  4. 04Vérifier les collections Linux + SSHVérifié parcscli collections list -o raw | grep -c 'crowdsecurity/sshd'attendu : au moins 1
  5. 05Protéger l’IP d’admin (seulement si une IP est fournie)Vérifié parcscli allowlists inspect servor-adminattendu : l’IP d’admin listée
  6. 06Installer le bouncer firewallVérifié parsystemctl is-active crowdsec-firewall-bouncer && cscli bouncers listattendu : active puis un bouncer firewall listé

SEC.03

Les garde-fous

Les consignes non négociables que le run doit respecter, quoi qu'il trouve sur le serveur.

L’IP d’administration doit être en allowlist AVANT d’installer le bouncer. Jamais curl | sh : télécharge le script puis exécute-le. La LAPI reste sur 127.0.0.1, jamais exposée. Ne touche pas aux règles pare-feu existantes ; si l’IP d’admin est bannie : cscli decisions delete --ip <ip>.

SEC.04

Les variables

Ce que vous choisissez avant de lancer — la recette s'occupe du reste.

NomSignification
${admin_ip}IP d’administration à ne jamais bannir

SEC.05

Comment une recette s'exécute dans Servor

Servor est zero-knowledge : la plateforme ne peut rien exécuter seule. Quand vous lancez cette recette, un run lit la reconnaissance, planifie les étapes et demande votre validation. Chaque commande approuvée est signée par votre navigateur — avec une clé que le serveur ne voit jamais — puis relayée telle quelle à l'agent, qui vérifie la signature localement avant d'exécuter.

recipe — fail2ban_setup150+ in catalogue
security4 étapes · risque faible · idempotentelancer
reconsshd present? ufw active? existing jails?✓
actinstall fail2ban · write default jails✓
actenable service · restart sshd (safe)✓
verifytest ban 60s · jails active · sshd alive✓

recherche par intention — tapez « firewall », obtenez ufw

  • 01Reconnaissance en lecture seule avant tout changement
  • 02Chaque commande signée par votre navigateur, validée par vous
  • 03Chaque étape vérifiée avant de continuer, chaque run conservé dans l'historique

SEC.06

Bouton Deploy on Servor

Vous maintenez CrowdSec ou un projet qui en dépend ? Ajoutez ce bouton à votre README ou à votre site : en un clic, vos utilisateurs l'installent sur leur propre serveur.

Deploy on ServorFond sombre
Deploy on ServorFond clair
[![Deploy on Servor](https://servor.app/badges/deploy-on-servor.svg)](https://servor.app/deploy/install-crowdsec)

SEC.07

Recette vérifiée

Lancez cette recette sur votre serveur

Connectez un serveur, lancez la recette, et validez chaque étape pendant que Servor exécute et vérifie. Plan gratuit, sans carte bancaire.