Com a autenticação de dois fatores (2FA) habilitada, você precisará usar um segundo fator ao acessar GitHub por meio do navegador. Quando você configurar a 2FA pela primeira vez, sua conta entrará em um período de verificação de 28 dias para garantir que os métodos de 2FA da sua conta estejam configurados corretamente. Você pode sair do período de verificação realizando a 2FA com sucesso dentro de 28 dias. Se você não se autenticar dentro de 28 dias, será solicitado que você execute 2FA dentro de uma de suas sessões existentes GitHub . Se você não conseguir realizar a 2FA para passar pela verificação do 28º dia, use o atalho fornecido para reconfigurar a 2FA e manter seu acesso a GitHub. Para saber mais, confira Configurar a autenticação de dois fatores.
Se você acessar GitHub usando outros métodos, como a API ou a linha de comando, você será autenticado usando um token, aplicativo ou chave SSH. 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, tocar em uma notificação em GitHub Mobile, 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.
Receber uma mensagem de texto
Se você configurar a autenticação de dois fatores por meio de mensagens de texto, GitHub enviará uma mensagem de texto com o código de autenticação.
Verificando com GitHub Mobile
Se você tiver instalado e feito login em GitHub Mobile, poderá optar por usar GitHub Mobile na autenticação de dois fatores.
-
Faça login em GitHub usando seu navegador, nome de usuário e senha.
-
GitHub enviará uma notificação por push para verificar sua tentativa de entrada. Ao abrir a notificação push ou o aplicativo GitHub Mobile, será exibida uma mensagem pedindo que você aprove ou rejeite esta tentativa de login.
Observação
Essa solicitação pode exigir que você insira um número de dois dígitos exibido no navegador no qual você está entrando.
- Ao aprovar a tentativa de logon usando GitHub Mobile, seu navegador concluirá a tentativa de entrada automaticamente.
- Rejeitar a tentativa de login impedirá que a autenticação seja concluída. Para saber mais, confira Proteger sua conta e dados.
Usar a autenticação de dois fatores com a linha de comando
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 especificará que você deve inserir seu personal access token quando 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.