---
title: "Wstrzykiwanie sekretów: klucze API poza sandboxem · Pethost"
description: "Powiąż klucz API ze zmienną: sandbox widzi znacznik, a proxy ruchu wychodzącego wstawia prawdziwy klucz do nagłówków żądań HTTPS, tylko do wskazanych hostów."
---

[Agent Sandboxes](https://pethost.dev/pl/sandboxes/) Klucze, które nie wchodzą do sandboxa

# Klucze API, których sandbox nigdy nie trzyma

Agent potrzebuje twojego klucza API, żeby wywołać swój model, a nic w sandboxie nie musi widzieć samego klucza. Dzięki wstrzykiwaniu sekretów sandbox trzyma znacznik, a proxy ruchu wychodzącego wstawia prawdziwy klucz do każdego wychodzącego żądania, tylko do wskazanych przez ciebie hostów.

W sandboxie klucz API to znacznik; proxy ruchu wychodzącego wstawia prawdziwy klucz do żądania do api.anthropic.com, a żądanie do innego hosta zachowuje znacznik.

## Jak działa wstrzykiwanie sekretów

Sekret ustawiasz raz dla przestrzeni roboczej: nazwę, wartość i hosty, dla których jest, jak w `set_secret("anthropic", value=…, hosts=["api.anthropic.com"])`. Sandbox wiąże go ze zmienną środowiskową, `EnvVar(name="ANTHROPIC_API_KEY", secret="anthropic")`. W sandboxie zmienna zawiera znacznik zaczynający się od `phs_`, a programy czytają go tak, jak czytałyby klucz.

Gdy żądanie wychodzi do jednego z hostów sekretu, proxy ruchu wychodzącego kończy jego TLS certyfikatem urzędu certyfikacji tego serwera, któremu sandbox ufa: Node, Python, curl i git są na niego ustawione. Proxy zamienia znacznik na wartość w każdym nagłówku żądania, także wewnątrz danych `Authorization: Basic`, więc działają tokeny Bearer, dane Basic i `x-api-key`. Potem wysyła żądanie dalej do hosta przez TLS. Żądanie do każdego innego hosta niesie niezmieniony znacznik, który nigdzie indziej nie jest kluczem.

Tak [agenci kodujący](https://pethost.dev/pl/sandboxes/coding-agents/) w sandboxie logują się bez trzymania twojego klucza: powiąż `ANTHROPIC_API_KEY` albo `OPENAI_API_KEY` z sekretem. Zdarzenia ruchu wychodzącego sandboxa podają, które sekrety podstawiono w żądaniach do każdego hosta.

## Gdzie jest wartość

Panel trzyma wartość zaszyfrowaną AES-GCM i żadne wywołanie jej nie zwraca. Serwery trzymają ją tylko w pamięci, tam, gdzie przestrzeń robocza ma sandboxy. Nigdy nie trafia do sandboxa, więc nie ma jej w żadnym jego pliku ani procesie, a żaden szablon ani fork nie może jej przenieść: przenoszą znacznik. Ustaw nową wartość, a działające sandboxy i ich forki od razu jej używają. Hosty sekretu zmieniają się razem z jego wartością, w tym samym wywołaniu, a sekretu nie da się usunąć, dopóki istnieje sandbox, który go wiąże.

Hosty sekretu to domeny albo `*.domain`, z opcjonalnym portem, domyślnie 443. [Lista dozwolonych dla ruchu wychodzącego](https://pethost.dev/pl/sandboxes/egress-allowlist/) sandboxa musi dopuszczać każdą nazwę sekretu, który wiąże, a panel odrzuca ustawienia, które tego nie robią. Domyślne `*` dopuszcza wszystkie.

Python

CLI

```
import os

from pethost.sandboxes import EnvVar, Environment, SandboxSettings, Sandboxes

sandboxes = Sandboxes()  # czyta 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_… : znacznik
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: proxy wysłało prawdziwy klucz
```

```
printenv ANTHROPIC_API_KEY | pethost sandbox secret set anthropic --host api.anthropic.com   # wartość ze stdin
pethost sandbox new --name agent --env ANTHROPIC_API_KEY=secret:anthropic
pethost sandbox run agent -- 'echo $ANTHROPIC_API_KEY'                                       # phs_…
```

## Co obejmuje, a czego nie

- **Tylko nagłówki żądań.** Klucz, który API przyjmuje w treści żądania albo w adresie, nie jest jeszcze podstawiany.
- **HTTPS przez zaufanie sandboxa.** Między sandboxem a proxy host sekretu mówi HTTP/1.1, więc klient, który oferuje tylko HTTP/2, nie przejdzie negocjacji. Program z własnym magazynem certyfikatów trzeba ustawić na systemowy.
- **Do 100 sekretów na przestrzeń roboczą,** każdy nazwany znakami a-z, 0-9 i myślnikami.
- **Klucz dalej działa dla sandboxa.** Program w nim wywołuje hosty sekretu z twoim kluczem, i o to chodzi. Nie może odczytać klucza ani wysłać go do innego hosta.

[Przewodnik po sekretach i ruchu wychodzącym](https://pethost.dev/pl/docs/sandboxes/secrets-and-egress/) ma każdą regułę.

## Jak to wypada na tle innych

21 listopada 2026 proxy danych logowania AI w boat.dev kosztowało 1 $ za każdy dzień, w którym jest włączone, plus 1 $ za 1000 żądań. E2B wstrzykiwało sekrety swoim proxy ruchu wychodzącego, a Outbound Policy Modala, która robi to samo dla żądań HTTPS, była w becie. Sekrety w Pethost nic nie kosztują, w każdym planie i w okresie próbnym.

[Przeczytaj dokumentację](https://pethost.dev/pl/docs/sandboxes/secrets-and-egress/)

## Pytania

**Czy przy wstrzykiwaniu sekretów agent może odczytać klucz?**

Nie. Gdziekolwiek zajrzy, w środowisku, w plikach czy w pamięci, znajdzie znacznik. Klucz jest dodawany do żądania dopiero wtedy, gdy żądanie opuści sandbox.

**Które nagłówki są podstawiane?**

Wartość każdego nagłówka żądania, łącznie z `Authorization`, także wewnątrz danych Basic.

**Czy podstawiana jest treść żądań?**

Jeszcze nie: tylko nagłówki. API, które przyjmuje klucz w treści albo w adresie, na razie wymaga klucza w sandboxie.

**Co dostają inne hosty?**

Niezmieniony znacznik.

**Ile kosztuje sekret?**

Nic. Przestrzeń robocza trzyma ich do 100.

## Powiązane

- [Połączenia sandboxa przechodzą przez bramkę, która przepuszcza pypi.org i *.github.com, a example.com odrzuca kodem 403; pytanie DNS o nazwę spoza listy dostaje REFUSED, a UDP nie wychodzi. Ruch wychodzący tylko tam, gdzie pozwolisz Wypisz domeny, wieloznaczniki, IP i CIDR, do których sandbox może dotrzeć; jego DNS nie zna innych nazw, UDP nie wychodzi, a zmiana działa od razu. Jak to działa](https://pethost.dev/pl/sandboxes/egress-allowlist/)
- [Prompt do agenta kodującego w sandboxie i jego wywołania narzędzi wracające na żywo: czyta plik, edytuje go, uruchamia testy, a tura kończy się jako gotowa z liczbą tokenów. Agenci kodujący, zainstalowani Claude Code, Codex i OpenCode działają w każdym sandboxie z pełną autonomią: jedno wywołanie daje agentowi prompt, drugie przesyła na żywo każde jego wywołanie narzędzia. Jak to działa](https://pethost.dev/pl/sandboxes/coding-agents/)

## Daj swojemu agentowi komputer w 0,15 s

[Zacznij darmowy okres próbny](https://console.pethost.dev/welcome?kind=sandboxes)

Pethost · Stephan Gomer · NIP 1133096755

Pethost

- [Szablony](https://pethost.dev/pl/templates/)
- [O nas](https://pethost.dev/about/)
- [Dokumentacja](https://pethost.dev/docs/)
- [Blog](https://pethost.dev/pl/blog/)
- [API](https://pethost.dev/docs/api/)
- [CLI](https://pethost.dev/docs/cli/)
- [Plugin](https://github.com/pethost-dev/plugin)
- [Regulamin](https://pethost.dev/terms/)
- [Prywatność](https://pethost.dev/privacy/)
- [Zwroty](https://pethost.dev/refunds/)
- [support@pethost.dev](mailto:support@pethost.dev)

Bazy danych

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

Agent Sandboxes

- [Sandboxy](https://pethost.dev/pl/sandboxes/)
- [Cennik](https://pethost.dev/pl/sandboxes/#pricing)
- [Dokumentacja](https://pethost.dev/pl/docs/sandboxes/)
- [API](https://pethost.dev/docs/sandboxes/api/)

Porównania

- [Coolify vs Dokploy vs CapRover vs Dokku](https://pethost.dev/pl/blog/coolify-vs-dokploy-vs-caprover-vs-dokku/)
- [Coolify Cloud vs Dokploy Cloud](https://pethost.dev/pl/blog/coolify-cloud-vs-dokploy-cloud/)
- [Cennik Railway vs Render vs Fly.io](https://pethost.dev/pl/blog/railway-vs-render-vs-fly-io-pricing/)
- [Zarządzany hosting Docker Compose](https://pethost.dev/pl/blog/managed-docker-compose-hosting/)

Alternatywy

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