Use a seção Segurança dos agentes no Console de administração para gerenciar políticas e configurações. Ela substitui a seção Políticas e configuração. A disponibilização da nova seção é independente da liberação do acesso ao computador local para o Work e os dots.
Quando as políticas de nuvem legadas elegíveis são migradas, suas configurações passam para o escopo Global. As atribuições e a ordem das políticas são preservadas. Revise as políticas migradas em Segurança dos agentes. A ativação do acesso ao computador local é opcional e feita separadamente para o Work e para os dots.
Onde as configurações se aplicam
Cada política parte de uma configuração de base no escopo Global. As substituições por ambiente alteram as configurações de execução compatíveis nos ambientes Local ou Codex Cloud. Quando um ambiente não tem uma substituição, ele herda as configurações aplicáveis do escopo Global dessa política.
-
Global: defina os controles do orquestrador, incluindo aprovações e pesquisa na Web, e as configurações de execução compartilhadas.
-
Local: ajuste as configurações de execução compatíveis para tarefas executadas em um computador conectado.
-
Codex Cloud: ajuste as configurações de execução compatíveis para tarefas do Codex na nuvem. Você pode configurar essas políticas antes de ativar o Codex Cloud, mas elas só entram em vigor depois que você o ativa na página de permissões. O Work Cloud tem permissões próprias para seus recursos, descritas em Como a Segurança dos agentes se aplica ao Work Cloud.
Definir uma configuração de base e adicionar configurações por ambiente
-
Abra Segurança dos agentes e revise as políticas existentes no escopo Global, suas atribuições e sua ordem. Verifique se elas correspondem aos controles que sua organização pretende aplicar. Essa revisão não ativa o acesso ao computador local com o Work Cloud.
-
Revise as seções Requisitos e Padrões separadamente. Os requisitos definem limites que os usuários não podem alterar. Os padrões definem os valores iniciais dentro desses limites.
-
Mantenha os controles do orquestrador no escopo Global. Eles incluem os requisitos de aprovação, os modos permitidos de pesquisa na Web e os controles de ferramentas gerenciadas.
-
Adicione configurações ao ambiente Local ou Codex Cloud para os controles de execução compatíveis, como o uso de ambiente isolado, as permissões do sistema de arquivos e o acesso gerenciado à rede durante a execução. Use uma substituição específica por sistema operacional quando precisar desse escopo.
-
Salve a política e revise as mensagens de validação sobre as configurações inseridas.
Escolher controles e campos de configuração
O orquestrador coordena a tarefa. O executor é o computador ou contêiner de nuvem que executa uma etapa da tarefa. Configure os controles do orquestrador no escopo Global. As configurações de requirements.toml por ambiente só permitem definir controles de execução. As configurações do orquestrador, como a política de aprovação e a pesquisa na Web, ficam no escopo Global e não podem ser substituídas por ambiente.
Controles do orquestrador
Configure esses controles no escopo Global. Para o Work com acesso local e para os dots, o orquestrador de nuvem compartilhado aplica as configurações compatíveis da política Global quando a política gerenciada está ativada. As substituições por ambiente se aplicam às configurações de execução compatíveis e não podem alterar os controles do orquestrador. Entre os requisitos de aprovação, pesquisa na Web, aplicativos, MCP, plugins e regras listados abaixo, apenas Políticas de aprovação permitidas e Modos permitidos de pesquisa na Web têm controles próprios na interface de Segurança dos agentes. Configure os demais campos via TOML.
| Controle | O que controla | Campos de requirements.toml |
|---|---|---|
| Políticas de aprovação e revisão | Quando o agente precisa de aprovação e quem analisa a solicitação, inclusive na revisão automática. | allowed_approval_policiesallowed_approvals_reviewersauto_reviewguardian_policy_config |
| Modos de pesquisa na Web | Quais modos de pesquisa na Web o agente pode usar. | allowed_web_search_modes |
Aplicativos, servidores MCP e plugins |
Quais aplicativos, servidores MCP e plugins estão disponíveis e como são configurados. | appsmcp_serversplugins |
Regras de comando (rules) |
Quais comandos o agente pode executar, quais exigem aprovação e quais ele não pode executar. | rules |
hooks gerenciados |
Ações que o administrador define para eventos compatíveis de tarefas e ferramentas. | hooksallow_managed_hooks_only |
Hooks no acesso ao computador local com o Work Cloud
No escopo Global, use Editar como TOML para configurar os manipuladores mcp_tool para o Work com acesso ao computador local e para os dots. Antes de depender de um hook para bloquear uma ferramenta, teste como ele se comporta tanto em caso de falha do callback quanto em caso de negativa explícita. Consulte Hooks com orquestração na nuvem para saber quais manipuladores e eventos são compatíveis.
O escopo Global também inclui configurações de desktop e de cliente. Algumas se aplicam apenas ao aplicativo para desktop. Definir uma configuração no escopo Global não significa que ela se aplica em todos os contextos. Consulte a Referência de configuração para saber onde cada campo pode ser usado.
Controles de execução (executor)
Esses campos controlam como as tarefas são executadas em um computador ou em um contêiner de nuvem. Defina os valores compartilhados no escopo Global. Use substituições no ambiente Local ou Codex Cloud para as configurações compatíveis que precisam de valores diferentes nesse ambiente.
| Controle | O que controla | Campos de requirements.toml |
|---|---|---|
| Uso do shell de login | Se as ferramentas de shell podem iniciar um shell de login. | allow_login_shell |
| Modos de sandbox permitidos | Quais modos de sandbox o executor pode usar. | allowed_sandbox_modes |
| Perfis de permissões e valores padrão | Os perfis de permissões permitidos, seus limites de acesso e o perfil padrão. | allowed_permission_profilesdefault_permissionspermissions |
| Configuração de sandbox remoto | Os modos de sandbox específicos de cada host, selecionados pelo nome do host. | remote_sandbox_config |
| Acesso gerenciado à rede durante a execução | O acesso gerenciado à rede, incluindo os destinos permitidos e bloqueados. | experimental_network |
| Configurações de execução no Windows | As configurações de execução e de sandbox específicas do Windows. | windows |
A tabela mostra quais grupos de campos aceitam substituições por ambiente. As opções compatíveis de cada grupo podem variar conforme a plataforma. Alguns requisitos de políticas diferentes se combinam em vez de substituir uns aos outros. Consulte a Referência de configuração para ver os valores compatíveis e a Configuração gerenciada para ver as exceções de rede.
Nos fluxos de execução gerenciada compatíveis do Codex Cloud, permitir um domínio em Segurança dos agentes não anula uma restrição do ambiente. Quando a elevação completa de privilégios do sandbox é aprovada, a execução pode ocorrer sem passar pelo proxy de comandos gerenciado. Consulte Isolamento de rede para saber o que o proxy abrange.
Configurar o acesso à rede na interface
- Abra Console de administração > Segurança dos agentes. Selecione uma política e escolha Global, Local ou Codex Cloud. Use o escopo Global para a configuração de base compartilhada e uma substituição por ambiente para as configurações compatíveis que precisam ser diferentes.
- Abra Requisitos e ative Gerenciar acesso à rede. Adicione os domínios necessários e escolha Permitir ou Negar para cada um. Ative Permitir apenas domínios adicionados por administradores se as configurações comuns dos usuários e as aprovações por domínio não puderem ampliar a lista de domínios permitidos pelo proxy gerenciado.
- Antes de salvar, revise as configurações em vigor e as regras herdadas. Configurações de ambiente vazias herdam os valores do escopo Global, sem apagá-los. Verifique separadamente a conectividade com redes locais ou privadas no Codex Cloud. Desativar Gerenciar acesso à rede é diferente de desativar Acesso à internet no ambiente de nuvem.
- No Codex Cloud, verifique também as configurações de acesso à internet, destinos e métodos do ambiente. Salve e teste uma solicitação que deve ser permitida e outra que deve ser bloqueada. Se a elevação completa de privilégios do sandbox for permitida, teste-a separadamente.
Nenhum destino permitido pelas regras em vigor
Quando Gerenciar acesso à rede e Permitir apenas domínios adicionados por administradores estão ativados, os comandos gerenciados comuns precisam de destinos permitidos pelas regras em vigor. Se nenhuma entrada Permitir tiver sido configurada ou herdada, esses comandos não terão nenhum destino permitido. Uma política que contém apenas entradas Negar não permite implicitamente o acesso ao restante da internet. Adicione as entradas Permitir necessárias e verifique as regras herdadas antes de salvar. Essa restrição se aplica ao proxy de comandos gerenciado. Ela não abrange todas as ferramentas nem as execuções com elevação completa de privilégios do sandbox já aprovada.
Conectividade do Codex Cloud com redes locais ou privadas
Desativar explicitamente a conectividade com redes locais ou privadas pode impedir que o Codex Cloud alcance seu proxy upstream, mesmo que o domínio de destino seja permitido. Verifique o valor final de allow_local_binding e identifique qual política ou configuração o define. No fluxo compatível que usa o proxy de nuvem, o valor padrão só é true quando nenhum requisito aplicável, perfil de rede selecionado ou configuração de recurso do proxy fornece um valor. Um valor false herdado também conta como configuração explícita. Quando houver suporte, defina uma substituição de maior prioridade no ambiente de nuvem para alterar esse valor no Codex Cloud sem mudar o valor do escopo Global usado pelo ambiente Local. Isso não adiciona entradas Permitir para domínios. Verifique se o executor oferece suporte à substituição antes de depender dela. Não aplique esse padrão do ambiente de nuvem ao ambiente Local.
Valores padrão por ambiente
O editor de Padrões usa campos de config.toml, que são diferentes das restrições de requirements.toml. Os seguintes valores padrão podem ser definidos no nível superior do ambiente:
-
Comportamento do shell:
allow_login_shelleshell_environment_policy. -
Sandbox e permissões:
sandbox_mode,sandbox_workspace_write,default_permissionse permissions. -
Execução no Windows: windows.
Um valor padrão não substitui um requisito obrigatório. Mantenha os padrões do orquestrador, incluindo as configurações de aprovação e pesquisa na Web, no escopo Global.
Como as políticas se combinam
-
Entre políticas, a de maior prioridade prevalece sobre a de menor prioridade, mesmo quando a de menor prioridade é mais específica.
-
Dentro de uma política, as configurações de execução compatíveis seguem esta ordem de prioridade: primeiro, a substituição por ambiente específica para o sistema operacional, depois, a substituição por ambiente válida para todos os sistemas operacionais e, por fim, a configuração do escopo Global.
-
Para execução local, o MDM e os requisitos legados de dispositivos gerenciados têm prioridade sobre a Segurança dos agentes. O arquivo de requisitos do sistema no dispositivo tem prioridade inferior à da Segurança dos agentes.
Para uma mesma regra de domínio dentro de uma política, o administrador pode usar uma substituição por ambiente para permitir um domínio bloqueado no escopo Global ou bloquear um domínio permitido nesse escopo. Sem uma substituição por ambiente, a regra do escopo Global é herdada. Outras regras Negar em vigor ou outros controles de acesso ainda podem bloquear a solicitação.
Esses resultados consideram a mesma chave de domínio em uma única política, desde que nenhuma política de maior prioridade altere o resultado. Um valor de maior prioridade substitui o valor da mesma chave. As demais chaves herdadas são mantidas. Uma regra Permitir não anula outra regra Negar que também corresponda ao domínio, como uma regra herdada com curinga. Um mapa de ambiente vazio não apaga as regras herdadas.
Como a Segurança dos agentes se aplica ao Work Cloud
Configure Uso do navegador na nuvem e Acesso à rede na nuvem em Console de administração > Permissões e funções > Recursos do espaço de trabalho > Recursos do computador na nuvem. Esses recursos compartilhados estão disponíveis para o Work Cloud e os dots e podem ser configurados independentemente do acesso ao Work Cloud. Uma tarefa do Work ainda exige acesso ao Work e permissão para usar cada recurso de que precisa. Revise separadamente o acesso pelo navegador e o acesso à rede por código ou shell. Desativar um não desativa o outro automaticamente.
Os contêineres do Work Cloud e os computadores dos dots na nuvem usam configurações e requisitos de execução próprios, em vez do pacote de ambiente gerenciado usado por outros tipos de executor. As restrições locais de arquivos e rede não se aplicam automaticamente a esses computadores na nuvem. As configurações compatíveis da política Global do orquestrador têm um escopo separado. Uma política Global ou uma substituição do Codex Cloud não define as permissões dos recursos compartilhados na nuvem. Revise essas permissões separadamente.
Ao verificar o acesso efetivo de um membro, confira o padrão do espaço de trabalho, todas as funções atribuídas diretamente ou por grupo e as restrições impostas separadamente, como o Modo de bloqueio.
Antes de ativar Permitir acesso ao computador local na seção Work Cloud, revise a configuração de base do escopo Global e verifique se ela é compatível com os controles dos quais sua organização depende. Usar o Codex localmente no aplicativo ChatGPT para desktop não é um pré-requisito. Se enforce_residency estiver ativado em qualquer política de nuvem, a opção Permitir acesso ao computador local ficará desativada tanto para o Work quanto para os dots. Essa proteção não configura a residência de dados do espaço de trabalho nem desativa, por si só, o Work Cloud ou os dots. Consulte Acesso ao computador local para o Work Cloud e os dots para ver as etapas de configuração de cada um, os critérios de elegibilidade e como funciona a conexão.
API de políticas e Terraform
Use a API de políticas para gerenciar as configurações do escopo Global. Para gerenciar as configurações dos ambientes Local ou Codex Cloud, use a interface de Segurança dos agentes. Os fluxos de trabalho existentes que usam a API para o escopo Global continuam disponíveis após a migração. Teste seus scripts e integrações com o Terraform e confirme que as atribuições e a ordem das políticas foram preservadas.
A migração das políticas não altera a sincronização de membros via SCIM nem as funções de RBAC.
Guias relacionados
-
Configuração gerenciada: distribuição de políticas, ordem de prioridade e regras de combinação específicas de cada campo.
-
Referência de configuração: definições dos campos e compatibilidade com o Work.
-
Acesso ao computador local para o Work Cloud e os dots: pré-requisitos e etapas de configuração.
-
Funções e permissões do espaço de trabalho: acesso aos recursos do Work e do Codex.