A verificação em duas etapas do Bitbucket é a mesma da minha conta Atlassian?

Não. Sua conta Atlassian, que também dá acesso ao Jira, ao Confluence e ao Trello, tem sua própria verificação em duas etapas, e o Bitbucket Cloud tem uma segunda, só dele. Com as duas ativadas, você digita dois códigos de duas entradas diferentes na extensão — use a entrada do Bitbucket no pedido do Bitbucket. A Atlassian também pede um backup diferente: uma única chave de recuperação de emergência em vez de seis códigos de recuperação.

Qual aplicativo autenticador funciona com o Bitbucket?

O Bitbucket cita o Authy, o Google Authenticator, o Duo e o Microsoft Authenticator e aceita qualquer app compatível com TOTP, no celular ou no computador. A extensão Authenticator lê o QR code direto da página do Bitbucket e gera os códigos no Chrome — sem precisar de celular.

Por que o git push parou de funcionar depois que ativei a verificação em duas etapas?

Com a verificação em duas etapas ativada, o Bitbucket espera que o Git acesse seus repositórios via SSH — para clonar, fazer push, pull e fetch. Adicione uma chave SSH à sua conta e troque os remotes dos seus repositórios para os endereços SSH; ferramentas que não podem usar SSH precisam de um token em vez da sua senha.

E se eu perder o acesso ao meu autenticador?

Digite um código de recuperação no campo “Verification code” e depois desative e ative a verificação em duas etapas de novo para adicionar o novo QR code. Sem códigos, selecione “Forgot code” (Esqueci o código) no pedido do código e “Send recovery email” (Enviar e-mail de recuperação): o Bitbucket manda um e-mail primeiro, espera 24 horas — um prazo que não pode ser encurtado — e então envia um link de login de uso único que expira 24 horas depois, então confira a caixa de entrada e a pasta de spam a tempo.

Bitbucket: aplicativo autenticador — ative a verificação em duas etapas (2FA)

Uma conta do Bitbucket faz push para os seus repositórios, aprova pull requests e roda Pipelines com os segredos dos seus deploys — uma senha roubada põe seu código, e tudo aquilo em que ele faz deploy, nas mãos de outra pessoa. Com a verificação em duas etapas ativada, o Bitbucket pede um código do seu autenticador em todo login, e um workspace no plano Premium pode exigi-la antes de dar acesso a qualquer pessoa.

Ative a verificação em duas etapas no Bitbucket

Esta é uma configuração do próprio Bitbucket, separada da verificação em duas etapas da sua conta Atlassian: se as duas estiverem ativadas, você recebe primeiro o pedido do código da Atlassian e depois o do Bitbucket, e cada código só funciona no seu próprio pedido. Antes de começar, o Bitbucket precisa de um e-mail confirmado e de uma senha na sua conta Atlassian, além de uma chave SSH — com a verificação em duas etapas ativada, o Git precisa acessar seus repositórios via SSH, e clientes Git e ferramentas de build precisam usar SSH ou um token em vez da sua senha.

Entre em bitbucket.org no computador.
Selecione a engrenagem de configurações e depois “Personal Bitbucket settings” (Configurações pessoais do Bitbucket).
Em “Security” (Segurança), selecione “Two-step verification” (Verificação em duas etapas) e confira os requisitos que o Bitbucket lista.
Digite a senha da sua conta Atlassian e selecione “Set up two-step verification” (Configurar a verificação em duas etapas).
Quando o Bitbucket mostrar um QR code, deixe essa página aberta e adicione-o à extensão como descrito abaixo — ou copie a chave do campo “Key” (Chave) —; depois digite o código da extensão no campo “Verification code” (Código de verificação).

Instruções oficiais do Bitbucket

Adicione o Bitbucket ao Authenticator

Instale o Autenticador 2FA pela Chrome Web Store e fixe-o na barra de ferramentas, para que o ícone fique a um clique de distância.
Deixe aberta a página do Bitbucket com o QR code. Clique no ícone do Authenticator e depois em “Adicionar Conta” → “Código QR” → “Escanear QR da tela”.
A conta aparece na lista com um código de seis dígitos que muda a cada 30 segundos. Renomeie se quiser — o nome é só para você.
Volte ao Bitbucket e digite o código atual no campo de confirmação. Se ele estiver prestes a expirar, espere o próximo.
O Bitbucket confirma que a autenticação de dois fatores está ativada. A partir de agora, ele vai pedir um código ao entrar — clique no ícone da extensão e copie-o.

Não tem QR code ou ele não é lido? Procure na tela de configuração do Bitbucket a opção de inserir uma chave manualmente, copie a chave e adicione-a na extensão em “Adicionar Conta” → “Manual” → “Chave Secreta”.

Instalar o Autenticador 2FA no Chrome — grátis

Salve seus seis códigos de recuperação do Bitbucket

A última etapa da configuração entrega seis códigos de recuperação: baixe-os, e o Bitbucket sugere imprimir uma cópia também, como último recurso. Guarde-os em outro lugar que não seja este computador. Cada código funciona uma vez, digitado no campo “Verification code” como um código normal. Mantenha pelo menos dois sem usar — você precisa de dois 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 de Two-step verification, mostra-os de novo. A Atlassian não consegue desativar a verificação em duas etapas do Bitbucket por você, o que faz desses códigos o seu caminho de volta.

O código não é aceito?

Na maioria das vezes o QR code mudou: o site gera um novo sempre que a página de configuração é recarregada ou aberta de novo, então a conta que você adicionou primeiro não bate mais. Comece a configuração de novo, adicione o QR code que está na tela agora e digite o código dele na hora. Duas entradas para o mesmo site? Use a mais nova. Outros motivos: por que os códigos são recusados.

Digitou a chave à mão? Cole-a no gerador de códigos TOTP e compare o código com o da extensão. Se forem diferentes, a chave foi copiada errado — adicione a conta de novo.

Perguntas frequentes

A verificação em duas etapas do Bitbucket é a mesma da minha conta Atlassian?: Não. Sua conta Atlassian, que também dá acesso ao Jira, ao Confluence e ao Trello, tem sua própria verificação em duas etapas, e o Bitbucket Cloud tem uma segunda, só dele. Com as duas ativadas, você digita dois códigos de duas entradas diferentes na extensão — use a entrada do Bitbucket no pedido do Bitbucket. A Atlassian também pede um backup diferente: uma única chave de recuperação de emergência em vez de seis códigos de recuperação.
Qual aplicativo autenticador funciona com o Bitbucket?: O Bitbucket cita o Authy, o Google Authenticator, o Duo e o Microsoft Authenticator e aceita qualquer app compatível com TOTP, no celular ou no computador. A extensão Authenticator lê o QR code direto da página do Bitbucket e gera os códigos no Chrome — sem precisar de celular.
Por que o git push parou de funcionar depois que ativei a verificação em duas etapas?: Com a verificação em duas etapas ativada, o Bitbucket espera que o Git acesse seus repositórios via SSH — para clonar, fazer push, pull e fetch. Adicione uma chave SSH à sua conta e troque os remotes dos seus repositórios para os endereços SSH; ferramentas que não podem usar SSH precisam de um token em vez da sua senha.
E se eu perder o acesso ao meu autenticador?: Digite um código de recuperação no campo “Verification code” e depois desative e ative a verificação em duas etapas de novo para adicionar o novo QR code. Sem códigos, selecione “Forgot code” (Esqueci o código) no pedido do código e “Send recovery email” (Enviar e-mail de recuperação): o Bitbucket manda um e-mail primeiro, espera 24 horas — um prazo que não pode ser encurtado — e então envia um link de login de uso único que expira 24 horas depois, então confira a caixa de entrada e a pasta de spam a tempo.

Seus códigos a um clique da página de login

O Authenticator guarda seus códigos de 2FA no navegador, só no seu dispositivo — de uso gratuito, de código aberto, sem conta e sem precisar de celular. Backups locais e proteção opcional por senha já vêm incluídos.