---
title: "Підстановка секретів: ключі поза пісочницею · Pethost"
description: "Прив’яжіть API-ключ до змінної: пісочниця бачить заглушку, а проксі на виході підставляє справжній ключ у заголовки HTTPS-запитів, лише для ваших хостів."
---

[Agent Sandboxes](https://pethost.dev/uk/sandboxes/) Ключі, що не потрапляють усередину

# API-ключі, яких пісочниця ніколи не тримає

Агентові потрібен ваш API-ключ, щоб звертатися до моделі, але нічому в пісочниці не треба бачити сам ключ. З підстановкою секретів пісочниця тримає заглушку, а проксі вихідного трафіку підставляє справжній ключ у кожен запит дорогою назовні, лише для хостів, які ви вкажете.

Усередині пісочниці API-ключ — заглушка; проксі вихідного трафіку підставляє справжній ключ у запит до api.anthropic.com, а запит до іншого хоста лишається із заглушкою.

## Як працює підстановка секретів

Ви задаєте секрет один раз для робочого простору: назву, значення й хости, для яких він призначений, як у `set_secret("anthropic", value=…, hosts=["api.anthropic.com"])`. Пісочниця прив’язує його до змінної середовища, `EnvVar(name="ANTHROPIC_API_KEY", secret="anthropic")`. Усередині пісочниці змінна містить заглушку, що починається з `phs_`, і програми читають її так само, як читали б ключ.

Коли запит іде до одного з хостів секрету, проксі вихідного трафіку завершує його TLS за допомогою центру сертифікації цього сервера, якому пісочниця довіряє: Node, Python, curl і git налаштовано на нього. Проксі замінює заглушку значенням у кожному заголовку запиту, зокрема всередині облікових даних `Authorization: Basic`, тож працюють і Bearer-токени, і облікові дані Basic, і `x-api-key`. Потім він надсилає запит далі до хоста через TLS. Запит до будь-якого іншого хоста несе заглушку без змін, а вона більше ніде не є ключем.

Так [агенти для коду](https://pethost.dev/uk/sandboxes/coding-agents/) в пісочниці входять, не тримаючи вашого ключа: прив’яжіть `ANTHROPIC_API_KEY` або `OPENAI_API_KEY` до секрету. Події вихідного трафіку пісочниці називають секрети, підставлені в запити до кожного хоста.

## Де лежить значення

Панель зберігає значення, зашифроване AES-GCM, і жоден виклик його не повертає. Сервери тримають його лише в пам’яті, там, де в робочого простору є пісочниці. Воно ніколи не потрапляє в пісочницю, тож його немає в жодному її файлі чи процесі, і жоден шаблон чи копія пісочниці не може його перенести: вони переносять заглушку. Задайте нове значення, і пісочниці, що працюють, та їхні копії одразу використовують його. Хости секрету змінюються разом зі значенням, тим самим викликом, а секрет не можна видалити, поки існує пісочниця, що його прив’язує.

Хости секрету — це домени або `*.domain`, з необов’язковим портом, типово 443. [Список дозволених адрес](https://pethost.dev/uk/sandboxes/egress-allowlist/) пісочниці має дозволяти кожне ім’я секрету, який вона прив’язує, і панель відхиляє налаштування, що цього не роблять. Типове значення, `*`, дозволяє їх усі.

Python

CLI

```
import os

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

sandboxes = Sandboxes()  # читає 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_… : заглушка
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: проксі надіслав справжній ключ
```

```
printenv ANTHROPIC_API_KEY | pethost sandbox secret set anthropic --host api.anthropic.com   # значення зі stdin
pethost sandbox new --name agent --env ANTHROPIC_API_KEY=secret:anthropic
pethost sandbox run agent -- 'echo $ANTHROPIC_API_KEY'                                       # phs_…
```

## Що це покриває, а що ні

- **Лише заголовки запитів.** Ключ, який API приймає в тілі запиту чи в URL, поки не підставляється.
- **HTTPS через довіру пісочниці.** Між пісочницею й проксі хост секрету говорить по HTTP/1.1, тож клієнт, що пропонує лише HTTP/2, не пройде рукостискання. Програму з власним сховищем сертифікатів треба налаштувати на системне.
- **До 100 секретів на робочий простір,** кожен із назвою з a-z, 0-9 і дефісів.
- **Для пісочниці ключ однаково працює.** Програма в ній звертається до хостів секрету з вашим ключем, і в цьому весь сенс. Вона не може прочитати ключ чи надіслати його на інший хост.

[Посібник із секретів і вихідного трафіку](https://pethost.dev/uk/docs/sandboxes/secrets-and-egress/) описує кожне правило.

## Порівняння з іншими

21 листопада 2026 року проксі облікових даних ШІ в boat.dev коштував 1 $ за кожен день, коли він увімкнений, плюс 1 $ за 1 000 запитів. E2B підставляв секрети своїм проксі вихідного трафіку, а Outbound Policy у Modal, що робить те саме для HTTPS-запитів, була в беті. Секрети Pethost нічого не коштують, у кожному тарифі й у пробному періоді.

[Читати документацію](https://pethost.dev/uk/docs/sandboxes/secrets-and-egress/)

## Запитання

**Чи може агент прочитати ключ, якщо його підставляє проксі?**

Ні. Хоч би де він шукав, у середовищі, у файлах чи в пам’яті, він знайде заглушку. Ключ додається до запиту лише після того, як запит покинув пісочницю.

**Які заголовки замінюються?**

Значення кожного заголовка запиту, зокрема `Authorization`, і всередині облікових даних Basic теж.

**Чи замінюються тіла запитів?**

Поки ні: лише заголовки. API, що приймає ключ у тілі чи в URL, поки потребує ключа в пісочниці.

**Що отримують інші хости?**

Заглушку, без змін.

**Скільки коштує секрет?**

Нічого. Робочий простір тримає до 100 секретів.

## Дивіться також

- [З’єднання пісочниці проходять крізь шлагбаум, що пропускає pypi.org і *.github.com і відхиляє example.com із 403; DNS-запит на ім’я поза списком отримує REFUSED, а UDP не виходить. Вихід лише туди, куди дозволено Перелічіть домени, wildcard-імена, IP і CIDR, до яких може звертатися пісочниця; її DNS більше нічого не відповідає, UDP не виходить, а зміна діє одразу. Як це працює](https://pethost.dev/uk/sandboxes/egress-allowlist/)
- [Промпт агентові в пісочниці, і його виклики інструментів транслюються назад: він читає файл, редагує його, запускає тести, і хід завершується станом DONE і кількістю токенів. Агенти для коду вже встановлені Claude Code, Codex і OpenCode працюють у кожній пісочниці з повною автономією: один виклик дає агентові промпт, інший транслює кожен його виклик інструмента. Як це працює](https://pethost.dev/uk/sandboxes/coding-agents/)

## Дайте агентові комп’ютер за 0,15 с

[Почати пробний період](https://console.pethost.dev/welcome?kind=sandboxes)

Pethost · Stephan Gomer · NIP 1133096755

Pethost

- [Шаблони](https://pethost.dev/uk/templates/)
- [Про нас](https://pethost.dev/about/)
- [Документація](https://pethost.dev/docs/)
- [Блог](https://pethost.dev/uk/blog/)
- [API](https://pethost.dev/docs/api/)
- [CLI](https://pethost.dev/docs/cli/)
- [Плагін](https://github.com/pethost-dev/plugin)
- [Умови](https://pethost.dev/terms/)
- [Конфіденційність](https://pethost.dev/privacy/)
- [Повернення коштів](https://pethost.dev/refunds/)
- [support@pethost.dev](mailto:support@pethost.dev)

Бази даних

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

Agent Sandboxes

- [Пісочниці](https://pethost.dev/uk/sandboxes/)
- [Тарифи](https://pethost.dev/uk/sandboxes/#pricing)
- [Документація](https://pethost.dev/uk/docs/sandboxes/)
- [API](https://pethost.dev/docs/sandboxes/api/)

Порівняння

- [Coolify vs Dokploy vs CapRover vs Dokku](https://pethost.dev/uk/blog/coolify-vs-dokploy-vs-caprover-vs-dokku/)
- [Coolify Cloud vs Dokploy Cloud](https://pethost.dev/uk/blog/coolify-cloud-vs-dokploy-cloud/)
- [Ціни Railway vs Render vs Fly.io](https://pethost.dev/uk/blog/railway-vs-render-vs-fly-io-pricing/)
- [Керований хостинг Docker Compose](https://pethost.dev/uk/blog/managed-docker-compose-hosting/)

Альтернативи

- [Альтернативи Railway](https://pethost.dev/uk/blog/railway-alternatives/)
- [Альтернативи Heroku](https://pethost.dev/uk/blog/heroku-alternatives/)
- [Альтернативи Dokploy](https://pethost.dev/uk/blog/dokploy-alternatives/)
- [Альтернативи Coolify](https://pethost.dev/uk/blog/coolify-alternatives/)
- [Альтернативи Render](https://pethost.dev/uk/blog/render-alternatives/)
- [Альтернативи Sliplane](https://pethost.dev/uk/blog/sliplane-alternatives/)
