2FA do Buildkite: como configurar um app autenticador
Pela equipe Novaz · Atualizado em 6 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
Um login do Buildkite dá acesso aos seus pipelines, builds e agentes de CI/CD. A autenticação de dois fatores (2FA) acrescenta um código de um app autenticador além da senha. O que você precisa saber antes de começar: o Buildkite fornece códigos de recuperação e, se você perder tanto o autenticador quanto esses códigos, o caminho documentado de volta é pedir a exclusão da sua conta e criar uma nova (Buildkite).
A documentação do Buildkite descreve um único método de 2FA, um app autenticador de terceiros. A 2FA é opcional na sua conta pessoal, mas um administrador da organização pode torná-la obrigatória para todos na organização (mais sobre isso abaixo). Este guia usa o Authenticator App - Novaz no iPhone. Qualquer app autenticador funciona do mesmo jeito.
Como verificamos este guia: os passos do Buildkite vêm da documentação do próprio Buildkite, com links abaixo, que lemos em 21 de outubro de 2026. Não os testamos em uma conta do Buildkite, 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
O tutorial de 2FA do Buildkite descreve estes passos no painel (Buildkite):
- Abra o menu suspenso abaixo da sua foto de perfil e selecione Personal Settings (ajustes pessoais).
- Clique em Two-Factor Authentication (autenticação de dois fatores). Se aparecer um campo Confirm Password (confirmar senha), digite a sua senha do Buildkite e continue.
- Clique em Setup Two-Factor Authentication (configurar a autenticação de dois fatores).
- O Buildkite mostra primeiro os seus códigos de recuperação. Copie-os ou baixe-os como arquivo de texto e guarde-os em algum lugar que não seja o celular. Depois, continue.
- O Buildkite mostra um código de barras (um QR code). No Novaz, toque em +, depois em Escanear QR code, e aponte a câmera para ele. Se o painel estiver aberto no mesmo iPhone, faça uma captura de tela e use Escolher uma foto. Veja como escanear um QR code no mesmo iPhone.
- Se não conseguir escanear, use a chave secreta que o Buildkite mostra abaixo do código de barras. No Novaz, toque em + e depois em Inserir chave manualmente. Digite "Buildkite" em Serviço, o seu e-mail em Conta, se quiser, e a chave secreta em Chave de configuração. Veja O que é a chave de configuração da 2FA?
- Digite o código de 6 dígitos do Novaz no campo do Buildkite e clique em Activate (ativar).
Se deu certo, Personal Settings mostra um selo Enabled (ativada) ao lado de Two-Factor Authentication.
O Buildkite diz que os códigos têm seis dígitos e mudam a cada 30 segundos, mais ou menos, o que corresponde ao que o Novaz gera a partir de uma chave digitada. Se o Novaz não aceitar a chave que você digitou, escaneie o QR code.
Os códigos de recuperação são o seu backup
O Buildkite entrega os códigos de recuperação antes mesmo de mostrar o QR code, e o tutorial manda guardá-los em um lugar digital seguro ou no papel e nunca compartilhá-los (Buildkite). Leve essa etapa a sério. Se esse celular sumir e o Novaz não tiver backup com o Backup no iCloud ou um arquivo de backup, os códigos de recuperação são o jeito de voltar a entrar. A documentação não diz quantos códigos você recebe, se cada um funciona só uma vez nem como gerar um conjunto novo. Mais em códigos de backup da 2FA.
Quando o Buildkite pede um código
O Buildkite pede o código atual quando você entra a partir de um navegador novo, de um dispositivo novo ou de um local novo (Buildkite).
Quando a sua organização exige a 2FA
Um administrador da organização pode exigir a 2FA de todos os membros em Settings > Security (ajustes > segurança), selecionando Enforce Two-factor authentication (exigir a autenticação de dois fatores) e depois Update Access Control (atualizar o controle de acesso) (Buildkite). Isso tem algumas consequências:
- Os membros que não configuraram a 2FA perdem na hora o acesso à organização e aos pipelines dela. Configure-a antes que a exigência seja ativada.
- Os tokens de acesso à API existentes continuam funcionando, mas você não pode criar tokens novos nem alterar os existentes até ativar a 2FA (Buildkite).
- As organizações que exigem login único (SSO) precisam desativar a exigência da 2FA, para que as duas não se apliquem ao mesmo tempo (Buildkite).
Se o Buildkite recusar o seu código
A documentação do Buildkite não traz orientações para códigos errados. A causa mais comum é um relógio do celular que se desajustou. No iPhone, abra Ajustes > Geral > Data e Hora e ative Ajustar Automaticamente. O Novaz também 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
O Buildkite diz que você pode reconfigurar ou desativar a 2FA na área Two-Factor Authentication de Personal Settings (Buildkite). A documentação não descreve uma troca de celular, mas a ordem segura é reconfigurar a 2FA ali enquanto o celular antigo ainda gera códigos e escanear o novo QR code com o Novaz no iPhone novo. Ou, se você usa o Backup no iCloud ou um arquivo de backup do Novaz, restaure-o no iPhone novo e pule a reconfiguração. Veja Como transferir o seu app autenticador para um iPhone novo.
Se você perder o autenticador
Entre com um dos seus códigos de recuperação e depois configure a 2FA de novo no celular novo.
Sem os códigos de recuperação, o tutorial do Buildkite não oferece nenhuma forma de redefinir a 2FA na conta que você tem. O caminho dele é (Buildkite):
- Peça ao administrador da sua organização no Buildkite que remova a sua conta da organização.
- Envie um e-mail para support@buildkite.com pedindo a exclusão da sua conta.
- Depois que ela for excluída, crie uma conta nova. O tutorial não fala de como voltar à organização, então pergunte ao seu administrador.
A documentação não diz que comprovação o suporte pede nem quanto tempo leva a exclusão. Para equipes, o guia de resposta a incidentes do Buildkite sugere guardar o segredo da 2FA e os códigos de recuperação de um administrador em um cofre de acesso restrito (Buildkite). Veja Perdeu o celular com o seu app autenticador?
Desativar a 2FA
Vá em Personal Settings > Two-Factor Authentication para desativá-la (Buildkite). O tutorial não lista os botões exatos. Se a sua organização exige a 2FA, desativá-la vai cortar o seu acesso a essa organização. Depois de desativar, remova a conta do Novaz: abra-a e toque em Remover conta.
