Referência de configurações de segurança

Controles de segurança locais refinados no Delegate — permissões de ferramentas, terminal e arquivos, arquivos protegidos e Automação de inteface gráfica — que vão além do Modo de aprovação.

Essas configurações estão em Configurações → Segurança, organizadas em cinco áreas: Permissões de ferramentas, Terminal e arquivos, Arquivos protegidos, Automação de interface gráfica e Acesso restrito.

Permissões da ferramenta

Configure quando o Delegate precisa da sua aprovação. As ferramentas são organizadas em quatro categorias de nível superior, cada uma mostrando quantas ferramentas ou operações abrange:

Categoria	Abrange
Conectores	Slack, GitHub, Notion, Linear, Jira, Microsoft 365 e muito mais
Office	Word, Excel, PowerPoint, Outlook, Teams
Ferramentas do sistema	Sistema de arquivos, pesquisa na Web, uso do computador, memória, shell
Servidores MCP	Todos os servidores MCP que você conectou

Expandir uma categoria divide-a ainda mais. As ferramentas do sistema, por exemplo, dividem-se em quatro grupos:

Grupo	Abrange	Padrão
SomenteLeitura	Leitura de arquivos, pesquisa na Web e inspeção de elementos de interface gráfica — operações que não mudam nada	Permitir
Gravar e usar Modificar	Criação ou edição de arquivos, download de arquivos, geração de imagens	Perguntar
Automação de Interface Gráfica	Clicar, digitar ou interagir de outra forma com um aplicativo	Perguntar
Shell e amp; script	Execução de um comando do PowerShell ou Bash	Perguntar

Cada grupo pode ser definido de forma independente para Permitir (executar automaticamente), Perguntar (solicitar primeiro) ou Bloquear (Negar automaticamente) e expande ainda mais para definir operações individuais por conta própria.

Os conectores e o Office seguem o mesmo princípio de somente leitura versus gravação e modificação em sua própria escala: cada aplicativo ou serviço (Outlook, Slack, Excel e assim por diante) é dividido em suas próprias operações, geralmente divididos da mesma maneira — por exemplo, a leitura de um canal do Slack ou um intervalo do Excel é somente leitura, enquanto a publicação de uma mensagem ou a escrita em um intervalo é escrita — cada um definido para Permitir, Perguntar ou Bloquear da mesma forma que as ferramentas do sistema.

Os servidores MCP são tratados da mesma forma que as outras categorias, exceto que as operações disponíveis dependem inteiramente de quais servidores sua organização configurou.

Terminal e arquivos

O Delegate pode executar comandos de shell e scripts por meio da Área restrita de comando do Shell, atualmente em versão BETA: um gerenciador de área restrita sensível a escopo que usa o Windows AppContainer para sistema de arquivo no nível do kernel, rede, processo e isolamento de credenciais. Consulte Scripts e execução de código na Visão geral da segurança para saber como a sandbox funciona conceitualmente.

Um comando de longa duração não bloqueia o restante da sessão: o Delegate pode iniciá-lo, continuar trabalhando em outras coisas, ler sua saída à medida que ela chega e interrompê-lo, se necessário.

Isolamento do kernel

Uma alternância que ativa ou desativa a sandbox para comandos do shell. Quando desativado, os comandos são executados com direitos completos de usuário em vez do ambiente confinado descrito em Visão geral de segurança.

Caminhos

Os comandos do Shell podem acessar apenas os caminhos listados aqui; todo o resto será bloqueado. Adicione seus próprios caminhos além dos padrão.

Capabilities

Recursos adicionais que você pode conceder a comandos de shell em área restrita, já que eles estão fora do que a área restrita permite por padrão. Acesso à Internet, rede particular e armazenamento removível estão desativados por padrão; o perfil do Shell está ativado por padrão:

• Acesso à Internet (Off por padrão) — permite que comandos em área restrita façam conexões de rede de saída (HTTP, HTTPS etc.).
• Rede particular (Off por padrão) — permite que comandos em área restrita cheguem à sua rede local ou LAN.
• Armazenamento removível (desativado por padrão) — permite que comandos em área restrita leiam ou gravem unidades USB e discos externos.
• Perfil do shell (ativado por padrão) — carrega o perfil do seu shell (.zshrc, .bash_profile ou perfil do PowerShell) antes de executar comandos para que seus aliases e variáveis de ambiente usuais estejam disponíveis.

Alterações feitas neles podem exigir a reinicialização do aplicativo para entrarem em vigor.

Comandos bloqueados

Bloqueie execução de tipos específicos de comandos — clique em uma sugestão para adicioná-la ou digite um padrão personalizado (por exemplo, shutdown, format c:, netstat). Esses padrões são verificados antes da execução: o comando do agente é comparado com eles como regex e bloqueado antes de ser executado. Esse é um mecanismo separado do isolamento do kernel, e aplica-se independentemente de a sandbox estar ativada ou não.

Arquivos protegidos

O Delegate precisa de aprovação antes de acessar esses arquivos, agrupados em categorias de acordo com o que eles protegem:

Categoria	Proteção	Padrões de exemplo
Segredos	Arquivos de ambiente e armazenamentos de credenciais	.env, .env.*, secrets/*, credentials/*, .npmrc, .pypirc
Chaves	Chaves e certificados SSH	.ssh/*, *.pem, *.key, *.p12, id_rsa, id_ed25519
Cloud	Credenciais do provedor de nuvem	.aws/*, .azure/*, .gcloud/*, service-account*.json
Config	Arquivos de configuração do projeto — a leitura é irrestrita, apenas as gravações precisam de aprovação	tsconfig.json, .eslintrc*, Dockerfile, .github/workflows/*
Dados	Bancos de dados locais e arquivos de histórico	*.sqlite, *.db, wallet.dat, .bash_history

Você pode adicionar seu próprio caminho personalizado ou padrão além desses.

Caso de uso: capture arquivos que podem conter credenciais, material criptográfico, acesso a conta de nuvem ou outros dados confidenciais, sem ter que enumerar todos os locais possíveis por conta própria.

Automação de Interface Gráfica

Controla em quais aplicativos e sites o Delegate pode agir sem perguntar, e quais ele nunca deve tocar.

Apps e sites confiáveis (aprovação automática)

• Apps confiáveis — apps que o Delegate pode usar sem perguntar. Adicione rapidamente por categoria (Editores de código, Terminais, Apps do Office, Gerenciadores de arquivos, Notas e Documentos), ou digite para selecionar qualquer aplicativo individual que esteja instalado ou em execução no momento.
• Sites confiáveis — sites que o Delegate pode usar sem perguntar. Pesquise ou insira um domínio; o histórico do seu navegador pode ajudar você a escolher.

Apps e sites protegidos (bloquear)

• Apps bloqueados — apps que o Delegate não abre ou com os quais não interage. Digite ou selecione um aplicativo para adicioná-lo.
• Sites bloqueados — sites que o Delegate não acessa. Recomendado para serviços bancários, pagamentos, gerenciadores de senhas e conteúdo confidencial. Adicione rapidamente uma categoria inteira com um clique — Serviços bancários, Pagamentos, Cripto, Gerenciador de Senhas, Governo, Saúde — que preenche a lista com um conjunto de sites conhecidos para essa categoria, ou pesquise/insira um domínio para você mesmo adicionar um site.

Caso de uso: aprove previamente fluxos de trabalho confiáveis (como Microsoft Excel, Microsoft Word ou um site interno) para que não disparem solicitações de confirmação repetidas e bloqueiem aplicativos ou sites específicos ou categorias confidenciais inteiras para que o agente nunca possa ler ou agir sobre eles.

Acesso restrito

Restringe o Delegate a um conjunto permitido de pastas, caminhos bloqueados e exceções de aprovação. O mesmo painel é compartilhado entre essa configuração global e a guia Segurança das configurações do projeto de cada projeto — as alterações feitas em uma delas são refletidas na outra.

• Pastas: as pastas locais que o Delegate pode usar.
• Caminhos bloqueados: caminhos que o Delegate nunca deve acessar, mesmo dentro de uma pasta permitida.
• Aprovações: quais ações ainda pedem sua confirmação enquanto o acesso restrito estiver ativado.

Caso de uso: limite o Delegate aos arquivos de um projeto específico ao trabalhar com informações confidenciais, sem ter que reconfigurar Permissões de ferramenta ou Arquivos protegidos a cada vez.

Melhores práticas de configuração de permissão

Consulte Melhores práticas de configuração de permissões para obter recomendações por função — usuários individuais, administradores de TI e desenvolvedores que criam habilidades.