{"meta":{"title":"Solução de problemas na autenticação do GitHub Copilot CLI","intro":"Diagnosticar falhas de autenticação ao entrar em Copilot CLI.","product":"GitHub Copilot","breadcrumbs":[{"href":"/pt/copilot","title":"GitHub Copilot"},{"href":"/pt/copilot/how-tos","title":"Instruções"},{"href":"/pt/copilot/how-tos/copilot-cli","title":"Copilot CLI"},{"href":"/pt/copilot/how-tos/copilot-cli/set-up-copilot-cli","title":"Configurar a CLI do Copilot"},{"href":"/pt/copilot/how-tos/copilot-cli/set-up-copilot-cli/troubleshoot-copilot-cli-auth","title":"Solucionar problemas de autenticação da CLI do Copilot"}],"documentType":"article"},"body":"# Solução de problemas na autenticação do GitHub Copilot CLI\n\nDiagnosticar falhas de autenticação ao entrar em Copilot CLI.\n\n## Erros de autenticação\n\nSe você encontrar erros de autenticação, use a tabela abaixo para identificar a causa e a resolução.\n\n| Questão | Motivo | Corrigir | Mais informações |\n| ------------------------------------------------------------------------------------- | ------------------------------------------------------ | ---------------------------------------------------- | ---------------- |\n| Nenhuma informação de autenticação encontrada | Nenhuma credencial armazenada | Execute `copilot login` | |\n| [Nenhuma informação de autenticação encontrada](#no-authentication-information-found) | | | |\n| 401 Não autorizado | Token revogado ou permissões insuficientes | Gerar token com permissões | |\n| [Token expirado ou revogado](#token-expired-or-revoked) | | | |\n| Token (classic) Rejeitado | | | |\n| Token (classic) (`ghp_`) | Usar personal access token refinado | | |\n| \\[ | | | |\n| Token (classic) Rejeitado]\\(#token-classic-rejected) | | | |\n| 403 Proibido ou política negada | | | |\n| Copilot licença ou política de empresa ou de organização | Verificar as configurações de assinatura e organização | | |\n| [Acesso negado](#access-denied) | | | |\n| Conjunto de chaves indisponível | Keychain do sistema ausente | Instalar `libsecret` ou aceitar texto sem formatação | |\n| [Falha de acesso ao keychain](#keychain-access-failure) | | | |\n| Conta errada | Várias contas ou substituição de variáveis de ambiente | Verificar variáveis de ambiente, usar `/user switch` | |\n| [Conta errada](#wrong-account) | | | |\n\n## Nenhuma informação de autenticação encontrada\n\nCopilot CLI exibe o seguinte erro:\n\n\n\n```text\nError: No authentication information found\nCopilot can be authenticated with GitHub using an OAuth Token or a Fine-Grained Personal Access Token\n```\n\n\n\n### Motivo\n\nNão existem credenciais em nenhum dos locais verificados.\n\n### Corrigir\n\nUtilize as etapas a seguir para descobrir onde a autenticação está faltando e restaurar o acesso.\n\n#### Verificar o status da autenticação\n\n```bash copy\ngh auth status\n```\n\nSe você vir uma mensagem indicando que não está conectado, faça logon com `gh auth login` ou use o fluxo OAuth com `copilot login`.\n\n#### Verificar se uma variável de ambiente de autenticação está definida\n\nSe você estiver usando uma variável de ambiente, verifique se a `COPILOT_GITHUB_TOKEN``GH_TOKEN`variável de ambiente ou `GITHUB_TOKEN` de ambiente está definida:\n\n```bash copy\necho $COPILOT_GITHUB_TOKEN\n```\n\nSe o comando não imprimir nada, a variável não será definida. Defina a variável como um token válido. Para gerar um token, consulte [Autenticando GitHub Copilot CLI](/pt/copilot/how-tos/copilot-cli/set-up-copilot-cli/authenticate-copilot-cli#authenticating-with-environment-variables).\n\n```bash copy\n export $COPILOT_GITHUB_TOKEN=PERSONAL_ACCESS_TOKEN\n```\n\n#### Conjunto de chaves do macOS\n\n```bash copy\nsecurity find-generic-password -s copilot-cli\n```\n\nSe nenhum item for encontrado, autentique-se novamente com `/login` ou `copilot login` para criar um.\nSe um item for encontrado, mas a autenticação ainda falhar, remova a credencial salva e autentique novamente com `/login` ou `copilot login`:\n\n```bash copy\n security delete-generic-password -s copilot-cli\n```\n\n## Token expirado ou revogado\n\nCopilot CLI exibe o seguinte erro:\n\n\n\n```text\nError: Authentication failed\n\nYour GitHub token may be invalid, expired, or lacking the required permissions.\n\nTo resolve this, try the following:\n • Start 'copilot' and run the '${LOGIN_COMMAND}' command to re-authenticate\n • If using a Fine-Grained PAT, ensure it has the 'Copilot Requests' permission enabled\n • If using COPILOT_GITHUB_TOKEN, GH_TOKEN or GITHUB_TOKEN environment variable, verify the token is valid and not expired\n • Run 'gh auth status' to check your current authentication status\n```\n\n\n\n### Motivo\n\nO token foi revogado, expirou ou foi criado sem as permissões necessárias.\n\n### Corrigir\n\nExamine o status e as permissões do token em GitHub. O token deve ser um fine-grained personal access token pertencente à sua **conta pessoal** (não de uma organização) com a permissão **Copilot de Solicitações**. Gere um novo token com as permissões necessárias, se necessário.\n\n## Token (classic) Rejeitado\n\nUm token que começa com `ghp_` é silenciosamente ignorado e a CLI se comporta como se nenhum token estivesse definido.\n\n### Motivo\n\nClássicos personal access tokens não são suportados por Copilot CLI.\n\n### Corrigir\n\nGere um personal access token refinado com os escopos necessários.\n\n## Acesso negado\n\nCopilot CLI exibe um dos seguintes erros:\n\n```text\nError: Access denied by policy settings\n\nYour Copilot CLI policy setting may be preventing access. This can happen when:\n • Your organization has restricted Copilot access\n • Your Copilot subscription does not include this feature\n • Required policies have not been enabled by your administrator\n\nTo resolve this, visit your Copilot settings: \n```\n\n### Motivo\n\nUma política de organização bloqueia GitHub Copilot CLIou a conta de usuário não tem uma GitHub Copilot licença.\n\n### Corrigir\n\n* Verifique se sua conta tem uma licença ativa GitHub Copilot .\n* Peça ao administrador da sua organização para habilitar GitHub Copilot CLI na política da organização.\n\n## Falha de acesso ao keychain\n\nDurante o logon, o CLI informa que o conjunto de chaves do sistema está indisponível e pergunta se deseja armazenar as credenciais em texto simples.\n\n```text\nSystem keychain unavailable. Store token in plaintext config file? (y/N)\n```\n\n### Motivo\n\nO conjunto de chaves do sistema não está acessível. Isso pode ocorrer em sistemas Linux sem `libsecret`, servidores sem interface gráfica ou sistemas com problemas de permissão.\n\n### Corrigir\n\nSiga as etapas para o seu sistema operacional restaurar o armazenamento seguro de credenciais.\n\n#### macOS ou Windows\n\nNo macOS, confirme se o aplicativo Keychain Access está disponível e certifique-se de que você pode desbloquear seu chaveiro de login.\nNo Windows, confirme se o Gerenciador de Credenciais está disponível e se você pode acessar o Cofre do Windows.\nSe você não puder acessar o gerenciador de credenciais do sistema, use armazenamento de texto puro (se solicitado) ou autentique usando um token de variável de ambiente e rode novamente `/login` ou `copilot login`.\n\n#### Linux\n\nNo Linux, use o chaveiro do sistema ou armazene credenciais em texto sem formatação.\n\n1. Verifique se `secret-tool` está instalado:\n\n ```bash copy\n command -v secret-tool\n ```\n\n2. Se `secret-tool` não for encontrado ou o comando de pesquisa não retornar resultados, instale `libsecret` e suas dependências. Por exemplo, no Debian e no Ubuntu, você pode usar o comando a seguir.\"\n\n ```bash copy\n sudo apt install libsecret-1-0 gnome-keyring seahorse\n ```\n\n3. Após a instalação de `secret-tool`, procure no chaveiro por uma credencial salva:\n\n ```bash copy\n secret-tool search copilot-cli\n ```\n\n Se o comando retornar um ou mais resultados, as credenciais existirão no keyring. Execute `copilot login` no terminal ou `/login` em Copilot CLI novamente.\n\n## Conta errada\n\nO usuário errado é autenticado ou o token pertence à organização errada.\n\n### Motivo\n\nVárias contas são armazenadas ou uma variável de ambiente está substituindo o token armazenado.\n\n### Corrigir\n\nPara alternar contas, use `/user switch` no prompt da CLI ou saia com `/logout` e execute `/login` com a conta correta."}