Warpgate¶
Couche : Services LXC · Où : LXC warpgate (zone BASTION, 10.20.30.10) · Version : 0.29.2 (image épinglée par digest)
À quoi elle sert ici et pourquoi ce choix¶
Point d'accès unique du personnel aux interfaces internes (SSH des LXC, de l'hôte et d'OPNsense, UI Proxmox et OPNsense).
Il centralise authentification SSO (groupe infra-admins via Authentik) et journalisation des sessions. La version 0.29 a
été retenue parce que seule cette lignée permet de mapper les groupes OIDC vers les rôles d'administration.
Où elle tourne et comment elle est déployée¶
Docker Compose dans le LXC warpgate (rôle warpgate), données persistantes dans data/ (SQLite, clés SSH, certificat auto-signé,
warpgate.yaml). Ports 2222 (SSH) et 8888 (HTTPS). Rôles et cibles : stack tofu 50-warpgate.
Version épinglée¶
pad_images.warpgate (0.29.2) dans infra/ansible/inventories/prod/group_vars/all/versions.yml ; provider tofu warp-tech/warpgate 1.2.0
(page).
Fichiers de configuration dans le dépôt¶
infra/ansible/roles/warpgate/(compose.yml.j2,warpgate.yaml.j2,README.md).infra/tofu/stacks/50-warpgate/(roles.tf,targets.tf).secrets/warpgate.example.yaml(compte local de secours),secrets/warpgate-tofu.example.yaml(jeton d'API).
Interactions avec les autres briques¶
- Joignable par le staff via NetBird (policy
staff-vers-bastion), exposé sousbastion.<domaine>. - Atteint les autres zones selon M6 de la matrice (SSH, HTTPS, API Kubernetes, API Talos).
- Un agent NetBird tourne sur ce LXC comme routing peer du réseau
pad-bastion(rôlenetbird-agent, phase 11 ;/dev/net/tunajouté par le rôlelxc-tun).
Sécurité¶
- Conteneur
read_only,cap_drop: ALL,no-new-privileges, mémoire bornée. - SSO Authentik ; utilisateurs créés à la première connexion ; compte local
admin(mot de passe SOPS) en secours. - Zone isolée : seul le staff NetBird y accède.
Supervision¶
Pas d'exporter Prometheus natif : métriques conteneur via Alloy (cAdvisor) et sonde HTTP d'Uptime Kuma. Panne d'un service : Cible injoignable, Docker dans un LXC.
Opérations courantes¶
Pièges connus¶
- OIDC ne couvre que l'interface web ; en SSH, la politique par défaut des utilisateurs SSO est
ssh: [web](lien d'authentification à ouvrir). unattended-setupne s'exécute qu'une fois ; ensuite Ansible gèrewarpgate.yamlet écrase les réglages SSO de l'UI.- Les nœuds Talos n'ont pas de SSH : utiliser
talosctldepuis le bastion. - Retour au formulaire de connexion sans erreur : Warpgate n'accepte son cookie de session que sur
external_host(bastion.<domaine>) ; ouvrir l'UI par son IP échoue silencieusement (journal :Session cookie rejected: request host ... is not authorized). Passer par le nom (DNS NetBird, ou/etc/hostsavant la phase 11). - Stack tofu
50-warpgate: API jointe par défaut en direct (https://<IP du LXC>:8888, certificat auto-signé,insecure_skip_verifyàtrue) depuis le poste opérateur ;warpgate_api_urlpour passer par le nom via NetBird.