2FA do Buddy: como configurar um app autenticador

O Buddy é a plataforma de CI/CD em buddy.works em que equipes compilam, testam e implantam código por meio de pipelines. Antes de procurar a opção, confira o seu plano: a documentação do Buddy diz que a autenticação de dois fatores (2FA) não está disponível no plano grátis (Buddy). Em um plano pago, cada pessoa a ativa na própria conta, e um proprietário ou administrador do workspace pode torná-la obrigatória para todos no workspace.

O Buddy oferece dois métodos: um código por mensagem de texto (SMS) ou um app autenticador. Este guia trata do app. Usamos o Authenticator App - Novaz no iPhone, mas qualquer app autenticador segue os mesmos passos.

Como verificamos este guia: os passos do Buddy vêm da documentação e do blog do próprio Buddy, incluindo as capturas de tela da documentação, com links abaixo, que lemos em 21 de outubro de 2026. Não os testamos em uma conta do Buddy, 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 nos ajustes da sua conta pessoal, que o Buddy chama de My ID (meu ID), e não em Workspace Settings (Buddy):

1. Abra My ID e vá até a aba Security (segurança).
2. Na seção Two-Factor Authentication (autenticação de dois fatores), clique no botão +. Escolha Enable authentication app (ativar app de autenticação); a outra opção, Enable text message (ativar mensagem de texto), é o SMS.
3. Uma página chamada Set up 2FA via a third-party authenticator (configurar a 2FA com um autenticador de terceiros) se abre com um QR code. No Novaz, toque em +, depois em Escanear QR code, e aponte a câmera para a tela. Se você estiver vendo o Buddy no mesmo iPhone, faça uma captura de tela e use Escolher uma foto. Veja como escanear um QR code no mesmo iPhone.
4. Ao lado do QR code há um botão Show code (mostrar código). A documentação do Buddy não o explica. Se ele mostrar uma chave em texto, você pode tocar em + e depois em Inserir chave manualmente no Novaz e colá-la em Chave de configuração. O Buddy não diz quanto tempo os códigos duram, então escanear o QR code é a opção mais segura. Veja O que é a chave de configuração da 2FA?
5. Digite o código de 6 dígitos do Novaz em Auth code (código de autenticação) e clique em Enable 2FA (ativar a 2FA).
6. O Buddy então mostra os seus códigos de recuperação (próxima seção).

Quando terminar, a seção Two-Factor Authentication mostra Authenticator App (app autenticador) como o seu método.

Baixe os códigos de recuperação

O Buddy cria códigos de recuperação durante a configuração, e a tela não deixa você continuar até baixá-los. A captura de tela na documentação do Buddy mostra dez códigos de seis dígitos com um botão Download (baixar) e um botão de copiar (Buddy). O Buddy sugere guardá-los em um gerenciador de senhas.

Se você não fez um backup do Novaz com o Backup no iCloud ou um arquivo de backup, as chaves dele existem só no seu iPhone, então esses códigos são o que permite entrar se esse celular sumir. Guarde-os em algum lugar longe do celular. Mais em códigos de backup da 2FA.

Para vê-los de novo depois, clique em + na seção Two-Factor Authentication e escolha Show backup codes (mostrar códigos de backup). O item do menu e o título da tela usam palavras diferentes, mas se referem aos mesmos códigos. O anúncio do Buddy de 2018 dizia que você também podia gerá-los de novo a qualquer momento em My ID (Buddy); a documentação atual não menciona isso.

Se o seu workspace exige a 2FA

Proprietários e administradores do workspace podem ativar Enforce 2FA (exigir a 2FA) em Workspace Settings > Security (ajustes do workspace > segurança). Depois disso, os membros que não ativaram a 2FA não conseguem entrar no workspace (Buddy). Se você estiver bloqueado, configure a 2FA em My ID como mostrado acima.

Com login único (SSO), os membros com a 2FA ativada entram pelo provedor de identidade e ainda confirmam com o método de 2FA do Buddy (Buddy).

O Git por HTTPS exige um token

Se você hospeda repositórios no próprio Buddy, ativar a 2FA muda a forma como o Git faz login. Desde 14 de janeiro de 2022, o Buddy não aceita mais o seu nome de usuário e a sua senha no Git por HTTPS quando a 2FA está ativada. Use um token de acesso pessoal ou uma chave SSH (Buddy). Os dois são configurados na mesma aba Security de My ID.

Se o Buddy recusar o seu código

A documentação do Buddy não traz orientações para códigos recusados. Na maioria das vezes, o relógio do iPhone está errado: vá em Ajustes > Geral > Data e Hora e ative Ajustar Automaticamente. O Novaz mostra um aviso quando o relógio está defasado em 15 segundos ou mais. Para outras causas, veja Código do autenticador não funciona?

Celular novo ou celular perdido

A documentação do Buddy não descreve como passar a 2FA para um celular novo nem como trocar do app para o SMS. A captura de tela de uma conta com a 2FA ativada mostra um menu (três pontos) ao lado de Authenticator App, mas a página não diz o que ele oferece. No Novaz, você pode restaurar as suas contas no iPhone novo a partir do Backup no iCloud ou de um arquivo de backup. De qualquer forma, guarde o celular antigo até a 2FA do Buddy funcionar no novo. Veja Como transferir o seu app autenticador para um iPhone novo.

Se o celular for perdido, entre com um dos seus códigos de recuperação. O Buddy avisa que, sem esses códigos, você não volta a entrar na conta se o dispositivo for perdido ou danificado (Buddy). A documentação não descreve nenhum outro processo de recuperação, comprovação de identidade ou prazo. O endereço de suporte que o Buddy informa é support@buddy.works (Buddy). Mais em Perdeu o celular com o seu app autenticador?

Como desativar a 2FA também não está documentado.

Ajuda oficial do Buddy

• Security (Buddy docs)
• Single Sign-On (SSO) with SAML & OIDC Identity Providers
• Two-factor authentication (2FA) (blog do Buddy, 2018)
• Changes to Git access in Buddy-hosted repos (2FA accounts only) (blog do Buddy, 2021)