Comment marche l’injection de secrets
Vous définissez un secret une fois pour l’espace de travail : un nom, une valeur et les hôtes auxquels il est destiné, comme dans set_secret("anthropic", value=…, hosts=["api.anthropic.com"]). Une sandbox le lie à une variable d’environnement, EnvVar(name="ANTHROPIC_API_KEY", secret="anthropic"). Dans la sandbox, la variable contient un marqueur qui commence par phs_, et les programmes le lisent comme ils liraient la clé.
Quand une requête part vers l’un des hôtes du secret, le proxy de sortie termine son TLS avec une autorité de certification propre à ce serveur, à laquelle la sandbox fait confiance : Node, Python, curl et git sont configurés pour elle. Le proxy remplace le marqueur par la valeur dans chaque en-tête de la requête, y compris dans les identifiants Authorization: Basic : les tokens Bearer, les identifiants Basic et x-api-key marchent tous. Puis il transmet la requête à l’hôte en TLS. Une requête vers tout autre hôte transporte le marqueur tel quel, qui n’est une clé nulle part ailleurs.
C’est ainsi que les agents de code d’une sandbox se connectent sans détenir votre clé : liez ANTHROPIC_API_KEY ou OPENAI_API_KEY à un secret. Les événements de trafic sortant de la sandbox nomment les secrets substitués dans les requêtes vers chaque hôte.
Où vit la valeur
La console garde la valeur scellée avec AES-GCM, et aucun appel ne la renvoie. Les serveurs ne la gardent qu’en mémoire, là où l’espace de travail a des sandboxes. Elle n’entre jamais dans une sandbox : elle n’est dans aucun de ses fichiers ni de ses processus, et aucun template ni aucune duplication ne peut l’emporter, ils emportent le marqueur. Définissez une nouvelle valeur, et les sandboxes actives et leurs copies l’utilisent aussitôt. Les hôtes d’un secret changent avec sa valeur, dans le même appel, et un secret ne peut pas être supprimé tant qu’une sandbox qui le lie existe.
Les hôtes d’un secret sont des domaines ou des *.domain, avec un port facultatif, 443 par défaut. La liste d’autorisation du trafic sortant de la sandbox doit autoriser chaque nom d’un secret qu’elle lie, et la console refuse les paramètres qui ne le font pas. La valeur par défaut, *, les autorise tous.
import os
from pethost.sandboxes import EnvVar, Environment, SandboxSettings, Sandboxes
sandboxes = Sandboxes() # lit PETHOST_TOKEN
sandboxes.set_secret("anthropic", value=os.environ["ANTHROPIC_API_KEY"], hosts=["api.anthropic.com"])
variable = EnvVar(name="ANTHROPIC_API_KEY", secret="anthropic")
sandbox = sandboxes.create_sandbox(settings=SandboxSettings(environment=Environment(variables=[variable])))
print(sandboxes.run_command(sandbox.sandbox_id, command="echo $ANTHROPIC_API_KEY").stdout)
# phs_… : le marqueur
models = (
"curl -s -o /dev/null -w '%{http_code}' https://api.anthropic.com/v1/models"
" -H \"x-api-key: $ANTHROPIC_API_KEY\" -H 'anthropic-version: 2023-06-01'"
)
print(sandboxes.run_command(sandbox.sandbox_id, command=models).stdout)
# 200 : le proxy a envoyé la vraie cléprintenv ANTHROPIC_API_KEY | pethost sandbox secret set anthropic --host api.anthropic.com # la valeur, depuis stdin
pethost sandbox new --name agent --env ANTHROPIC_API_KEY=secret:anthropic
pethost sandbox run agent -- 'echo $ANTHROPIC_API_KEY' # phs_…Ce que cela couvre, et ce que cela ne couvre pas
- Les en-têtes de requête seulement. Une clé qu’une API prend dans le corps d’une requête ou dans son URL n’est pas encore substituée.
- HTTPS via la confiance de la sandbox. Entre la sandbox et le proxy, l’hôte d’un secret parle HTTP/1.1 : un client qui ne propose que HTTP/2 échoue à la négociation. Un programme qui a son propre magasin de certificats doit être pointé vers celui du système.
- Jusqu’à 100 secrets par espace de travail, chacun nommé avec a-z, 0-9 et des tirets.
- La clé marche toujours pour la sandbox. Un programme qui y tourne appelle les hôtes du secret avec votre clé, c’est tout l’intérêt. Il ne peut pas lire la clé, ni l’envoyer à un autre hôte.
Le guide des secrets et du trafic sortant détaille chaque règle.
Face aux autres
Le 21 novembre 2026, le proxy d’identifiants d’IA de boat.dev coûtait 1 $ par jour d’activation, plus 1 $ pour 1 000 requêtes. E2B injectait des secrets avec son proxy de sortie, et l’Outbound Policy de Modal, qui fait de même pour les requêtes HTTPS, était en bêta. Les secrets de Pethost ne coûtent rien, dans chaque offre et dans l’essai gratuit.