Как работает подстановка секретов
Секрет задается один раз для рабочего пространства: имя, значение и хосты, для которых он предназначен, например 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. Запрос к любому другому хосту уходит с неизмененной заглушкой, а больше нигде она ключом не служит.
Так агенты для кода в песочнице входят, не держа у себя ваш ключ: привяжите ANTHROPIC_API_KEY или OPENAI_API_KEY к секрету. В событиях исходящего трафика песочницы указано, какие секреты подставлены в запросы к каждому хосту.
Где хранится значение
Панель хранит значение запечатанным AES-GCM, и ни один вызов его не возвращает. Серверы держат его только в памяти, и только там, где у рабочего пространства есть песочницы. В песочницу оно никогда не попадает, поэтому его нет ни в ее файлах, ни в процессах, и ни шаблон, ни форк не могут его перенести: они переносят заглушку. Задайте новое значение, и работающие песочницы и их форки сразу начнут его использовать. Хосты секрета меняются вместе со значением, тем же вызовом, а удалить секрет нельзя, пока существует песочница, которая его привязывает.
Хосты секрета — это домены или *.domain, с необязательным портом, по умолчанию 443. Список разрешенных адресов песочницы должен разрешать каждое имя секрета, который она привязывает, и панель отклоняет настройки, где это не так. Значение по умолчанию, *, разрешает их все.
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 и дефисов.
- Ключ по-прежнему работает для песочницы. Программа в ней обращается к хостам секрета с вашим ключом, в этом и смысл. Прочитать ключ или отправить его на другой хост она не может.
Все правила — в руководстве по секретам и исходящему трафику.
Сравнение с другими
На 21 ноября 2026 года прокси учетных данных ИИ-сервисов у boat.dev стоил 1 $ за каждый день, пока он включен, плюс 1 $ за 1 000 запросов. E2B подставлял секреты своим прокси исходящего трафика, а Outbound Policy у Modal, которая делает то же для HTTPS-запросов, была в бете. Секреты Pethost ничего не стоят, на любом тарифе и в пробном периоде.