> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wirespeed.co/llms.txt
> Use this file to discover all available pages before exploring further.

# OpenAI Platform

> Supervisar la actividad administrativa, de configuración y de autenticación en su organización de OpenAI API Platform

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.

> [!NOTE]
>
> 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](https://platform.openai.com/)
2. Abra **Settings** → **Data controls** → **Data retention**
3. En **Audit logging**, haga clic en **Enable**
4. Guarde los cambios

> [!WARNING]
>
> 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](https://platform.openai.com/settings/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

> [!WARNING]
>
> OpenAI muestra la clave una sola vez. Si se pierde, elimínela y cree otra
> clave. Guárdela de forma segura.

> [!NOTE]
>
> 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**](https://app.wirespeed.co/settings/integrations?tab=browse)
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.

> [!NOTE]
>
> 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:

| Detección | Condición |
| - | - |
| Lista de IP permitidas modificada | Se crea, actualiza, elimina, activa o desactiva una lista de permitidos |
| Rol de propietario o administrador asignado | Un usuario o una cuenta de servicio recibe acceso elevado |
| Configuración SCIM modificada | El aprovisionamiento SCIM se habilita o deshabilita |
| Clave de API elevada | Se crea una clave de API con **All** del panel (`scopes` vacíos), o se crea/actualiza con un alcance `.write` / `:write` / `admin` |

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:

```bash theme={null}
curl -sS "https://api.openai.com/v1/organization/audit_logs?limit=5" \
  -H "Authorization: Bearer $OPENAI_ADMIN_KEY"
```

`"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

* [OpenAI Admin and Audit Logs API](https://help.openai.com/en/articles/9687866-admin-and-audit-logs-api-for-the-api-platform)
* [OpenAI Admin APIs guide](https://developers.openai.com/api/docs/guides/admin-apis)
* [OpenAI Audit Logs API reference](https://developers.openai.com/api/reference/resources/organization/subresources/audit_logs/)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.