---
title: "Inyección de secretos: claves fuera del sandbox · Pethost"
description: "Vincula una clave de API a una variable: el sandbox ve un marcador, y el proxy de salida pone la clave real en las cabeceras, solo hacia los hosts que indiques."
---

[Agent Sandboxes](https://pethost.dev/es/sandboxes/) Claves que nunca entran

# Claves de API que el sandbox nunca tiene

Un agente necesita tu clave de API para llamar a su modelo, y nada en el sandbox necesita ver la clave en sí. Con la inyección de secretos, el sandbox guarda un marcador, y el proxy de salida pone la clave real en cada petición al salir, solo hacia los hosts que indiques.

Dentro del sandbox la clave de API es un marcador; el proxy de salida pone la clave real en la petición a api.anthropic.com, y una petición a otro host conserva el marcador.

## Cómo funciona la inyección de secretos

Configuras un secreto una vez para el espacio de trabajo: un nombre, un valor y los hosts a los que va, como en `set_secret("anthropic", value=…, hosts=["api.anthropic.com"])`. Un sandbox lo vincula a una variable de entorno, `EnvVar(name="ANTHROPIC_API_KEY", secret="anthropic")`. Dentro del sandbox, la variable guarda un marcador que empieza por `phs_`, y los programas lo leen como leerían la clave.

Cuando una petición sale hacia uno de los hosts del secreto, el proxy de salida termina su TLS con una autoridad de certificación de ese servidor, en la que confía el sandbox: Node, Python, curl y git apuntan a ella. El proxy reemplaza el marcador por el valor en cada cabecera de la petición, también dentro de las credenciales `Authorization: Basic`, así que funcionan los tokens Bearer, las credenciales Basic y `x-api-key`. Después envía la petición al host por TLS. Una petición a cualquier otro host lleva el marcador sin cambios, que no es una clave en ningún otro lugar.

Así es como los [agentes de programación](https://pethost.dev/es/sandboxes/coding-agents/) de un sandbox inician sesión sin tener tu clave: vincula `ANTHROPIC_API_KEY` o `OPENAI_API_KEY` a un secreto. Los eventos de salida del sandbox nombran los secretos puestos en las peticiones a cada host.

## Dónde vive el valor

El panel guarda el valor sellado con AES-GCM, y ninguna llamada lo devuelve. Los servidores solo lo tienen en memoria, allí donde el espacio de trabajo tiene sandboxes. Nunca entra en un sandbox, así que no está en ninguno de sus archivos ni procesos, y ninguna plantilla ni fork de él puede llevarlo: llevan el marcador. Configura un valor nuevo, y los sandboxes en ejecución y sus forks lo usan al momento. Los hosts de un secreto cambian con su valor, en la misma llamada, y un secreto no puede eliminarse mientras exista un sandbox que lo vincule.

Los hosts de un secreto son dominios o `*.domain`, con un puerto opcional, el 443 por defecto. La [lista de destinos permitidos](https://pethost.dev/es/sandboxes/egress-allowlist/) del sandbox debe permitir todos los nombres de un secreto que vincule, y el panel rechaza los ajustes que no lo hacen. El valor por defecto, `*`, los permite todos.

Python

CLI

```
import os

from pethost.sandboxes import EnvVar, Environment, SandboxSettings, Sandboxes

sandboxes = Sandboxes()  # lee 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_… : el 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: el proxy envió la clave real
```

```
printenv ANTHROPIC_API_KEY | pethost sandbox secret set anthropic --host api.anthropic.com   # el valor, desde stdin
pethost sandbox new --name agent --env ANTHROPIC_API_KEY=secret:anthropic
pethost sandbox run agent -- 'echo $ANTHROPIC_API_KEY'                                       # phs_…
```

## Qué cubre y qué no

- **Solo las cabeceras de la petición.** Una clave que una API recibe en el cuerpo de la petición o en su URL aún no se reemplaza.
- **HTTPS a través de la confianza del sandbox.** Entre el sandbox y el proxy, el host de un secreto habla HTTP/1.1, así que un cliente que solo ofrece HTTP/2 falla en el handshake. Un programa con su propio almacén de certificados debe apuntar al del sistema.
- **Hasta 100 secretos por espacio de trabajo,** cada uno con un nombre de a-z, 0-9 y guiones.
- **La clave sigue funcionando para el sandbox.** Un programa dentro llama a los hosts del secreto con tu clave, que es de lo que se trata. No puede leer la clave ni enviarla a otro host.

La [guía de secretos y salida](https://pethost.dev/es/docs/sandboxes/secrets-and-egress/) tiene cada regla.

## Cómo se compara

El 21 de noviembre de 2026, el proxy de credenciales de IA de boat.dev costaba 1 US$ por cada día activo, más 1 US$ por cada 1000 peticiones. E2B inyectaba secretos con su proxy de salida, y la Outbound Policy de Modal, que hace lo mismo con las peticiones HTTPS, estaba en beta. Los secretos de Pethost no cuestan nada, en todos los planes y en la prueba gratis.

[Leer la documentación](https://pethost.dev/es/docs/sandboxes/secrets-and-egress/)

## Preguntas

**Con la inyección de secretos, ¿puede el agente leer la clave?**

No. Mire donde mire, en el entorno, en los archivos o en la memoria, encuentra el marcador. La clave se agrega a una petición solo después de que la petición salió del sandbox.

**¿Qué cabeceras se reemplazan?**

El valor de cada cabecera de la petición, `Authorization` incluida, y también dentro de las credenciales Basic.

**¿Se reemplaza el cuerpo de las peticiones?**

Aún no: solo las cabeceras. Una API que recibe su clave en un cuerpo o en una URL necesita, por ahora, la clave dentro del sandbox.

**¿Qué reciben los demás hosts?**

El marcador, sin cambios.

**¿Cuánto cuesta un secreto?**

Nada. Un espacio de trabajo guarda hasta 100.

## Relacionado

- [Las conexiones de un sandbox pasan por una puerta que permite pypi.org y *.github.com y rechaza example.com con un 403; una consulta DNS por un nombre fuera de la lista recibe REFUSED, y UDP no sale. La salida que permites, por nombre Lista los dominios, comodines, IP y CIDR a los que puede llegar un sandbox; su DNS no responde nada más, ningún UDP sale, y un cambio se aplica al momento. Cómo funciona](https://pethost.dev/es/sandboxes/egress-allowlist/)
- [Un prompt a un agente de programación en un sandbox, y sus llamadas a herramientas llegando en tiempo real: lee un archivo, lo edita, ejecuta los tests, y el turno termina con éxito y su cuenta de tokens. Agentes de programación, ya instalados Claude Code, Codex y OpenCode se ejecutan en cada sandbox con autonomía total: una llamada le da un prompt a uno, otra transmite cada llamada a herramienta que hace. Cómo funciona](https://pethost.dev/es/sandboxes/coding-agents/)

## Dale a tu agente una VM en 0,15 s

[Empezar la prueba gratis](https://console.pethost.dev/welcome?kind=sandboxes)

Pethost · Stephan Gomer · NIP 1133096755

Pethost

- [Plantillas](https://pethost.dev/es/templates/)
- [Sobre nosotros](https://pethost.dev/about/)
- [Docs](https://pethost.dev/docs/)
- [Blog](https://pethost.dev/es/blog/)
- [API](https://pethost.dev/docs/api/)
- [CLI](https://pethost.dev/docs/cli/)
- [Plugin](https://github.com/pethost-dev/plugin)
- [Términos](https://pethost.dev/terms/)
- [Privacidad](https://pethost.dev/privacy/)
- [Reembolsos](https://pethost.dev/refunds/)
- [support@pethost.dev](mailto:support@pethost.dev)

Bases de datos

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

Agent Sandboxes

- [Sandboxes](https://pethost.dev/es/sandboxes/)
- [Precios](https://pethost.dev/es/sandboxes/#pricing)
- [Docs](https://pethost.dev/es/docs/sandboxes/)
- [API](https://pethost.dev/docs/sandboxes/api/)

Comparativas

- [Coolify vs Dokploy vs CapRover vs Dokku](https://pethost.dev/es/blog/coolify-vs-dokploy-vs-caprover-vs-dokku/)
- [Coolify Cloud vs Dokploy Cloud](https://pethost.dev/es/blog/coolify-cloud-vs-dokploy-cloud/)
- [Precios de Railway vs Render vs Fly.io](https://pethost.dev/es/blog/railway-vs-render-vs-fly-io-pricing/)
- [Hosting gestionado para Docker Compose](https://pethost.dev/es/blog/managed-docker-compose-hosting/)

Alternativas

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