Pular para o conteúdo
Novaz AuthenticatorOBTER

2FA do GitHub: como configurar um app autenticador

Pela equipe Novaz · Atualizado em 5 de novembro de 2026
Passos do Novaz verificados na versão 1.0.5

Traduzido do guia em inglês. No site do serviço, os botões e menus podem ter nomes um pouco diferentes em português.

Nesta página
  1. A 2FA é obrigatória na sua conta?
  2. Ative a 2FA com um app autenticador
  3. A verificação de 28 dias
  4. Seus códigos de recuperação
  5. Quando o GitHub pede um código
  6. Se o GitHub recusar o seu código
  7. Mudar para um iPhone novo
  8. Se você perder o autenticador
  9. Desativar a 2FA
  10. Ajuda oficial do GitHub

Sua conta do GitHub é onde ficam seus repositórios, issues e pull requests, e nela a autenticação de dois fatores (2FA) muitas vezes não é uma escolha sua. Desde março de 2023, o GitHub a exige de contas que contribuem com código, e as organizações podem exigi-la de seus membros. O GitHub recomenda um app autenticador, que a documentação dele chama de app TOTP, como método principal. Mensagens de texto são a única outra forma de começar; chaves-senha (passkeys), chaves de segurança e o GitHub Mobile podem ser adicionados depois (GitHub, GitHub). Este guia usa o Authenticator App - Novaz no iPhone, mas qualquer app autenticador funciona do mesmo jeito.

Como verificamos este guia: os passos do GitHub vêm do GitHub Docs e do GitHub Blog, com link abaixo, que lemos em 20 de outubro de 2026. Não os testamos em uma conta do GitHub, então um rótulo pode ser um pouco diferente. Os passos do Novaz foram conferidos no app, versão 1.0.5.

A 2FA é obrigatória na sua conta?

O GitHub seleciona contas pelo que elas fazem: publicar um app ou uma action, criar uma release, ser dono de uma organização ou contribuir com repositórios que publicam pacotes ou que o GitHub considera de alta importância. As contas selecionadas recebem um e-mail e avisos em banners, e têm 45 dias para configurar a 2FA, mais um período de tolerância de 7 dias. Depois disso, o GitHub.com fica inacessível até a 2FA ser ativada. O login único (single sign-on) da sua empresa não isenta você (GitHub).

Você nunca precisa dar um número de telefone ao GitHub: um app autenticador basta. Ele também é a única opção onde o GitHub não oferece mensagens de texto, e conta como método seguro para organizações que só permitem métodos seguros (GitHub).

Ative a 2FA com um app autenticador

Os passos no GitHub.com (GitHub):

  1. Clique na sua foto de perfil no canto superior direito e depois em Settings (configurações).
  2. Na seção Access (acesso) da barra lateral, clique em Password and authentication (senha e autenticação).
  3. Em Two-factor authentication (autenticação de dois fatores), clique em Enable two-factor authentication (ativar a autenticação de dois fatores).
  4. Em Scan the QR code (escaneie o QR code), o GitHub mostra um QR code. No Novaz, toque em + e depois em Escanear QR code. Se o código estiver no mesmo iPhone, faça uma captura de tela e use Escolher uma foto. Veja como escanear um QR code no mesmo iPhone.
  5. Não consegue escanear? Clique em setup key (chave de configuração) para ver o segredo como texto. No Novaz, toque em +, depois em Inserir chave manualmente, e digite-o como Chave de configuração. O GitHub usa 6 dígitos, 30 segundos e SHA-1, então uma chave digitada funciona. Veja O que é a chave de configuração da 2FA?
  6. Digite o código do Novaz em Verify the code from the app (verifique o código do app).
  7. Em Save your recovery codes (salve seus códigos de recuperação), clique em Download (baixar) e depois em I have saved my recovery codes (salvei meus códigos de recuperação). Esse clique ativa a 2FA.

A verificação de 28 dias

Cada nova configuração de 2FA inicia uma verificação de 28 dias. Faça um login com 2FA nesse prazo e ela termina. Se não fizer, o GitHub pede a 2FA em uma das suas sessões abertas no 28º dia (GitHub). O objetivo é detectar apps autenticadores configurados errado. Se você não conseguir passar, o GitHub oferece um atalho para configurar a 2FA de novo sem ficar bloqueado (GitHub). O jeito mais fácil de passar: saia logo depois da configuração e entre de novo com um código do Novaz.

Seus códigos de recuperação

Você recebe 16 códigos de uso único no formato xxxxx-yyyyy, salvos por padrão como github-recovery-codes.txt (GitHub, GitHub). O GitHub recomenda apps autenticadores que fazem backup na nuvem (GitHub). No Novaz, isso é o Backup no iCloud (PRO). Um arquivo de backup que você mesmo exporta também serve, desde que você o mantenha atualizado; sem nenhum dos dois, as chaves ficam só no seu iPhone. Guarde esses códigos de qualquer forma, para o dia em que o celular sumir e o backup estiver faltando ou desatualizado. O GitHub sugere um gerenciador de senhas para eles.

Mais tarde, clique em View (ver) ao lado de Recovery codes (códigos de recuperação) em Password and authentication para usar Download, Print (imprimir) ou Copy (copiar). Generate new recovery codes (gerar novos códigos de recuperação) cancela o conjunto antigo, assim como desativar e reativar a 2FA. Trocar de app autenticador não cancela (GitHub). Veja Códigos de backup da 2FA.

Quando o GitHub pede um código

O GitHub pede um código depois da senha quando você entra. Ele só pede de novo quando você saiu, usa um dispositivo novo, sua sessão expira ou você faz algo sensível (GitHub). Ações sensíveis incluem mudar um endereço de e-mail, adicionar uma chave SSH, criar um token de acesso pessoal e ver os códigos de recuperação. Depois de uma delas, o GitHub não pede de novo por duas horas (GitHub).

O Git na linha de comando nunca pede o código: o HTTPS usa um token de acesso pessoal, e o SSH funciona como antes (GitHub).

Se o GitHub recusar o seu código

Um código errado mostra Two-factor authentication failed (falha na autenticação de dois fatores). As verificações do GitHub: leia o código no app e na entrada que você configurou, ajuste a data e a hora do celular automaticamente e digite um código novo na hora, sem espaços (GitHub). No iPhone, isso é Ajustes > Geral > Data e Hora > Ajustar Automaticamente. O Novaz avisa quando o relógio está defasado em 15 segundos ou mais.

A mesma página diz que o Suporte do GitHub "cannot assist with troubleshooting your 2FA methods" (não pode ajudar a resolver problemas dos seus métodos de 2FA) (GitHub). Veja Código do autenticador não funciona?

Mudar para um iPhone novo

Você não precisa desativar a 2FA. Em Password and authentication, em Two-factor methods (métodos de dois fatores), clique em Edit (editar) ao lado do app autenticador (se tiver vários métodos, abra primeiro o menu ao lado dele). Escaneie o novo QR code com o Novaz no iPhone novo, digite um código e clique em Save (salvar). Seus códigos de recuperação continuam os mesmos (GitHub). Só então remova o GitHub do Novaz no iPhone antigo: abra a conta e toque em Remover conta. Faça isso antes de se desfazer do aparelho antigo. Se você tiver o Backup no iCloud ou um arquivo de backup do Novaz, pode restaurar suas contas no iPhone novo em vez disso, e a entrada do GitHub continua funcionando. Veja Como transferir seu app autenticador para um iPhone novo.

Se você perder o autenticador

As opções do GitHub, nesta ordem (GitHub):

  1. Outro método que você adicionou: chave-senha, chave de segurança, GitHub Mobile ou mensagens de texto.
  2. Um código de recuperação. Depois da senha, escolha 2FA recovery code (código de recuperação da 2FA) em More options (mais opções), digite um código e clique em Verify (verificar).
  3. Recuperação da conta. Nessa tela, escolha Begin account or email recovery (iniciar a recuperação da conta ou do e-mail) e depois I understand, get started (entendi, começar). Digite a senha de uso único que o GitHub envia por e-mail e prove que é você com Verify with this device (verificar com este dispositivo, se você já entrou nele antes), SSH key (chave SSH) ou Personal access token (token de acesso pessoal). O Suporte do GitHub analisa o pedido e responde por e-mail em até três dias úteis.

Esqueceu a senha também? Comece redefinindo a senha; depois, o GitHub oferece as mesmas opções.

A opção 3 só funciona se você se preparou. O GitHub sugere uma chave SSH adicionada como chave de autenticação ou um token de acesso pessoal clássico com o escopo repo (GitHub). Não apague os cookies todos os dias: é por um cookie que o GitHub reconhece um dispositivo que você já usou (GitHub).

Se nada funcionar, a conta está perdida para sempre. O Suporte não a restaura e não aceita verificação de identidade (GitHub). Você ainda pode desvincular seu endereço de e-mail e usá-lo em uma conta nova. Veja Perdeu o celular com o seu app autenticador?

Desativar a 2FA

Em Password and authentication, abra o menu de três pontos, escolha Disable two-factor authentication (desativar a autenticação de dois fatores) e confirme. Você perde o acesso às organizações que exigem 2FA, e se o GitHub selecionou você para a 2FA obrigatória, não é possível desativá-la de jeito nenhum (GitHub). Para trocar de app, edite o método em vez disso.

Ajuda oficial do GitHub

Mais guias: Ferramentas para desenvolvedores