Codex CLI: Sandbox y seguridad
Codex CLI incluye mecanismos de sandbox y políticas de seguridad para garantizar la protección del sistema y de los datos mientras te ayuda a programar. Esta sección detalla estos mecanismos de seguridad y cómo configurarlos.
Mecanismo de sandbox
Codex ejecuta comandos y opera archivos en un entorno de sandbox aislado. Este diseño garantiza:
- Las modificaciones a los archivos de tu proyecto son controlables
- Los comandos potencialmente peligrosos requieren tu confirmación
- Los datos sensibles no se filtran accidentalmente
El sandbox es la primera línea de defensa de la política de seguridad de Codex; garantiza que las operaciones de la IA no excedan el alcance que esperas.
Política de ejecución
Codex utiliza una política de ejecución (Execution Policy) para controlar el comportamiento de diferentes tipos de operaciones:
Tipos de política
| Política | Comportamiento | Escenario aplicable |
|---|---|---|
ask | Preguntar confirmación antes de cada ejecución | Desarrollo diario (predeterminado) |
approve | Aprobar ejecución automáticamente | Entorno de total confianza |
deny | Rechazar todas las operaciones que puedan causar efectos secundarios | Modo de solo lectura |
Operaciones que requieren confirmación
Los siguientes tipos de operaciones activarán solicitudes de confirmación:
- Ejecutar comandos de Shell (especialmente
rm、killetc.) - Modificar o eliminar archivos
- Crear nuevos archivos
- Acceder a directorios sensibles (como
~/.ssh/、/etc/) - Solicitudes de red (en ciertos casos)
Configurar la política de ejecución
Establecer la política de ejecución en la configuración
default_policy = "ask"
Por razones de seguridad, no se recomienda establecer la política predeterminada como
approve, a menos que comprendas completamente los riesgos potenciales.
Diálogo de confirmación
Cuando Codex necesita realizar una operación sensible, se muestra un diálogo de confirmación:
══════════════════════════════════════════════════════ 确认执行 ══════════════════════════════════════════════════════ Codex 计划执行以下操作: 命令: rm -rf node_modules/ 目录: /path/to/project 这将永久删除目录及其所有内容 [Y] 确认执行 [N] 取消 [A] 始终允许此类操作 ══════════════════════════════════════════════════════
Descripción de opciones
| Opción | Descripción |
|---|---|
Y | Ejecutar solo esta vez |
N | Cancelar la operación |
A | Agregar regla y aprobar automáticamente en el futuro |
Ten cuidado al elegir "Permitir siempre"; asegúrate de que la operación sea realmente segura.
Control de acceso a archivos
Directorios protegidos
Ciertos directorios del sistema están protegidos por defecto; Codex solicitará confirmación adicional al acceder a ellos:
| Directorio | Descripción |
|---|---|
~/.ssh/ | Claves y configuración SSH |
~/.aws/ | Credenciales de AWS |
/etc/ | Configuración del sistema |
~/.git-credentials | Almacenamiento de credenciales de Git |
Reglas de protección personalizadas
Puedes agregar reglas de protección personalizadas en la configuración:
Configurar reglas de acceso a archivos
# Directorios a los que se permite el acceso
allowed_paths = [
"~/projects/*",
"/workspace/*"
]
# Directorios protegidos (requieren confirmación adicional)
protected_paths = [
"~/.ssh/*",
"~/secrets/*"
]
Control de acceso a la red
Codex puede restringir el alcance de las solicitudes de red:
Configurar el acceso a la red
# Dominios permitidos
allowed_domains = [
"github.com",
"api.openai.com"
]
# Si se permite el acceso a la red local
allow_localhost = false
# Si se permite la red privada
allow_private_network = false
Restringir el acceso a la red evita que Codex se conecte accidentalmente a servicios no confiables.
Restricción del directorio de trabajo
Puedes limitar Codex para que solo opere en directorios específicos:
Limitar el directorio de trabajo
# Codex solo puede operar en estos directorios
working_directories = [
"~/projects/*",
"/workspace/*"
]
# Comportamiento al salir del directorio: warn (advertencia) o deny (denegar)
out_of_bounds = "deny"
Lista blanca/negra de comandos
Modo de lista blanca (recomendado)
Solo permite ejecutar los comandos explícitamente listados:
Lista blanca de comandos
# Modo de lista blanca
whitelist_enabled = true
allowed_commands = [
"git",
"npm",
"node",
"python",
"cargo"
]
Modo de lista negra
Prohíbe ejecutar comandos específicos:
Lista negra de comandos
# Modo de lista negra
blacklist_enabled = true
blocked_commands = [
"rm -rf /",
"dd",
"mkfs"
]
El modo de lista blanca es más seguro; se recomienda usarlo en entornos de producción o al manejar proyectos sensibles.
Manejo de datos sensibles
Enmascaramiento automático
Codex detecta y enmascara automáticamente la información sensible:
- Claves de API y contraseñas
- Tokens e información de autenticación
- Información de identificación personal (PII)
Protección de variables de entorno
Algunas variables de entorno se ocultan automáticamente:
AWS_ACCESS_KEY_ID AWS_SECRET_ACCESS_KEY OPENAI_API_KEY DATABASE_URL
Especificar manualmente datos sensibles
Puedes marcar manualmente en la configuración el contenido que necesita protección:
Personalizar patrones de datos sensibles
# Patrones de expresión regular que deben enmascararse
patterns = [
"password\\s*=\\s*[^\\s]+",
"api_key\\s*=\\s*[^\\s]+",
"secret\\s*=\\s*[^\\s]+"
]
Registro de auditoría
Codex puede registrar un registro de auditoría de todas las operaciones:
Habilitar el registro de auditoría
enabled = true
log_file = "~/.codex/log/audit.log"
Contenido del registro
El registro de auditoría registra la siguiente información:
- Marca de tiempo
- Tipo de operación
- Archivos o comandos involucrados
- Resultado de la operación (éxito/fracaso)
- Estado de confirmación del usuario
Ver el registro de auditoría
tail -f ~/.codex/log/audit.log
El registro de auditoría es muy importante para la auditoría de seguridad y la resolución de problemas, especialmente en entornos de equipo.
Mejores prácticas de seguridad
Entorno de desarrollo
- Usar la política de ejecución predeterminada (ask)
- Habilitar el registro de auditoría
- Configurar la lista blanca de comandos
Entorno de producción
- Limitar el directorio de trabajo
- Usar el modo de lista blanca
- Deshabilitar el acceso a la red innecesario
- Habilitar el registro de auditoría completo
Proyectos sensibles
- Usar las reglas de protección más estrictas
- Revisar cuidadosamente cada solicitud de confirmación
- Revisar periódicamente los registros de auditoría
Preguntas frecuentes
P: ¿Dónde se configura la política de ejecución?
La política de ejecución se configura principalmente a través de~/.codex/config.tomlel archivo de configuración. Algunas opciones también se pueden configurar mediante variables de entorno.
P: ¿Qué hago si hice clic por error en "Permitir siempre"?
Elimina la regla correspondiente en el archivo de configuración, o elimina todo el archivo de configuración y reinicia Codex; las reglas se restablecerán.
P: ¿Puede Codex acceder a mi token de GitHub?
Codex solicitará los permisos necesarios de acceso a GitHub para ejecutar operaciones. Puedes revocar estos permisos en cualquier momento desde la configuración de GitHub.
P: ¿Cómo deshabilitar completamente la modificación de archivos?
Establece la política de ejecución comodeny, esto evitará que Codex ejecute cualquier operación que pueda modificar el sistema de archivos.