2FA do Assembla: 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 Assembla hospeda repositórios Perforce, Subversion e Git junto com ferramentas de gestão de projetos (Assembla), então o seu login no Assembla muitas vezes protege código-fonte. Ele aceita autenticação de dois fatores (2FA) com um app autenticador, e o dono de um portfólio pode torná-la obrigatória para todos no portfólio. Duas coisas o diferenciam. A tela de configuração dá um QR code e nada mais, sem chave para digitar. E, com a 2FA ativada, a sua senha deixa de funcionar nos clientes de repositório (Assembla).
Este guia usa o Authenticator App - Novaz no iPhone. Qualquer app autenticador que gere códigos baseados em tempo funciona do mesmo jeito.
Como verificamos este guia: os passos do Assembla vêm da central de ajuda do próprio Assembla, incluindo a captura de tela do artigo sobre a 2FA, com links abaixo, que lemos em 21 de outubro de 2026. Não os testamos em uma conta do Assembla, então um rótulo pode ser um pouco diferente. Os passos do Novaz foram conferidos no app, versão 1.0.5.
Antes de começar
- Entra com SSO? O Assembla diz que uma conta que usa login único não tem senha e, sem senha, não é possível ativar a 2FA do próprio Assembla (Assembla).
- 2FA do Google no seu portfólio: o mesmo artigo observa que, se um portfólio exige a 2FA do Google, esse método tem prioridade. Ele não explica mais do que isso.
- A lista de apps é antiga. A lista do Assembla ainda inclui o Windows Phone, mas os códigos dele são códigos padrão baseados em tempo, então o Novaz consegue escanear o mesmo QR code.
Ative a 2FA com um app autenticador
A ajuda do Assembla descreve estes passos (Assembla):
- Clique no seu avatar no topo da página.
- Escolha My Profile > Two-factor authentication (meu perfil > autenticação de dois fatores). A página diz que a autenticação de dois fatores está desativada no momento e mostra um QR code.
- No Novaz, toque em +, depois em Escanear QR code, e aponte a câmera para o código na tela do computador. Se o Assembla 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.
- Em Confirm current password (confirme a senha atual), digite a sua senha do Assembla.
- Em Enter the six-digit code from the application (digite o código de seis dígitos do app), digite o código atual do Novaz.
- Clique em Enable (ativar).
- Guarde o arquivo de códigos de recuperação que o Assembla fornecer. Ele é a sua forma de voltar a entrar se o celular for perdido.
Sem chave de configuração na página
A tela do Assembla não mostra uma chave em texto. A ajuda dele sugere uma alternativa se o seu celular não conseguir escanear: decodificar o QR code com um app leitor separado, como um leitor de QR code para desktop, para obter um link otpauth://. A parte secret= desse link é a chave. No Novaz, você a digitaria em + > Inserir chave manualmente como Chave de configuração. Veja O que é a chave de configuração da 2FA?
Escanear é mais simples com o Novaz. Uma chave digitada precisa de pelo menos 16 caracteres, e o Assembla não diz qual é o tamanho da chave dele.
O seu arquivo de códigos de recuperação
O Assembla entrega um arquivo de códigos de recuperação quando você ativa a 2FA. Se o celular sumir e você não tiver backup do Novaz, ou tiver adicionado o Assembla depois do seu último arquivo de backup, é com esse arquivo que você volta a entrar. Guarde-o em um lugar que você consiga acessar sem esse celular. A ajuda do Assembla não diz quantos códigos o arquivo contém nem como obter um conjunto novo. Mais em Códigos de backup da 2FA.
Clientes Git, SVN e Perforce
Com a 2FA ativada, clientes externos não conseguem fazer checkout de código nem commits com o seu nome de usuário e a sua senha. Crie uma chave de API no lugar (Assembla, Assembla):
- Clique no seu avatar e depois em My Profile > API Applications & Sessions (aplicações e sessões de API).
- Marque Repository access (acesso aos repositórios) e clique em Create (criar).
- No seu cliente, entre com o seu nome de usuário do Assembla e o segredo da API no lugar da senha.
Quando ela é obrigatória
Um administrador do portfólio pode ativar a exigência em More > Portfolio Admin (mais > administração do portfólio), marcando Enabled (ativado) na seção Two-factor Authentication e clicando em Update 2FA Settings (atualizar configurações da 2FA). A partir daí, os membros sem 2FA precisam configurá-la no próximo login. Até fazerem isso, não conseguem entrar no Assembla de forma alguma (Assembla).
Se o Assembla recusar o seu código
A ajuda do Assembla não traz orientações sobre códigos recusados. 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 mostra um aviso quando o relógio está defasado em 15 segundos ou mais. Mais causas estão em Código do autenticador não funciona?
Celular novo, celular perdido ou desativar a 2FA
O Assembla trata os três casos do mesmo jeito: desative a 2FA e depois ative-a de novo com o dispositivo novo (Assembla).
- Clique no seu avatar e depois em My Profile > Two-factor Authentication.
- Digite a sua senha em Confirm current password.
- Em Enter the six-digit code from the application, digite um código. Se você perdeu o celular, o Assembla diz que um código de recuperação não usado vai nesse campo.
- Clique em Disable (desativar). Depois, você pode configurar a 2FA de novo.
Se você está trocando de celular sem um backup do Novaz, faça isso enquanto o iPhone antigo ainda funciona. Com o Backup no iCloud ou um arquivo de backup, você pode restaurar as suas contas no iPhone novo. Veja Como transferir seu app autenticador para um iPhone novo.
Se você perdeu o celular e o arquivo de recuperação, o Assembla pede que você envie um e-mail para support@assembla.com para redefinir a sua conta. A ajuda dele não diz que comprovação o suporte pede nem quanto tempo leva. Veja também Perdeu o celular com o seu app autenticador?
