Pular para o conteúdo

Trocamos o link mágico por senha com verificação em duas etapas

Equipe AIUBYEngenharia de plataforma

Senha, TOTP e links de uso único

Até esta semana, entrar na área do cliente da AIUBY com e-mail significava pedir um link e esperar ele chegar. Agora é e-mail e senha, com verificação em duas etapas para quem quiser. Entrar com Google e com GitHub continua igual.

#O que mudou

  • O link mágico saiu. O acesso com e-mail usa senha.
  • A verificação em duas etapas é opcional para clientes e obrigatória para a equipe AIUBY entrar no console interno.
  • Quem já tinha conta define a senha por "Esqueci a senha ou ainda não tenho uma", na tela de login. As sessões abertas continuaram valendo.

Com isso, entrar passa a depender de algo que a pessoa sabe e, se ela ligar o segundo fator, de algo que ela tem. Não depende mais da entrega de um e-mail a cada acesso.

#Como a senha é guardada

A senha nunca é guardada. Guardamos o resultado do scrypt, uma função feita para ser cara em memória e em tempo, com um sal aleatório por conta. Na comparação, o tempo não depende de quanto da senha está certo. Senhas curtas ou muito comuns são recusadas no cadastro e na troca.

As tentativas de login erradas são contadas por e-mail e por endereço de rede, e o contador é atualizado de forma atômica no banco: duas tentativas simultâneas não passam pelo limite juntas.

#O segundo fator

O segundo fator é o código de seis dígitos de um aplicativo autenticador (TOTP, RFC 6238). A ativação mostra um QR code e a chave para digitar. Alguns detalhes que importam:

  • O segredo do autenticador fica cifrado no banco com AES-256-GCM.
  • Ao ligar, a conta recebe dez códigos de recuperação de uso único. Guardamos só o resumo deles.
  • Ligar, desligar ou trocar o segundo fator pede a senha de novo, mesmo com a sessão aberta.
  • Ligar o segundo fator encerra as outras sessões da conta.
  • Vale também para quem entra com Google ou GitHub.

Definir ou redefinir a senha continua passando pelo e-mail, e aí o cuidado é com o link. Ele vale 30 minutos, funciona uma vez e leva o código depois do # no endereço. Essa parte do endereço não é enviada ao servidor nem aparece em registro de acesso, e a página a remove da barra assim que lê.

O pedido de link responde sempre do mesmo jeito, exista a conta ou não, e sem esperar o envio do e-mail, para a tela não servir de consulta de quem é cliente.

#O que a revisão achou

Antes de publicar, o código passou por uma revisão de segurança independente da implementação. Ela encontrou seis problemas, e todos foram corrigidos antes do deploy:

  • o limitador de tentativas não era atômico e deixava passar rajadas;
  • dava para ligar o segundo fator só com a sessão, sem a senha;
  • o tempo de resposta do "esqueci a senha" revelava se o e-mail existia;
  • o código do link viajava na parte do endereço que vai ao servidor;
  • a regra de senha aceitava senhas fracas;
  • a equipe podia entrar no console sem segundo fator.

Publicamos a lista porque ela é o argumento a favor do processo: nenhum desses itens apareceu nos testes que nós mesmos escrevemos.

#O que ainda falta

Limite

Não há chave de segurança física nem passkey: o segundo fator é só aplicativo autenticador. Quem perde o autenticador e os códigos de recuperação precisa falar com a equipe, que zera o segundo fator com registro em auditoria.

O passo a passo para a sua conta está em Conta e organização.