Skip to main content

Acessar o GitHub usando a autenticação de dois fatores

Com a 2FA habilitada, será solicitado que você forneça seu código de autenticação de 2FA, bem como sua senha, ao iniciar a sessão no GitHub.

Com a autenticação de dois fatores habilitada, você deverá fornecer um código de autenticação ao acessar GitHub por meio do seu navegador. Se você acessar GitHub usando outros métodos, como, por exemplo, a API ou a linha de comando, você deverá usar uma forma alternativa de autenticação. Para obter mais informações, confira "Sobre a autenticação no GitHub".

Fornecer um código 2FA ao entrar no site

Depois de entrar no GitHub usando sua senha, você precisará fornecer um código de autenticação de uma mensagem de texto ou do seu aplicativo TOTP.

O GitHub solicitará seu código de autenticação 2FA novamente apenas se você se desconectar, for usar um novo dispositivo ou a sessão expirar.

Gerar um código por meio de um aplicativo TOTP

Se você optar por configurar a autenticação de dois fatores usando um aplicativo TOTP no smartphone, será possível gerar um código de autenticação para o GitHub a qualquer momento. Na maioria das vezes, apenas iniciar o aplicativo gera um novo código. Você deve consultar a documentação do seu aplicativo para obter instruções específicas.

Em caso de exclusão do aplicativo móvel após configuração da autenticação de dois fatores, será preciso fornecer seu código de recuperação para obter acesso à sua conta. Para obter mais informações, confira "Como recuperar sua conta se você perder suas credenciais de autenticação de dois fatores"

Receber uma mensagem de texto

Se você configurar a autenticação de dois fatores por meio de mensagens de texto, o GitHub enviará uma mensagem de texto com seu código de autenticação.

Verificando com GitHub Mobile

Se você tiver instalado e conectado a GitHub Mobile, você poderá optar por efetuar a autenticação com GitHub Mobile para autenticação de dois fatores.

  1. Efetue o login em GitHub com seu navegador, usando seu nome de usuário e senha.

  2. Se você adicionou uma chave de segurança à sua conta, primeiro será solicitado que você insira e use uma chave de segurança. Para ignorar o uso de uma chave de segurança, clique em Autenticar-se com o GitHub Mobile . Desafio da autenticação de dois fatores no GitHub com "Autenticar-se com o GitHub Mobile" realçado

  3. GitHub irá enviar uma notificação por push para verificar a sua tentativa de login. Abrir a notificação push ou abrir o aplicativo de GitHub Mobile irá exibir um aviso que pedirá que você aprove ou rejeite esta tentativa de login.

    Observação: esse prompt pode exigir que você insira um número de dois dígitos exibido no navegador no qual você está entrando.

    GitHub Mobile exige uma entrada de dois dígitos em duas etapas

    • Ao aprovar a tentativa de login usando GitHub Mobile, seu navegador concluirá a tentativa de login automaticamente.
    • Rejeitar a tentativa de login na tentativa impedirá que a autenticação seja concluída. Para obter mais informações, confira "Como manter sua conta e seus dados seguros".

Usar a autenticação de dois fatores com a linha de comando

Depois de habilitar a 2FA, você não usará mais sua senha para acessar GitHub na linha de comando. Em vez disso, use o Git Credential Manager, um token de acesso pessoal ou uma chave SSH.

Autenticação na linha de comando usando o Git Credential Manager

O Git Credential Manager é um auxiliar de credencial do git seguro que é executado em Windows, macOS e Linux. Para obter mais informações sobre auxiliares de credenciais do Git, confira Evitar repetições no livro Pro Git.

As instruções de instalação variam de acordo com o sistema operacional do computador. Para obter mais informações, confira Baixar e instalar no repositório GitCredentialManager/git-credential-manager.

Autenticar na linha de comando usando HTTPS

Após habilitação da 2FA, você deverá criar um token de acesso pessoal a ser usado como uma senha ao autenticar no GitHub na linha de comando usando URLs HTTPS.

Ao ser solicitado a fornecer um nome de usuário e uma senha na linha de comando, use seu nome de usuário no GitHub e o token de acesso pessoal. O prompt da linha de comando não especificará que você deve inserir seu token de acesso pessoal quando solicitar sua senha.

Para obter mais informações, confira "Como criar um token de acesso pessoal".

Autenticar na linha de comando usando SSH

Habilitar a 2FA não altera como você faz a autenticação no GitHub na linha de comando usando URLs SSH. Para obter mais informações sobre como configurar e usar uma chave SSH, confira "Como se conectar ao GitHub com o SSH".

Usar a autenticação de dois fatores para acessar um repositório usando o Subversion

Quando você acessa um repositório via Subversion, é preciso fornecer um token de acesso pessoal no lugar de digitar sua senha. Para obter mais informações, confira "Como criar um token de acesso pessoal".

Solução de problemas

Em caso de perda de acesso às suas credenciais de autenticação de dois fatores, você poderá usar seus códigos de recuperação ou outro método de recuperação (se houver um configurado) para obter acesso novamente à sua conta. Para obter mais informações, confira "Como recuperar sua conta se você perder suas credenciais de 2FA".

Se a autenticação falhar várias vezes, talvez seja conveniente sincronizar o relógio do seu telefone com o provedor móvel. Muitas vezes, isso envolve verificar a opção "Set automatically" (Definir automaticamente) no relógio do seu telefone, em vez de fornecer seu próprio fuso horário.

Leitura adicional