Usa la API de Cumplimiento en los flujos de trabajo de seguridad, asuntos legales, gobernanza e investigación que requieran registros auditables. Para medir la adopción y las tendencias, usa datos de análisis en lugar de registros de cumplimiento.
La referencia de la API de administración es la fuente oficial de información actualizada sobre los requisitos de acceso, los eventos cubiertos, las rutas, los esquemas, los filtros, la retención y el procesamiento de solicitudes.
Para conocer las opciones de cumplimiento disponibles y los patrones de integración habituales, consulta la guía de la plataforma de cumplimiento.
Cuándo usar la API de Cumplimiento
Usa la API de Cumplimiento cuando necesites:
- Exportar los registros admitidos a un sistema de auditoría o investigación.
- Aplicar los procesos de retención y preservación por motivos legales de tu organización.
- Correlacionar la actividad de Codex con otros datos de seguridad o identidad.
- Respaldar investigaciones autorizadas en materia de seguridad, asuntos legales o gobernanza.
La API no es un panel de productividad. No la uses para inferir la calidad del código ni el desempeño individual. Para generar informes de adopción, usa los análisis del espacio de trabajo o la API de análisis.
Primeros pasos
- Abre la referencia de la API de administración y confirma que tu rol de administrador te da acceso a los recursos de cumplimiento que necesitas.
- Para recopilar registros de forma continua, usa el flujo de registros de cumplimiento, que solo permite agregar entradas. Consulta la referencia de la API para saber qué recursos y métodos de recuperación admite actualmente.
- Descarga los archivos de registro y, en un entorno que no sea de producción, prueba su ingesta en un sistema de gestión de información y eventos de seguridad (SIEM) o en un lago de datos.
- Programa la recopilación continua y aplica a los registros exportados los controles de acceso, retención y preservación por motivos legales de tu organización. No des por sentado que el plazo de retención en el origen sustituye la política de retención de tu organización.
Por ejemplo, un equipo de seguridad puede transmitir eventos de cumplimiento inmutables a su SIEM para realizar investigaciones o dirigir esos eventos a un flujo de trabajo autorizado de descubrimiento electrónico de pruebas. Consulta la referencia de la API para obtener las rutas y los esquemas vigentes en lugar de copiar de esta guía el contrato de un punto de acceso.
Descarga de registros
Descarga el script de Bash o el script de PowerShell. Ambos recorren todas las páginas de resultados, enumeran y descargan todos los archivos de registro disponibles posteriores a la marca de tiempo indicada y escriben los datos en formato JSONL en la salida estándar. Los errores se envían a la salida de error estándar.
Asigna a COMPLIANCE_API_KEY el valor de tu clave de la API de Cumplimiento de Enterprise. Reemplaza <workspace_or_org_id> por el ID de tu espacio de trabajo de ChatGPT o el ID de la organización en la Plataforma API, y <after> por una marca de tiempo en formato ISO 8601 que incluya la zona horaria. Este ejemplo recupera archivos AUTH_LOG en lotes de 100.
En macOS o Linux, instala Bash, curl y jq. Luego ejecuta:
bash ./download_compliance_files.sh "<workspace_or_org_id>" AUTH_LOG 100 "<after>" > output.jsonlEl script para Windows es compatible con PowerShell 5.1 y versiones posteriores. Revisa el archivo descargado. Si Windows lo bloquea y la política de ejecución de tu organización permite desbloquearlo, ejecuta Unblock-File -Path .\download_compliance_files.ps1. Este ejemplo usa PowerShell 7 para guardar el archivo en UTF-8 sin marca de orden de bytes:
.\download_compliance_files.ps1 "<workspace_or_org_id>" AUTH_LOG 100 "<after>" |
Set-Content -Encoding utf8NoBOM output.jsonlRegistros de auditoría para el acceso a la computadora local con la nube de Work
La API de Cumplimiento ofrece la misma cobertura para el acceso a la computadora local con la nube de Work que para la nube de Work. Los registros aparecen en los tipos de evento conversation_message y codex_log. La ejecución local también genera eventos de OpenTelemetry (OTel), que puedes recopilar si configuras un punto de acceso para el recopilador de OTel. Recopila estos eventos locales por separado de los registros de la API de Cumplimiento. Estas fuentes no proporcionan un registro exhaustivo de todos los comandos locales, operaciones con archivos, capturas de pantalla, aprobaciones o acciones externas.
Al configurar la recopilación:
-
Usa
conversation_messageycodex_logpara los registros admitidos del modo Work. Consulta la referencia de la API para conocer sus esquemas, identificadores de acciones y marcas de tiempo. -
Confirma cómo se retienen y eliminan los registros en el flujo de trabajo.
-
Ejecuta una tarea representativa y compara los registros exportados con las acciones realizadas.
Automatización de políticas. Usa la API de políticas para administrar la configuración global. Administra la configuración de Local y Codex Cloud en la interfaz de seguridad de agentes. Los flujos de trabajo existentes que usan la API para la configuración global siguen disponibles después de la migración. Prueba los scripts y las integraciones con Terraform y confirma que se mantienen las asignaciones y el orden de las políticas. Revisa la automatización de políticas por separado de la recuperación de registros de auditoría. La compatibilidad con la API de políticas no cambia los eventos que cubre la API de Cumplimiento.
Auditoría mediante hooks. Si están habilitados en tu espacio de trabajo, usa los hooks de MCP definidos por el administrador. Estos hooks se ejecutan en el coordinador de la nube (orquestador) para los eventos de ciclo de vida y de herramientas admitidos. Antes de reemplazar un flujo de trabajo de auditoría existente, prueba la conexión de la función de devolución de llamada, la cobertura de eventos y el comportamiento ante fallas. Verifica estos registros por separado de la cobertura de la API de Cumplimiento.
Confirma el alcance administrativo
La cobertura de cumplimiento abarca el espacio de trabajo de ChatGPT y los productos que figuran en la referencia vigente de la API. Los datos de las organizaciones de la Plataforma API se rigen por los controles de datos y administración propios de esa API.
La referencia de la API especifica las rutas, los eventos cubiertos, los esquemas, los filtros, el comportamiento de retención, los permisos necesarios y el funcionamiento de las solicitudes. Esta página no reproduce ese contrato.