Código de verificação por SMS: tamanho e validade
Um código de verificação por SMS tem normalmente 6 dígitos, vale 5 a 10 minutos e admite poucas tentativas. Tamanho, validade, reenvio e remetente.
Um código de verificação por SMS deve ter normalmente 6 dígitos, ser válido durante 5 a 10 minutos, servir uma única vez e admitir apenas algumas tentativas erradas. Um novo código deve anular o anterior e entre dois envios deve haver uma pausa curta. Coloque o nome do seu serviço no início do texto.
Qualquer início de sessão ou registo com código por SMS obriga às mesmas decisões: quantos dígitos tem o código, quanto tempo dura, quantas tentativas e reenvios são permitidos e o que diz a mensagem. Aqui ficam os valores habituais e os que a Verify API da TopSMS aplica.
Configuração recomendada num relance
| Parâmetro | Valor habitual | Verify API da TopSMS |
|---|---|---|
| Tamanho do código | 6 dígitos | 6 por omissão, opcional de 4 a 8 |
| Validade | 5 a 10 minutos | 5 minutos por omissão, opcional de 1 a 30 minutos |
| Tentativas por código | 3 a 5 | 5 |
| Pausa antes do código seguinte | 30 a 60 segundos | 30 segundos |
| Limite por número | alguns códigos por hora | 5 códigos por hora |
| Reutilização | não | utilização única; o novo código anula o anterior |
Tamanho: porquê seis dígitos
Um código numérico de seis dígitos tem um milhão de combinações. Por si só não chegaria, mas com um limite de tentativas a probabilidade de acertar é mínima: cinco tentativas cobrem 5 em 1 000 000. Tamanho e limite de tentativas andam juntos.
A NIST SP 800-63B pede pelo menos seis dígitos decimais para os segredos entregues por um segundo canal, onde a SMS se enquadra, e exige limitar as tentativas quando o segredo é curto. Reserve os quatro dígitos para situações de baixo risco, como confirmar uma marcação. Oito dígitos são mais difíceis de copiar e acrescentam pouco numa SMS.
Use apenas algarismos. As letras escrevem-se pior no telemóvel e confundem-se (O e 0, l e 1).
Validade: 5 a 10 minutos
O código tem de durar o suficiente para a SMS chegar e o utilizador o copiar, e pouco o suficiente para um código intercetado perder valor depressa. Na prática, 5 minutos para iniciar sessão ou criar conta e até 10 para recuperar uma conta. A NIST SP 800-63B considera inválida a autenticação que não é concluída em 10 minutos.
Indique a validade na própria mensagem («Válido 5 min») e anule o código logo após uma verificação bem-sucedida.
Tentativas e reenvios
- O limite de tentativas erradas protege contra quem experimenta códigos ao acaso. Esgotadas as tentativas, anule o código e deixe pedir outro.
- O limite de envios protege a sua empresa do abuso do formulário e o utilizador de uma enxurrada de mensagens: uma pausa entre dois códigos e um limite por número e por hora. Sem ele, qualquer pessoa pode usar o seu formulário para enviar SMS para números alheios à sua custa.
Mostre o botão «Reenviar código» apenas depois da pausa, com contagem decrescente.
Remetente e texto da mensagem
MinhaLoja: o seu codigo de verificacao é 482913. Valido 5 min. Nao o partilhe com ninguem.- Uma só SMS. O texto acima tem 90 caracteres e fica em GSM-7 porque está escrito sem acentos, com exceção do «é», que pertence ao alfabeto. Com «código» e «verificação» a mensagem passa a Unicode, com limite de 70 caracteres. Verifique o seu texto no contador de caracteres.
- Sem ligação. Um código copia-se, não se clica. As ligações em mensagens de verificação habituam o utilizador a clicar e ajudam os burlões.
- Com aviso. «Nao o partilhe com ninguem» custa poucos caracteres e trava a burla telefónica mais comum.
- Remetente. Um nome tem até 11 caracteres. Em Portugal os remetentes alfanuméricos são, em regra, aceites sem registo prévio, embora alguns operadores possam, em casos pontuais, substituí-los por um número. Veja Remetente de SMS em Portugal.
Como se configura na Verify API
A Verify API gera, envia e verifica o código, pelo que o tamanho, a validade e os limites não exigem código da sua parte:
POST /api/verify/send
{ "to": "+351912345678", "brand": "MinhaLoja", "locale": "en", "length": 6, "ttl": 300 }length aceita 4 a 8 e ttl 60 a 1800 segundos; se os omitir, usam-se 6 dígitos e 5 minutos. A verificação é uma segunda chamada, POST /api/verify/check. O código nunca é guardado em forma legível e, com uma chave de teste, nada é enviado.
O texto enviado pela Verify API está disponível em inglês, alemão e checo (campo locale). Se precisar da mensagem em português, gere e verifique o código no seu sistema e envie o seu próprio texto com POST /api/sms/send, aplicando os mesmos limites desta página. A referência completa está na documentação da API, em inglês.
O que fazer quando o código não chega está explicado em Quantas SMS não são entregues e porquê.
Perguntas frequentes
Quantos dígitos deve ter um código de verificação por SMS?
Normalmente 6. A norma NIST SP 800-63B pede pelo menos seis dígitos decimais para os segredos enviados por um segundo canal. Um código mais curto só faz sentido em ações de baixo risco e sempre com um limite de tentativas.
Durante quanto tempo deve o código ser válido?
Entre 5 e 10 minutos. Com prazos mais curtos o utilizador não chega a tempo se a SMS se atrasar; a NIST SP 800-63B considera inválida a autenticação que não é concluída em 10 minutos. Na Verify API da TopSMS o valor predefinido é de 5 minutos.
Quantas tentativas se devem permitir?
Poucas, normalmente 3 a 5; depois o código é anulado e é preciso pedir outro. A Verify API da TopSMS permite 5 tentativas por código.
Com que frequência pode o utilizador pedir um novo código?
Com uma pausa curta e um limite por hora. A Verify API da TopSMS permite outro código para o mesmo número ao fim de 30 segundos e, no máximo, 5 códigos por hora; o novo código anula o anterior.
Quanto custa enviar um código de verificação?
Com a TopSMS, 0,089 € por SMS para números portugueses, preço final. Só é cobrada a mensagem enviada; a verificação do código é gratuita e, com uma chave de teste, nada é enviado nem cobrado.