Como funciona a injeção de segredos
Você define um segredo uma vez para o espaço de trabalho: um nome, um valor e os hosts a que ele se destina, como em set_secret("anthropic", value=…, hosts=["api.anthropic.com"]). Um sandbox o liga a uma variável de ambiente, EnvVar(name="ANTHROPIC_API_KEY", secret="anthropic"). Dentro do sandbox a variável guarda um marcador que começa com phs_, e os programas o leem como leriam a chave.
Quando uma requisição sai para um dos hosts do segredo, o proxy de saída termina o TLS dela com uma autoridade certificadora daquele servidor, em que o sandbox confia: Node, Python, curl e git são apontados para ela. O proxy troca o marcador pelo valor em todo cabeçalho da requisição, inclusive dentro de credenciais Authorization: Basic, então tokens Bearer, credenciais Basic e x-api-key funcionam. Depois envia a requisição ao host por TLS. Uma requisição para qualquer outro host leva o marcador sem mudança, e ele não é chave em nenhum outro lugar.
É assim que os agentes de código em um sandbox fazem login sem guardar a sua chave: ligue ANTHROPIC_API_KEY ou OPENAI_API_KEY a um segredo. Os eventos de saída do sandbox indicam os segredos trocados nas requisições de cada host.
Onde o valor fica
O painel guarda o valor selado com AES-GCM, e nenhuma chamada o devolve. Os servidores o guardam só na memória, onde o espaço de trabalho tem sandboxes. Ele nunca entra em um sandbox, então não está em nenhum arquivo ou processo dele, e nenhum template ou fork pode levá-lo: eles levam o marcador. Defina um novo valor, e os sandboxes rodando e os forks deles passam a usá-lo na hora. Os hosts de um segredo mudam com o valor, na mesma chamada, e um segredo não pode ser excluído enquanto existir um sandbox que o liga.
Os hosts de um segredo são domínios ou *.domain, com uma porta opcional, 443 por padrão. A lista de permissões de saída do sandbox precisa permitir todo nome de um segredo que ele liga, e o painel recusa configurações que não permitem. O padrão, *, permite todos.
import os
from pethost.sandboxes import EnvVar, Environment, SandboxSettings, Sandboxes
sandboxes = Sandboxes() # lê o 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_… : o marcador
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: o proxy enviou a chave realprintenv ANTHROPIC_API_KEY | pethost sandbox secret set anthropic --host api.anthropic.com # o valor vem do stdin
pethost sandbox new --name agent --env ANTHROPIC_API_KEY=secret:anthropic
pethost sandbox run agent -- 'echo $ANTHROPIC_API_KEY' # phs_…O que cobre, e o que não cobre
- Só cabeçalhos de requisição. Uma chave que uma API recebe no corpo da requisição ou na URL ainda não é trocada.
- HTTPS pela confiança do sandbox. Entre o sandbox e o proxy, o host de um segredo fala HTTP/1.1, então um cliente que só oferece HTTP/2 falha no handshake. Um programa com um repositório de certificados próprio precisa ser apontado para o do sistema.
- Até 100 segredos por espaço de trabalho, cada um nomeado com a-z, 0-9 e hífens.
- A chave continua funcionando para o sandbox. Um programa nele chama os hosts do segredo com a sua chave, e é essa a ideia. Ele não consegue ler a chave nem enviá-la para outro host.
O guia de segredos e saída tem todas as regras.
Como se compara
Em 21 de novembro de 2026, o proxy de credenciais de IA do boat.dev custava US$ 1 por dia ligado, mais US$ 1 a cada 1.000 requisições. O E2B injetava segredos com o proxy de saída dele, e a Outbound Policy do Modal, que faz o mesmo para requisições HTTPS, estava em beta. Os segredos do Pethost não custam nada, em todos os planos e no teste grátis.