Ir al contenido principal
Español— Elegir un idioma
Menú

Protege tu clave de API: nunca la expongas en el lado del cliente

Lección 6 de 12 Actualizado el 28 de julio de 2026 Avanzado
En esta página
  1. Una clave de API es una contraseña
  2. Vectores de exposición comunes
  3. Arquitectura de proxy: la solución
  4. Almacenamiento seguro de claves
  5. Qué hacer si tu clave está comprometida
  6. Puntos clave

Una clave de API es una contraseña

Tu clave de API de xAI actúa como una contraseña con acceso total a tu cuenta. Cualquier persona que la posea puede realizar llamadas a la API a tu costa, acceder a tus modelos y, potencialmente, comprometer tus datos. ¿En qué se diferencia de una contraseña estándar? Una clave robada puede utilizarse en silencio: no verás nada hasta que llegue la factura o hasta que tu equipo financiero lance una alerta. La regla es simple y absoluta: nunca expongas una clave de API en el lado del cliente.

Vectores de exposición comunes

El caso más frecuente es la inclusión directa de la clave en JavaScript del frontend:

// PELIGRO - NUNCA hagas esto
const response = await fetch("https://api.x.ai/v1/chat/completions", {
  headers: { "Authorization": "Bearer xai-abc123..." }
});

Una vez desplegado, este código es visible para cualquiera que utilice las herramientas de desarrollo del navegador. Solo necesitas abrir la pestaña Network (Red) para leer la clave en texto plano dentro de las cabeceras de la solicitud.

Un vector más insidioso, porque ofrece una falsa sensación de seguridad, son las variables de entorno del frontend. Las variables con prefijos NEXT_PUBLIC_, VITE_ o REACT_APP_ se incluyen en el paquete de JavaScript en tiempo de compilación y, por tanto, son públicas. El desarrollador cree que ha «mantenido la clave fuera del código»; en realidad, simplemente se ha compilado dentro de él:

# PELIGRO - esta variable estará en el paquete
NEXT_PUBLIC_XAI_API_KEY=xai-abc123...

Los repositorios de Git son el tercer vector clásico. Incluso un commit eliminado permanece en el historial de Git: si has confirmado una clave por error, reescribir el historial no es suficiente, porque los clones y los forks pueden haberla conservado. Considera que está comprometida y revócala. Por último, las claves también se filtran por vías indirectas, más difíciles de imaginar pero muy comunes: registros de aplicación que trazan cabeceras completas, mensajes de error mostrados al usuario o herramientas de monitorización que capturan solicitudes salientes.

Arquitectura de proxy: la solución

El único enfoque seguro es intermediar todas las llamadas a través de tu backend:

Cliente (navegador/móvil)
    ↓ solicitud sin clave de API
Tu Backend (servidor)
    ↓ añade la clave de API (variable de entorno)
API de xAI
    ↓ respuesta
Tu Backend
    ↓ reenvía la respuesta (filtrada si es necesario)
Cliente

Aquí tienes un proxy minimalista en Python:

# Backend en Python (Flask)
import os
from flask import Flask, request, jsonify
import requests

app = Flask(__name__)
XAI_KEY = os.environ["XAI_API_KEY"]  # Variable solo del lado del servidor

@app.route("/api/chat", methods=["POST"])
def proxy_chat():
    user_message = request.json.get("message")

    response = requests.post(
        "https://api.x.ai/v1/chat/completions",
        headers={"Authorization": f"Bearer {XAI_KEY}"},
        json={
            "model": "grok-4.3",
            "messages": [{"role": "user", "content": user_message}]
        }
    )

    return jsonify(response.json())

Más allá de proteger la clave, que nunca se transmite al cliente, el proxy te ofrece un punto de control que las llamadas directas hacen imposible. Puedes filtrar solicitudes: limitación de tasa para evitar que un cliente agote tu cuota, validación de entrada y moderación de contenido. Controlas qué modelos son accesibles, impidiendo que un cliente secuestrado llame a un modelo costoso y genere gastos inesperados. Puedes registrar las llamadas para auditoría, una necesidad central para un responsable de cumplimiento. Y puedes almacenar en caché ciertas respuestas para reducir costes en solicitudes repetitivas.

Almacenamiento seguro de claves

En el lado del servidor, la base es la variable de entorno, cargada desde un archivo .env que nunca se confirma en Git:

# Archivo .env (NUNCA confirmado en Git)
XAI_API_KEY=xai-your-secret-key

Añade sistemáticamente estos archivos a tu .gitignore:

# .gitignore
.env
.env.local
.env.production

Para entornos de producción, un archivo .env colocado en un servidor sigue siendo un proceso manual frágil: es preferible un gestor de secretos dedicado. Entre las opciones probadas se encuentran AWS Secrets Manager o SSM Parameter Store, Google Secret Manager, Azure Key Vault, HashiCorp Vault, o Doppler e Infisical para estructuras más ligeras. Lo que estas herramientas ofrecen frente a un archivo plano: rotación automática de claves, auditoría de acceso (quién leyó qué secreto y cuándo) y cifrado en reposo. Estos son elementos que puedes presentar tal cual durante una auditoría de seguridad, mientras que un archivo de texto en una máquina no prueba nada.

Qué hacer si tu clave está comprometida

Si sospechas que una clave ha sido expuesta, el orden de las operaciones importa tanto como las operaciones en sí. Revoca la clave en la consola de xAI (console.x.ai) antes que nada: cada minuto que la clave comprometida permanece activa es un minuto de posible explotación, y la continuidad del servicio se gestiona después, no antes. A continuación, genera una nueva clave y actualiza tus backends para restablecer el servicio.

El incidente aún no ha terminado. Audita el uso buscando llamadas a la API sospechosas en tu historial de facturación: un pico durante una ventana de tiempo inusual o un uso atribuido a un modelo que no utilizas. Identifica la fuente de la fuga; de lo contrario, la nueva clave seguirá el mismo camino que la anterior. Finaliza escaneando tu código con herramientas como gitleaks o truffleHog, que también recorren el historial de Git y a menudo revelan otros secretos olvidados hace tiempo.

Puntos clave

  • Una clave de API es una contraseña con acceso total a tu cuenta
  • Siempre intermediar las llamadas a la API a través de tu backend
  • Las variables NEXT_PUBLIC_, VITE_, REACT_APP_ son públicas
  • Utiliza un gestor de secretos en producción
  • Si una clave está comprometida, revócala inmediatamente y audita el uso