Com a autenticação de dois fatores habilitada, você precisará informar um código de autenticação ou usar uma chave de acesso ou chave de segurança ao acessar GitHub pelo navegador. Se você acessar GitHub usando outros métodos, como a API ou a linha de comando, será necessário usar uma forma alternativa de autenticação. Para saber mais, confira Sobre a autenticação para GitHub.
Como executar a 2FA ao entrar no site
Depois de entrar em GitHub com sua senha, você precisará fornecer um código de autenticação ou usar uma chave de segurança para realizar a autenticação de dois fatores.
GitHub só solicitará que você forneça seu código de autenticação 2FA novamente se você tiver feito logon, estiver usando um novo dispositivo, estiver executando uma ação confidencial ou sua sessão expirar. Para obter mais informações sobre o uso de 2FA para ações confidenciais, confira Modo sudo.
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, poderá gerar um código de autenticação a GitHub 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.
Se você excluir seu aplicativo autenticador após configurar a autenticação de dois fatores, precisará fornecer seu código de recuperação para obter acesso à sua conta. Muitos aplicativos TOTP dão suporte ao backup seguro de seus códigos de autenticação na nuvem e podem ser restaurados se você perder o acesso ao seu dispositivo. Para saber mais, confira Recuperar sua conta ao perder as credenciais 2FA.
Como usar uma chave de segurança
Se você configurou uma chave de segurança em sua conta e seu navegador oferece suporte a esse recurso, você pode usá-lo para se conectar.
- Usando seu nome de usuário e senha, faça login em GitHub pelo navegador.
- Se você usar uma chave de segurança física, verifique se ela está conectada ao seu dispositivo.
- Para disparar o prompt de chave de segurança do sistema operacional, selecione "Usar chave de segurança".
- Selecione a opção apropriada no prompt. Dependendo da configuração da chave de segurança, você pode digitar um PIN, usar um prompt biométrico ou uma chave de segurança física.
Usar uma chave de acesso
Se você habilitou a 2FA e adicionou uma chave de acesso à sua conta, poderá usar a chave de acesso para entrar. Como as chaves de acesso atendem aos requisitos de senha e 2FA, você pode concluir sua entrada com uma única etapa. Confira Sobre chaves de acesso.
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 personal access tokenou uma chave SSH.
Autenticação na linha de comando usando o Git Credential Manager
Git Credential Manager é um auxiliar de credencial Git seguro 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
Você deve criar uma personal access token para usar como senha ao autenticar GitHub na linha de comando usando URLs HTTPS.
Quando solicitado um nome de usuário e senha na linha de comando, use seu GitHub nome de usuário e personal access token. O prompt da linha de comando não informará que você deve inserir seu personal access token quando ele solicitar sua senha.
Para saber mais, confira Gerenciar seus tokens de acesso pessoal.
Autenticar na linha de comando usando SSH
Habilitar a autenticação de dois fatores (2FA) não altera a forma como você se autentica no GitHub pela linha de comando com URLs SSH. Para obter mais informações sobre como configurar e usar uma chave SSH, confira Conectando-se ao GitHub com o SSH.
Solução de problemas
Se você estiver recebendo um erro de "Falha na autenticação de dois fatores" ao autenticar com 2FA, o código de autenticação que você está inserindo está incorreto. Você pode tentar solucionar problemas dos métodos de autenticação configurados antes de tentar a recuperação da conta. Confira Solução de problemas de autenticação de dois fatores.