Enrôler le premier serveur

L'enrôlement est la façon dont un serveur rejoint le parc — et dont il reçoit dès lors ses règles et leurs mises à jour, sans que personne ne copie de fichiers. L'agent reste le même programme : il lit, décide et bannit toujours localement ; seule sa configuration vient désormais du contrôleur.

Sur le contrôleur : un jeton d'enrôlement#

Dans la console, le panneau Join a server crée un jeton ; au terminal :

sudo -u shieldlist shieldlist-controller token      # un usage, valable un jour

Le jeton porte l'empreinte du certificat du contrôleur : l'agent qui le présente épingle le contrôleur à partir de là.

Sur le serveur : l'agent#

Même dépôt, autre paquet :

curl -fsSL https://repo.lrob.net/apt/shieldlist/shieldlist.gpg -o /usr/share/keyrings/shieldlist.gpg
echo "deb [signed-by=/usr/share/keyrings/shieldlist.gpg] https://repo.lrob.net/apt/shieldlist stable main" > /etc/apt/sources.list.d/shieldlist.list
apt update && apt install shieldlist-agent

stable porte les versions publiées. Il existe aussi une suite dev avec nos builds de développement : en avance sur les versions publiées, et faits pour casser.

Dites-lui où est le contrôleur, puis enrôlez :

mode: enrolled
controller: https://console.example.net:17453

shieldlist-agent -t && systemctl restart shieldlist-agent
shield enrol <jeton>

En quelques secondes la machine apparaît sous Servers dans la console, avec la révision de configuration qu'elle détient. shield status sur le serveur affiche controller_sync.

Il démarre en détection seule#

Un agent neuf note ce que chaque règle aurait fait et ne touche à rien. Laissez-le une journée, lisez la console — les coups, les bans potentiels, les adresses — et seulement ensuite armez-le : l'interrupteur du serveur dans la console, ou state: on dans sa déclaration. Rien ne s'arme en silence.

Ce qui reste sur le serveur#

agent.yaml, ses secrets, ses exemptions locales et ses hooks. Revenir en arrière, c'est mode: local et un redémarrage : les fichiers locaux n'ont jamais été touchés. Tout sur la conversation — ce qui est poussé, ce qui remonte, ce qui se passe quand le contrôleur est injoignable — est dans Agent → Enrolment.