---
title: "Injection de secrets : des clés hors de la sandbox · Pethost"
description: "Liez une clé d’API à une variable : la sandbox voit un marqueur, et le proxy de sortie met la vraie clé dans les en-têtes HTTPS, vers les hôtes que vous nommez."
---

[Agent Sandboxes](https://pethost.dev/fr/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.

Dans la sandbox, la clé d’API est un marqueur ; le proxy de sortie met la vraie clé dans la requête vers api.anthropic.com, et une requête vers un autre hôte garde le marqueur.

## 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](https://pethost.dev/fr/sandboxes/coding-agents/) 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](https://pethost.dev/fr/sandboxes/egress-allowlist/) 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.

Python

CLI

```
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](https://pethost.dev/fr/docs/sandboxes/secrets-and-egress/) 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](https://pethost.dev/fr/docs/sandboxes/secrets-and-egress/)

## 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

- [Les connexions d’une sandbox passent une barrière qui autorise pypi.org et *.github.com et refuse example.com avec un 403 ; une question DNS pour un nom absent de la liste reçoit REFUSED, et l’UDP ne sort pas. Trafic sortant autorisé, par nom Listez les domaines, wildcards, IP et CIDR qu’une sandbox peut atteindre ; son DNS ne répond à rien d’autre, aucun UDP ne sort, et un changement s’applique aussitôt. Comment ça marche](https://pethost.dev/fr/sandboxes/egress-allowlist/)
- [Un prompt à un agent de code dans une sandbox, et ses appels d’outils qui reviennent en direct : il lit un fichier, le modifie, lance les tests, et le tour se termine avec son nombre de tokens. Agents de code installés Claude Code, Codex et OpenCode tournent dans chaque sandbox en pleine autonomie : un appel donne un prompt à l’un d’eux, un autre diffuse chacun de ses appels d’outils. Comment ça marche](https://pethost.dev/fr/sandboxes/coding-agents/)

## Donnez un ordinateur à votre agent en 0,15 s

[Démarrer l’essai gratuit](https://console.pethost.dev/welcome?kind=sandboxes)

Pethost · Stephan Gomer · NIP 1133096755

Pethost

- [Templates](https://pethost.dev/fr/templates/)
- [À propos](https://pethost.dev/about/)
- [Docs](https://pethost.dev/docs/)
- [Blog](https://pethost.dev/fr/blog/)
- [API](https://pethost.dev/docs/api/)
- [CLI](https://pethost.dev/docs/cli/)
- [Plugin](https://github.com/pethost-dev/plugin)
- [Conditions](https://pethost.dev/terms/)
- [Confidentialité](https://pethost.dev/privacy/)
- [Remboursements](https://pethost.dev/refunds/)
- [support@pethost.dev](mailto:support@pethost.dev)

Bases de données

- [Postgres](https://pethost.dev/fr/postgres/)
- [Valkey](https://pethost.dev/fr/valkey/)

Agent Sandboxes

- [Sandboxes](https://pethost.dev/fr/sandboxes/)
- [Tarifs](https://pethost.dev/fr/sandboxes/#pricing)
- [Docs](https://pethost.dev/fr/docs/sandboxes/)
- [API](https://pethost.dev/docs/sandboxes/api/)

Comparatifs

- [Coolify vs Dokploy vs CapRover vs Dokku](https://pethost.dev/fr/blog/coolify-vs-dokploy-vs-caprover-vs-dokku/)
- [Coolify Cloud vs Dokploy Cloud](https://pethost.dev/fr/blog/coolify-cloud-vs-dokploy-cloud/)
- [Tarifs Railway vs Render vs Fly.io](https://pethost.dev/fr/blog/railway-vs-render-vs-fly-io-pricing/)
- [Hébergement Docker Compose managé](https://pethost.dev/fr/blog/managed-docker-compose-hosting/)

Alternatives

- [Alternatives à Railway](https://pethost.dev/fr/blog/railway-alternatives/)
- [Alternatives à Heroku](https://pethost.dev/fr/blog/heroku-alternatives/)
- [Alternatives à Dokploy](https://pethost.dev/fr/blog/dokploy-alternatives/)
- [Alternatives à Coolify](https://pethost.dev/fr/blog/coolify-alternatives/)
- [Alternatives à Render](https://pethost.dev/fr/blog/render-alternatives/)
- [Alternatives à Sliplane](https://pethost.dev/fr/blog/sliplane-alternatives/)
