2FA do Appwrite: como configurar um app autenticador na sua conta do Console
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 Appwrite tem dois tipos de autenticação multifator (MFA), e é fácil cair na página errada. Um é um recurso que você incorpora ao seu próprio app para os seus usuários. O outro protege a sua própria conta de desenvolvedor, aquela com que você entra no Appwrite Console e gerencia as suas organizações e projetos. Este guia trata do segundo (Appwrite). Se você quer MFA para as pessoas que usam o seu app, o Appwrite trata disso na documentação do Auth.
Para a sua conta do Console, a MFA é opcional. A documentação do Appwrite cita um código baseado em tempo de um app autenticador (TOTP) como o método aceito e diz que outros fatores virão depois (Appwrite). Usamos o Authenticator App - Novaz no iPhone nos passos abaixo, mas qualquer app autenticador funciona do mesmo jeito.
Como verificamos este guia: os passos do Appwrite vêm da documentação do próprio Appwrite e das capturas de tela dela, com links abaixo, que lemos em 21 de outubro de 2026. Não os testamos em uma conta do Appwrite, 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 MFA com um app autenticador
A página do Appwrite é curta, e o texto e as capturas de tela usam rótulos um pouco diferentes. Estes passos seguem os dois (Appwrite):
- Entre no Appwrite Console. Abra o menu da sua conta no canto superior direito e escolha Your account (sua conta).
- Vá até as configurações de segurança. Na captura de tela do Appwrite, é Security (segurança) na lista à esquerda, com um cartão Multi-factor authentication (autenticação multifator) na página.
- Ative a chave Multi-factor authentication.
- Adicione o autenticador. O texto chama o botão de Add authentication factor (adicionar fator de autenticação); a captura de tela mostra uma linha Authenticator app (app autenticador) com um botão Add (adicionar).
- Abre-se uma janela Scan QR code (escanear QR code). No Novaz, toque em +, depois em Escanear QR code, e aponte a câmera para o código. Se o Console 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, a mesma janela mostra um Manual entry code (código para entrada manual) com um botão de copiar. No Novaz, toque em +, depois em Inserir chave manualmente, digite um nome como Appwrite em Serviço e cole o código em Chave de configuração. Veja O que é a chave de configuração da 2FA?
- Escolha Continue (continuar) e digite o código atual do Novaz para concluir a configuração.
- Guarde os seus códigos de recuperação (próxima seção).
A documentação não diz quantos dígitos os códigos têm nem com que frequência mudam. Escanear o QR code é a opção mais segura, porque ele passa essas configurações para o seu app. Uma chave digitada à mão gera códigos de 6 dígitos a cada 30 segundos.
Os códigos de recuperação são a sua única volta
O Appwrite é excepcionalmente direto sobre isso. A documentação dele chama os códigos de recuperação de “the only way to access your account if you lose access to your authenticator app” (a única forma de acessar a sua conta se você perder o acesso ao app autenticador) (Appwrite). Ela não descreve um caminho pelo suporte para uma conta do Console bloqueada.
A captura de tela mostra uma linha Recovery codes (códigos de recuperação) com um botão View (ver) na mesma página de configurações, então você pode vê-los de novo enquanto ainda estiver conectado. Guarde uma cópia em outro lugar que não seja o celular, como um gerenciador de senhas ou uma folha impressa. Se você não tem backup do Novaz, ou se ele é mais antigo que a sua conta do Appwrite, esses códigos são a sua volta. Mais em Códigos de backup da 2FA.
A mesma captura de tela também lista Email (e-mail) como fator, com códigos de uso único enviados ao endereço verificado da conta. O texto da página menciona apenas o app autenticador, então a documentação não nos permite dizer se os códigos por e-mail servem como alternativa no login.
Se o Appwrite recusar o seu código
A documentação do Appwrite 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 mostra um aviso quando o relógio está defasado em 15 segundos ou mais. Se você digitou a chave à mão, confira se copiou a chave inteira. Outras causas estão em Código do autenticador não funciona?
Trocar de celular
O Appwrite não documenta como mover a MFA para um celular novo, como substituir o autenticador nem como desativar a MFA. Faça qualquer uma dessas coisas enquanto ainda consegue entrar com o celular antigo, no mesmo cartão Multi-factor authentication. Se você ativou o Backup no iCloud do Novaz ou exportou um arquivo de backup, pode restaurar o Appwrite no celular novo; sem isso, vai adicioná-lo ao celular novo como uma conta nova. 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 e depois configure o autenticador de novo no celular novo. Sem os códigos de recuperação, a documentação do Appwrite não oferece nenhum outro caminho de volta à conta. Mais em Perdeu o celular com o seu app autenticador?
Ajuda oficial do Appwrite
- Multi-factor authentication (a sua conta do Console)
- Multi-factor authentication (Appwrite Auth, para os usuários do seu app)
- Security
