Saltar al contenido principal
La integración OpenAI Platform recopila registros de auditoría de la organización para la supervisión de seguridad y la detección. Cubre cambios administrativos, actividad de claves de API, configuración de identidad e intentos de inicio de sesión sin requerir software en los dispositivos de los empleados.
Esta integración se conecta a la API Platform de OpenAI en platform.openai.com. No usa credenciales de la ChatGPT Enterprise Admin Console ni recopila el contenido de prompts ni de respuestas.

​
Requisitos previos

Antes de configurar esta integración, asegúrese de que:
  1. Es Organization Owner en OpenAI API Platform
  2. Puede cambiar los controles de datos de la organización
  3. Puede crear una clave de API de Admin de API Platform

​
Paso 1: Habilitar el registro de auditoría

  1. Inicie sesión en OpenAI Platform
  2. Abra Settings → Data controls → Data retention
  3. En Audit logging, haga clic en Enable
  4. Guarde los cambios
Habilitar el registro de auditoría es, en la práctica, unidireccional. No se puede deshabilitar en la configuración de la organización; un Organization Owner debe contactar con OpenAI Support para solicitar un cambio.
El registro de auditoría debe estar habilitado antes de que OpenAI ponga los registros de auditoría a disposición a través de la API. OpenAI no rellena la actividad anterior a la activación de este ajuste. Una organización recién habilitada puede devolver un registro de auditoría vacío hasta que alguien realice una acción administrativa tras la habilitación.

​
Paso 2: Crear una clave de API de Admin restringida

  1. Abra Organization Admin keys
  2. Haga clic en Create new admin key
  3. Introduzca un nombre descriptivo, por ejemplo Wirespeed Audit Logs
  4. En Permissions, seleccione Restricted
  5. Establezca Audit Logs Scope en Read
  6. Deje deshabilitados los permisos de gestión no relacionados
  7. Cree la clave y cópiela de inmediato
OpenAI muestra la clave una sola vez. Si se pierde, elimínela y cree otra clave. Guárdela de forma segura.
Use una clave de Admin de API Platform, cuya forma redactada comienza por sk-admin.... Las claves estándar de modelo/proyecto y las claves de Admin del espacio de trabajo de ChatGPT no pueden acceder a este endpoint. Wirespeed no requiere Organization Administration Write.

​
Paso 3: Conectar OpenAI Platform a Wirespeed

  1. En Wirespeed, abra Integraciones → Añadir integración
  2. Busque y seleccione OpenAI Platform
  3. Pegue la clave de Admin de API
  4. Haga clic en Integrate
Wirespeed valida la clave frente al endpoint de Audit Logs de la organización antes de habilitar la integración. Una conexión correcta solo demuestra que la clave puede llamar a ese endpoint. No significa que ya existan eventos.

​
¿Qué eventos se recopilan?

Wirespeed importa todos los tipos de evento que devuelve la API de Audit Logs de la organización de OpenAI, entre ellos:
  • Éxitos y fallos de inicio y cierre de sesión
  • Cambios de usuarios, invitaciones, grupos y cuentas de servicio
  • Asignaciones de roles y permisos
  • Creación, actualización y eliminación de claves de API
  • Cambios en la lista de IP permitidas y en la configuración SCIM
  • Cambios de proyecto, organización y límites de velocidad
  • Cambios de identidad de carga de trabajo, túnel, certificado y claves externas
La primera sincronización solicita hasta siete días de historial disponible. Los eventos anteriores a la habilitación del registro de auditoría no están disponibles. OpenAI retiene los registros de auditoría según el mejor esfuerzo y no garantiza un periodo de retención fijo.
Los registros de auditoría de OpenAI contienen metadatos administrativos, no el contenido de solicitudes ni respuestas del modelo. Los ajustes de Zero Data Retention de OpenAI no cambian la disponibilidad de los registros de auditoría.

​
Detecciones gestionadas

Wirespeed evalúa los eventos recopilados en busca de: Los inicios de sesión correctos y fallidos también se normalizan como eventos de autenticación para búsquedas SIEM y detecciones de inicio de sesión entre plataformas. Wirespeed no crea una detección individual por cada inicio de sesión.

​
Resolución de problemas

​
Clave de API no válida

Para errores 401:
  1. Confirme que se pegó la clave completa sin espacios
  2. Confirme que es una clave de Admin de API Platform, no una clave de API estándar de OpenAI
  3. Si la clave se eliminó o se perdió, cree un reemplazo y actualice Wirespeed

​
Falta el permiso de Audit Log

Para errores 403 o de alcance faltante:
  1. Cree la clave como Organization Owner de OpenAI API Platform
  2. Seleccione permisos Restricted
  3. Establezca Audit Logs Scope en Read
  4. Sustituya la clave en Wirespeed

​
La integración se conecta pero no aparecen eventos

Una integración en buen estado con solo un registro «Integration added» suele significar que OpenAI devolvió una lista vacía. Confirme que existen eventos en el proveedor antes de esperarlos en Wirespeed:
"data": [] con "has_more": false significa que no hay nada que Wirespeed pueda ingestar. A continuación:
  1. Confirme que el registro de auditoría está Active en Data controls → Data retention
  2. Cree y elimine una clave de API de project, o cierre sesión e inicie sesión de nuevo
  3. Espere unos minutos y vuelva a ejecutar la solicitud hasta que data contenga eventos
  4. Espere un minuto más para que Wirespeed realice el sondeo
No use la clave de Admin pegada en Wirespeed como clave de modelo. Las claves de API de proyecto y la actividad de sesión del panel son lo que produce registros de auditoría.

​
Limitación de velocidad

OpenAI puede devolver respuestas 429 durante una recopilación de alto volumen. Wirespeed reintenta la recopilación en una sincronización posterior sin avanzar más allá de la ventana incompleta.

​
Recursos adicionales