2FA do Bitrise: 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
O Bitrise é uma plataforma de CI/CD para apps móveis: a sua conta pessoal do Bitrise dá acesso aos workspaces e projetos em que rodam os seus builds de iOS e Android. A autenticação de dois fatores (2FA) é opcional e usa um app autenticador. Antes de ativá-la, saiba uma coisa sobre o Bitrise: se você perder tanto o autenticador quanto os códigos de recuperação, o Bitrise diz que a equipe de suporte em geral não consegue remover a 2FA para você (Bitrise). Por isso, este guia dedica tanto tempo ao plano de backup quanto à configuração.
A documentação do Bitrise cita o Google Authenticator, mas a configuração é um QR code padrão, então qualquer app autenticador funciona. Nos passos abaixo usamos o Authenticator App - Novaz no iPhone.
Como verificamos este guia: os passos do Bitrise vêm da documentação do próprio Bitrise, incluindo as capturas de tela, com link abaixo, que lemos em 21 de outubro de 2026. Não os testamos em uma conta do Bitrise, então um rótulo pode ser um pouco diferente. Os passos do Novaz foram conferidos no app, versão 1.0.5.
Ative a 2FA com um app autenticador
A opção fica na sua conta pessoal, não em um workspace (Bitrise):
- Entre no Bitrise e escolha Bitrise CI no menu de navegação à esquerda.
- Clique na sua imagem de perfil no canto superior direito e escolha Account settings (configurações da conta).
- Escolha Security (segurança) à esquerda.
- Em Two-factor authentication (autenticação de dois fatores), clique no controle 2FA is enabled (a 2FA está ativada). (A documentação do Bitrise usa esse rótulo tanto para ativar quanto para desativar.)
- Um QR code aparece. No Novaz, toque em +, depois em Escanear QR code, e aponte a câmera para ele. Se o QR code estiver no mesmo iPhone, faça uma captura de tela e use Escolher uma foto. Veja como escanear um QR code no mesmo iPhone.
- Digite no Bitrise o código de 6 dígitos do Novaz.
- Guarde os códigos de recuperação que o Bitrise fornece.
Quando a 2FA está ativada e os códigos de recuperação foram guardados, o Bitrise manda um e-mail de confirmação de letsconnect@bitrise.io.
A página do Bitrise não menciona uma chave em texto que você possa digitar no lugar de escanear. Se encontrar uma na tela de configuração, no Novaz toque em +, depois em Inserir chave manualmente, e cole-a como Chave de configuração. Veja O que é a chave de configuração da 2FA?
Os códigos de recuperação são o verdadeiro backup
Sem um backup do Novaz (backup no iCloud ou arquivo de backup), as chaves existem só no seu iPhone e, de qualquer forma, os códigos de recuperação são a sua única alternativa dentro do Bitrise. Guarde-os em um gerenciador de senhas ou imprima-os, e mantenha-os longe do celular.
A captura de tela da página Security na documentação do Bitrise mostra uma seção Recovery codes (códigos de recuperação) com um botão New recovery codes (novos códigos de recuperação), que é onde você obteria um conjunto novo. O texto da página não explica quantos códigos você recebe nem o que acontece com os antigos. Mais sobre como guardá-los em Códigos de backup da 2FA.
Quando o Bitrise pede um código
O Bitrise descreve a 2FA como uma etapa extra no processo de login (Bitrise). A documentação não diz se você pode marcar um navegador como confiável nem com que frequência o código será pedido.
Se o seu workspace exige SAML SSO, você entra pelo provedor de identidade da sua empresa, e esse provedor pode aplicar as próprias regras de 2FA (Bitrise). Nesse caso, a configuração do seu empregador decide como você comprova quem é.
Se o Bitrise recusar o seu código
A documentação do Bitrise não trata de códigos recusados. A causa mais comum é o relógio do iPhone: abra Ajustes > Geral > Data e Hora e ative Ajustar Automaticamente. O Novaz avisa quando o relógio está defasado em 15 segundos ou mais. Saiba também que várias tentativas de login malsucedidas podem bloquear a sua conta do Bitrise e que, nesse caso, o Bitrise manda instruções de desbloqueio por e-mail (Bitrise). Outras causas estão em Código do autenticador não funciona?
Trocar de celular
O Bitrise não descreve como passar a 2FA para um celular novo. Com um backup no iCloud ou um arquivo de backup do Novaz, você pode simplesmente restaurar as suas contas no iPhone novo. Sem nenhum dos dois, repare que a documentação do Bitrise diz que desativar a 2FA só pede a sua senha do Bitrise enquanto você está conectado; então, enquanto ainda tem o celular antigo, você pode desativar a 2FA, ativá-la de novo e escanear o novo QR code no iPhone novo. Guarde os novos códigos de recuperação. Veja Como transferir o seu app autenticador para um iPhone novo.
Se você perder o autenticador
Comece com um código de recuperação. Sem um, as suas opções são poucas (Bitrise):
- Uma conta Git conectada. Se você vinculou GitHub, GitLab ou Bitbucket ao Bitrise antes, o Bitrise sugere tentar entrar por ela. Você pode conectar essas contas a partir da sua conta (Bitrise), e vale a pena fazer isso antes de precisar.
- O suporte do Bitrise, em casos raros. O Bitrise só pode remover a 2FA se uma conta de provedor Git já estiver conectada. Mande um e-mail para o suporte a partir do endereço com que você se cadastrou e explique o motivo. O suporte vai pedir que você crie um novo repositório público chamado
bitrise_verificationnessa conta Git e envie o link. Ainda assim, ele pode recusar se remover a 2FA parecer um risco de segurança. - Uma conta nova. Sem conta Git conectada, o Bitrise recomenda criar uma nova conta do Bitrise.
O Bitrise não diz quanto tempo leva um pedido ao suporte. Mais em Perdeu o celular com o seu app autenticador?
Desativar a 2FA
Vá em Account settings > Security, clique em 2FA is enabled em Two-factor authentication, digite a sua senha do Bitrise na janela Edit profile (editar perfil) e clique em Done (concluído) (Bitrise). Depois, abra a entrada do Bitrise no Novaz e toque em Remover conta.
