NetBird¶
Couche : Services LXC · Où : LXC netbird (zone DMZ, 10.20.20.11) + routing peers · Version : serveur 0.81.0, dashboard v2.95.0 (digests épinglés)
À quoi elle sert ici et pourquoi ce choix¶
Les instances de challenges ne sont jamais exposées sur Internet : le joueur se connecte au VPN NetBird, qui route vers l'IP d'instance (zone CHALLENGES) uniquement pour le groupe de son équipe. Le staff passe par NetBird pour atteindre le bastion Warpgate. NetBird est auto-hébergeable, pilotable par API/IaC et s'intègre en OIDC à Authentik.
Où elle tourne et comment elle est déployée¶
Docker Compose dans le LXC netbird (rôle netbird-server) : image combinée netbird-server (management + signal +
relay + STUN) et dashboard. Le STUN UDP 3478 est publié directement. Coturn n'est pas déployé (relay intégré suffisant).
Amorçage en deux passes : déploiement avec le propriétaire local, création d'un jeton d'accès (PAT) dans le dashboard,
ajout dans secrets/netbird.sops.yaml, second passage (connecteur Authentik et groupes JWT). Puis la stack tofu 40-netbird.
Version épinglée¶
pad_images.netbird_server (0.81.0) et pad_images.netbird_dashboard (v2.95.0), pad_images.coturn (4.18.0, non déployé par défaut),
dans infra/ansible/inventories/prod/group_vars/all/versions.yml. Provider tofu : netbirdio/netbird 0.0.10 (page).
Fichiers de configuration dans le dépôt¶
infra/ansible/roles/netbird-server/(compose.yml.j2,config.yaml.j2,dashboard.env.j2,README.md).infra/tofu/stacks/40-netbird/: groupes, networkspad-instancesetpad-bastion, policies, clés d'installation.infra/contracts.yaml: sectionnetbird(groupes, CIDR overlay100.64.0.0/10, préfixectf-team-).secrets/netbird.example.yaml,secrets/netbird-tofu.example.yaml.
Interactions avec les autres briques¶
- Exposé par Traefik edge (gRPC en h2c,
/relay,/api,/oauth2, dashboard). - Authentifie via Authentik (connecteur OIDC, groupes JWT).
- netbird-sync crée par API les ressources et policies d'instance, par équipe.
- Les routing peers donnent accès à la zone CHALLENGES et au LXC bastion. Ils sont enrôlés par le rôle Ansible
netbird-agent(phase 11) : LXC dédiénbrouter(10.20.70.10, zone CHALLENGES, 512 Mo) pour les joueurs, agent sur le LXCwarpgatepour le staff. Choix du LXC plutôt que d'un agent dans le cluster : IP fixe du contrat (PAD_FROM_CIDRS), indépendance du cycle de vie de Kubernetes (le VPN survit à la reconstruction du cluster) et pas de pod privilégié sur les workers. Setup keys : créées par40-netbird, recopiées partask netbird:sync-keysdanssecrets/netbird-agent.sops.yaml.
Sécurité¶
- Deny all par défaut : désactiver la policy « Default » ; seule une policy d'instance ouvre un accès, pour un groupe d'équipe.
- Filtrage des groupes JWT (
jwt_allow_groups= groupes du contrat). no-new-privileges, mémoire bornée, journaux Docker bornés. TLS terminé à l'edge.
Supervision¶
- Métriques sur le port 9090 (job
netbird) ; dashboardpad-security. - Alertes liées :
NetbirdSync*(netbird-sync) ; accès VPN : Incident.
Opérations courantes¶
task ansible:services -- --tags netbird --limit netbird
task tofu:apply-netbird # groupes, networks, policies (PAT requis)
Pièges connus¶
- Le serveur combiné embarque toujours un IdP interne (Dex) : Authentik est ajouté comme connecteur par l'API, pas dans
config.yaml. - Le LXC doit pouvoir joindre
https://<auth>.<domaine>pour la découverte OIDC. - La plage
turn_relay_rangedu contrat reste inutilisée sans Coturn. - Mot de passe du propriétaire local :
config.yamlattend un hash bcrypt (Dex), produit par le template à partir denetbird_server_owner_password; en clair, toute connexion échoue (« Login error », journal :hashedSecret too short).