Pular para o conteúdo
Novaz AuthenticatorOBTER

2FA do Bitbucket: 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. Antes de começar: SSH e uma senha
  2. Ative a 2FA com um app autenticador
  3. Seis códigos de recuperação
  4. Se o Bitbucket recusar o seu código
  5. Passar para um celular novo
  6. Se você perder o autenticador
  7. Desativar a 2FA
  8. Ajuda oficial do Bitbucket e da Atlassian

O Bitbucket Cloud, a hospedagem Git da Atlassian em bitbucket.org, faz o seu login com uma conta Atlassian (Bitbucket), mas a verificação em duas etapas dele é um ajuste separado. A Atlassian descreve duas verificações, uma para a conta e outra para o Bitbucket. Com as duas ativadas, você pode encarar dois pedidos de código seguidos, e o código de uma não serve para a outra (Atlassian).

O ajuste próprio do Bitbucket, tratado aqui, aceita um app autenticador baseado em tempo (TOTP) ou uma chave de segurança FIDO U2F. A página de ajuda não menciona mensagens de texto (Bitbucket). Ele é opcional, a menos que um workspace do Bitbucket Premium o exija para você acessar os repositórios privados dele (Bitbucket). Para a camada da conta, veja a ajuda da Atlassian sobre verificação em duas etapas.

Os passos usam o Authenticator App - Novaz no iPhone; outros apps autenticadores funcionam de forma parecida.

Como verificamos este guia: os passos do Bitbucket vêm das páginas de ajuda do Bitbucket Cloud, dos artigos da base de conhecimento e do changelog para desenvolvedores da própria Atlassian, com link abaixo, que lemos em 20 de outubro de 2026. Não os testamos em uma conta do Bitbucket, então um rótulo pode ser um pouco diferente. Os passos do Novaz foram conferidos no app, versão 1.0.5.

Antes de começar: SSH e uma senha

O Bitbucket lista estes requisitos (Bitbucket):

  • Uma chave SSH na sua conta. Com a verificação em duas etapas ativada, espera-se que as ações remotas do Git passem por SSH, então troque antes seus remotes, clientes Git e ferramentas de build.
  • Um endereço de e-mail confirmado e uma senha da conta Atlassian. Ainda não tem senha? O Bitbucket diz para definir uma pela recuperação de senha e fazer login de novo.

A página de duas etapas ainda sugere senhas de app para HTTPS e para a API, mas o changelog do Bitbucket marcou a descontinuação completa delas para 28 de julho de 2026 (Bitbucket). As substitutas, os tokens de API, não exigem a verificação em duas etapas (Bitbucket).

Ative a 2FA com um app autenticador

  1. No Bitbucket, selecione a engrenagem Settings (ajustes) e depois Personal Bitbucket settings (ajustes pessoais do Bitbucket) (Bitbucket).
  2. Em Security (segurança), selecione Two-step verification (verificação em duas etapas). O endereço direto é bitbucket.org/account/settings/two-step-verification/manage (Bitbucket).
  3. Confira os requisitos, digite a senha da sua conta Atlassian e selecione Set up two-step verification (configurar a verificação em duas etapas).
  4. Quando o QR code aparecer, toque em + no Novaz, escolha Escanear QR code e aponte a câmera para ele. No mesmo iPhone, faça uma captura de tela e use Escolher uma foto. Veja como escanear um QR code no mesmo iPhone.
  5. Se escanear falhar, os campos Account (conta) e Key (chave) do Bitbucket trazem os mesmos dados. No Novaz, toque em +, depois em Inserir chave manualmente, digite Bitbucket em Serviço e cole a Key em Chave de configuração. Veja O que é a chave de configuração da 2FA?
  6. Digite o código atual do Novaz em Verification code (código de verificação).
  7. Baixe ou anote seus códigos de recuperação.

Os códigos têm 6 dígitos (Bitbucket), mas nenhuma página informa o intervalo, e uma chave digitada sempre gera códigos de 30 segundos no Novaz, então escaneie se puder. Depois disso, todo login pede um código em Verification code e depois Verify (verificar). O Bitbucket não menciona lembrar um dispositivo.

Seis códigos de recuperação

Você recebe 6 códigos de recuperação, cada um válido uma vez, digitados em Verification code como um código do app. Mantenha pelo menos dois sem usar: o Bitbucket exige essa quantidade para gerar novos códigos ou para desativar a verificação em duas etapas. Show recovery codes (mostrar códigos de recuperação), na página Two-step verification, exibe os códigos; quando os 6 tiverem sido usados, selecione Can't find codes? (não encontra os códigos?) ali (Bitbucket).

Se você perder o iPhone e não tiver backup do Novaz, ou só tiver um de antes de adicionar o Bitbucket, esses códigos são o seu caminho de volta. Guarde-os longe do celular. Mais em Códigos de backup da 2FA.

Se o Bitbucket recusar o seu código

A ajuda do Bitbucket sugere estas verificações (Bitbucket, Bitbucket):

  • Digite os dígitos todos juntos, sem espaço.
  • Leia a entrada certa. Com a verificação da conta Atlassian também ativada, você terá duas, e elas não são intercambiáveis.
  • Não reutilize um código de recuperação.
  • Acerte o relógio: uma defasagem de 30 a 60 segundos quebra os códigos. No iPhone, ative Ajustes > Geral > Data e Hora > Ajustar Automaticamente, ou desative e ative de novo se já estiver ativado, e espere um novo código. O Novaz mostra um aviso quando o relógio está defasado em 15 segundos ou mais.

Ainda sem sucesso? Use um código de recuperação e veja Código do autenticador não funciona?

Passar para um celular novo

O caminho do Bitbucket é desativar e ativar de novo a verificação em duas etapas (Bitbucket). Enquanto o celular antigo funciona, abra Two-step verification, digite o código dele ou um código de recuperação, selecione Disable two-step verification (desativar a verificação em duas etapas), depois configure com o celular novo e salve os novos códigos.

No Novaz, um Backup no iCloud ou um arquivo de backup restaura suas contas no iPhone novo, então os códigos continuam funcionando sem isso. Sem um deles, cada conta vai para o iPhone novo do zero. Veja Como transferir seu app autenticador para um iPhone novo.

Se você perder o autenticador

Comece com um código de recuperação. O Bitbucket também menciona obtê-los por SSH, sem dar os passos.

Sem códigos restantes, um artigo da base de conhecimento de março de 2026 descreve a recuperação por e-mail (Atlassian):

  1. No pedido do código, selecione Forgot code (esqueci o código) e depois Send recovery email (enviar e-mail de recuperação). A página de ajuda principal chama isso de Can't find codes?, então os rótulos podem variar.
  2. O primeiro e-mail só diz para esperar. 24 horas depois, um segundo e-mail traz um link de login de uso único (confira o spam).
  3. O link expira em 24 horas e faz o seu login com a verificação em duas etapas desativada. Configure-a de novo.

A espera não pode ser encurtada: "Atlassian cannot disable two-step verification for any Bitbucket user account" (a Atlassian não pode desativar a verificação em duas etapas de nenhuma conta de usuário do Bitbucket) (Bitbucket). Se o e-mail falhar, o artigo sugere abrir um ticket no suporte da Atlassian.

Se a sua conta Atlassian também tiver verificação em duas etapas, libere primeiro essa camada com a chave de recuperação de emergência de 24 caracteres. Mais em Perdeu o celular com o seu app autenticador?

Desativar a 2FA

Em Two-step verification, digite um código do app ou de recuperação, selecione Disable two-step verification e confirme com Disable (desativar) (Bitbucket). Se você exige a verificação em duas etapas no conteúdo que administra, desmarque antes Require two-step verification (exigir verificação em duas etapas) em Access controls (controles de acesso) (Bitbucket). Depois, apague a entrada do Bitbucket no Novaz com Remover conta.

Ajuda oficial do Bitbucket e da Atlassian

Mais guias: Ferramentas para desenvolvedores