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

Auditoría de seguridad y acceso

Lección 17 de 20 Actualizado el 3 de noviembre de 2026 Desarrollador
En esta página
  1. Controlar qué puede ver y hacer Codex
  2. El modelo de seguridad de Codex
  3. Ocultar lo que no debe leerse
  4. Rastreo y monitorización
  5. Cumplimiento y normativa
  6. Mejores prácticas de seguridad
  7. Puntos clave

Lección reescrita el 3 de noviembre de 2026 basándose en las páginas Agent approvals & security, Rules, Compliance API and audit events y el manual de Codex. La versión anterior describía un archivo .codexignore inexistente, afirmaba que Codex solo ejecuta comandos listados en AGENTS.md, citaba un menú «Organization Settings → Audit Logs» y mencionaba una certificación SOC 2 Type II de Codex sin fuente. Fuentes: Agent approvals & security · Rules · Compliance API · Pricing.

Controlar qué puede ver y hacer Codex

La seguridad se vuelve crítica en el momento en que un agente de IA accede a tu código fuente. Codex incluye salvaguardas integradas, pero configurarlas es responsabilidad tuya: el producto proporciona el aislamiento, mientras que tú defines el perímetro. Si conectas un repositorio por comodidad durante una urgencia nocturna o dejas un secreto en un archivo de configuración olvidado, el aislamiento técnico no te protegerá.

El modelo de seguridad de Codex

Dos configuraciones complementarias gobiernan lo que el agente puede hacer: la sandbox (entorno aislado), que define qué puede tocar técnicamente, y la política de aprobación, que determina cuándo debe detenerse y pedir permiso, como al salir de la sandbox, usar la red o ejecutar un comando fuera del conjunto permitido.

  • Localmente (CLI, extensión, aplicación de escritorio), los mecanismos a nivel de sistema operativo hacen cumplir la sandbox. Por defecto, no hay acceso a la red y las operaciones de escritura se limitan al espacio de trabajo activo. Con el preajuste común --sandbox workspace-write --ask-for-approval on-request, Codex lee, modifica y ejecuta libremente dentro del directorio de trabajo, pero pregunta antes de escribir en otro lugar o usar la red. El modo read-only (mediante el comando /permissions) te permite discutir y planificar sin realizar cambios.
  • En la nube, cada tarea de Codex Cloud se ejecuta en su propio espacio de trabajo dentro de un entorno gestionado por OpenAI; las credenciales y el acceso a la red se configuran por entorno, y los secretos de red se limitan a servicios HTTPS autorizados.

Al contrario de lo que afirmaba la versión anterior de esta lección, Codex no está restringido a los comandos listados en AGENTS.md: puede ejecutar comandos, limitado por el par sandbox/aprobación. Para ir más allá, las reglas gobiernan los comandos permitidos fuera de la sandbox: una regla de prefijo puede requerir confirmación o prohibir un comando por completo.

# Archivo .rules (sintaxis Starlark)
prefix_rule(
    pattern = ["curl"],
    decision = "prompt",
    justification = "Todas las solicitudes de red salientes deben confirmarse.",
)

Aplicadas por el administrador, estas reglas solo pueden requerir confirmación o prohibir acciones; no pueden otorgar autorización automática.

Ocultar lo que no debe leerse

No existe ningún archivo .codexignore. Para evitar que Codex lea archivos sensibles, incluso si están versionados, utiliza un perfil de permisos con reglas deny en rutas exactas o patrones:

# ~/.codex/config.toml
[permissions.project-edit.filesystem]
glob_scan_max_depth = 3

[permissions.project-edit.filesystem.":workspace_roots"]
"**/*.env" = "deny"

Colocada bajo :workspace_roots, la regla se aplica a cada raíz del espacio de trabajo: los archivos .env se vuelven ilegibles allí, sin bloquear escrituras normales en otros lugares. Las rutas exactas funcionan bien para ubicaciones estables como ~/.ssh; los patrones son adecuados para archivos con ubicaciones variables. Un administrador puede aplicar estas denegaciones en toda la organización (permissions.filesystem.deny_read).

La documentación señala dos limitaciones. En Linux, WSL y Windows, las coincidencias de patrones se resuelven al inicio de cada proceso de sandbox: un archivo coincidente creado posteriormente permanece legible para un proceso ya en ejecución. Además, un patrón ** sin límites requiere glob_scan_max_depth. El enfoque más seguro sigue siendo mantener los secretos fuera del repositorio por completo.

Aplica la misma precaución a AGENTS.md, que Codex lee en cada ejecución. Nunca coloques secretos reales allí: los valores ficticios bastan para explicar el formato esperado por tus comandos de prueba.

## Variables de entorno
Los comandos de prueba usan variables ficticias:
- DATABASE_URL=postgresql://test:test@localhost:5432/test_db
- AUTH_SECRET=test-secret-for-development-only

Rastreo y monitorización

En los planes Enterprise y Edu, los registros de auditoría y el seguimiento del uso se gestionan a través de la API de cumplimiento (Compliance API). Soporta usos de seguridad, legales e investigativos que requieren registros verificables: exportar eventos a un SIEM o lago de datos, aplicar tus periodos de retención y retenciones legales, y correlacionar la actividad de Codex con tus datos de identidad. La documentación de la Admin API rige los eventos cubiertos, los filtros y la retención; prueba la ingesta en un sistema que no sea de producción antes de programar la recogida continua.

Esto no es un panel de productividad: OpenAI desaconseja usarlo para juzgar la calidad del código o el rendimiento individual, refiriéndose en su lugar a las perspectivas del espacio de trabajo y a la API de Analytics para métricas de adopción. Alguien debe usar realmente estos registros más allá de las revisiones posteriores a incidentes: mantenlos fuera del entorno controlado por el agente y configura alertas para fallos de autenticación repetidos, accesos inusuales y cambios de configuración.

Cumplimiento y normativa

Si tu código maneja datos personales europeos, cuatro puntos recaen bajo tu responsabilidad, no la del proveedor. Asegúrate de que tu contrato con OpenAI incluya un DPA (Acuerdo de Procesamiento de Datos); utiliza controles de retención y residencia de datos cuando tu plan los ofrezca (Enterprise y Edu); documenta el uso de Codex en tu registro de actividades de tratamiento; y, finalmente, informa a los equipos de que su código es procesado por un servicio de terceros. En el plan Business, los datos de la empresa no se utilizan para el entrenamiento por defecto.

Para una auditoría SOC 2 o ISO 27001, confía en los documentos publicados por OpenAI, incluido el Codex Security Whitepaper en su portal de confianza, y verifica el alcance y la fecha de cada atestación: una atestación caducada, o una que no cubra el servicio que utilizas, no tiene peso ante un auditor. Las exportaciones de la Compliance API cumplen los requisitos de trazabilidad, siempre que se recojan de forma continua y se produzcan cuando se soliciten.

Mejores prácticas de seguridad

Hacer
  • - Prohibir la lectura de archivos sensibles (reglas `deny`)
  • - Recopilar y auditar registros de la Compliance API
  • - Limitar los repositorios conectados al mínimo necesario
  • - Usar SSO con MFA
  • - Revisar las PR de Codex antes de fusionar
No hacer
  • - Conectar repositorios con secretos en el código
  • - Poner tokens reales en AGENTS.md
  • - Fusionar automáticamente sin revisión
  • - Ignorar las alertas de auditoría
  • - Compartir una cuenta de Codex entre desarrolladores

El uso compartido de cuentas, el último elemento de la columna derecha, merece una mención especial: anula instantáneamente todo el valor de los registros de auditoría, ya que ninguna acción puede vincularse a una persona identificable.

Puntos clave

  • La sandbox delimita qué puede tocar Codex (localmente: sin red, escrituras limitadas al espacio de trabajo por defecto); la política de aprobación establece cuándo pregunta
  • Las reglas gobiernan los comandos fuera de la sandbox (prompt o forbidden)
  • .codexignore no existe: prohíbe la lectura de archivos sensibles mediante reglas deny en un perfil de permisos
  • Los registros de auditoría pasan por la Compliance API (Enterprise y Edu)
  • Verifica el cumplimiento del RGPD si manejas datos europeos
  • Nunca pongas secretos reales en AGENTS.md