Equipos, roles y registros de auditoría
En esta página
Cuando una única clave ya no es suficiente
En una organización grande, no todos los usuarios tienen las mismas necesidades ni los mismos derechos. Un desarrollador necesita llamar a la API, un director financiero necesita consultar la facturación y un administrador debe gestionarlo todo. Mientras tres personas compartan una única clave, el problema sigue siendo teórico y todos salen del paso. Pero en cuanto treinta personas de cinco proyectos distintos llaman a la misma API, la falta de estructura deriva en incidentes difíciles de atribuir y facturas que nadie sabe explicar. La oferta Enterprise de xAI estructura este acceso mediante un sistema de equipos y roles.
Qué abarca un equipo
Un equipo en xAI representa un grupo de usuarios que comparten recursos comunes: claves de API, grupos de capacidad aprovisionada, facturación y límites de gasto. Cada equipo dispone de sus propias claves con listas de control de acceso (ACL) específicas, límites de gasto independientes, métricas de uso separadas y una facturación trazable. En la práctica, un equipo que agota su presupuesto mensual no bloquea a los demás, y la dirección financiera puede responder a la pregunta «¿cuánto nos cuesta el proyecto del chatbot?» sin tener que reconstruir manualmente las cifras en una hoja de cálculo.
Suelen presentarse tres estructuras, y la elección correcta depende de cómo tome tu organización las decisiones presupuestarias. Dividir por departamento —equipe-engineering, equipe-data, equipe-support— funciona cuando cada servicio es dueño de su presupuesto y da cuenta de su consumo. Dividir por proyecto —projet-chatbot, projet-analyse, projet-recherche— tiene sentido cuando las iniciativas son transversales y se financian por separado, con colaboradores de varios servicios. Dividir por entorno —team-production, team-staging, team-dev— protege mejor la producción: un experimento que se descontrola y entra en un bucle infinito un viernes por la noche consume entonces el presupuesto de desarrollo, no el de atención al cliente.
Roles y el principio de mínimo privilegio
Los roles definen qué puede hacer cada miembro dentro de un equipo. El administrador se encarga de la gestión completa: claves, miembros, facturación y límites. El desarrollador crea y utiliza claves de API y consulta métricas, sin tocar la configuración del equipo. El lector ve métricas y facturación sin capacidad de modificación, lo cual encaja con perfiles de pilotaje y reporting. El rol de facturación, por último, gestiona los métodos de pago y consulta facturas, sin ningún acceso técnico.
Asigna a cada usuario únicamente los derechos necesarios para su misión. Este principio fundamental de seguridad limita el impacto de una cuenta comprometida, y su aplicación diaria es sencilla: un desarrollador de frontend solo necesita modelos de chat, no modelos de generación de imágenes; un científico de datos no tiene motivo para acceder a la facturación; un becario debería trabajar en modo de solo lectura. Aplicar esta matriz a una lista de usuarios existente casi siempre revela a dos o tres personas con derechos de administración porque era la solución más rápida en su fecha de inicio, y nadie lo ha revisado desde entonces.
Blindar cada clave con ACL
La API de Management permite definir controles de acceso granulares (ACL) sobre cada clave de API:
{
"name": "cle-chatbot-support",
"acls": [
"api-key:endpoint:chat",
"api-key:model:grok-4.3"
],
"qps": 10,
"qpm": 100,
"tpm": 500000,
"expireTime": "2026-12-31T23:59:59Z"
}
Esta clave ilustra exactamente el principio anterior: solo llama al extremo de chat, únicamente con grok-4.3, dentro de un límite de 10 solicitudes por segundo, y deja de funcionar a finales de año. Si se filtra, un atacante no podrá generar imágenes ni consultar un modelo más costoso, y su ventana de explotación queda acotada en el tiempo sin que tengas que intervenir. Las ACL cubren cuatro dimensiones: extremos autorizados entre chat, embed, image, tts, tokenize y documents; modelos accesibles, con restricción a uno o varios modelos específicos; límites de tasa expresados en solicitudes por segundo (QPS), por minuto (QPM) y tokens por minuto (TPM); y la fecha de caducidad de la clave.
La memoria de tu cuenta
Los registros de auditoría registran todas las acciones significativas realizadas en tu cuenta Enterprise: inicios y cierres de sesión de usuarios, creación, modificación y eliminación de claves de API, cambios de roles y permisos, modificaciones de facturación y límites de gasto, rotaciones de claves. Constituyen un elemento esencial tanto para el cumplimiento normativo como para la detección de incidentes.
Su utilidad se manifiesta en cuatro ámbitos. Para el cumplimiento, demuestran a los auditores que el acceso está controlado y trazado, lo cual alimenta directamente la documentación SOC 2 e HIPAA. Para la investigación, permiten reconstruir las acciones durante un incidente: saber qué clave se creó, quién la creó y a qué hora convierte una suposición en un hecho establecido y acorta considerablemente las reuniones de crisis. Para la optimización, revelan claves sin uso y patrones anómalos, por ejemplo una clave de prueba que sigue ejecutándose seis meses después de abandonar el prototipo. Por último, para la gobernanza, verifican que las políticas de acceso se respetan realmente, no solo quedan escritas en un memorando.
Puntos clave
- Los equipos permiten segmentar el acceso, la facturación y los límites por departamento o proyecto
- Los roles aplican el principio de mínimo privilegio a cada usuario
- Las ACL de las claves de API controlan los extremos, los modelos, los límites de tasa y la caducidad
- Los registros de auditoría trazan todas las acciones significativas para el cumplimiento y la investigación
- Estructura tus equipos desde el inicio para evitar deuda de gobernanza