---
title: "Secret Injection: API-Keys nie in der Sandbox · Pethost"
description: "Binde einen API-Key an eine Variable: Die Sandbox sieht einen Platzhalter, und der Egress-Proxy setzt den echten Key in HTTPS-Header ein, nur für deine Hosts."
---

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

In der Sandbox ist der API-Key ein Platzhalter; der Egress-Proxy setzt den echten Key in den Request an api.anthropic.com ein, und ein Request an einen anderen Host behält den Platzhalter.

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

Python

CLI

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

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

- [Die Verbindungen einer Sandbox passieren ein Tor, das pypi.org und *.github.com erlaubt und example.com mit 403 ablehnt; eine DNS-Frage nach einem Namen, der nicht auf der Liste steht, bekommt REFUSED, und UDP geht nicht hinaus. Egress nur zu erlaubten Namen Führ die Domains, Wildcards, IPs und CIDRs auf, die eine Sandbox erreichen darf; ihr DNS beantwortet nichts anderes, kein UDP geht hinaus, und eine Änderung gilt sofort. So funktioniert es](https://pethost.dev/de/sandboxes/egress-allowlist/)
- [Ein Prompt an einen Coding-Agenten in einer Sandbox, und seine Tool-Aufrufe streamen zurück: Er liest eine Datei, bearbeitet sie, führt die Tests aus, und der Turn endet fertig mit seiner Token-Zahl. Coding-Agenten, schon installiert Claude Code, Codex und OpenCode laufen in jeder Sandbox mit voller Autonomie: Ein Aufruf gibt einem einen Prompt, ein anderer streamt jeden Tool-Aufruf, den er macht. So funktioniert es](https://pethost.dev/de/sandboxes/coding-agents/)

## Gib deinem Agenten einen Computer in 0,15 s

[Kostenlose Testphase starten](https://console.pethost.dev/welcome?kind=sandboxes)

Pethost · Stephan Gomer · NIP 1133096755

Pethost

- [Vorlagen](https://pethost.dev/de/templates/)
- [Über uns](https://pethost.dev/about/)
- [Doku](https://pethost.dev/docs/)
- [Blog](https://pethost.dev/de/blog/)
- [API](https://pethost.dev/docs/api/)
- [CLI](https://pethost.dev/docs/cli/)
- [Plugin](https://github.com/pethost-dev/plugin)
- [AGB](https://pethost.dev/terms/)
- [Datenschutz](https://pethost.dev/privacy/)
- [Erstattung](https://pethost.dev/refunds/)
- [support@pethost.dev](mailto:support@pethost.dev)

Datenbanken

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

Agent Sandboxes

- [Sandboxes](https://pethost.dev/de/sandboxes/)
- [Preise](https://pethost.dev/de/sandboxes/#pricing)
- [Doku](https://pethost.dev/de/docs/sandboxes/)
- [API](https://pethost.dev/docs/sandboxes/api/)

Vergleiche

- [Coolify vs Dokploy vs CapRover vs Dokku](https://pethost.dev/de/blog/coolify-vs-dokploy-vs-caprover-vs-dokku/)
- [Coolify Cloud vs Dokploy Cloud](https://pethost.dev/de/blog/coolify-cloud-vs-dokploy-cloud/)
- [Railway vs Render vs Fly.io Preise](https://pethost.dev/de/blog/railway-vs-render-vs-fly-io-pricing/)
- [Managed Hosting für Docker Compose](https://pethost.dev/de/blog/managed-docker-compose-hosting/)

Alternativen

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