Skip to content
smallPict

Autenticação segura via OTP

Acesso sem senhas por meio de códigos One-Time Password enviados por e-mail.

O SmallPict utiliza autenticação Passwordless (sem senhas) com códigos OTP descartáveis enviados por e-mail, garantindo máxima segurança contra vazamentos de credenciais.


Regras de segurança criptográfica

RegraParâmetroFinalidade
Tamanho do código6 dígitos numéricosSimples e ágil para digitação humana.
Tempo de validade10 minutos (600 segundos)Reduz o risco de ataques de força bruta.
Limite de tentativasMáximo de 3 tentativasBloqueia o código automaticamente após 3 erros.
Intervalo de reenvio60 segundosPrevine abuso de envio de mensagens e spam.
Hash de segurançaSHA-256 com Salt criptográficoOs códigos não são salvos em texto legível no banco de dados.

Fluxo de autenticação via API

1. Solicitar código OTP (POST /v1/auth/otp/request)

JSON
{  "email": "desenvolvedor@empresa.com.br"}

Resposta:

JSON
{  "success": true,  "message": "Código de verificação enviado com sucesso.",  "cooldown_seconds": 60}

2. Validar código OTP (POST /v1/auth/otp/verify)

JSON
{  "email": "desenvolvedor@empresa.com.br",  "code": "849201"}

Resposta bem-sucedida:

JSON
{  "success": true,  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",  "user": {    "id": "usr_9a8b7c6d",    "email": "desenvolvedor@empresa.com.br",    "plan": "pro"  }}