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

Mejores prácticas de seguridad

Lección 14 de 14 Actualizado el 29 de julio de 2026 Desarrollador
En esta página
  1. Asegura el uso de tu API de Grok
  2. Gestión de secretos
  3. Rotación periódica
  4. Principio de mínimo privilegio
  5. Auditoría y monitorización
  6. Lista de comprobación de seguridad completa
  7. Puntos clave
  8. Pon a prueba tus conocimientos

Asegura el uso de tu API de Grok

Una clave de la API de Management no es como las demás: no consume tokens, crea y revoca las que sí lo hacen. Quien la posea puede abrir accesos, elevar límites y cargar los gastos a tu equipo. Por eso, las prácticas que siguen no son una higiene opcional: marcan la diferencia entre un incidente contenido en una hora y una factura descubierta a final de mes.

Esta lección se estructura en cuatro áreas que se refuerzan mutuamente: dónde viven los secretos, con qué frecuencia cambian, qué autorizan exactamente y cómo detectas cuando algo va mal. Ninguna basta por sí sola: una clave perfectamente almacenada pero con permisos comodín sigue siendo una clave peligrosa.

Gestión de secretos

Regla fundamental: nunca en texto plano

Una clave nunca debe escribirse en texto plano donde pueda copiarse, indexarse o almacenarse sin tu decisión explícita. Los repositorios de código encabezan la lista, incluso los privados: un repositorio privado puede hacerse público por accidente, cambiar de propietario o quedar en la caché de una herramienta de terceros; y el historial de Git no olvida nada, así que un secreto confirmado una vez sigue siendo recuperable aunque se borre el fichero.

Las otras tres fugas clásicas son más insidiosas porque no parecen almacenamiento. Los registros de aplicación capturan de buena gana una cabecera completa durante la depuración y luego la envían a un agregador que ve todo el equipo. Las URL en parámetros de consulta atraviesan proxies y acaban en los registros de acceso de cada intermediario. Y una clave pegada en un mensaje de Slack o un ticket permanece allí indefinidamente, visible para personas que no estaban en el equipo el día que se compartió. En los cuatro casos, la clave no fue «robada»: la copiaron sistemas que hacían su trabajo.

Almacenes recomendados

La contrapartida de esta regla es que las claves necesitan un lugar legítimo donde vivir. Un gestor de secretos cumple tres funciones que un fichero nunca podrá ofrecer: cifra en reposo, registra quién leyó qué y permite sustituir un valor sin volver a desplegar la aplicación. La elección depende sobre todo de tu infraestructura existente: usar la herramienta de tu proveedor de nube te ahorra una integración más.

  • HashiCorp Vault: solución completa con rotación automática, políticas de acceso y pista de auditoría
  • AWS Secrets Manager: integración nativa con el ecosistema AWS, rotación automática
  • Google Secret Manager: equivalente en GCP, integración con Cloud Run y GKE
  • Azure Key Vault: solución de Microsoft Azure
  • Doppler: solución independiente de la nube, interfaz sencilla
  • 1Password / Bitwarden: para equipos pequeños, incluye CLI

Configuración recomendada

# Mal: clave hardcodeada en un script
MANAGEMENT_API_KEY="xai-mgmt-abc123..."  # NO HAGAS ESTO

# Bien: recuperar desde un almacén
MANAGEMENT_API_KEY=$(vault kv get -field=key secret/xai/management)

# Bien: variable de entorno inyectada por CI/CD
# La clave se configura en los secretos del pipeline (GitHub Actions, GitLab CI, etc.)

Rotación periódica

Política de rotación

Define una política de rotación adaptada a tu contexto:

Nivel de riesgoFrecuencia de rotaciónEjemplos
AltoCada 30 díasClaves con acceso total (comodín)
MedioCada 90 díasClaves de producción con ACL restringidas
BajoCada 180 díasClaves de desarrollo local

Automatizar la rotación

import requests
from datetime import datetime, timedelta

MANAGEMENT_API = "https://management-api.x.ai"
MGMT_KEY = "xai-mgmt-..."
TEAM_ID = "team-..."
ROTATION_DAYS = 90  # Rotar cada 90 días

def check_and_rotate():
    """Comprueba la antigüedad de la clave y la rota si es necesario."""
    response = requests.get(
        f"{MANAGEMENT_API}/auth/teams/{TEAM_ID}/api-keys",
        headers={"Authorization": f"Bearer {MGMT_KEY}"}
    )
    keys = response.json().get("apiKeys", [])
    now = datetime.now()

    for key in keys:
        created = datetime.fromisoformat(key.get("createdAt", "").replace("Z", "+00:00"))
        age_days = (now - created.replace(tzinfo=None)).days

        if age_days >= ROTATION_DAYS:
            key_id = key.get("id")
            name = key.get("name", "Unnamed")
            print(f"Rotación requerida para [{name}] (antigüedad: {age_days} días)")

            # Realizar rotación
            rotate_resp = requests.post(
                f"{MANAGEMENT_API}/auth/api-keys/{key_id}/rotate",
                headers={"Authorization": f"Bearer {MGMT_KEY}"}
            )

            if rotate_resp.status_code == 200:
                new_secret = rotate_resp.json().get("secret")
                print(f"  Nueva clave generada. Actualiza tu almacén.")
                # Guardar new_secret en tu almacén
            else:
                print(f"  Error de rotación: {rotate_resp.status_code}")

check_and_rotate()

Principio de mínimo privilegio

ACL granulares

El mínimo privilegio se reduce a responder una pregunta precisa: si esta clave se filtra mañana, ¿qué podrá hacer un tercero con ella? Una clave limitada al endpoint de chat y a un único modelo da una respuesta corta. Una clave con comodín da una respuesta que empieza por «todo». El coste de la restricción es cero cuando creas la clave, y precisamente por eso debes fijarlo en ese momento y no después del incidente.

{
  "acls": ["api-key:endpoint:chat", "api-key:model:grok-4.3"],
  "qps": 10,
  "qpm": 100
}

Evita los comodines (*) en producción. Si tu aplicación solo usa chat con un único modelo, concede acceso solo a eso.

Límites de tasa como red de seguridad

Las ACL dicen qué puede hacer la clave; los límites de tasa dicen cuánto. La distinción importa, porque una clave de chat legítimamente restringida puede aun así generar una factura considerable si nadie limita su throughput. Configura qps, qpm y tpm en cada clave, calibrados al uso real y no a picos imaginables: una aplicación que maneja diez solicitudes por segundo en hora punta no tiene motivo para estar autorizada a mil. Este tope no te protege de una fuga, pero convierte un gasto catastrófico en uno contenido y te gana tiempo para detectar la anomalía antes de que cueste caro.

Auditoría y monitorización

Registros de auditoría

Mantén un diario de todas las operaciones de management:

import logging
from datetime import datetime

# Configurar logging
logging.basicConfig(
    filename="/var/log/xai-management-audit.log",
    level=logging.INFO,
    format="%(asctime)s | %(levelname)s | %(message)s"
)

def log_operation(operation, key_name, details=""):
    """Registra una operación de management en el diario de auditoría."""
    logging.info(f"{operation} | Clave: {key_name} | {details}")

# Ejemplos de uso
log_operation("CREATE", "prod-backend-v2", "ACL: chat+embed, QPS: 50")
log_operation("ROTATE", "prod-backend-v2", "Rotación programada 90d")
log_operation("DELETE", "dev-former-intern", "Salida del equipo")

Alertas de seguridad

Un registro solo sirve para investigar; lo que te protege en tiempo real es la alerta. El principio para elegir qué monitorizar es sencillo: alerta sobre eventos que no tienen razón de ocurrir en operación normal, porque solo esos mantendrán una tasa de falsos positivos lo bastante baja para que el equipo siga leyéndolos. Cinco señales merecen este estatus.

  • Creación de una clave con comodines en producción
  • Intento de login con una clave no válida (pico de 401)
  • Consumo anómalo detectado (pico inesperado)
  • Factura en estado FAILED (riesgo de interrupción del servicio)
  • Clave próxima a expirar (7 días antes)

Lista de comprobación de seguridad completa

Aquí tienes, condensado, lo que aportan en la práctica las cuatro áreas. Esta lista solo tiene valor si se revisa en el momento adecuado: la primera parte en el despliegue, la segunda a intervalos regulares y la tercera el día que descubres que una clave se ha filtrado, el día en que nadie tendrá la calma para improvisar un procedimiento.

Despliegue inicial

  • Claves almacenadas en un almacén, nunca en texto plano
  • ACL restrictivas (sin comodines en producción)
  • Límites de tasa configurados para cada clave
  • Healthcheck automático de la clave de management
  • Script de auditoría de claves en su sitio

Operaciones habituales

  • Rotar claves según la política definida (30/90/180 días)
  • Auditoría mensual de claves y sus permisos
  • Revisión de claves cuando un miembro del equipo se va
  • Comprobar facturas (detectar estados FAILED)
  • Monitorizar picos de consumo anómalos

Respuesta a incidentes

  • Procedimiento de rotación de emergencia documentado
  • Capacidad para restringir ACL de inmediato (vía PUT)
  • Capacidad para eliminar una clave comprometida (vía DELETE)
  • Contactos de emergencia identificados (equipo de seguridad, soporte de xAI)

Puntos clave

  • Almacena todas las claves en un almacén de secretos; nunca en texto plano en el código
  • Aplica el mínimo privilegio: ACL restringidas, sin comodines en producción
  • Automatiza la rotación de claves según una política definida (de 30 a 180 días)
  • Configura auditorías periódicas y alertas para eventos críticos
  • Documenta tu procedimiento de respuesta a incidentes para claves comprometidas
  • Combina ACL restringidas, límites de tasa y límites de gasto para una protección en capas

Pon a prueba tus conocimientos

Gestión de claves, facturación y uso mediante la API: el recorrido está completo.

1. ¿Para qué sirve la API de Management?

Respuesta: Para administrar programáticamente tu cuenta de xAI: claves de API (crear, modificar, rotar, eliminar), facturación, límites y analíticas; la administración se vuelve scriptable.

2. ¿Cómo aseguras el ciclo de vida de una clave?

Respuesta: Una clave por caso de uso, rotación periódica (crear nueva, cambiar, eliminar la antigua) y eliminación inmediata en caso de duda; todo automatizable mediante la API.

3. ¿Qué salvaguardas financieras puedes implementar?

Respuesta: Límites de gasto, créditos prepago y recargas automáticas monitorizadas; control del presupuesto por configuración, no por sorpresa en la factura.

4. ¿Qué aportan las analíticas de uso?

Respuesta: Consumo por clave y por modelo, informes avanzados; suficiente para asignar costes, detectar anomalías y dimensionar niveles.

5. ¿Qué precaución especial requiere la propia clave de management?

Respuesta: Es la clave de las claves: máximo alcance, por tanto máxima protección; nunca en cliente, acceso restringido, validación periódica y rotación como las demás.

Claves gobernadas, presupuesto acotado, uso medido: la administración de xAI se codifica y se asegura al nivel de lo que protege.