Aller au contenu

Pourquoi la sortie réseau passe par un proxy à allowlist

Cette page explique pourquoi l'environnement de développement Kirexo n'a plus de route vers l'extérieur, et pourquoi sa seule sortie est un proxy Squid en CONNECT-only qui n'ouvre un tunnel que vers des domaines listés par leur nom. Pour la recette d'ouverture d'un domaine, voir Ouvrir un domaine dans l'allowlist du proxy sortant. Pour le diagnostic, voir Diagnostiquer un blocage réseau sortant.

Collision de vocabulaire : « firewall »

Kirexo emploie le mot firewall dans deux sens sans rapport. Ici, il s'agit du filtrage réseau sortant de l'environnement de développement. Les firewalls du composant Symfony Security — ceux qui décident qui est authentifié sur quelle partie du site — sont un tout autre sujet, traité dans Architecture des firewalls. Le namespace Castor firewall: désigne, lui, le filtrage réseau.

Le problème : le geôlier vivait dans la cellule

Le premier dispositif d'isolation réseau était un pare-feu iptables posé à l'intérieur du conteneur php, au démarrage, par un script de 505 lignes. Il flushait les règles, posait une policy OUTPUT DROP, redirigeait le DNS vers un dnsmasq local, et laissait ce dnsmasq alimenter au fil des résolutions un ipset d'IP autorisées auquel une règle match-set donnait le droit de sortir.

Le mécanisme fonctionnait, mais il portait une contradiction structurelle : pour poser ces règles, le conteneur devait recevoir la capacité CAP_NET_ADMIN. Or la capacité qui permet de poser un pare-feu est exactement celle qui permet de le défaire. Un processus root du conteneur — un post-install Composer hostile, un binaire arbitraire lancé depuis Bash — n'avait qu'à exécuter iptables -F pour rendre au conteneur une sortie réseau complète. Le pare-feu était une règle, et les règles se retirent.

S'y ajoutaient deux faiblesses moins spectaculaires mais quotidiennes :

  • Le filtre portait sur l'IP, pas sur le nom. Un domaine non listé qui partageait une IP de CDN avec un domaine autorisé passait sans le savoir. Le filtre était donc plus large que sa configuration ne le laissait croire, et personne ne pouvait dire de combien.
  • Il ne couvrait que le conteneur php. Les autres services de la stack — docs en particulier — sortaient librement, sans que ce soit un choix.

internal: true retire la route, pas une règle

Le réseau de la stack est déclaré internal: true dans compose.override.yaml. Ce n'est pas un pare-feu plus strict, c'est un changement de nature :

  • Docker crée le bridge sans NAT — aucune règle MASQUERADE en POSTROUTING pour la subnet ;
  • il insère deux DROP dans DOCKER-ISOLATION-STAGE-1, l'un sur l'entrée, l'autre sur la sortie du bridge.

Ces règles vivent dans le namespace réseau de l'hôte. Un processus root du conteneur ne peut pas les flusher : il ne les voit même pas. Et il n'y a rien à contourner à l'intérieur — il n'y a simplement pas de chemin. La garantie ne repose plus sur ce que le conteneur veut bien s'appliquer à lui-même.

C'est ce qui permet de retirer du conteneur CAP_NET_ADMIN, CAP_NET_RAW, le sudoers, sudo lui-même, iptables, ipset et dnsmasq — et de rendre tenables les invariants de confinement C3 (pas de route), C4 (whitelists non modifiables depuis l'intérieur) et C6 (pas de sudo). Cf. Vérifier l'effet, jamais la configuration.

Les deux réseaux du conteneur doivent être internal

Le conteneur php est attaché à deux réseaux : default (la stack du worktree) et kirexo-egress (le lien vers le proxy mutualisé). Les deux sont internal — le premier par sa déclaration dans compose.override.yaml, le second par la sienne dans compose.shared.yaml.

C'est le point de vigilance permanent de tout le dispositif : un seul réseau non-internal attaché à php rendrait une route par défaut et annulerait la garantie entière, sans aucun signal — l'application continuerait de fonctionner, les tests passeraient, seule la sonde de confinement le verrait.

Le proxy : CONNECT-only, donc pas de CA à injecter

La seule machine qui voit les deux mondes est le conteneur egress-proxy : d'un côté le réseau interne partagé kirexo-egress, de l'autre le bridge NAT de son propre projet Compose. C'est la seule sortie de l'environnement de développement, atteinte par les variables HTTPS_PROXY / HTTP_PROXY posées sur php et docs.

Squid y tourne en CONNECT-only : il n'accepte que la méthode CONNECT, uniquement vers le port 443, uniquement vers un domaine de l'allowlist. Tout le reste est refusé — le HTTP en clair comme le cache manager. Le fichier de politique est infra/egress/squid.conf.

Conséquence importante : Squid ne termine pas le TLS. Il ouvre un tunnel TCP opaque et ne voit rien du contenu. Le chiffrement reste de bout en bout entre le client et le domaine cible, et aucune autorité de certification n'est à installer dans les conteneurs. C'est ce qui distingue cette approche d'un proxy d'inspection : on filtre la destination, pas le contenu — et on n'introduit pas une CA capable de déchiffrer tout le trafic de développement.

C'est aussi pourquoi les variables de proxy pointent une URL en http:// : on parle en clair au proxy, sur le réseau interne, pour lui demander un tunnel. Le https du site visé n'est jamais rompu.

Filtrer par nom change la nature du filtre

Avec l'ancien ipset, le client choisissait l'IP de destination et le pare-feu la comparait à une liste alimentée par les résolutions DNS. Avec le proxy, le client donne un nom ; c'est Squid qui le résout, depuis son propre réseau, et qui refuse si le nom n'est pas dans l'allowlist.

Trois conséquences :

  1. Un CONNECT menteur n'aboutit nulle part. Annoncer CONNECT packagist.org:443 en visant une autre machine ne sert à rien : c'est Squid qui résout le nom annoncé.
  2. Les faux positifs CDN disparaissent — et le filtre se resserre. Un domaine absent de l'allowlist est refusé même s'il partage une IP avec un domaine autorisé. La tolérance de fait qui existait avant n'existe plus. Concrètement, plusieurs domaines de la plateforme Anthropic passaient jusque-là par collision d'IP et ont dû être ajoutés explicitement à la baseline.
  3. La course DNS/ipset n'existe plus. L'ancien mécanisme dépendait de l'ordre entre la résolution et l'ouverture de la socket ; ce couplage a disparu.

Le filtrage s'applique maintenant à tous les services rattachés au réseau interne, pas seulement à php. Le service docs en a fait les frais : le plugin social de Material for MkDocs télécharge ses polices au démarrage, et sans fonts.google.com ni fonts.gstatic.com dans l'allowlist, mkdocs serve ne sert plus rien. Ce n'est pas une régression du proxy : c'est un service qui n'était pas filtré avant et qui l'est devenu.

Le point de tête, seul détail sémantique à connaître

L'ACL dstdomain de Squid n'a pas la même sémantique que le préfixe /domain/ de dnsmasq :

Entrée dans le fichier d'allowlist Ce qu'elle matche
symfony.com symfony.com et rien d'autre
.symfony.com symfony.com et ux.symfony.com, live.symfony.com, …

Le /domain/ de dnsmasq couvrait le domaine et ses sous-domaines. Pour conserver ce comportement, le générateur infra/egress/render-allowlist.sh émet systématiquement la forme .<domaine>. Émettre la forme nue casserait ux.symfony.com sans le moindre signal, jusqu'à ce qu'un composer install échoue sans raison visible.

Corollaire : on n'écrit jamais le point de tête dans les fichiers de whitelist. baseline-domains.txt et whitelist.local.txt contiennent des FQDN nus ; c'est le générateur qui ajoute le point, et lui seul.

Un second piège s'est révélé en test. Le générateur dédoublonne en écartant tout domaine déjà couvert par un parent, et il garde le premier rencontré. Sur un flux non trié, ux.symfony.com listé avant symfony.com ferait survivre le sous-domaine et jetterait le parent : l'accès s'en trouverait restreint au lieu d'élargi. D'où le tri par profondeur, parents d'abord, avant tout dédoublonnage.

La résolution DNS externe échoue, par conception

Depuis le conteneur, 127.0.0.11 (le resolver Docker embarqué) continue de résoudre les noms de services de la stack (database, redis, …) et les alias du réseau partagé (egress-proxy). La résolution des noms externes, elle, peut échouer — et c'est sans conséquence : dès qu'un HTTPS_PROXY est configuré, le client ne résout rien localement, il envoie CONNECT packagist.org:443 au proxy.

À retenir pour tout diagnostic : un getent hosts packagist.org qui échoue depuis php est attendu, ce n'est pas la cause d'un blocage.

Un proxy mutualisé, une seule allowlist

egress-proxy n'est pas déclaré dans le compose du worktree mais dans compose.shared.yaml, projet Compose kirexo-shared. Un seul conteneur, une seule whitelist, un seul rechargement pour N worktrees.

Ce choix a des conséquences visibles au quotidien :

  • castor docker:down ne l'arrête pas. Il appartient à un autre projet Compose et survit à l'arrêt de la stack applicative.
  • Aucun depends_on ne pointe vers lui : un depends_on vers un service d'un autre projet Compose fait échouer le up. L'ordre de démarrage est donc porté par l'outillage, pas par Compose.
  • Le réseau kirexo-egress est déclaré external côté worktree : il doit exister avant le up. Sur un poste où le projet mutualisé n'a jamais démarré, toute commande qui crée les réseaux du projet échoue avec network kirexo-egress declared as external, but could not be found. C'est le message d'erreur le plus fréquent du dispositif, et sa cause est toujours la même.
  • Les fichiers de whitelist sont ceux du dépôt principal, quel que soit le checkout d'où part la commande — cf. la section suivante.

Pour éviter que chaque point d'entrée recopie la séquence de préalables (espace Claude, whitelist locale, rendu de l'allowlist, démarrage du projet mutualisé), elle est factorisée dans un helper unique de castor.php, shared_stack_up(), appelé par docker:up, docs:build, wt:up et image:refresh. Un docker compose up lancé à la main, lui, ne traverse aucune cible Castor : personne ne remonte alors le projet mutualisé, et la stack revient soit en échec de démarrage (réseau externe introuvable), soit sans aucune sortie réseau. Sur ce chemin, le préalable est à jouer à la main — cf. la recette de diagnostic.

Une seule whitelist, celle du dépôt principal

Un proxy unique applique une politique unique. L'outillage, lui, a longtemps laissé croire l'inverse : chaque checkout porte ses propres infra/firewall/baseline-domains.txt et infra/firewall/whitelist.local.txt, et les cibles firewall:* lisaient celles du répertoire courant. Un rechargement lancé depuis un worktree rendait donc l'allowlist de ce worktree — refermant au passage des domaines ouverts ailleurs — tandis qu'un rechargement lancé ailleurs pouvait n'avoir aucun effet sur ce que le conteneur du proxy lisait réellement, ses montages étant figés sur son répertoire fondateur.

Le symptôme mesuré tient en trois faits contradictoires sur le même domaine : release-assets.githubusercontent.com ajouté, l'allowlist rendue sans erreur, castor firewall:status le listant — et CONNECT tunnel failed, response 403 sur ce même domaine.

La décision D13 supprime l'écart plutôt que de le signaler : les cibles firewall:* lisent, écrivent et rendent dans le dépôt principal, quel que soit le checkout d'où elles sont lancées. castor firewall:whitelist-add écrit donc là où le proxy lit, et l'allowlist rendue est toujours celle qui sera appliquée. Le raisonnement sur l'ancrage lui-même — pourquoi le dépôt principal, et ce que Compose fige — est dans Un singleton est parenté sur le répertoire qui l'a créé.

La contrepartie est assumée : la whitelist locale n'est plus « la mienne sur ce ticket », c'est celle du poste. Elle était déjà commune de fait, puisqu'un seul proxy l'appliquait ; elle devient commune en droit.

Le fichier infra/firewall/whitelist.local.txt d'un worktree continue pourtant d'exister, et castor wt:up continue de le créer depuis son modèle .dist. La raison n'a plus rien à voir avec l'allowlist : c'est le substrat du bind :ro (./infra/firewall:/app/infra/firewall:ro, compose.override.yaml) sur lequel repose l'invariant C4. Un fichier manquant y ferait rendre « substrat manquant » à la sonde de confinement. Il est là pour être monté, plus pour être lu.

L'ancrage s'arrête à la porte du conteneur

Le chemin du dépôt principal est un chemin de l'hôte, et ce dépôt n'est pas monté dans la cellule d'un worktree. Depuis un conteneur, l'ancrage est donc inopérant par construction : le checkout courant, /app, est tout ce qui existe. Ce que cela implique dépend de la cellule d'où l'on regarde :

  • cellule du dépôt principal — /app est le dépôt principal : rien ne diverge, ce qui est lu est ce que le proxy applique ;
  • cellule d'un worktree — la whitelist lue est celle du worktree, c'est-à-dire un fichier gitignoré que plus personne n'alimente depuis que whitelist-add écrit dans le dépôt principal.

C'est précisément la cellule depuis laquelle un agent vient chercher la vérité quand plus rien ne sort. D'où le parti pris : castor firewall:status affiche systématiquement le dossier réellement lu, et avertit dans le second cas — un tableau qui n'annonce pas d'où il vient se lit comme la vérité, quelle que soit la cellule. castor doctor passe par le même chemin sans le dire encore ; c'est une dette assumée, pas un oubli.

Il reste une limite que l'ancrage ne lève pas : aucune de ces cibles ne lit ce que Squid applique. Elles lisent les fichiers depuis lesquels l'allowlist est rendue. Un conteneur créé avant cette décision, encore parenté sur un worktree, applique toujours autre chose — et seules les sondes réseau le mesurent. Le format exact de la sortie est dans castor firewall:status.

Le revers : une sortie unique est un point de défaillance unique

Un seul conteneur pour N worktrees, c'est une seule allowlist à tenir — et une seule chose à perdre. La disparition d'egress-proxy ne dégrade pas la sortie réseau, elle la supprime, simultanément pour tous les worktrees : plus de composer, plus de npm, plus de Claude Code. C'est arrivé trois fois, pour des causes sans rapport entre elles — le cliquet du fichier pid décrit plus bas, une suppression du conteneur venue de l'extérieur du dépôt, puis la destruction du worktree depuis lequel le proxy avait été créé, qui a coûté 1029 redémarrages sur environ 17 heures.

Le vrai défaut n'était pas la panne : c'était son silence. castor confinement:check rendait PASS dans les deux premiers cas, et le seul symptôme était une erreur d'API opaque côté Claude Code. La raison tient à la question que posait la sonde. Les deux premiers volets de C3 demandent la politique est-elle appliquée ? — un domaine hors allowlist est-il refusé, une route directe subsiste-t-elle. Un domaine autorisé injoignable était classé « le réseau ou l'allowlist sont HS : à voir, pas à bloquer », ce qui est un jugement raisonnable pour une allowlist périmée. Mais aucune sonde ne posait la question antérieure : reste-t-il quelqu'un pour appliquer la politique ?

C'est la symétrie exacte du mode de panne fondateur du contrat de confinement : un confinement inactif y était indiscernable d'un confinement actif ; ici, une panne totale devenait indiscernable d'un fonctionnement nominal. Dans les deux cas, ce qui manque n'est pas une règle mais une mesure d'effet — et la réponse est la même : un troisième volet qui interroge le proxy lui-même, et rend ✗ KO quand il ne répond plus alors que la sortie ne passe plus.

Deux conséquences assumées :

  • Le gate de session se ferme sur une panne d'infrastructure locale, pas sur une violation de sécurité. C'est inhabituel, et défendable : sans sortie réseau, l'agent ne peut de toute façon rien faire, et un message qui nomme la cause et le remède vaut mieux que vingt minutes passées sur une erreur d'API. Cf. Modèle de menace et confinement.
  • Le remède reste hôte-only. Le conteneur constate l'absence du proxy ; il ne peut ni la corriger — C2 lui interdit le socket Docker — ni même la distinguer d'un redémarrage en boucle. C'est le prix d'une garantie qui ne repose plus sur ce que le conteneur s'applique à lui-même.

Ce dispositif rend la panne visible et réparable en un geste ; il ne la rend pas impossible. Aucune cible Castor ne supprime egress-proxy, mais un docker container prune lancé par ailleurs restera toujours possible, et prétendre l'empêcher serait une garantie que le projet ne peut pas tenir.

Avertir à l'ouverture, sans jamais bloquer

Le gate de session ne pouvait pas rattraper le pire des trois épisodes. Le 17 septembre 2026, le conteneur php d'un worktree était Up 18 hours (healthy) pendant qu'egress-proxy était mort : wt:claude sondait la stack par docker compose exec -T php true, cette sonde réussissait, donc aucun wt:up n'était déclenché — et avec lui, aucun passage par le préalable qui remonte le projet mutualisé. Le proxy n'était jamais regardé. La session Claude Code s'ouvrait, puis échouait sur « impossible de se connecter à l'API », un symptôme qui ne désigne rien de ce qui s'est passé. Le gate SessionStart, lui, s'exécute dans une session qui n'arrive pas à démarrer : ce qu'il aurait eu à dire n'atteignait pas la personne qui venait de taper la commande. Coût : environ 17 heures, et 1029 redémarrages du proxy sans que rien ne le remonte nulle part.

La leçon n'est pas qu'il manquait une sonde, mais qu'elle n'était pas posée à la bonne question. exec -T php true répond à « puis-je entrer dans le conteneur ? ». C'est exactement ce qu'il faut savoir pour décider d'un wt:up, et cela ne suffit pas à une commande qui ouvre un espace de travail : celle-là promet autre chose, « ce que j'ouvre pourra-t-il travailler ? ». Le remède devait donc être délivré par l'hôte, avant le lancement — le seul moment où l'écran appartient encore à la commande, et le seul endroit d'où le proxy est réparable.

Deux choix suivent, et aucun n'est évident.

La sonde part du conteneur, bien que la cible soit hôte-only. http_proxy=http://egress-proxy:3128 est une variable du conteneur, et egress-proxy n'est résolvable que sur le réseau Docker. La même commande lancée depuis l'hôte emprunterait sa route normale et réussirait toujours, proxy mort inclus : on mesurerait l'hôte en croyant mesurer la session. Une sonde qui se trompe de point d'exécution ne donne pas un résultat imprécis, elle donne un résultat systématiquement faux — et rassurant, ce qui est le mode de panne qu'on cherchait à supprimer.

L'avertissement ne bloque rien. C'est l'arbitrage inverse de celui du gate de confinement, et pour une raison qui lui est propre : une stack morte ne doit jamais rendre la session impossible à ouvrir, sinon un worktree en panne devient une panne qu'on ne peut plus réparer de l'intérieur. wt:shell est précisément la commande par laquelle on entre réparer ; lui interdire l'ouverture au motif que la sortie réseau est tombée fermerait la porte du garage sur la voiture en panne. Un shell sans sortie réseau reste utile ; une session d'agent, beaucoup moins — mais la différence est de degré, pas de nature, et elle ne justifiait pas de priver wt:shell de la mesure. Le prix à payer est que l'avertissement peut être ignoré : c'est acceptable, parce qu'il nomme la cause et porte le geste, là où l'erreur d'API ne faisait ni l'un ni l'autre.

Une exception, symétrique de la règle : sur le repli en conteneur jetable de wt:shell, rien n'est sondé. Ce conteneur tourne --no-deps, sans services liés ; l'absence de sortie réseau y est attendue, et la signaler reviendrait à présenter comme une panne ce que la commande vient d'annoncer comme normal. Le comportement exact des deux cibles est en référence.

Une cible du dépôt pouvait en revanche le laisser inutilisable sans le supprimer : castor wt:destroy, quand le worktree détruit était celui depuis lequel le proxy avait été créé. Ses bind mounts, figés en chemins absolus à la création du conteneur, pointaient alors sur un répertoire disparu. La cible défait ce parentage avant de retirer le worktree, et le proxy n'est désormais plus créé que depuis le dépôt principal, qu'aucune destruction de worktree n'emporte : le raisonnement est dans Un singleton est parenté sur le répertoire qui l'a créé, les gestes de réparation a posteriori — encore utiles sur un conteneur hérité — dans Diagnostiquer un blocage réseau sortant.

Deux pannes révélatrices

La mise en service a produit deux incidents qui n'ont rien en commun sur le fond, mais tout dans leur forme : le composant en cause n'était jamais celui que le symptôme désignait. Les gestes de dépannage sont dans Diagnostiquer un blocage réseau sortant ; ce qui suit est le raisonnement.

Le fichier pid de Squid, quand PID 1 se prend pour lui-même

L'image du proxy lance Squid avec -N (infra/egress/Dockerfile) : le master tourne en avant-plan, sans processus enfant, pour que Docker suive le bon process. Conséquence secondaire, longtemps sans importance : Squid est le PID 1 du conteneur, et le pid qu'il inscrit dans son fichier pid vaut donc 1.

Sur un arrêt propre, Squid retire ce fichier. Sur une mort brutale — SIGKILL, OOM killer — aucun handler ne s'exécute, rien n'est retiré. Le fichier restait alors dans la couche writable du conteneur, que docker start ne recrée pas. Au redémarrage, le nouveau Squid lisait ce fichier, y trouvait 1, vérifiait que ce process existait — c'était lui-même — et sortait sur FATAL: Squid is already running.

Le résultat est un cliquet : une fois armé, il ne se désarme pas. restart: unless-stopped relance un process qui refuse aussitôt de démarrer ; autoheal fait de même ; castor docker:up non plus, parce qu'il fait un start du conteneur existant et non un recreate. Et comme le proxy est mutualisé, la panne coupe la sortie réseau de tous les worktrees simultanément. Constaté : 66 redémarrages successifs, et un castor docker:up qui échoue sur container kirexo-shared-egress-proxy-1 is unhealthy. Reproductible en cinq secondes avec un docker kill suivi d'un docker start.

Le correctif est posé à deux endroits, et la redondance est le sujet plutôt qu'un excès de zèle. Côté déploiement, compose.shared.yaml monte /tmp en tmpfs : le fichier pid redevient éphémère par construction, un tmpfs étant remonté vide à chaque démarrage du conteneur. Côté image, l'ENTRYPOINT fait un rm -f du fichier pid avant d'exec Squid. Le tmpfs suffirait au chemin nominal ; il ne couvre que les consommateurs qui le déclarent. Un docker run de diagnostic sur kirexo-egress-local, ou un autre fichier Compose, réarmerait le cliquet à l'identique — une image qui ne se défend que dans un seul fichier Compose ne se défend pas.

L'alternative évidente, pid_filename none, a été écartée : elle supprime le symptôme en supprimant le fichier, mais deux mécanismes en dépendent. Le squid -k reconfigure que castor firewall:reload (castor/firewall.php) exécute après avoir régénéré l'allowlist lit ce fichier pour trouver le process à signaler — c'est ce qui permet d'appliquer une nouvelle politique sans couper les tunnels en cours ; le HEALTHCHECK de l'image fait de même via squid -k check. Guérir la panne en aveuglant le rechargement et la sonde de santé du composant qui filtre toute la sortie réseau aurait été un mauvais échange.

no_proxy est une convention, pas un standard

Étendre le proxy à tous les services du réseau interne a mis docs derrière l'ancre x-proxy-env, et donc derrière http_proxy. Son healthcheck visait http://127.0.0.1:8000 — une adresse explicitement listée dans no_proxy, donc a priori hors de portée du proxy. Il partait pourtant vers egress-proxy, qui refusait la requête faute d'être un CONNECT (TCP_DENIED/403).

L'explication est que no_proxy n'a jamais été normalisé. Chaque client l'implémente à sa façon, et certains ne l'implémentent pas du tout : le wget des images Alpine est celui de BusyBox, qui honore http_proxy mais ignore purement et simplement no_proxy. Il faut lui passer -Y off pour couper le proxy.

Le mode de panne qui en découle est particulièrement trompeur. Le service était sain — mkdocs répondait — mais son healthcheck le déclarait mort ; autoheal, qui existe précisément pour redémarrer les conteneurs unhealthy, appliquait consciencieusement la sanction. Deux redémarrages en 90 s, en boucle. Les fenêtres d'indisponibilité de la documentation qui en résultaient étaient jusque-là mises sur le compte de castor docs:build, qui n'y était pour rien.

D'où une règle générale, valable pour tout service qu'un lot futur brancherait sur le proxy : ajouter <<: *proxy-env à un service dont le healthcheck utilise wget impose d'ajouter -Y off. curl honore no_proxy et échappe au problème. Le healthcheck de mailer illustre la nuance : même forme, sans -Y off, et parfaitement sain — parce que ce service ne reçoit pas les variables de proxy.

Ces deux incidents partagent la même leçon que le bind de fichier plus bas : sur un dispositif qui filtre toute la sortie réseau, les pannes ne se signalent pas là où elles sont. Elles se signalent chez le voisin — mkdocs, docs:build, un composer install — et c'est ce décalage qui coûte le plus cher à diagnostiquer.

Le double verrou sur la whitelist

Si l'agent qui tourne dans le conteneur pouvait ajouter un domaine à la whitelist et recharger le proxy, il pourrait ouvrir sa propre sortie réseau : la garantie serait cosmétique. Deux verrous indépendants ferment ce chemin :

  1. Montage en lecture seule. infra/firewall/, infra/lib/ et infra/egress/ sont bind-montés :ro dans le conteneur. Une écriture y échoue au niveau du noyau — pas au niveau d'une règle applicative que l'on peut contourner. C'est le substrat de l'invariant C4.
  2. Rechargement hôte-only. castor firewall:reload, firewall:whitelist-add et firewall:whitelist-remove refusent de tourner depuis le conteneur. Même en supposant le premier verrou franchi, le conteneur ne peut pas faire appliquer un changement : c'est un docker compose exec sur un projet auquel il n'a pas accès.

Ce qui reste disponible depuis l'intérieur, volontairement, c'est la lecture : castor firewall:status affiche la whitelist et sonde la sortie réelle. L'agent peut donc comprendre un blocage et demander une ouverture — ce qui est exactement le comportement souhaité, plutôt que de le pousser à chercher un contournement. C'est aussi ce qui impose à cette cible d'annoncer d'où elle lit : depuis la cellule d'un worktree, la liste affichée n'est pas celle que le proxy applique (plus haut).

Le montage porte sur des dossiers, jamais sur des fichiers. Un bind de fichier attache un inode : tout éditeur qui écrit un temporaire puis le renomme (et tout sed -i) crée un nouvel inode côté hôte, et le conteneur reste sur l'ancien contenu, sans aucun signal. Le piège s'est manifesté deux fois dans le projet — sur le jeton GitLab, puis sur squid.conf lui-même, où un squid -k reconfigure rechargeait l'ancienne politique en annonçant « Allowlist régénérée ». Sur le composant qui filtre toute la sortie réseau, c'est le pire mode de panne possible.

Options écartées

Option Pourquoi écartée
Garder le pare-feu iptables interne Exige CAP_NET_ADMIN, donc la capacité de le défaire. Filtre par IP (faux positifs CDN). Ne couvre que le conteneur qui l'héberge.
tinyproxy Filtre par expression régulière sur l'URL, pas par ACL de domaine ; rechargement non atomique.
mitmproxy Termine le TLS, donc exige d'injecter une CA dans tous les conteneurs — et cette CA peut déchiffrer l'intégralité du trafic de développement. Trop cher pour un filtre de destination.
Une image Squid tierce Il n'existe pas d'image officielle Docker. Le seul rock maintenu n'est publié qu'en risque edge et est « distroless-like » (pas de shell utilisable pour -k reconfigure). Le projet a déjà tranché ce cas de figure — cf. Supply chain et signatures : on assemble une image Alpine minimale, la confiance étant épinglée sur la base par digest.

Ce que ce dispositif ne protège pas

Une allowlist est un filtre de destination, jamais un filtre de contenu. anthropic.com est autorisé parce que Claude Code en a besoin ; un agent compromis peut donc exfiltrer du contenu dans le corps d'une requête vers un domaine légitimement autorisé, sans rien violer. Le même raisonnement vaut pour gitlab.com ou sentry.io.

Le passage au filtrage par nom ferme en revanche le contournement par DNS-over-HTTPS qui menaçait l'ancien mécanisme : le client ne choisit plus l'IP de destination, donc résoudre un nom par un canal parallèle ne lui donne plus rien. Reste le cas où un domaine autorisé hébergerait lui-même un endpoint DoH — argument de plus pour préférer des FQDN précis à des suffixes génériques de CDN.

Le modèle de menace complet, et ce que la vérification de confinement prouve exactement, sont traités dans Modèle de menace et confinement.

Voir aussi