Français
Commencer

Agent Sandboxes Des clés qui n’entrent jamais

Des clés d’API que la sandbox ne détient jamais

Un agent a besoin de votre clé d’API pour appeler son modèle, et rien dans la sandbox n’a besoin de voir la clé elle-même. Avec l’injection de secrets, la sandbox détient un marqueur, et le proxy de sortie met la vraie clé dans chaque requête au moment où elle sort, seulement vers les hôtes que vous nommez.

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.

Lire la documentation

Questions

Avec l’injection de secrets, l’agent peut-il lire la clé ?

Non. Où qu’il regarde, dans l’environnement, dans les fichiers ou en mémoire, il trouve le marqueur. La clé n’est ajoutée à une requête qu’une fois la requête sortie de la sandbox.

Quels en-têtes sont substitués ?

La valeur de chaque en-tête de requête, Authorization compris, et aussi à l’intérieur des identifiants Basic.

Le corps des requêtes est-il substitué ?

Pas encore : seulement les en-têtes. Une API qui prend sa clé dans un corps ou une URL a besoin de la clé dans la sandbox pour l’instant.

Que reçoivent les autres hôtes ?

Le marqueur, tel quel.

Que coûte un secret ?

Rien. Un espace de travail en garde jusqu’à 100.

Voir aussi

Donnez un ordinateur à votre agent en 0,15 s

Démarrer l’essai gratuit