2FA da balena: como configurar um app autenticador no balenaCloud

Uma conta do balenaCloud controla frotas de dispositivos conectados: o código que eles rodam, o acesso SSH a eles e as chaves de API que podem mudar tudo isso. Por isso, ela merece mais do que uma senha. A autenticação de dois fatores (2FA) da balena é opcional e usa um único método, um código baseado em tempo de um app autenticador (TOTP). A documentação não traz opção por SMS (balena, balena). Este guia usa o Authenticator App - Novaz no iPhone, mas qualquer app autenticador funciona do mesmo jeito.

Como verificamos este guia: os passos da balena vêm da documentação da própria balena, com link abaixo, que lemos em 21 de outubro de 2026. Para bloqueios de acesso, também lemos respostas da equipe da balena no fórum oficial dela. Não testamos nada disso em uma conta do balenaCloud, 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 documentação de contas da balena descreve estes passos (balena):

1. Faça login no painel do balenaCloud. Clique no seu perfil no canto superior direito e abra a página Preferences (preferências).
2. Abra a aba Two-factor Authentication (autenticação de dois fatores) e clique em Enable two-factor authentication (ativar a autenticação de dois fatores).
3. A balena mostra um QR code e um campo Pairing code (código de pareamento). No Novaz, toque em +, depois em Escanear QR code, e aponte a câmera para o código no monitor. Se o painel estiver aberto no mesmo iPhone, faça uma captura de tela, toque em + e depois em Escolher uma foto. Veja como escanear um QR code no mesmo iPhone.
4. Digite o código de 6 dígitos do Novaz em Pairing code.
5. A balena mostra então os seus códigos de recuperação. Baixe-os e guarde-os em um lugar seguro, depois clique em OK.

A documentação ressalta que a 2FA só é ativada quando o pareamento dá certo, então você não fica bloqueado se parar no meio.

A documentação da balena não menciona uma chave em texto para digitar no lugar do QR code e não diz com que frequência os códigos mudam. Escaneie o QR code: ele leva as configurações do código para o seu app. Se você encontrar uma chave e digitá-la com Inserir chave manualmente, o Novaz assume 6 dígitos a cada 30 segundos. Veja O que é a chave de configuração da 2FA?

A lista de apps verificados da balena cita o Google Authenticator, o Authy e o 1Password. O Novaz não está nela, mas gera os mesmos códigos TOTP padrão.

Se você entra com SAML

Se você usa o login único da sua empresa e recebe um erro toda vez que tenta ativar a 2FA, a sugestão da balena é sair, entrar de novo e tentar outra vez logo em seguida (balena).

Quando a balena pede um código

Depois da configuração, a balena pede o código do seu app no próximo login, depois que você digitar o nome de usuário e a senha (balena). A documentação não menciona dispositivos lembrados ou confiáveis.

Na linha de comando, balena login aceita seu e-mail, sua senha e um código de 2FA, ou permite autorizar a CLI pelo painel, ou aceita um token de sessão ou uma chave de API (balena). As chaves de API nunca expiram, a menos que sejam revogadas, e têm todas as suas permissões (balena), então proteja-as como os seus códigos de recuperação.

Guarde os seus códigos de recuperação

Os códigos de recuperação são o único backup que a balena documenta. Eles são o seu jeito de voltar a entrar se o celular sumir e você não tiver um backup do Novaz, ou só tiver um feito antes de adicionar a balena. Guarde-os em um gerenciador de senhas ou no papel, longe do celular. Mais em Códigos de backup da 2FA.

Se a balena recusar o seu código

A documentação da balena diz que um código para de funcionar quando a contagem regressiva no app termina, então digite-o enquanto ele ainda aparece. Se códigos novos continuarem falhando, confira o relógio do iPhone: Ajustes > Geral > Data e Hora > Ajustar Automaticamente. O Novaz avisa quando o relógio está defasado em 15 segundos ou mais. Outras causas estão em Código do autenticador não funciona?

Trocar de celular

A documentação da balena não descreve como passar a 2FA para um celular novo. Os passos que ela traz são desativar e ativar de novo. Enquanto você ainda tem o celular antigo, desative a 2FA, depois ative-a de novo e escaneie o novo QR code com o iPhone novo. Se você ativou o backup no iCloud do Novaz ou salvou um arquivo de backup, restaurá-lo no iPhone novo é o caminho mais simples: os códigos continuam funcionando. Veja Como transferir seu app autenticador para um iPhone novo.

Se você perder o autenticador

Entre com um dos seus códigos de recuperação. Sem eles, a documentação da balena não oferece caminho de autoatendimento. O lugar documentado para pedir ajuda é a seção de suporte ao produto dos fóruns da balena (balena).

Em um tópico do fórum de 2023, respostas da equipe da balena, incluindo um moderador listado do fórum, descreveram o processo. Os códigos de recuperação são a forma mais rápida de provar que a conta é sua. Na falta deles, a balena verifica se você tem a parte privada de uma chave SSH que adicionou à sua conta do balenaCloud. Você assina uma sequência de caracteres que eles fornecem e envia o resultado a um membro da equipe da balena em particular, nunca em um post público. Quando a assinatura é confirmada, a balena remove a 2FA para que você entre só com a senha (balena forums). Isso vem de respostas no fórum, não da documentação, e a balena não diz quanto tempo leva. Se você usa SSH com seus dispositivos, guarde essa chave. Mais em Perdeu o celular com o seu app autenticador?

Desativar a 2FA

Volte à aba Two-factor Authentication nas suas preferências e clique em Disable two-factor authentication (desativar a autenticação de dois fatores). A balena pede primeiro a senha da sua conta (balena). Se você se cadastrou com o GitHub ou o Google e nunca definiu uma senha, pode adicionar uma na aba Account details (dados da conta) da mesma página.

Ajuda oficial da balena

• Account management
• Security
• Enterprise Single Sign-On (SSO): Introduction
• Balena CLI reference (latest)
• Getting Help
• Disable 2FA Reset without recovery codes (tópico do balenaForums com respostas da equipe da balena)