Publicamos atualizações frequentes em nossa documentação, e a tradução desta página ainda pode estar em andamento. Para obter as informações mais recentes, acesse a documentação em inglês. Se houver problemas com a tradução desta página, entre em contato conosco.

Autenticar com o GitHub

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

Neste artigo

Esse documento ajudou você?

Ajude-nos a tornar esses documentos ótimos!

Todos os documentos do GitHub são de código aberto. Você percebeu que algo que está errado ou não está claro? Envie um pull request.

Faça uma contribuição

Ou, aprenda como contribuir.

Sobre a 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 do GitHub ou do GitHub Enterprise.

  • Para obter mais informações sobre como criar uma conta no GitHub, consulte "Inscrever uma nova conta do GitHub".
  • Para uma conta do GitHub Enterprise, entre em contato com o administrador do site do GitHub Enterprise.

Autenticando uma conta no GitHub

  1. Na barra de menu, use o menu suspenso GitHub Desktop e clique em Preferências.

    Valor das Preferences (Preferências) no menu suspenso doGitHub Desktop

  2. Na janela Preferências, selecione Accounts (Contas).

    Painel Accounts (Contas) na janela Preferences (Preferências)

  3. À direita de "GitHub.com," clique Iniciar sessão.

    Botão Sign In (Entrar) do GitHub

  4. No painel "Entrar", clique em Entrar usando seu navegador. GitHub Desktop abrirá seu navegador padrão.

    Link Sign in using your browser (Entrar via navegador)

    Aviso: Efetuar a autenticação em GitHub usando seu nome de usuário e senha está em desuso. Em vez disso, recomendamos efetuar a autenticação usando o navegador.

  5. Para autenticar no GitHub, digite suas credenciais do GitHub.com e clique em Sign in (Login).

    Botão de Sign In (Login) em GitHub no navegador

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

  6. 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 seu código 2FA no prompt no GitHub e clique em Verify (Verificar).

    Campo de autenticação do código 2FA

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

Autenticando uma conta no GitHub Enterprise

Aviso: Efetuar a autenticação em GitHub usando seu nome de usuário e senha está em desuso. Em vez disso, recomendamos efetuar a autenticação usando o navegador.

  1. Na barra de menu, use o menu suspenso GitHub Desktop e clique em Preferências.

    Valor das Preferences (Preferências) no menu suspenso doGitHub Desktop

  2. Na janela Preferências, selecione Accounts (Contas).

    Painel Accounts (Contas) na janela Preferences (Preferências)

  3. À direita do "Servidor GitHub Enterprise", clique em Sign In (Entrar).

    Botão Sign In (Entrar) do GitHub Enterprise Server

  4. Para adicionar uma conta de GitHub Enterprise, digite as suas credenciais em "Endereço do servidor Enterprise" e clique em Continuar.

    Botão Sign In (Entrar) do GitHub Enterprise

  5. Se você configurou a autenticação de dois fatores no 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.

    Em seguida, insira seu código 2FA no prompt no GitHub Desktop e clique em Sign In (Entrar).

    Campo de autenticação do código 2FA

Autenticando uma conta no GitHub

  1. Use o menu File (Arquivo) e clique em Options (Opções).

    Valor Options (Opções) no menu suspenso Settings (Configurações)

  2. Na janela Options (Opções), selecione Accounts (Contas).

    Painel Accounts (Contas) na janela Options (Opções)

  3. À direita do "GitHub.com", clique Iniciar sessão.

    Botão Sign In (Entrar) do GitHub

  4. No painel Sign in (Entrar), clique em Sign in using your browser (Entrar via navegador).

    Link Sign in using your browser (Entrar via navegador)

    Aviso: Efetuar a autenticação em GitHub usando seu nome de usuário e senha está em desuso. Em vez disso, recomendamos efetuar a autenticação usando o navegador.

  5. Para autenticar no GitHub, digite suas credenciais do GitHub.com e clique em Sign in (Login).

    Botão de Sign In (Login) em GitHub no navegador

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

  6. 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 seu código 2FA no prompt no GitHub e clique em Verify (Verificar).

    Campo de autenticação do código 2FA

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

Autenticando uma conta no GitHub Enterprise

Aviso: Efetuar a autenticação em GitHub usando seu nome de usuário e senha está em desuso. Em vez disso, recomendamos efetuar a autenticação usando o navegador.

  1. Use o menu File (Arquivo) e clique em Options (Opções).

    Valor Options (Opções) no menu suspenso Settings (Configurações)

  2. Na janela Options (Opções), selecione Accounts (Contas).

    Painel Accounts (Contas) na janela Options (Opções)

  3. À direita do "Servidor GitHub Enterprise", clique em Sign In (Entrar).

    Botão Sign In (Entrar) do GitHub Enterprise Server

  4. Para adicionar uma conta de GitHub Enterprise, digite as suas credenciais em "Endereço do servidor Enterprise" e clique em Continuar.

    Botão Sign In (Entrar) do GitHub Enterprise

  5. Se você configurou a autenticação de dois fatores no 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.

    Em seguida, insira seu código 2FA no prompt no GitHub Desktop e clique em Sign In (Entrar).

    Campo de autenticação do código 2FA

Solução de 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. Use o menu suspenso Help (Ajuda) e clique em Show Logs in Finder (Mostrar Logs no Finder).
    O botão Mostrar Logs no Finder
  2. Selecione o arquivo de log a partir da data em que você encontrou o erro de autenticação.
  1. Use o menu suspenso Help (Ajuda) e clique em Show Logs in Explorer (Mostrar Logs no Explorer).
    O botão Mostrar Logs no Explorer
  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

Erro: credenciais inválidas

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] conta encontrada para o repositório: node -  (token vazio)

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: repositório 'https://github.com//.git' não encontrado

(O erro foi analisado como 8: O repositório parece não existir mais. Talvez você não tenha acesso, ou ele pode ter sido excluído ou renomeado.)

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: Permissão negada (publickey).
fatal: Não foi possível ler a partir do repositório remoto.

Por favor, verifique se você tem os direitos de acesso corretos e se o repositório existe.

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

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

Falha ao clonar

fatal: o clone do 'git@github.com:/' no caminho do submódulo '' falhou
Falha ao clonar 'src/github.com//'. Nova tentativa agendada
Clonando em ''...
git@github.com: Permissão negada (publickey).
fatal: Não foi possível ler a partir do repositório remoto.
Por favor, verifique se você tem os direitos de acesso corretos e se o repositório existe.

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.

Se você não tem uma chave SSH válida configurada, consulte "Gerando uma nova chave SSH e adicionando-a ao agente SSH".

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

erro: incapaz de ler a resposta de askpass a partir de '/Users//GitHub Desktop.app/Contents/Resources/static/ask-pass-trampoline.sh'
fatal: não pôde ler o nome de usuário para 'https://github.com': terminal prompts desativado

Este erro pode ser causado por vários eventos.

Se as entradas de registro do Processador de Comando forem modificadas, GitHub Desktop responderá com um erro de falha de Autenticação. Para verificar se estas entradas de registro foram modificadas, siga estas etapas.

  1. Abra o Editor de Registro (regedit.exe) e navegue para os seguintes locais. HKEY_CURRENT_USER\Software\Microsoft\Command Processor\`HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Command Processor`
  2. Verifique se há um valor de Autorun em algum local.
  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, consulte "Criar uma conta de usuário no Windows" na documentação da Microsoft.

Leia mais

Esse documento ajudou você?

Ajude-nos a tornar esses documentos ótimos!

Todos os documentos do GitHub são de código aberto. Você percebeu que algo que está errado ou não está claro? Envie um pull request.

Faça uma contribuição

Ou, aprenda como contribuir.