Wie Secret Injection funktioniert
Du legst ein Secret einmal für den Workspace an: einen Namen, einen Wert und die Hosts, für die es gilt, wie in set_secret("anthropic", value=…, hosts=["api.anthropic.com"]). Eine Sandbox bindet es an eine Umgebungsvariable, EnvVar(name="ANTHROPIC_API_KEY", secret="anthropic"). In der Sandbox enthält die Variable einen Platzhalter, der mit phs_ beginnt, und Programme lesen ihn, wie sie den Key lesen würden.
Geht ein Request an einen der Hosts des Secrets hinaus, terminiert der Egress-Proxy sein TLS mit einer Zertifizierungsstelle dieses Servers, der die Sandbox vertraut: Node, Python, curl und git sind auf sie eingestellt. Der Proxy ersetzt den Platzhalter in jedem Request-Header durch den Wert, auch in Zugangsdaten für Authorization: Basic, sodass Bearer-Tokens, Basic-Zugangsdaten und x-api-key alle funktionieren. Dann schickt er den Request über TLS an den Host weiter. Ein Request an jeden anderen Host trägt den Platzhalter unverändert, und der ist nirgendwo sonst ein Key.
So melden sich die Coding-Agenten in einer Sandbox an, ohne deinen Key zu halten: Binde ANTHROPIC_API_KEY oder OPENAI_API_KEY an ein Secret. Die Egress-Events der Sandbox nennen die Secrets, die in die Requests an jeden Host eingesetzt wurden.
Wo der Wert liegt
Das Panel hält den Wert mit AES-GCM versiegelt, und kein Aufruf gibt ihn zurück. Server halten ihn nur im RAM, und nur dort, wo der Workspace Sandboxes hat. Er kommt nie in eine Sandbox, steht also in keiner ihrer Dateien und keinem ihrer Prozesse, und keine Vorlage und kein Fork von ihr kann ihn mitnehmen: Sie nehmen den Platzhalter mit. Setz einen neuen Wert, und laufende Sandboxes und ihre Forks nutzen ihn sofort. Die Hosts eines Secrets ändern sich mit seinem Wert, im selben Aufruf, und ein Secret lässt sich nicht löschen, solange eine Sandbox existiert, die es bindet.
Die Hosts eines Secrets sind Domains oder *.domain, mit optionalem Port, standardmäßig 443. Die Egress-Allowlist der Sandbox muss jeden Namen eines Secrets erlauben, das sie bindet, und das Panel lehnt Einstellungen ab, die das nicht tun. Der Standard, *, erlaubt sie alle.
import os
from pethost.sandboxes import EnvVar, Environment, SandboxSettings, Sandboxes
sandboxes = Sandboxes() # liest 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_… : der Platzhalter
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: Der Proxy hat den echten Key geschicktprintenv ANTHROPIC_API_KEY | pethost sandbox secret set anthropic --host api.anthropic.com # der Wert aus stdin
pethost sandbox new --name agent --env ANTHROPIC_API_KEY=secret:anthropic
pethost sandbox run agent -- 'echo $ANTHROPIC_API_KEY' # phs_…Was es abdeckt und was nicht
- Nur Request-Header. Ein Key, den eine API im Body eines Requests oder in ihrer URL erwartet, wird noch nicht eingesetzt.
- HTTPS über das Vertrauen der Sandbox. Zwischen Sandbox und Proxy spricht der Host eines Secrets HTTP/1.1, also scheitert ein Client, der nur HTTP/2 anbietet, am Handshake. Ein Programm mit eigenem Zertifikatsspeicher muss auf den des Systems eingestellt werden.
- Bis zu 100 Secrets pro Workspace, jedes benannt mit a-z, 0-9 und Bindestrichen.
- Der Key funktioniert für die Sandbox trotzdem. Ein Programm darin ruft die Hosts des Secrets mit deinem Key auf, und genau darum geht es. Es kann den Key nicht lesen und nicht an einen anderen Host schicken.
Die Anleitung zu Secrets und Egress hat jede Regel.
Im Vergleich
Am 21. November 2026 kostete der Proxy für KI-Zugangsdaten von boat.dev 1 $ für jeden Tag, an dem er an ist, plus 1 $ pro 1.000 Requests. E2B setzte Secrets mit seinem Egress-Proxy ein, und die Outbound Policy von Modal, die dasselbe für HTTPS-Requests tut, war in Beta. Die Secrets von Pethost kosten nichts, in jedem Tarif und in der Testphase.