Usa Seguridad de los agentes en la consola de administración para gestionar las políticas y la configuración. Esta sección reemplaza a Políticas y configuración. Su implementación es independiente de la del acceso a la computadora local para el modo Work y los dots.
Cuando se migran las políticas de nube anteriores que cumplen los requisitos, su configuración se transfiere a Global y se conservan sus asignaciones y su orden. Revisa las políticas migradas en Seguridad de los agentes. El acceso a la computadora local es opcional y se activa por separado para el modo Work y para los dots.
Dónde se aplica la configuración
Cada política parte de una configuración base en Global. Puedes definir excepciones por entorno para cambiar los ajustes de ejecución compatibles con Local o Codex Cloud. Cuando un entorno no tiene una excepción, hereda los ajustes de Global que le corresponden según esa política.
-
Global: define los controles del orquestador, incluidas las aprobaciones y la búsqueda web, así como los ajustes de ejecución compartidos.
-
Local: modifica los ajustes de ejecución compatibles para las tareas que se ejecutan en una computadora conectada.
-
Codex Cloud: modifica los ajustes de ejecución compatibles para las tareas de Codex en la nube. Puedes configurar estas políticas antes de habilitar Codex Cloud, pero solo se aplican una vez que lo habilitas en la página de permisos. Work Cloud tiene permisos de funciones independientes, que se describen en Cómo se aplica Seguridad de los agentes a Work Cloud.
Definir una configuración base y agregar ajustes por entorno
-
Abre Seguridad de los agentes y revisa las políticas existentes en Global, sus asignaciones y su orden. Comprueba que coincidan con los controles que tu organización quiere aplicar. Esta revisión no habilita el acceso a la computadora local con Work Cloud.
-
Revisa por separado Requisitos y Valores predeterminados. Los requisitos fijan límites que los usuarios no pueden anular. Los valores predeterminados establecen los valores iniciales dentro de esos límites.
-
Mantén los controles del orquestador en Global. Estos incluyen los requisitos de aprobación, los modos de búsqueda web permitidos y los controles administrados de las herramientas.
-
Agrega ajustes de entorno en Local o Codex Cloud para los controles de ejecución compatibles, como el entorno aislado, los permisos del sistema de archivos y el acceso administrado a la red durante la ejecución. Si necesitas limitar un ajuste a un sistema operativo, define una excepción específica para ese sistema.
-
Guarda la política y revisa los mensajes de validación sobre los ajustes que ingresaste.
Elegir controles y campos de configuración
El orquestador coordina la tarea. El ejecutor es la computadora o el contenedor en la nube que lleva a cabo un paso de ejecución. Configura los controles del orquestador en Global. Los ajustes de requirements.toml de cada entorno solo admiten controles de ejecución. Los ajustes del orquestador, como la política de aprobación y la búsqueda web, se mantienen en Global y no se pueden modificar por entorno.
Controles del orquestador
Configura estos controles en Global. Para el modo Work con acceso local y los dots, el orquestador compartido en la nube aplica los controles compatibles de la política de Global cuando se habilita la política administrada. Las excepciones por entorno se aplican a los ajustes de ejecución compatibles y no pueden modificar los controles del orquestador. De los requisitos de aprobación, búsqueda web, apps, MCP, complementos y reglas que se indican a continuación, solo Políticas de aprobación permitidas y Modos de búsqueda web permitidos tienen controles específicos en la interfaz de Seguridad de los agentes. Configura los demás campos mediante TOML.
| Control | Qué controla | Campos de requirements.toml |
|---|---|---|
| Políticas de aprobación y revisión | Cuándo necesita aprobación el agente y quién revisa la solicitud, incluida la opción de revisión automática. | allowed_approval_policiesallowed_approvals_reviewersauto_reviewguardian_policy_config |
| Modos de búsqueda web | Qué modos de búsqueda web puede usar el agente. | allowed_web_search_modes |
Apps, servidores MCP y plugins |
Qué apps, servidores MCP y complementos están disponibles y cómo se configuran. | appsmcp_serversplugins |
Reglas de comandos (rules) |
Qué comandos puede ejecutar el agente, cuáles requieren aprobación y cuáles no puede ejecutar. | rules |
hooks administrados |
Acciones que define el administrador para eventos compatibles de tareas y herramientas. | hooksallow_managed_hooks_only |
Hooks para el acceso a la computadora local con Work Cloud
En Global, usa Editar como TOML para configurar los manejadores mcp_tool para el modo Work con acceso a la computadora local y para los dots. Antes de confiar en un hook para bloquear una herramienta, prueba cómo responde tanto a las fallas de las llamadas de retorno como a las denegaciones explícitas. Consulta Hooks con orquestación en la nube para conocer los manejadores y eventos compatibles.
Global también incluye ajustes de escritorio y del cliente. Algunos solo se aplican a la app de escritorio. Configurar un ajuste en Global no implica que se aplique en todos los casos. Consulta la Referencia de configuración para saber dónde se admite cada campo.
Controles de ejecución (ejecutor)
Estos campos controlan cómo se ejecutan las tareas en una computadora o en un contenedor en la nube. Define los valores compartidos en Global. Usa excepciones en Local o Codex Cloud para los ajustes compatibles que deban tener un valor distinto en ese entorno.
| Control | Qué controla | Campos de requirements.toml |
|---|---|---|
| Uso de un shell de inicio de sesión | Si las herramientas de shell pueden iniciar un shell de inicio de sesión. | allow_login_shell |
| Modos de sandbox permitidos | Qué modos de sandbox puede usar el ejecutor. | allowed_sandbox_modes |
| Perfiles de permisos y valores predeterminados | Los perfiles de permisos permitidos, sus límites de acceso y el perfil predeterminado. | allowed_permission_profilesdefault_permissionspermissions |
| Configuración del sandbox remoto | Los modos de sandbox específicos de cada host, que se seleccionan según el nombre del host. | remote_sandbox_config |
| Acceso administrado a la red durante la ejecución | El acceso administrado a la red, incluidos los destinos permitidos y denegados. | experimental_network |
| Ajustes de ejecución de Windows | Los ajustes de ejecución y de sandbox específicos de Windows. | windows |
La tabla muestra qué grupos de campos admiten excepciones por entorno. Las opciones compatibles de cada grupo pueden variar según la plataforma. Algunos requisitos de distintas políticas se combinan en lugar de reemplazarse entre sí. Consulta los valores admitidos en la Referencia de configuración y las excepciones de red en Configuración administrada.
En las rutas de ejecución administradas compatibles de Codex Cloud, permitir un dominio en Seguridad de los agentes no anula las restricciones del entorno. Si se aprueba la elevación completa de privilegios del sandbox, el comando puede ejecutarse sin pasar por el proxy de comandos administrado. Consulta Aislamiento de red para conocer el alcance del proxy.
Configurar el acceso a la red en la interfaz
- Abre Consola de administración > Seguridad de los agentes. Selecciona una política y elige Global, Local o Codex Cloud. Usa Global para la configuración base compartida y define excepciones por entorno para los ajustes compatibles que deban ser diferentes.
- Abre Requisitos y activa Administrar acceso a la red. Agrega los dominios necesarios y elige Permitir o Denegar para cada uno. Activa Permitir solo los dominios agregados por administradores si la configuración habitual de los usuarios y las aprobaciones por dominio no deben ampliar la lista de dominios permitidos del proxy administrado.
- Antes de guardar, revisa los ajustes efectivos y las reglas heredadas. Si dejas vacíos los ajustes del entorno, este hereda los de Global en vez de borrarlos. Comprueba por separado la conectividad con redes locales o privadas en Codex Cloud. Desactivar Administrar acceso a la red es distinto de desactivar Acceso a internet en el entorno en la nube.
- En Codex Cloud, comprueba también los ajustes de acceso a internet, destinos y métodos del entorno. Guarda los cambios y prueba una solicitud que deba permitirse y otra que deba bloquearse. Si se permite la elevación completa de privilegios del sandbox, pruébala por separado.
Sin destinos permitidos en la configuración efectiva
Cuando Administrar acceso a la red y Permitir solo los dominios agregados por administradores están activados, los comandos administrados ordinarios necesitan destinos permitidos en la configuración efectiva. Si no se configura ni se hereda ninguna entrada de tipo Permitir, esos comandos no tienen destinos permitidos. Una política que solo contiene denegaciones no permite implícitamente el acceso al resto de internet. Agrega las entradas de tipo Permitir necesarias y comprueba las reglas heredadas antes de guardar. Esta restricción se aplica al proxy de comandos administrado. No se extiende a todas las herramientas ni a las ejecuciones aprobadas con elevación completa de privilegios del sandbox.
Conectividad de Codex Cloud con redes locales o privadas
Si la conectividad con redes locales o privadas se desactiva de forma explícita, es posible que Codex Cloud no pueda acceder a su proxy ascendente, incluso si el dominio de destino está permitido. Comprueba el valor final de allow_local_binding e identifica qué política o ajuste lo establece. En la ruta compatible del proxy en la nube, el valor predeterminado es true solo cuando ningún requisito aplicable, perfil de red seleccionado o ajuste de la función de proxy establece un valor. Un valor false heredado también cuenta como ajuste explícito. Si se admiten excepciones, define una de mayor prioridad en el entorno en la nube para cambiar este valor en Codex Cloud sin modificar el valor de Global que usa Local. Esto no agrega entradas de tipo Permitir para los dominios. Antes de depender de la excepción, verifica que el ejecutor la admita. No apliques este valor predeterminado del entorno en la nube a Local.
Valores predeterminados del entorno
El editor de Valores predeterminados usa campos de config.toml, que son distintos de las restricciones de requirements.toml. Se admiten los siguientes valores predeterminados en el nivel superior del entorno:
-
Comportamiento del shell:
allow_login_shellyshell_environment_policy. -
Sandbox y permisos:
sandbox_mode,sandbox_workspace_write,default_permissionsy permissions. -
Ejecución en Windows: windows.
Un valor predeterminado no anula un requisito obligatorio. Mantén los valores predeterminados del orquestador en Global, incluidos los ajustes de aprobación y búsqueda web.
Cómo se combinan las políticas
-
Entre distintas políticas, la de mayor prioridad prevalece sobre la de menor prioridad, incluso cuando esta última es más específica.
-
Dentro de una misma política, los ajustes de ejecución compatibles se resuelven en este orden: primero, la excepción del entorno específica del sistema operativo, luego la excepción del entorno para todos los sistemas operativos y, por último, Global.
-
Para la ejecución local, MDM y los requisitos anteriores de los dispositivos administrados tienen prioridad sobre Seguridad de los agentes. El archivo de requisitos del sistema del dispositivo tiene menor prioridad que Seguridad de los agentes.
Para una misma regla de dominio dentro de una política, el administrador puede definir una excepción por entorno que permita un dominio denegado en Global o deniegue uno permitido en Global. Si no hay una excepción por entorno, se hereda la regla de Global. Otras reglas de denegación vigentes u otros controles de acceso pueden bloquear la solicitud de todos modos.
Estos resultados corresponden a la misma clave de dominio dentro de una política, siempre que ninguna política de mayor prioridad cambie el resultado. Un valor de mayor prioridad reemplaza el de la misma clave. Las demás claves heredadas se conservan. Una regla de tipo Permitir no anula otra regla de tipo Denegar que también coincida, como una regla heredada con comodín. Un mapa de entorno vacío no borra las reglas heredadas.
Cómo se aplica Seguridad de los agentes a Work Cloud
Configura Uso del navegador en la nube y Acceso a la red en la nube en Consola de administración > Permisos y roles > Funciones del espacio de trabajo > Funciones de las computadoras en la nube. Estas funciones compartidas están disponibles para Work Cloud y los dots. Puedes configurarlas independientemente del acceso a Work Cloud. Una tarea del modo Work sigue necesitando acceso a ese modo y permiso para usar cada función que requiera. Revisa por separado el acceso al navegador y el acceso a la red desde el código o el shell. Deshabilitar uno no deshabilita automáticamente el otro.
Los contenedores de Work Cloud y las computadoras en la nube de los dots usan sus propios ajustes y requisitos de ejecución en lugar del paquete de configuración del entorno administrado que usan otros tipos de ejecutores. Las restricciones locales de archivos y red no se aplican automáticamente a estas computadoras en la nube. Los controles compatibles de la política de Global para el orquestador tienen un alcance distinto. Ni una política de Global ni una excepción de Codex Cloud configuran los permisos de las funciones compartidas en la nube. Revisa esos permisos por separado.
Al verificar el acceso efectivo de un miembro, comprueba la configuración predeterminada del espacio de trabajo, todos los roles asignados directamente o a través de grupos y las restricciones que se aplican por separado, como el Modo restringido.
Antes de habilitar Permitir el acceso a la computadora local en Work Cloud, revisa la configuración base de Global y comprueba que sea compatible con los controles de los que depende tu organización. Usar Codex localmente en la app de escritorio de ChatGPT no es un requisito previo. Si enforce_residency está habilitado en alguna política de nube, Permitir el acceso a la computadora local se deshabilita tanto para el modo Work como para los dots. Esta medida de protección no configura la residencia de datos del espacio de trabajo ni deshabilita por sí sola Work Cloud o los dots. Consulta Acceso a la computadora local para Work Cloud y los dots para conocer los pasos de configuración por separado, los requisitos de elegibilidad y el funcionamiento de la conexión.
API de políticas y Terraform
Usa la API de políticas para administrar los ajustes de Global. Para administrar los ajustes de Local o Codex Cloud, usa la interfaz de Seguridad de los agentes. Los flujos de trabajo existentes que usan la API para Global siguen disponibles después de la migración. Prueba tus scripts y tus integraciones con Terraform y confirma que las asignaciones de políticas y su orden se conserven.
La migración de políticas no modifica la sincronización de miembros mediante SCIM ni los roles de RBAC.
Guías relacionadas
-
Configuración administrada: distribución de políticas, orden de prioridad y reglas de combinación para cada campo.
-
Referencia de configuración: definiciones de los campos y compatibilidad con el modo Work.
-
Acceso a la computadora local para Work Cloud y los dots: requisitos previos y pasos de configuración.
-
Roles y permisos del espacio de trabajo: acceso a las funciones del modo Work y de Codex.