Autenticar para o GitHub no GitHub Desktop

Você pode acessar com segurança os recursos da sua conta em GitHub Desktop através da autenticação no GitHub.

Platform navigation

Neste artigo

Sobre autenticação

Para manter sua conta segura, você deve autenticar antes de usar o GitHub Desktop para acessar os recursos no GitHub.

Antes de autenticar, você já deve ter uma conta no GitHub. Para obter mais informações, confira "Criar uma conta no GitHub".

Autenticando uma conta no GitHub

  1. Na barra de menus, selecione GitHub Desktop e clique em Preferências.

    Captura de tela da barra de menus no Mac. No menu suspenso "GitHub Desktop" aberto, o cursor passa sobre "Preferências", que está realçada em azul.

  2. Na janela "Preferências", no painel Contas, clique no botão Entrar ao lado de "GitHub.com".

    Captura de tela do painel "Contas" na janela "Preferências". Ao lado de "GitHub.com", há um botão rotulado como "Entrar" e contornado em laranja.

  3. Na janela modal "Entrar usando seu navegador", clique em Continuar no Navegador. GitHub Desktop abrirá seu navegador padrão.

  4. Para se autenticar no GitHub, digite suas credenciais do GitHub.com e clique em Entrar.

    Como alternativa, se você já estava logado no GitHub, siga as instruções para retornar ao GitHub Desktop para finalizar a autenticação.

  5. Se você configurou a autenticação de dois fatores (2FA) no GitHub, faça uma das seguintes opções:

    • Se você configurou a 2FA via SMS, recupere seu código 2FA na mensagem SMS.
    • Se você configurou a 2FA com um aplicativo TOTP, gere um código 2FA.

    Em seguida, insira o código 2FA no prompt do GitHub e clique em Verificar.

  6. Depois que o GitHub autenticar sua conta, siga as instruções para retornar a GitHub Desktop.

Autenticando uma conta no GitHub Enterprise Server

  1. Na barra de menus, selecione GitHub Desktop e clique em Preferências.

    Captura de tela da barra de menus no Mac. No menu suspenso "GitHub Desktop" aberto, o cursor passa sobre "Preferências", que está realçada em azul.

  2. Na janela "Preferências", no painel Contas, clique no botão Entrar ao lado de "GitHub Enterprise".

    Captura de tela do painel "Contas" na janela "Preferências". Ao lado de "GitHub Enterprise", há um botão rotulado como "Entrar" e contornado em laranja.

  3. Para adicionar uma conta no sua instância do GitHub Enterprise Server, na janela modal "Entrar", digite a URL da sua instância em "Endereço da empresa" e clique em Continuar.

  4. Na janela modal "Entrar usando seu navegador", clique em Continuar no Navegador. GitHub Desktop abrirá seu navegador padrão.

  5. Para se autenticar na conta do sua instância do GitHub Enterprise Server, digite as credenciais da sua conta e clique em Entrar.

    Como alternativa, se você já estava conectado à conta do sua instância do GitHub Enterprise Server, siga os prompts para voltar ao GitHub Desktop para finalizar a autenticação.

Autenticando uma conta no GitHub

  1. Use o menu Arquivo e clique em Opções.

    Captura de tela da barra de menus "GitHub Desktop" no Windows. No menu suspenso "Arquivo" que é expandido, há um item "Opções" realçado com o contorno em laranja.

  2. Na janela "Opções", no painel Contas, clique no botão Entrar ao lado de "GitHub.com".

    Captura de tela do painel "Contas" na janela "Opções". Ao lado de "GitHub.com", há um botão rotulado como "Entrar" e contornado em laranja.

  3. Na janela modal "Entrar usando seu navegador", clique em Continuar no Navegador. GitHub Desktop abrirá seu navegador padrão.

    Aviso: não há suporte para autenticação no GitHub com seu nome de usuário e a senha. Em vez disso, é necessário se autenticar usando o navegador.

  4. Para se autenticar no GitHub, digite suas credenciais do GitHub.com e clique em Entrar.

    Como alternativa, se você já estava logado no GitHub, siga as instruções para retornar ao GitHub Desktop para finalizar a autenticação.

  5. Se você configurou a autenticação de dois fatores (2FA) no GitHub, faça uma das seguintes opções:

    • Se você configurou a 2FA via SMS, recupere seu código 2FA na mensagem SMS.
    • Se você configurou a 2FA com um aplicativo TOTP, gere um código 2FA.

    Em seguida, insira o código 2FA no prompt do GitHub e clique em Verificar.

  6. Depois que o GitHub autenticar sua conta, siga as instruções para retornar a GitHub Desktop.

Autenticando uma conta no GitHub Enterprise

  1. Use o menu Arquivo e clique em Opções.

    Captura de tela da barra de menus "GitHub Desktop" no Windows. No menu suspenso "Arquivo" que é expandido, há um item "Opções" realçado com o contorno em laranja.

  2. Na janela "Opções", no painel Contas, clique no botão Entrar ao lado de "GitHub Enterprise".

    Captura de tela do painel "Contas" na janela "Opções". Ao lado de "GitHub Enterprise", há um botão rotulado como "Entrar" e contornado em laranja.

  3. Para adicionar uma conta do GitHub Enterprise, digite suas credenciais em "Endereço da empresa" e clique em Continuar.

  4. Se você configurou a autenticação de dois fatores do GitHub Enterprise, execute uma das seguintes opções:

    • Se você configurou a 2FA via SMS, recupere seu código 2FA na mensagem SMS.
    • Se você configurou a 2FA com um aplicativo TOTP, gere um código 2FA.

Solucionando problemas de autenticação

Se o GitHub Desktop encontrar um erro de autenticação, você pode usar mensagens de erro para solucionar problemas.

Se você encontrar um erro de autenticação, primeiro tente sair e entrar novamente em sua conta no GitHub Desktop.

Para alguns erros, GitHub Desktop enviará a você uma mensagem de erro. Se você não receber a mensagem, ou caso queira encontrar mais informações sobre qualquer erro, visualize os arquivos de log de GitHub Desktop usando as seguintes etapas.

  1. Na barra de menus, selecione Ajuda e clique em Mostrar Logs no Localizador.

    Captura de tela da barra de menus "GitHub Desktop" em um Mac. No menu suspenso "Ajuda" expandido, há um cursor sobre "Mostrar logs no Localizador" realçado em azul.

  2. Selecione o arquivo de log a partir da data em que você encontrou o erro de autenticação.

  1. Use o menu suspenso Ajuda e clique em Mostrar Logs no Explorer.

    Captura de tela da barra de menus "GitHub Desktop" no Windows. No menu suspenso "Ajuda" expandido, há uma opção "Mostrar logs no Explorer" com o contorno em laranja.

  2. Selecione o arquivo de log a partir da data em que você encontrou o erro de autenticação.

Revise abaixo as informações de solução de problemas para a mensagem de erro que você encontrar.

Credenciais inválidas

Error: Bad credentials

Este erro significa que há um problema com suas credenciais da conta armazenada.

Para solucionar problemas, saia da sua conta no GitHub Desktop e entre novamente.

Token vazio

info: [ui] [AppStore.withAuthenticatingUser] account found for repository: node - USERNAME (empty token)

Este erro significa que GitHub Desktop não foi possível encontrar o token de acesso que ele criou no keychain do sistema.

Para solucionar problemas, saia da sua conta no GitHub Desktop e entre novamente.

Repositório não encontrado

fatal: repository 'https://github.com/<user>/<repo>.git' not found

(The error was parsed as 8: The repository does not seem to exist anymore. You may not have access, or it may have been deleted or renamed.)

Este erro significa que você não tem permissão para acessar o repositório que está tentando clonar.

Para solucionar problemas, entre em contato com a pessoa da sua organização que administra as permissões.

Não foi possível ler a partir do repositório remoto

git@github.com: Permission denied (publickey).
fatal: Could not read from remote repository.

Please make sure you have the correct access rights and the repository exists.

Este erro significa que você não tem uma chave SSH válida configurada.

Para solucionar problemas, confira "Gerando uma nova chave SSH e adicionando-a ao agente SSH".

Falha ao clonar

fatal: clone of 'git@github.com:<user>/<repo>' into submodule path '<path>' failed
Failed to clone 'src/github.com/<user>/<repo>'. Retry scheduled
Cloning into '<path>'...
git@github.com: Permission denied (publickey).
fatal: Could not read from remote repository.
Please make sure you have the correct access rights
and the repository exists.

Este erro significa que, ou o repositório que você está tentando clonar tem submódulos aos quais você não tem acesso, ou você não tem uma chave SSH válida configurada.

Se você não tem acesso aos submódulos, resolva problemas entrando em contato com a pessoa que administra permissões para o repositório.

Caso não tenha uma chave SSH válida configurada, confira "Gerando uma nova chave SSH e adicionando-a ao agente SSH".

Não foi possível ler a resposta do AskPass

error: unable to read askpass response from '/Users/<path>/GitHub Desktop.app/Contents/Resources/app/static/ask-pass-trampoline.sh'
fatal: could not read Username for 'https://github.com': terminal prompts disabled

Este erro pode ser causado por vários eventos.

Se as entradas Command Processor do Registro forem modificadas, o GitHub Desktop responderá com o erro Authentication failed. Para verificar se estas entradas de registro foram modificadas, siga estas etapas.

  1. Abra o Editor do Registro (regedit.exe) e procure os locais a seguir. HKEY_CURRENT_USER\Software\Microsoft\Command Processor\ HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Command Processor\
  2. Verifique se há um valor Autorun em um desses locais.
  3. Se houver um valor Autorun, exclua-o.

Se o seu nome de usuário do Windows tiver caracteres Unicode estendidos, isso pode causar um erro de resposta do AskPass. Para solucionar problemas, crie uma nova conta de usuário do Windows e migre seus arquivos para essa conta. Para obter mais informações, confira "Criar uma conta de usuário no Windows" na documentação da Microsoft.

Leitura adicional