
Un pare-feu de sortie pour les workloads non fiables.
Les jobs CI, les agents de codage IA et les conteneurs sandboxés peuvent effectuer des requêtes sortantes arbitraires. Une dépendance compromise, une injection de prompt ou une étape de build malveillante peut exfiltrer des secrets, effectuer des appels sortants non autorisés ou ouvrir un reverse shell. La plupart des équipes n'ont aucune visibilité sur ce qui sort de leurs charges de travail, et encore moins de moyen de l'arrêter.
iron-proxy est un proxy de sortie MITM avec un serveur DNS intégré qui se place entre votre charge de travail non fiable et Internet. Il applique le refus par défaut à la frontière du réseau, de sorte que la charge de travail ne peut atteindre que les domaines que vous autorisez explicitement. Les vrais secrets n'entrent jamais dans le sandbox. Les charges de travail utilisent des jetons de proxy, et iron-proxy substitue les vrais identifiants à la sortie, ce qui signifie qu'une charge de travail compromise peut exfiltrer un jeton qui est sans valeur en dehors du proxy.
Binaire unique. Configuration YAML unique.
169.254.169.254,
fd00:ec2::254 et fd20:ce::254) et le loopback sont refusés par défaut ;
remplacez cela via proxy.upstream_deny_cidrs ou
IRON_PROXY_UPSTREAM_DENY_CIDRS.HTTP_PROXY, HTTPS_PROXY ou les paramètres SOCKS5.SET ROLE sur la session
en amont et rejette les tentatives du client de modifier le rôle (SET ROLE,
tout appel set_config, blocs DO, définitions de fonctions non sûres, définitions
qui lient des fonctions comme callbacks telles que CREATE AGGREGATE, etc.) via une
analyse de l'AST SQL. Les corps de routines SQL et PL/pgSQL sont inspectés récursivement ;
le PL/pgSQL dynamique et les langages de routines non pris en charge sont rejetés. En défense
en profondeur, révoquez EXECUTE sur pg_catalog.set_config et les privilèges
TEMPORARY / CREATE non nécessaires du rôle injecté (par exemple de
PUBLIC), en ne réaccordant set_config qu'à l'utilisateur de connexion que le proxy
utilise pour la configuration de session. Le proxy fixe toujours standard_conforming_strings=on
et client_encoding=UTF8 sur la session en amont et rejette les tentatives du client
de les modifier, afin que son analyseur SQL et le serveur s'accordent sur la façon dont
les instructions sont tokenisées. S'associe à
la sécurité au niveau des lignes PostgreSQL pour offrir une isolation des données par locataire lorsque
l'application se connecte en tant qu'utilisateur de compte de service partagé. Nécessite
PgBouncer (si utilisé) pour fonctionner en pool_mode = session — les modes de pool transaction ou
statement relient silencieusement les backends entre les requêtes et
ruineraient la politique. Voir docs.iron.sh pour plus de détails.Conçu pour les pipelines CI, GitHub Actions, les agents IA (Claude Code, Cursor, Codex) et tout environnement où vous exécutez du code que vous ne faites pas entièrement confiance.
Les images Docker sont disponibles sur Docker Hub et les binaires précompilés pour Linux/macOS (amd64/arm64) sont sur GitHub Releases.
Ou compilez depuis les sources :
go build -o iron-proxy ./cmd/iron-proxy
cd examples/docker-compose
docker compose up
Cela démarre iron-proxy et un client de démonstration qui envoie cinq requêtes à travers le proxy. Consultez les journaux pour voir les requêtes autorisées, bloquées et réécrites avec des secrets :
docker compose logs proxy
Chaque requête produit une entrée d'audit JSON structurée :
{
"host": "httpbin.org",
"method": "GET",
"path": "/headers",
"action": "allow",
"status_code": 200,
"duration_ms": 142,
"request_transforms": [
{ "name": "allowlist", "action": "continue" },
{
"name": "secrets",
"action": "continue",
"annotations": { "swapped": [{ "secret": "OPENAI_API_KEY", "locations": ["header:Authorization"] }] }
}
]
}
Les requêtes rejetées incluent un champ rejected_by et sont journalisées au niveau WARN. Voir
Format du journal d'audit pour le schéma complet.
iron-proxy termine le TLS en générant des certificats feuilles à la volée, signés par une CA que vous fournissez. Les conteneurs clients doivent faire confiance à cette CA.
mkdir -p certs
openssl genrsa -out certs/ca.key 4096
openssl req -x509 -new -nodes \
-key certs/ca.key \
-sha256 -days 3650 \
-subj "/CN=iron-proxy CA" \
-addext "basicConstraints=critical,CA:TRUE" \
-addext "keyUsage=critical,keyCertSign" \
-out certs/ca.crt
iron-proxy a besoin d'une IP fixe pour que les conteneurs puissent pointer leur DNS vers lui :
docker network create --subnet=172.20.0.0/24 iron-proxy
Créez un fichier env avec vos secrets (gardez-le hors du contrôle de version) :
echo "OPENAI_API_KEY=sk-real-key" > .env
docker run -d --name iron-proxy \
--network iron-proxy --ip 172.20.0.2 \
-v $(pwd)/proxy.yaml:/etc/iron-proxy/proxy.yaml:ro \
-v $(pwd)/certs/ca.crt:/etc/iron-proxy/ca.crt:ro \
-v $(pwd)/certs/ca.key:/etc/iron-proxy/ca.key:ro \
--env-file .env \
ironsh/iron-proxy:latest -config /etc/iron-proxy/proxy.yaml