Um valor aceito uma vez durante sua validade
Um código de uso único é um valor que o serviço aceita uma vez para concluir uma verificação, como uma etapa de autenticação. Ele tem validade limitada e deve ser recusado após uma validação bem-sucedida, mesmo que o prazo ainda não tenha terminado.
A sigla OTP pode aparecer como one-time password ou one-time passcode. O nome abrange usos diferentes, por isso você precisa identificar como o código foi gerado e entregue antes de avaliar o método.
Como o TOTP calcula o código
O TOTP é um método de geração de códigos baseado no tempo. O aplicativo autenticador e o serviço compartilham um segredo e aplicam o mesmo cálculo a uma referência de tempo. Isso permite que o serviço confira o valor digitado sem receber o segredo a cada tentativa.
A RFC 6238 recomenda intervalos de 30 segundos. Num exemplo didático com esse intervalo, um código calculado perto do fim dos 30 segundos terá pouco tempo restante para uso. A janela aceita pelo serviço também considera a diferença entre os relógios.
Após aceitar o código, o serviço precisa registrar seu uso para recusar uma segunda tentativa no mesmo intervalo. Apenas conferir o relógio permitiria aceitar novamente o valor enquanto ele ainda fosse válido.
Códigos enviados por email
Um código enviado por email pode ser gerado pelo serviço e conferido quando você o informa na tela de entrada. O Supabase documenta esse fluxo, que usa a entrega da mensagem em vez do cálculo TOTP no aplicativo.
O serviço também precisa limitar tentativas para dificultar a adivinhação dos códigos. Confira a expiração, a recusa de reutilização e o método de entrega ao revisar uma implementação.
Dúvidas frequentes
Perguntas frequentes sobre código de uso único
- Todo código de uso único é gerado por um aplicativo?
- Há aplicativos que calculam códigos a partir de um segredo e serviços que geram e enviam códigos por email. O Supabase, por exemplo, oferece entrada por código entregue ao endereço cadastrado.
- O código funciona novamente enquanto não expirar?
- Depois de uma validação bem-sucedida, o serviço deve recusar a reutilização daquele código durante sua validade. A expiração e o registro de uso são verificações diferentes.
- Um código de uso único garante proteção contra phishing?
- O NIST não considera a autenticação OTP resistente a phishing. Um site falso pode capturar o código digitado e repassá-lo ao serviço legítimo antes do uso ou da expiração.
Para continuar
Recursos relacionados
Documentação
NIST: autenticadores e códigos de uso único
O NIST descreve os autenticadores OTP, a aceitação única durante a validade e os limites das tentativas de autenticação.
Abrir recursoSite de referência
Dev Side Studio: desenvolvimento colaborativo
O Desenvolvimento Colaborativo permite revisar ao vivo a validação dos códigos e os testes de expiração e reutilização.
Abrir recursoAplicação na formação
Vibe Coding: Do Zero ao MVP
Ao implementar autenticação com agentes, você precisa conferir a expiração dos códigos e a recusa de valores já utilizados.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.