Deutsch
Loslegen

Agent Sandboxes Keys, die nie hineinkommen

API-Keys, die die Sandbox nie hält

Ein Agent braucht deinen API-Key, um sein Modell aufzurufen, und nichts in der Sandbox muss den Key selbst sehen. Mit Secret Injection hält die Sandbox einen Platzhalter, und der Egress-Proxy setzt den echten Key auf dem Weg hinaus in jeden Request ein, nur für die Hosts, die du nennst.

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 geschickt
printenv 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.

Doku lesen

Fragen

Kann der Agent bei Secret Injection den Key lesen?

Nein. Wo immer er nachsieht, in der Umgebung, in Dateien oder im RAM, findet er den Platzhalter. Der Key wird erst in einen Request eingesetzt, nachdem der Request die Sandbox verlassen hat.

Welche Header werden ersetzt?

Der Wert jedes Request-Headers, Authorization eingeschlossen, und auch in Basic-Zugangsdaten.

Werden Request-Bodys ersetzt?

Noch nicht: nur Header. Eine API, die ihren Key in einem Body oder einer URL erwartet, braucht den Key vorerst in der Sandbox.

Was bekommen andere Hosts?

Den Platzhalter, unverändert.

Was kostet ein Secret?

Nichts. Ein Workspace hält bis zu 100 davon.

Verwandte Funktionen

Gib deinem Agenten einen Computer in 0,15 s

Kostenlose Testphase starten