2FA da ActiveState: 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
A sua conta da ActiveState Platform é a que você usa para criar runtimes, usar o State Tool na linha de comando e acessar os projetos privados da sua organização. A ActiveState oferece a autenticação de dois fatores (2FA) como opção para contas que entram com senha. A documentação descreve um método, um código de 6 dígitos de um app autenticador, e não torna a 2FA obrigatória. A documentação da ActiveState cita o Google Authenticator e o Authy como exemplos, mas diz que qualquer app parecido que leia QR codes serve (ActiveState). Este guia usa o Authenticator App - Novaz no iPhone. Qualquer app autenticador funciona do mesmo jeito.
Como verificamos este guia: os passos da ActiveState vêm da documentação da própria ActiveState, com link abaixo, que lemos em 21 de outubro de 2026. Não os testamos em uma conta da ActiveState, 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: a forma de login faz diferença
As contas da ActiveState podem ser criadas com endereço de e-mail e senha ou com uma conta do GitHub (ActiveState). A 2FA descrita aqui é a da própria ActiveState, usada junto com a sua senha da ActiveState. A documentação da ActiveState não diz se ela se aplica quando você entra com o GitHub. Nesse caso, os ajustes de segurança do próprio GitHub protegem o login.
As empresas também podem conectar a Platform ao próprio login único, pelo suporte da ActiveState ou por um gerente de conta. Se a sua organização fizer isso, pergunte à sua equipe de TI como a 2FA funciona para você.
Ative a 2FA com um app autenticador
A documentação da ActiveState traz estes passos (ActiveState):
- Entre na ActiveState Platform. Abra o menu no canto superior direito, o que mostra o seu nome de usuário, e selecione Account Settings (configurações da conta).
- Clique em Two-factor Authentication (autenticação de dois fatores) e depois em Enable (ativar).
- A ActiveState mostra um QR code. No Novaz, toque em +, depois em Escanear QR code, e aponte a câmera para ele. Se o código estiver na tela do próprio iPhone, faça uma captura de tela, toque em + e depois em Escolher uma foto. Veja como escanear um QR code no mesmo iPhone.
- Digite o código de 6 dígitos do Novaz na caixa de texto e clique em Confirm (confirmar).
Se o código for aceito, a 2FA está ativa.
A documentação da ActiveState só descreve o escaneamento do QR code. Ela não menciona uma chave em texto que você possa digitar no lugar. Se você encontrar uma, adicione-a no Novaz com + e depois Inserir chave manualmente, colocando-a no campo Chave de configuração. Veja O que é a chave de configuração da 2FA?
Quando a ActiveState pede um código
Segundo a ActiveState, depois de ativar a 2FA você precisa da sua senha e do código atual do app toda vez que faz login. A documentação não descreve um jeito de confiar em um dispositivo e pular o código (ActiveState).
O State Tool
Rodar state auth abre o navegador na página de login da Platform, então você digita o código ali, como sempre (ActiveState). Se, em vez disso, você entrar com o nome de usuário e a senha como flags na linha de comando, a referência de comandos lista uma flag --totp para o código do seu app, e ela só funciona junto com as flags de nome de usuário e senha (ActiveState).
Para pipelines de CI/CD, a ActiveState recomenda uma chave de API salva na variável de ambiente ACTIVESTATE_API_KEY, que você cria com state export new-api-key (ActiveState). Assim, o seu servidor de build não precisa de um código do seu celular.
Sem códigos de backup na documentação
A documentação da ActiveState não menciona códigos de backup ou de recuperação, nem descreve um segundo método de 2FA. O Novaz guarda as chaves no seu iPhone, então, a menos que você ative o Backup no iCloud ou exporte um arquivo de backup em Ajustes › Backup, esse iPhone é o único lugar de onde vêm os seus códigos da ActiveState. Cuide bem dele e leia a seção de recuperação abaixo antes de precisar dela. Para uma visão geral, veja Códigos de backup da 2FA.
Se a ActiveState recusar o seu código
A documentação da ActiveState 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 também avisa quando o relógio está defasado em 15 segundos ou mais. Confira também se você digita o código antes que ele mude. Mais causas em Código do autenticador não funciona?
Trocar de celular
A ActiveState não descreve como levar a 2FA para um celular novo. Os passos que ela documenta formam um caminho viável: enquanto ainda tem o celular antigo, entre com um código, desative a 2FA em Account Settings > Two-factor Authentication, ative-a de novo e escaneie o novo QR code com o celular novo. Com um backup no iCloud ou um arquivo de backup do Novaz, você pode restaurar a conta no iPhone novo; sem nenhum dos dois, este é o caminho. Veja Como transferir seu app autenticador para um iPhone novo.
Se você perder o autenticador
A documentação da ActiveState não descreve o que fazer se você perder o celular com os seus códigos. Ela não diz que comprovação o suporte pede nem quanto tempo leva uma redefinição. Desativar a 2FA por conta própria começa com um login com código, então isso não ajuda depois que o celular sumiu (ActiveState). Também não conte com uma redefinição de senha: a página de senhas da ActiveState não diz que ela desativa a 2FA (ActiveState).
O contato de suporte que a ActiveState indica para assuntos da conta é support@activestate.com, por exemplo para alterar o endereço de e-mail da conta (ActiveState). É para esse endereço que você deve escrever, a partir do e-mail da sua conta. Para os passos imediatos, veja Perdeu o celular com o seu app autenticador?
Desativar a 2FA
Você pode desativar a 2FA a qualquer momento enquanto ainda consegue gerar códigos. Entre com o seu código, abra Account Settings no menu do nome de usuário, clique em Two-factor Authentication e depois em Disable (desativar). A ActiveState não vai pedir um código no próximo login (ActiveState). No Novaz, abra a conta da ActiveState e toque em Remover conta.
