---
title: "Seguridad de claves de API de LLM: rotación y listas de IP"
description: "Mantenga las claves de API de LLM fuera del código y los logs, use una clave por carga de trabajo, rótelas, restrínjalas a sus IP y revoque una fuga en segundos."
url: https://broadrouter.com/es/blog/llm-api-key-security/
lang: es
updated: 2026-11-14
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Traducido del inglés con ayuda de IA. [Lea el original en inglés](https://broadrouter.com/blog/llm-api-key-security/) (actualizado el 2026-11-15).

# Claves de API de LLM seguras: almacenamiento, rotación y listas de IP

Por el equipo de BroadNet Inference · 6 min de lectura · Publicado 2026-11-14 · Actualizado 2026-11-15

Guarde las claves de API de LLM en un gestor de secretos, nunca en el código ni en el navegador. Dé a cada aplicación o agente su propia clave, rótelas periódicamente y restrínjalas a sus servidores con una lista de IP permitidas. BroadNet Inference indica que sus listas admiten 32 entradas, que la revocación detiene las nuevas solicitudes en cinco segundos y que las claves duran un año.

## Puntos clave

-   Nunca incluya una clave en un navegador ni en una app móvil; llame al LLM desde su servidor.
-   Una clave por carga de trabajo: hasta 10 claves activas por cuenta de BroadNet facilitan aislar una filtración.
-   Las listas de IP permitidas impiden que una clave robada funcione en otro lugar. BroadNet admite hasta 32 entradas IPv4, IPv6 o CIDR.
-   En BroadNet Inference, la revocación y los cambios en la lista de IP surten efecto en un plazo de cinco segundos.
-   Las claves caducan un año después de crearse, así que la rotación debe ser una rutina, no una emergencia.

**En esta página**

1.  ¿Dónde se debe guardar una clave de API de LLM?
2.  ¿Se puede poner una clave de API en un navegador o una app móvil?
3.  ¿Por qué dar a cada carga de trabajo su propia clave?
4.  ¿Cómo protegen una clave las listas de IP permitidas?
5.  ¿Por qué separar las claves de inferencia de las credenciales de administración?
6.  ¿Con qué frecuencia se deben rotar las claves de API?
7.  ¿Qué hacer cuando se filtra una clave?
8.  ¿Cómo se filtran las claves a través de los logs?
9.  ¿Cómo limitar el daño de una filtración que aún no ha detectado?
10.  ¿Qué controles de claves ofrece BroadNet Inference?

Para proteger una clave de API de LLM, guárdela en un gestor de secretos y llame al modelo solo desde su servidor, nunca desde un navegador o una app. Dé a cada carga de trabajo su propia clave, rote las claves periódicamente, restrínjalas a las IP de sus servidores con una lista de permitidas y, si una clave se filtra, revóquela primero e investigue después.

Este artículo reúne los hábitos que mantienen seguras las claves, con los controles concretos que ofrece BroadNet Inference. Para los pasos en el portal, consulte la [guía de claves de API y listas de IP permitidas](https://broadrouter.com/es/guides/api-keys-ip-allow-lists/); para presupuestos y protección frente a bucles descontrolados, consulte [control del gasto en APIs de LLM](https://broadrouter.com/es/blog/llm-api-spend-control/).

## ¿Dónde se debe guardar una clave de API de LLM?

Guarde las claves en un gestor de secretos o en los secretos cifrados de su plataforma, nunca en el código. El [OWASP Secrets Management Cheat Sheet](https://cheatsheetseries.owasp.org/cheatsheets/Secrets_Management_Cheat_Sheet.html) analiza las opciones a fondo. Tenga en cuenta su advertencia: las variables de entorno “are generally accessible to all processes and may be included in logs or system dumps” (Traducción: suelen ser accesibles para todos los procesos y pueden acabar en logs o volcados del sistema), por lo que OWASP prefiere, cuando se puede elegir, archivos de secretos montados u obtener los secretos de un almacén de secretos. Una variable de entorno que se rellena desde un gestor de secretos al arrancar es el término medio habitual.

```python
import os
from openai import OpenAI

client = OpenAI(
    base_url="https://inference.broadnet.ai/v1",
    api_key=os.environ["BROADNET_API_KEY"],  # fails loudly if missing
)
```

Use `os.environ[...]`, no `os.getenv(...)` con un valor por defecto escrito en el código; así es como las claves acaban en Git. En desarrollo local, un archivo `.env` está bien si figura en `.gitignore` desde el primer commit. Active el escaneo de secretos y la protección de push de su plataforma Git. En GitHub, la [protección de push](https://docs.github.com/en/code-security/secret-scanning/introduction/about-push-protection) bloquea los push que contienen formatos de secretos conocidos antes de que lleguen al repositorio; la protección de push para usuarios viene activada por defecto, pero la protección a nivel de repositorio viene desactivada y debe activarla un administrador del repositorio o el propietario de la organización.

## ¿Se puede poner una clave de API en un navegador o una app móvil?

No. Todo lo que se entrega a un cliente se puede extraer. El código del front-end y los paquetes de las apps son públicos, por mucho que se minifiquen u ofusquen. Llame al LLM desde su servidor, autentique allí a sus propios usuarios y aplique sus propios límites por usuario antes de reenviar la solicitud.

Lo mismo vale para las herramientas de escritorio que entrega a otras personas. Si un compañero necesita acceso a un agente de programación, dele su propia clave en su propia cuenta en lugar de compartir una.

## ¿Por qué dar a cada carga de trabajo su propia clave?

En BroadNet Inference, una cuenta puede tener **hasta diez claves activas**. Aprovéchelas:

| Etiqueta de la clave | Quién la usa |
| --- | --- |
| `prod-api` | Backend de producción |
| `prod-worker` | Trabajos por lotes |
| `staging` | Entorno de staging |
| `agent-ci` | Agente de programación en CI |
| `dev-laptop-<name>` | Desarrollo local |

Si una se filtra, solo revoca esa clave y las demás siguen funcionando. Las etiquetas también hacen legible el uso: puede ver cuánto gasta cada carga de trabajo. Nombre las claves según lo que las usa, no según quién las creó.

## ¿Cómo protegen una clave las listas de IP permitidas?

Con una [lista de IP permitidas](https://broadrouter.com/es/glossary/ip-allow-list/), una clave robada falla en cualquier lugar que no sea su propia infraestructura. En BroadNet Inference:

-   La lista de la cuenta admite **hasta 32 entradas**, una dirección IPv4 o IPv6 o un rango CIDR por línea.
-   Una lista vacía significa que no hay restricción.
-   Las claves nuevas heredan la lista de la cuenta, salvo que cree una clave con su propio `allowed_ips`, que sustituye la lista heredada para esa clave.
-   Una solicitud desde una dirección fuera de la lista se rechaza con un 403 (“refused by model, route or IP policy”; traducción: rechazada por la política de modelo, ruta o IP).

Cree una clave con su propia lista mediante la API del portal:

```bash
curl -X POST https://inference.broadnet.ai/portal/keys \
  -H "Authorization: Bearer $BROADNET_PORTAL_CREDENTIAL" \
  -H "Content-Type: application/json" \
  -d '{"label":"prod-worker","allowed_ips":["203.0.113.7","198.51.100.0/24"]}'
```

La respuesta contiene la clave en bruto una sola vez. Guárdela de inmediato en su gestor de secretos; no se puede volver a leer. Los pasos completos están en la [guía de listas de IP permitidas](https://broadrouter.com/es/guides/api-keys-ip-allow-lists/).

Las listas de IP permitidas convienen a servidores con IP de salida estables: un VPS, un gateway NAT, una IP fija de oficina. Para portátiles que cambian de red, use una clave aparte sin lista y mantenga bajo el saldo expuesto.

## ¿Por qué separar las claves de inferencia de las credenciales de administración?

BroadNet usa dos tipos de credenciales:

| Credencial | Qué puede hacer | Dónde guardarla |
| --- | --- | --- |
| Clave de inferencia | Solicitudes a modelos en `/v1/*` | Donde se ejecute la aplicación |
| Credencial del portal | Crear y revocar claves, cambiar las IP permitidas, hacer compras | Solo en su automatización o herramientas de administración |

La documentación indica que cada credencial del portal debe tratarse como autoridad total sobre la cuenta. Nunca despliegue una credencial del portal junto a su aplicación. Si su servidor de aplicaciones se ve comprometido, el atacante debería obtener una clave de inferencia, no el control de la cuenta.

## ¿Con qué frecuencia se deben rotar las claves de API?

OWASP recomienda rotarlas con regularidad “so that any stolen credentials will only work for a short time” (Traducción: para que cualquier credencial robada solo funcione durante poco tiempo). Las claves de BroadNet duran **un año** desde su creación, así que todas habrá que reemplazarlas de todos modos. Convierta la rotación en rutina:

1.  Cree una clave nueva con el mismo patrón de etiqueta y la misma lista de IP.
2.  Despliéguela junto a la anterior, o cambie el secreto y reinicie.
3.  Compruebe que el tráfico pasa a la clave nueva.
4.  Revoque la clave anterior con `DELETE /portal/keys/{alias}`.

Como una cuenta puede tener hasta diez claves activas, puede mantener la anterior y la nueva a la vez durante unos minutos sin interrupción del servicio. Rote antes las claves a las que tenía acceso alguien que deja el equipo.

## ¿Qué hacer cuando se filtra una clave?

Cuando se filtra una clave, revóquela primero e investigue después. En BroadNet Inference, las nuevas solicitudes se detienen **en un plazo de cinco segundos** tras una revocación o un cambio en la lista de IP; la documentación explica que las decisiones de autorización pueden permanecer en una caché replicada durante ese intervalo acotado.

Después de revocarla:

-   revise el uso de la clave en la página de la cuenta o con `GET /portal/usage`;
-   averigüe cómo se filtró (historial de commits, logs de CI, una captura de pantalla compartida);
-   rote cualquier otro secreto guardado en el mismo lugar.

Una clave revocada o bloqueada devuelve 401 o 403; consulte la [guía de errores](https://broadrouter.com/es/guides/errors-and-retries/) para que su monitoreo no los trate como errores transitorios.

## ¿Cómo se filtran las claves a través de los logs?

Los logs son una filtración fácil de pasar por alto. Oculte la cabecera `Authorization` en el logging de depuración HTTP, en los servicios de reporte de errores y en los logs de acceso del proxy. Cuando contacte con soporte, envíe el `X-Request-ID`, la marca de tiempo, la ruta, el estado y el **alias** de la clave, nunca la clave en sí. La documentación de BroadNet indica que el portal solo guarda un hash de cada clave, así que tampoco puede mostrarle una clave perdida.

## ¿Cómo limitar el daño de una filtración que aún no ha detectado?

Aun con todos los hábitos anteriores, asuma que una clave podría filtrarse algún día. Reduzca el radio de impacto:

-   Mantenga el saldo de pago por uso en un nivel que pueda permitirse perder, y recargue según lo necesite.
-   Use un plan de tarifa plana para los agentes intensivos: una sesión de plan tiene un precio fijo, así que una clave de plan robada no puede disparar una factura por token. Consulte [qué significa realmente “ilimitado”](https://broadrouter.com/es/blog/what-unlimited-llm-api-really-means/).
-   Configure alertas ante un gasto o una tasa de solicitudes inusual por clave; la [calculadora de costos de API de LLM](https://broadrouter.com/tools/llm-api-cost-calculator/) le da una cifra mensual normal con la que comparar. Nuestro artículo sobre [control del gasto en APIs de LLM](https://broadrouter.com/es/blog/llm-api-spend-control/) trata los presupuestos y las alertas.

## ¿Qué controles de claves ofrece BroadNet Inference?

| Control | BroadNet Inference |
| --- | --- |
| La clave se muestra una vez y se guarda como hash | Sí |
| Claves activas por cuenta | Hasta 10 |
| Vigencia de la clave | Un año |
| Lista de IP permitidas | Hasta 32 entradas IPv4, IPv6 o CIDR |
| Lista de IP por clave | Sí, `allowed_ips` al crearla |
| La revocación surte efecto | En un plazo de cinco segundos |
| Credencial de administración separada | Credencial del portal |

Las claves protegen su cuenta; la [retención cero de datos](https://broadrouter.com/es/privacy/) protege lo que envía a través de ella. Lea ambos temas antes de pasar a producción.

Herramientas gratuitas sobre este tema (en inglés)

-   [OpenAI to BroadNet migration helper](https://broadrouter.com/tools/openai-to-broadnet-migration/) Paste OpenAI SDK code; get base URL, key and model edits, a diff and the checks that remain.
-   [max\_tokens calculator for reasoning models](https://broadrouter.com/tools/reasoning-token-budget/) Answer length + reasoning budget + margin = a max\_tokens that does not cut the answer off.
-   [JSON schema generator for LLM structured output](https://broadrouter.com/tools/json-schema-generator/) Sample JSON to strict schema, Pydantic, Zod and a ready request.
-   [LLM JSON output validator](https://broadrouter.com/tools/llm-json-output-validator/) Parse errors by line and column, safe repairs, cut-off detection and JSON Schema checks for model output.

[Herramientas gratuitas (en inglés)](https://broadrouter.com/tools/)

## Términos de este artículo

[Clave de API (API key)](https://broadrouter.com/es/glossary/api-key/)

Una clave de API es una cadena secreta que identifica y autoriza a un cliente que llama a una API. Las APIs de LLM suelen esperarla en un encabezado Authorization: Bearer, y cualquiera que tenga la clave puede hacer solicitudes que se facturan a la cuenta propietaria.

[Llamadas a herramientas (tool calling)](https://broadrouter.com/es/glossary/tool-calling/)

Las llamadas a herramientas (tool calling), también llamadas function calling, son una función de las APIs de LLM en la que el modelo devuelve una solicitud estructurada para ejecutar una función definida por el desarrollador, con argumentos JSON. La aplicación ejecuta la función y devuelve el resultado; el modelo nunca ejecuta código.

[Agente de programación con IA (AI coding agent)](https://broadrouter.com/es/glossary/coding-agent/)

Un agente de programación con IA es una herramienta de software en la que un modelo de lenguaje trabaja sobre una base de código en un ciclo: lee archivos, los edita, ejecuta comandos como pruebas, lee la salida y decide el siguiente paso hasta que termina la tarea o alcanza un límite.

[Lista de IP permitidas (IP allow list)](https://broadrouter.com/es/glossary/ip-allow-list/)

Una lista de IP permitidas es un control de seguridad que solo acepta solicitudes de direcciones IP o rangos CIDR incluidos en ella y rechaza todas las demás. En una API, limita el daño de una clave filtrada, porque la clave no funciona desde redes que no estén en la lista.

[Pago por uso (pay-as-you-go)](https://broadrouter.com/es/glossary/pay-as-you-go/)

El pago por uso es un modelo de precios en el que usted paga solo lo que usa, medido por unidades como tokens, solicitudes o minutos de audio, sin suscripción ni compromiso mínimo. La mayoría de las APIs de LLM cobran así, desde un saldo prepagado o con una factura periódica.

[Plan de LLM con tarifa plana (flat-rate LLM plan)](https://broadrouter.com/es/glossary/flat-rate-llm-plan/)

Un plan de LLM con tarifa plana cobra un precio fijo por un periodo, como un mes, por acceder a la API de un modelo de lenguaje, en lugar de facturar por token. Estos planes suelen limitar otra cosa, como la concurrencia, la velocidad, los modelos o las ventanas de uso, así que los topes importan tanto como el precio.

[Retención cero de datos (zero data retention, ZDR)](https://broadrouter.com/es/glossary/zero-data-retention/)

La retención cero de datos (ZDR) es una política de manejo de datos en la que un proveedor de IA procesa los prompts y las salidas solo para atender una solicitud y después no guarda ese contenido en logs, cachés ni datos de entrenamiento. Los registros sin contenido, como conteos de tokens y tiempos, normalmente se conservan.

[Token](https://broadrouter.com/es/glossary/token/)

Un token es la unidad de texto que un modelo de lenguaje lee y escribe: una palabra, parte de una palabra, un signo de puntuación o una secuencia de bytes producida por el tokenizador del modelo. Las APIs de LLM cuentan, limitan y normalmente facturan el uso en tokens.

## Preguntas frecuentes

### ¿Dónde debo guardar una clave de API de LLM?

En un gestor de secretos o en los secretos cifrados de su plataforma, inyectada en el proceso como variable de entorno, por ejemplo BROADNET\_API\_KEY. No en el código fuente, no en un archivo .env incluido en un commit y nunca en el código del front-end.

### ¿Con qué rapidez puedo revocar una clave de BroadNet Inference?

La documentación de BroadNet indica que las nuevas solicitudes se detienen en los cinco segundos siguientes a una revocación o a un cambio en la lista de IP, porque las decisiones de autorización pueden permanecer en una caché replicada durante ese intervalo acotado.

### ¿Cuánto dura una clave de BroadNet Inference?

Una clave de pago por uso dura un año desde su creación. Una cuenta puede tener hasta diez claves activas, así que puede crear la sustituta antes de que caduque la anterior.

### ¿Puede BroadNet volver a mostrarme una clave si la pierdo?

No. La documentación de BroadNet indica que la clave en bruto se devuelve una sola vez y que el portal solo guarda su hash. Cree una clave nueva y revoque la anterior.

### ¿Qué hago si se filtra mi clave de una API compatible con OpenAI?

Revóquela primero e investigue después. Revise el uso de la clave en busca de tráfico desconocido, averigüe por dónde se filtró (historial de commits, logs de CI, capturas de pantalla), rote cualquier otro secreto guardado en el mismo lugar y emita una clave de reemplazo con una lista de IP permitidas.

## Siga leyendo

-   [Control de gasto en APIs de LLM: presupuestos, límites y bucles](https://broadrouter.com/es/blog/llm-api-spend-control/)
-   [Datos sensibles en una API de LLM: ocultar, minimizar, registrar menos](https://broadrouter.com/es/blog/llm-api-sensitive-data/)
-   [Cómo manejar el 429 de una API de LLM: backoff, jitter y limitadores](https://broadrouter.com/es/blog/handle-llm-api-429-rate-limits/)
-   [RGPD y API de LLM: 15 preguntas para su proveedor](https://broadrouter.com/es/blog/gdpr-llm-api-checklist/)
-   [El hardware GPU de BroadNet y cómo sirve los modelos, según BroadNet](https://broadrouter.com/es/blog/broadnet-gpu-fleet-and-serving/)
-   [Caché de respuestas de APIs de LLM para reducir costos en Python](https://broadrouter.com/es/blog/cache-llm-responses-cut-cost/)
-   [Guía: Limite sus claves de API a sus servidores con listas de IP permitidas](https://broadrouter.com/es/guides/api-keys-ip-allow-lists/)
-   [Guía: Códigos de error de BroadNet Inference y cuándo reintentar](https://broadrouter.com/es/guides/errors-and-retries/)
-   [Guía: Usar el SDK de OpenAI para Python con BroadNet Inference](https://broadrouter.com/es/guides/openai-python-sdk/)

Pruébelo con su carga de trabajo real. Las cuentas nuevas empiezan con USD 5 de crédito para Gemma y transcripción. DeepSeek, GLM y Qwen3.8 requieren una recarga.

[Comenzar](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=es-blog-llm-api-key-security&utm_content=page-cta) ·

**Fuentes**

-   [Referencia de la API de BroadNet Inference, límites: vigencia de las claves y claves activas (consultado el 2026-11-14) (en inglés)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=es-blog-llm-api-key-security&utm_content=sources#limits)
-   [Referencia de la API de BroadNet Inference, listas de IP permitidas y claves del portal (consultado el 2026-11-14) (en inglés)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=es-blog-llm-api-key-security&utm_content=sources#ip-allow-lists)
-   [OWASP Secrets Management Cheat Sheet (consultado el 2026-11-14)](https://cheatsheetseries.owasp.org/cheatsheets/Secrets_Management_Cheat_Sheet.html)
-   [GitHub Docs, escaneo de secretos (consultado el 2026-11-14)](https://docs.github.com/en/code-security/secret-scanning/about-secret-scanning)
-   [GitHub Docs, acerca de la protección de push (consultado el 2026-11-14)](https://docs.github.com/en/code-security/secret-scanning/introduction/about-push-protection)
