Pular para o conteúdo principal

Autenticação de dois fatores (2FA)

A autenticação de dois fatores (2FA) adiciona uma camada extra de segurança ao login. Além da senha, o usuário deverá apresentar um código gerado por um aplicativo autenticador (TOTP). Se o acesso ao aplicativo for perdido, códigos de backup permitirão a recuperação da conta.

Habilitando 2FA em sua conta

  1. Vá para Profile → Security.
  2. Clique em Ativar autenticação de dois fatores.
  3. Digitalize o código QR com um aplicativo autenticador (Google Authenticator, Authy, 1Password, Bitwarden, etc.).
  4. Digite o código de 6 dígitos mostrado pelo aplicativo para confirmar.
  5. Salve os códigos de backup mostrados na tela em um local seguro (gerenciador de senhas, cofre físico).
  6. Confirme.
A partir de agora, todo login exigirá senha + código do aplicativo.

Códigos de backup

Os códigos de backup são códigos de uso único que permitem fazer login sem o aplicativo autenticador – úteis se você perder seu telefone, trocar de dispositivo ou se o aplicativo falhar.

Como eles funcionam

  • Cada código pode ser usado apenas uma vez. Após o uso, é invalidado.
  • Você recebe um conjunto de códigos ao ativar o 2FA. Quando eles estiverem prestes a acabar, regenere o conjunto.
  • Os códigos são armazenados como hashes BCrypt no banco de dados (começando em v1.0.0-rc3 — WTO-991). Nem mesmo o operador da instalação consegue ler códigos em texto simples.

Regenerando Códigos

Profile → Security → Regenerate backup codes.
Atenção: quando você regenera, códigos antigos param de funcionar. Faça isso somente quando tiver acesso ao aplicativo autenticador no momento, para confirmar a regeneração.

Quando regenerar

  • Depois de usar um código — para manter o estoque cheio.
  • Após suspeita de comprometimento — se você acha que alguém pode ter visto sua lista de códigos.
  • Após a mudança organizacional — se você mudou de função e a lista antiga estava em algum lugar acessível a outras pessoas.
Para instalações que existiam antes de v1.0.0-rc3: os códigos gerados naquela época eram armazenados como texto simples no banco de dados. Se o histórico do banco de dados estiver acessível a qualquer pessoa fora do operador de instalação, recomenda-se a regeneração.

Recuperação de conta sem 2FA ou códigos de backup

Se você perder ambos o aplicativo autenticador e os códigos de backup:
  1. Entre em contato com o administrador de instalação (super_admin).
  2. O administrador pode desabilitar 2FA em sua conta por meio do console de administração.
  3. Após o login subsequente, reative 2FA imediatamente com um novo dispositivo e salve novos códigos de backup.
O administrador da instalação não consegue ler seus códigos (armazenados como hashes). A única operação possível é zerar o 2FA da conta para que você possa reconfigurar.

Recomendações de segurança

  • Use um aplicativo autenticador, não SMS. O SMS é vulnerável à troca de SIM.
  • Armazene códigos de backup em um gerenciador de senhas. Evite imprimir e jogá-los em uma gaveta.
  • Não compartilhe códigos alternativos. Eles são equivalentes ao seu segundo fator.
  • Ative 2FA em contas administrativas. Especialmente super_admin e account_owner.

Considerações Finais

2FA é o controle de acesso mais barato e eficaz contra vazamento de credenciais. Combine com senhas fortes (ajuda de validação em linha — WTO-1063) e revisão periódica de função em Funções personalizadas.