Trocamos o link mágico por senha com verificação em duas etapas
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.
#Links de uso único
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
O passo a passo para a sua conta está em Conta e organização.


