Saltar para o conteúdo
← Todos os artigos

Código de verificação por SMS: tamanho e validade

4 min de leituraEnglishDeutschEspañolItaliano

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.

Em resumo

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âmetroValor habitualVerify API da TopSMS
Tamanho do código6 dígitos6 por omissão, opcional de 4 a 8
Validade5 a 10 minutos5 minutos por omissão, opcional de 1 a 30 minutos
Tentativas por código3 a 55
Pausa antes do código seguinte30 a 60 segundos30 segundos
Limite por númeroalguns códigos por hora5 códigos por hora
Reutilizaçãonãoutilizaçã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.