Русский
Начать

Agent Sandboxes Ключи, которые не попадают внутрь

API-ключи, которых никогда нет в песочнице

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

Как работает подстановка секретов

Секрет задается один раз для рабочего пространства: имя, значение и хосты, для которых он предназначен, например 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 ничего не стоят, на любом тарифе и в пробном периоде.

Читать документацию

Вопросы

Может ли агент прочитать ключ при подстановке секретов?

Нет. Где бы он ни искал — в окружении, в файлах или в памяти, — он находит заглушку. Ключ добавляется к запросу только после того, как запрос покинул песочницу.

Какие заголовки подставляются?

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

Подставляется ли тело запроса?

Пока нет: только заголовки. API, которому ключ нужен в теле или в URL, пока требует ключ в песочнице.

Что получают другие хосты?

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

Сколько стоит секрет?

Ничего. Рабочее пространство хранит до 100 секретов.

По теме

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

Начать пробный период