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

[Agent Sandboxes](https://pethost.dev/ru/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/ru/sandboxes/coding-agents/) в песочнице входят, не держа у себя ваш ключ: привяжите `ANTHROPIC_API_KEY` или `OPENAI_API_KEY` к секрету. В событиях исходящего трафика песочницы указано, какие секреты подставлены в запросы к каждому хосту.

## Где хранится значение

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

Хосты секрета — это домены или `*.domain`, с необязательным портом, по умолчанию 443. [Список разрешенных адресов](https://pethost.dev/ru/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/ru/docs/sandboxes/secrets-and-egress/).

## Сравнение с другими

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

[Читать документацию](https://pethost.dev/ru/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/ru/sandboxes/egress-allowlist/)
- [Промпт агенту в песочнице и поток его вызовов инструментов: он читает файл, правит его, запускает тесты, и ход заканчивается с состоянием DONE и числом токенов. Агенты для кода уже установлены Claude Code, Codex и OpenCode работают в каждой песочнице с полной автономией: один вызов дает агенту промпт, другой потоком отдает каждый его вызов инструмента. Как это устроено](https://pethost.dev/ru/sandboxes/coding-agents/)

## Дайте агенту компьютер за 0,15 с

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

Pethost · Stephan Gomer · NIP 1133096755

Pethost

- [Шаблоны](https://pethost.dev/ru/templates/)
- [О нас](https://pethost.dev/about/)
- [Документация](https://pethost.dev/docs/)
- [Блог](https://pethost.dev/ru/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/ru/postgres/)
- [Valkey](https://pethost.dev/ru/valkey/)

Agent Sandboxes

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

Сравнения

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

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

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