Solução de problemas de erros de rede para GitHub Copilot

Resolva erros comuns relacionados a proxies e certificados personalizados.

Neste artigo

Se você estiver trabalhando em equipamentos da empresa e se conectando a uma rede corporativa, talvez esteja se conectando à Internet por meio de uma VPN ou um servidor proxy HTTP. Em alguns casos, esses tipos de configurações de rede podem impedir GitHub Copilot a conexão com GitHubo servidor. Para obter mais informações sobre as opções para configurar proxies com GitHub Copilot, consulte Configurando configurações de rede para o Copilot GitHub.

Este artigo fornece orientação para problemas comuns relacionados a proxies HTTP e certificados personalizados. Se você usar um firewall, isso também poderá interferir na GitHub Copilotconexão. Para obter mais informações, consulte Solução de problemas de configurações de firewall para GitHub Copilot.

Diagnosticar problemas de rede

Se você estiver solucionando problemas de rede, talvez seja útil fazer solicitações curl para testar sua conexão. Se você adicionar a opção --verbose, essas solicitações fornecerão mais informações para diagnosticar o problema ou para compartilhar com o departamento de TI da sua empresa ou Suporte do GitHub. Você pode entrar em contato Suporte do GitHub por meio do Portal de Suporte do GitHub.

Para verificar se você consegue acessar pelo menos alguns dos endpoints de GitHub a partir do seu ambiente, execute o comando a seguir na linha de comando.

Shell
curl --verbose https://copilot-proxy.githubusercontent.com/_ping

Se você conseguir se conectar, deverá receber uma resposta HTTP 200.

Se você sabe que está se conectando por meio de um proxy HTTP, pode verificar se a solicitação é bem-sucedida quando feita por meio do proxy. No exemplo a seguir, substitua YOUR-PROXY-URL:PORT pelas informações do seu proxy.

Shell
curl --verbose -x http://YOUR-PROXY-URL:PORT -i -L https://copilot-proxy.githubusercontent.com/_ping

Se você receber um erro relacionado à "revogação do certificado", poderá tentar a solicitação novamente com o sinalizador --insecure. Se a solicitação só for bem-sucedida quando o --insecure sinalizador for adicionado, isso poderá indicar que GitHub Copilot só se conectará com êxito se você ignorar erros de certificado. Para obter mais informações, confira Solucionar problemas de erros relacionados a certificados.

Se você estiver tendo dificuldades especificamente com Bate-papo do Copilot no seu editor, execute os comandos curl acima, mas use https://api.githubcopilot.com/_ping em vez de https://copilot-proxy.githubusercontent.com/_ping.

Se você não conseguir se conectar e as solicitações curl não ajudarem a identificar o erro, talvez seja útil coletar logs de diagnóstico detalhados em seu editor. Se você estiver trabalhando com o departamento de TI da sua empresa ou Suporte do GitHub, compartilhar esses diagnósticos pode ajudar a resolver o erro. Habilitar o registro de depuração em seu editor ajudará você a compartilhar informações mais específicas. Para obter mais informações, consulte Exibindo logs para GitHub Copilot em seu ambiente.

Solução de erros de proxy

Se houver um problema com a configuração do proxy, você verá o seguinte erro: GitHub Copilot could not connect to server. Extension activation failed: "read ETIMEDOUT" or "read ECONNRESET". Esse erro pode ser causado por vários problemas de rede.

Se você souber que está se conectando por meio de um proxy, verifique se o proxy está configurado corretamente em seu ambiente. Para obter mais informações, consulte Configurando configurações de rede para o Copilot GitHub.

Observação

Se você for funcionário de uma empresa com um servidor proxy, sua empresa também deverá configurar as definições de proxy para Copilot no nível da empresa. Consulte Referência da lista de permissões do Copilot.

GitHub Copilot usa código personalizado para se conectar a proxies. Isso significa que uma configuração de proxy compatível com seu editor não é necessariamente compatível com o GitHub Copilot. Algumas causas comuns para erros relacionados a proxies são:

  • Se a URL do seu proxy começar com https://, no momento ela não é compatível com GitHub Copilot.
  • Talvez seja necessário autenticar no proxy. GitHub Copilot dá suporte à autenticação básica ou à autenticação com Kerberos. Se você estiver usando Kerberos, verifique se você tem um tíquete válido para o serviço proxy e se está usando o nome principal de serviço correto para o serviço. Para obter mais informações, consulte Configurando configurações de rede para o Copilot GitHub.
  • GitHub Copilot pode rejeitar certificados personalizados. Para obter mais informações, confira Solucionar problemas de erros relacionados a certificados.

Dependendo da configuração do proxy, é possível encontrar erros como “falha de assinatura de certificado”, “certificado personalizado” ou “não é possível verificar o primeiro certificado”. Esses erros geralmente são causados por uma configuração de proxy corporativo que usa certificados personalizados para interceptar e inspecionar conexões seguras.

Algumas maneiras possíveis de resolver erros relacionados a certificados são:

  • Configure um proxy diferente que não intercepta conexões seguras.

  • Se você estiver usando um proxy corporativo, entre em contato com o departamento de TI para ver se ele pode configurar o proxy para não interceptar conexões seguras.

  • Verifique se os certificados personalizados estão corretamente instalados no repositório de confiança do sistema operacional. Para obter mais informações, consulte Configurando configurações de rede para o Copilot GitHub. Se os certificados estiverem instalados em seu computador, mas GitHub Copilot não os estiverem detectando, poderá ajudá-lo a conhecer os mecanismos que GitHub Copilot usam para localizar certificados.

    • No Windows, Copilot usa o pacote win-ca.
    • No macOS, Copilot usa o pacote mac-ca.
    • No Linux, Copilot verifica os arquivos /etc/ssl/certs/ca-certificates.crt OpenSSL padrão e /etc/ssl/certs/ca-bundle.crt.

  • Configure GitHub Copilot para ignorar erros de certificado. Nas configurações de proxy, você pode desmarcar Proxy Strict SSL em Visual Studio Code, ou selecionar Aceitar certificados não confiáveis automaticamente em uma IDE da JetBrains. Para obter mais informações, consulte Configurando configurações de rede para o Copilot GitHub.

    Aviso

    Aviso: não é recomendável ignorar erros de certificado, pois isso pode causar problemas de segurança.

Se você ou sua organização usam um software de segurança que monitora o tráfego seguro da Web e você recebe um erro "não é possível verificar o primeiro certificado", talvez seja necessário configurar uma exceção para o IDE e/ou a extensão do Copilot.

Para obter mais informações sobre como configurar uma exceção, consulte o fornecedor do software de segurança.