---
title: "Injeção de segredos: chaves que o sandbox não vê · Pethost"
description: "Ligue uma chave de API a uma variável: o sandbox vê um marcador, e o proxy de saída coloca a chave real nos cabeçalhos HTTPS, só para os hosts que você indicar."
---

[Agent Sandboxes](https://pethost.dev/pt/sandboxes/) Chaves que nunca entram

# Chaves de API que o sandbox nunca guarda

Um agente precisa da sua chave de API para chamar o modelo, e nada no sandbox precisa ver a chave em si. Com a injeção de segredos, o sandbox guarda um marcador, e o proxy de saída coloca a chave real em cada requisição na saída, só para os hosts que você indicar.

Dentro do sandbox a chave de API é um marcador; o proxy de saída coloca a chave real na requisição para api.anthropic.com, e uma requisição para outro host fica com o marcador.

## 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](https://pethost.dev/pt/sandboxes/coding-agents/) 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](https://pethost.dev/pt/sandboxes/egress-allowlist/) 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.

Python

CLI

```
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 real
```

```
printenv 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](https://pethost.dev/pt/docs/sandboxes/secrets-and-egress/) 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.

[Ler a documentação](https://pethost.dev/pt/docs/sandboxes/secrets-and-egress/)

## Perguntas

**Com a injeção de segredos, o agente consegue ler a chave?**

Não. Onde quer que procure, no ambiente, em arquivos ou na memória, ele encontra o marcador. A chave só é adicionada a uma requisição depois que ela sai do sandbox.

**Quais cabeçalhos são trocados?**

O valor de todo cabeçalho da requisição, `Authorization` incluído, e também dentro de credenciais Basic.

**Os corpos das requisições são trocados?**

Ainda não: só os cabeçalhos. Uma API que recebe a chave no corpo ou na URL precisa da chave no sandbox, por enquanto.

**O que os outros hosts recebem?**

O marcador, sem mudança.

**Quanto custa um segredo?**

Nada. Um espaço de trabalho guarda até 100 deles.

## Relacionados

- [As conexões de um sandbox passam por um portão que libera pypi.org e *.github.com e recusa example.com com 403; uma pergunta DNS por um nome fora da lista recebe REFUSED, e o UDP não sai. Saída que você libera, por nome Liste os domínios, wildcards, IPs e CIDRs que um sandbox pode alcançar; o DNS dele não responde mais nada, nenhum UDP sai, e uma mudança vale na hora. Como funciona](https://pethost.dev/pt/sandboxes/egress-allowlist/)
- [Um prompt a um agente de código em um sandbox, e as chamadas de ferramenta dele voltando ao vivo: ele lê um arquivo, edita, roda os testes, e o turno termina concluído com a contagem de tokens. Agentes de código, já instalados O Claude Code, o Codex e o OpenCode rodam em todo sandbox com autonomia total: uma chamada dá um prompt a um deles, outra transmite cada chamada de ferramenta que ele faz. Como funciona](https://pethost.dev/pt/sandboxes/coding-agents/)

## Dê um computador ao seu agente em 0,15 s

[Começar o teste grátis](https://console.pethost.dev/welcome?kind=sandboxes)

Pethost · Stephan Gomer · NIP 1133096755

Pethost

- [Templates](https://pethost.dev/pt/templates/)
- [Sobre nós](https://pethost.dev/about/)
- [Docs](https://pethost.dev/docs/)
- [Blog](https://pethost.dev/pt/blog/)
- [API](https://pethost.dev/docs/api/)
- [CLI](https://pethost.dev/docs/cli/)
- [Plugin](https://github.com/pethost-dev/plugin)
- [Termos](https://pethost.dev/terms/)
- [Privacidade](https://pethost.dev/privacy/)
- [Reembolsos](https://pethost.dev/refunds/)
- [support@pethost.dev](mailto:support@pethost.dev)

Bancos de dados

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

Agent Sandboxes

- [Sandboxes](https://pethost.dev/pt/sandboxes/)
- [Preços](https://pethost.dev/pt/sandboxes/#pricing)
- [Docs](https://pethost.dev/pt/docs/sandboxes/)
- [API](https://pethost.dev/docs/sandboxes/api/)

Comparativos

- [Coolify vs Dokploy vs CapRover vs Dokku](https://pethost.dev/pt/blog/coolify-vs-dokploy-vs-caprover-vs-dokku/)
- [Coolify Cloud vs Dokploy Cloud](https://pethost.dev/pt/blog/coolify-cloud-vs-dokploy-cloud/)
- [Preços Railway vs Render vs Fly.io](https://pethost.dev/pt/blog/railway-vs-render-vs-fly-io-pricing/)
- [Hospedagem gerenciada de Docker Compose](https://pethost.dev/pt/blog/managed-docker-compose-hosting/)

Alternativas

- [Alternativas ao Railway](https://pethost.dev/pt/blog/railway-alternatives/)
- [Alternativas ao Heroku](https://pethost.dev/pt/blog/heroku-alternatives/)
- [Alternativas ao Dokploy](https://pethost.dev/pt/blog/dokploy-alternatives/)
- [Alternativas ao Coolify](https://pethost.dev/pt/blog/coolify-alternatives/)
- [Alternativas ao Render](https://pethost.dev/pt/blog/render-alternatives/)
- [Alternativas ao Sliplane](https://pethost.dev/pt/blog/sliplane-alternatives/)
