{"meta":{"title":"Personalizando ou desabilitando o firewall para GitHub Copilot","intro":"Saiba como controlar os domínios e URLs que Copilot cloud agent e Copilot code review podem acessar.","product":"GitHub Copilot","breadcrumbs":[{"href":"/pt/copilot","title":"GitHub Copilot"},{"href":"/pt/copilot/how-tos","title":"Instruções"},{"href":"/pt/copilot/how-tos/copilot-on-github","title":"Copilot em GitHub"},{"href":"/pt/copilot/how-tos/copilot-on-github/customize-copilot","title":"Personalizar Copilot"},{"href":"/pt/copilot/how-tos/copilot-on-github/customize-copilot/customize-the-firewall","title":"Personalizar o firewall"}],"documentType":"article"},"body":"# Personalizando ou desabilitando o firewall para GitHub Copilot\n\nSaiba como controlar os domínios e URLs que Copilot cloud agent e Copilot code review podem acessar.\n\n> \\[!NOTE]\n> A configuração do firewall é gerenciada na guia de configurações \"Acesso à Internet\", que abrange tanto Copilot cloud agent quanto Copilot code review. As configurações anteriores salvas como variáveis do Ações serão mantidas nessa página.\n\n## Overview\n\nPor padrão, Copiloto acesso à Internet é limitado por um firewall.\n\n> \\[!NOTE]\n> Copilot code review também dá suporte à configuração de firewall, no nível da organização e do repositório, em sua própria seção da guia \"Acesso à Internet\" descrita abaixo. Isso permite que você configure regras de firewall de Copilot code review forma independente de Copilot cloud agent. Consulte [Usando o GitHub Copilot para revisão de código](/pt/copilot/how-tos/use-copilot-agents/request-a-code-review/use-code-review#customizing-copilot-code-reviews-environment).\n\nLimitar o acesso à Internet ajuda a gerenciar riscos de exfiltração de dados. Um comportamento inesperado de Copilot, ou instruções mal-intencionadas, pode levar a que o código ou outras informações confidenciais sejam vazadas para locais remotos.\n\nO firewall sempre permite o acesso a vários hosts que Copilot usa para interagir com GitHub. Por padrão, uma lista de permissões recomendada também é habilitada para que o agente baixe dependências.\n\nSe Copilot tentar fazer uma solicitação bloqueada pelo firewall, um aviso será adicionado ao corpo da solicitação de pull (para novas solicitações de pull) ou a um comentário (para solicitações de pull existentes). O aviso mostra o endereço bloqueado e o comando que tentou fazer a solicitação.\n\n![Captura de tela de um aviso do Copilot sobre o bloqueio pelo firewall.](/assets/images/help/copilot/cloud-agent/firewall-warning.png)\n\n## Limitations\n\nO firewall do agente tem limitações importantes que afetam sua cobertura de segurança.\n\n* **Aplica-se somente aos processos iniciados pelo agente**: o firewall só se aplica aos processos iniciados pelo agente por meio de sua ferramenta Bash. Ele não se aplica a servidores ou processos do PROTOCOLO MCP (Model Context Protocol) iniciados nas etapas de instalação configuradas Copilot .\n* **Aplica-se apenas no GitHub Actions dispositivo**: o firewall só funciona dentro do ambiente do GitHub Actions dispositivo. Ele não se aplica a processos em execução fora desse ambiente.\n* **Potencial de bypass**: ataques sofisticados podem ignorar o firewall, permitindo potencialmente o acesso não autorizado à rede e a exfiltração de dados.\n\nEssas limitações significam que o firewall fornece proteção para cenários comuns, mas não deve ser considerado uma solução de segurança abrangente.\n\n## Noções básicas sobre a lista de permissões de firewall recomendada\n\nA lista de permissões recomendada, habilitada por padrão, permite o acesso a:\n\n* Repositórios de pacotes de sistemas operacionais comuns (por exemplo, Debian, Ubuntu, Red Hat).\n* Registros de contêiner comuns (por exemplo, Docker Hub, Registro de Contêiner do Azure, Registro de Contêiner Elástico da AWS).\n* Pacotes de registros usados por linguagens de programação populares (C#, Dart, Go, Haskell, Java, JavaScript, Perl, PHP, Python, Ruby, Rust, Swift).\n* Autoridades de certificação comuns (para permitir que certificados SSL sejam validados).\n* Hosts usados para baixar navegadores da Web para o servidor MCP da Playwright.\n\nPara obter a lista completa de hosts incluídos na lista de permissões recomendada, consulte [Referência da lista de permissões do Copilot](/pt/copilot/reference/copilot-allowlist-reference#copilot-cloud-agent-recommended-allowlist).\n\n## Configurando o firewall no nível da organização\n\nOs proprietários da organização podem definir todas as configurações de firewall no nível da organização para ambos Copilot cloud agent e Copilot code review. Para acessar as configurações de firewall:\n\n1. No canto superior direito de GitHub, clique na foto de perfil e clique em ** Your organizations**.\n2. Selecione uma organização clicando nela.\n3. No nome da organização, clique em ** Settings**. Caso não consiga ver a guia \"Configurações\", selecione o menu suspenso **** , clique em **Configurações**.\n\n ![Captura de tela das guias no perfil de uma organização. A guia \"Configurações\" está contornada em laranja escuro.](/assets/images/help/discussions/org-settings-global-nav-update.png)\n Na barra lateral, em \"Código, planejamento e automação\", clique **Copilot** e clique em **Acesso à Internet**.\n\nA página \"Acesso à Internet\" tem seções separadas para Copilot cloud agent e Copilot code review, de modo que você possa configurar as seguintes definições independentemente para cada uma delas.\n\n### Habilitar ou desabilitar o firewall\n\n> \\[!WARNING]\n> Desabilitar o firewall permitirá Copilot se conectar a qualquer host, aumentando os riscos de exfiltração de código ou outras informações confidenciais.\n\n1. Em \"Acesso à Internet\", defina a configuração **Habilitar firewall** como **Habilitado**, **Desabilitado** ou **Permitir que os repositórios decidam** (padrão).\n\n### Habilitar ou desabilitar a lista de permissões recomendada\n\n1. Em \"Acesso à Internet\", defina a **configuração de lista de permissões recomendada** como **Habilitado**, **Desabilitado** ou **Permitir que os repositórios decidam** (padrão).\n\n### Controlar se os repositórios podem adicionar regras de lista de permissões personalizadas\n\nPor padrão, os administradores do repositório podem adicionar suas próprias entradas à lista de permissões do firewall. Os proprietários da organização podem desabilitar isso para impedir que os repositórios adicionem regras personalizadas.\n\n1. Em \"Acesso à Internet\", defina a configuração **permitir regras personalizadas do repositório** como **Habilitado** (padrão) ou **Desabilitado**.\n\n### Gerenciando a lista de permissões personalizada da organização\n\nOs itens adicionados à lista de permissões personalizada da organização se aplicam a todos os repositórios na organização. Esses itens não podem ser excluídos no nível do repositório. As regras no nível da organização e do repositório são combinadas.\n\n1. Em \"Acesso à Internet\", clique **na lista de permissões personalizada da organização**.\n2. Adicione os endereços que você deseja incluir na lista de permitidos. Você pode incluir:\n\n * **Domínios** (por exemplo, `packages.contoso.corp`). O tráfego será permitido para o domínio especificado e quaisquer subdomínios.\n\n**Exemplo**: `packages.contoso.corp` vai permitir o tráfego para `packages.contoso.corp` e `prod.packages.contoso.corp`, mas não para `artifacts.contoso.corp`.\n\n* **URLs** (por exemplo, `https://packages.contoso.corp/project-1/`). O tráfego só será permitido no esquema (`https`) e no host (`packages.contoso.corp`) especificados, sendo limitado aos caminhos e seus descendentes especificados.\n\n**Exemplo**: `https://packages.contoso.corp/project-1/` vai permitir o tráfego para `https://packages.contoso.corp/project-1/` e `https://packages.contoso.corp/project-1/tags/latest`, mas não para `https://packages.contoso.corp/project-2`, `ftp://packages.contoso.corp` ou `https://artifacts.contoso.corp`.\n\n1. Clique em **Adicionar regra**.\n2. Depois de validar sua lista, clique em **Salvar alterações**.\n\n## Configurando o firewall no nível do repositório\n\nOs administradores do repositório podem definir as configurações de firewall no nível do repositório, incluindo habilitar ou desabilitar o firewall, habilitar ou desabilitar a lista de permissões recomendada e gerenciar uma lista de permissões personalizada. Dependendo da configuração no nível da organização, algumas dessas configurações podem ser bloqueadas. A página de configurações do repositório também tem seções separadas para Copilot cloud agent e Copilot code review, assim você pode configurar essas opções de forma independente para cada um deles.\n\nPara acessar as configurações de firewall:\n\n1. Em GitHub, acesse a página principal do repositório.\n2. No nome do repositório, clique em ** Settings**. Caso não consiga ver a guia \"Configurações\", selecione o menu suspenso **** , clique em **Configurações**.\n\n ![Captura de tela de um cabeçalho de repositório que mostra as guias. A guia \"Configurações\" é realçada por um contorno laranja-escuro.](/assets/images/help/repository/repo-actions-settings.png)\n3. Na barra lateral, em \"Código, planejamento e automação\", clique em **Copilot** e depois em **Acesso à Internet**.\n\n### Habilitar ou desabilitar o firewall\n\n> \\[!NOTE]\n> Você só poderá alterar essa configuração no nível do repositório se a configuração **habilitar firewall** no nível da organização estiver definida como **Permitir que os repositórios decidam**. Se a configuração no nível da organização estiver **habilitada** ou **desabilitada**, você não poderá alterar essa configuração para repositórios individuais.\n\n1. Ative ou desative a configuração **Habilitar firewall** .\n\n### Habilitar ou desabilitar a lista de permissões recomendada\n\n> \\[!NOTE]\n> Você só poderá alterar essa configuração no nível do repositório se a **configuração da lista de permissões recomendada** no nível da organização estiver definida como **Permitir que os repositórios decidam**. Se a configuração no nível da organização estiver **habilitada** ou **desabilitada**, você não poderá alterar essa configuração para repositórios individuais.\n\n1. Alterne ou desative a **configuração de lista de permissões recomendada** .\n\n### Gerenciando a lista de permissões personalizada\n\n> \\[!NOTE]\n> Você só poderá adicionar regras personalizadas de lista de permissões no nível do repositório se a configuração **Permitir regras personalizadas de repositório** no nível da organização estiver definida como **Habilitada**. Para obter mais informações, consulte [Controlando se os repositórios podem adicionar regras de lista de permissões personalizadas](#controlling-whether-repositories-can-add-custom-allowlist-rules).\n\n1. Clique na **lista de permissões personalizada**.\n2. Adicione os endereços que você deseja incluir na lista de permitidos. Você pode incluir:\n\n * **Domínios** (por exemplo, `packages.contoso.corp`). O tráfego será permitido para o domínio especificado e quaisquer subdomínios.\n\n**Exemplo**: `packages.contoso.corp` vai permitir o tráfego para `packages.contoso.corp` e `prod.packages.contoso.corp`, mas não para `artifacts.contoso.corp`.\n\n* **URLs** (por exemplo, `https://packages.contoso.corp/project-1/`). O tráfego só será permitido no esquema (`https`) e no host (`packages.contoso.corp`) especificados, sendo limitado aos caminhos e seus descendentes especificados.\n\n**Exemplo**: `https://packages.contoso.corp/project-1/` vai permitir o tráfego para `https://packages.contoso.corp/project-1/` e `https://packages.contoso.corp/project-1/tags/latest`, mas não para `https://packages.contoso.corp/project-2`, `ftp://packages.contoso.corp` ou `https://artifacts.contoso.corp`.\n\n1. Clique em **Adicionar regra**.\n2. Depois de validar sua lista, clique em **Salvar alterações**.\n\n## Leitura adicional\n\n* [Armazenar informações em variáveis](/pt/actions/how-tos/write-workflows/choose-what-workflows-do/use-variables#creating-configuration-variables-for-a-repository)\n* [Configurar o ambiente de desenvolvimento](/pt/copilot/how-tos/copilot-on-github/customize-copilot/customize-cloud-agent/customize-the-agent-environment)"}