Skip to content
Segurança
10 min de leitura17 de julho de 2026

Como a Phone-Verif protege a verificação de telefone por WhatsApp

Uma visão de defesa em profundidade de como a Phone-Verif protege a verificação de telefone por WhatsApp, de webhooks autenticados e tokens de alta entropia a endpoints que preservam a privacidade e controles de acesso rigorosos.

Escudo com um balão de conversa no estilo do WhatsApp representando a segurança da Phone-Verif

Todo fluxo de login, cadastro, redefinição de senha e autenticação de dois fatores depende, no fim das contas, de uma premissa: quem conclui a verificação realmente controla o número de telefone que declara.

A Phone-Verif foi construída para proteger essa premissa. Em vez de tratar a segurança como algo secundário, cada parte do fluxo de verificação foi projetada para minimizar a superfície de ataque e se defender das classes mais comuns de abuso.

Diferentemente dos fluxos tradicionais de OTP por SMS, em que o usuário recebe um código secreto e o transfere manualmente de um aplicativo para outro, a Phone-Verif usa uma mensagem de WhatsApp iniciada pelo próprio usuário como prova de controle. Isso elimina a etapa de copiar e colar que deixa muitos fluxos de OTP vulneráveis a phishing, engenharia social e interceptação de códigos.

A Phone-Verif verifica números pelo WhatsApp de forma reversa. Em vez de enviar um código de uso único e pedir que o usuário o digite de volta, o usuário envia uma mensagem de WhatsApp pré-preenchida. Nós verificamos a titularidade diretamente a partir dessa mensagem recebida.

A segurança não vem de um único recurso. Ela vem da aplicação consistente de muitas proteções independentes ao longo de todo o fluxo de verificação.

Nossos princípios de segurança

A Phone-Verif adota uma abordagem de defesa em profundidade. Cada solicitação de verificação passa por vários controles de segurança independentes, cada um projetado para mitigar uma classe diferente de ataque. Se um controle falhar, os demais continuam protegendo o fluxo de verificação.

Em todo o serviço, seguimos alguns princípios consistentes:

Autenticar primeiro

Toda requisição é autenticada antes de ser considerada confiável.

Aleatoriedade real

Os segredos vêm de aleatoriedade criptograficamente segura.

Não revelar nada

Usuários não autenticados descobrem o mínimo possível.

Falhar com segurança

Quando a infraestrutura está incerta, escolhemos o caminho seguro.

Janelas curtas

As janelas de verificação são curtas de propósito.

Isolamento rigoroso

Dados e ambientes dos clientes são mantidos separados.

Contra o que nos protegemos

A Phone-Verif foi projetada para mitigar os ataques mais comuns contra sistemas de verificação de telefone. Cada ameaça tem um controle dedicado:

Webhooks do WhatsApp forjados

Verificação de assinatura HMAC-SHA256 em toda requisição recebida.

Adivinhação de token por força bruta

Tokens de 47,6 bits, mais backoff exponencial e bloqueio temporário.

Enumeração de tokens

Respostas idênticas para tokens válidos e inválidos.

Ataques de replay

Sessões de uso único com expiração automática curta.

Phishing por meio de open redirects

As URLs de callback são fixadas na criação da sessão e nunca aceitas depois.

Acesso a dados entre clientes

As chaves de API são restritas ao seu proprietário, com verificação de titularidade por sessão.

Abuso automatizado dos endpoints

Rate limiting por remetente e monitoramento contínuo de abuso.

Nenhum sistema de segurança consegue eliminar todos os riscos possíveis, mas nosso objetivo é tornar os ataques bem-sucedidos computacionalmente inviáveis, minimizando a quantidade de informação exposta a um atacante.

O que isso significa para os clientes da Phone-Verif

Controles de segurança só importam se se traduzirem em garantias práticas para as empresas que dependem da Phone-Verif. Nossa abordagem de segurança assegura que:

  • Usuários não conseguem verificar um número de telefone que não controlam.
  • Os resultados da verificação só podem ser acessados pelo cliente que criou a sessão.
  • Os links de verificação não podem ser usados como open redirects ou ferramentas de phishing.
  • Tentativas de verificação expiradas não podem ser reutilizadas.
  • Falhas de infraestrutura não podem aprovar por acidente tentativas de verificação inválidas.

Essas proteções permitem que as empresas usem a Phone-Verif como um alicerce confiável para autenticação, recuperação de conta e fluxos de identidade baseados em telefone.

Webhooks autenticados

Todo webhook recebido da WhatsApp Business Platform é autenticado antes de ser processado. Cada requisição inclui um header X-Hub-Signature-256 com uma assinatura HMAC-SHA256 calculada pela Meta com o segredo da nossa aplicação. Antes de processar o payload, recalculamos a assinatura de forma independente sobre o corpo bruto da requisição.

Alguns detalhes de implementação são importantes:

  • Verificamos a assinatura sobre os bytes brutos da requisição, antes de qualquer parsing.
  • A comparação das assinaturas é feita em tempo constante, o que impede ataques de timing.
  • Requisições com assinatura ausente ou inválida são rejeitadas antes que qualquer lógica de negócio seja executada.

Isso garante que atacantes não consigam forjar eventos de verificação chamando diretamente o nosso endpoint de webhook.

Tokens de verificação de alta entropia

Cada sessão de verificação está associada a um token de 8 caracteres, gerado a partir de um alfabeto alfanumérico de 62 caracteres com maiúsculas e minúsculas, o que dá aproximadamente 2,2 × 10¹⁴ valores possíveis (47,6 bits de entropia).

Os tokens são gerados com um gerador de números aleatórios criptograficamente seguro, e não com uma função pseudoaleatória de uso geral. Também usamos rejection sampling para garantir que cada caractere seja escolhido com a mesma probabilidade, evitando vieses estatísticos que poderiam reduzir o espaço de busca efetivo.

Combinada com tokens de curta duração e rate limiting, a adivinhação exaustiva é computacionalmente inviável.

Verificação de uso único

As sessões de verificação são de uso único. Depois de concluída com sucesso, uma sessão não pode ser verificada novamente com a mesma mensagem de WhatsApp ou o mesmo token. Isso previne ataques de replay, garantindo que mensagens de verificação já usadas não possam autorizar outra ação.

Prevenção da enumeração de tokens

Tokens fortes só são eficazes se os atacantes não conseguirem saber quando acertaram um token válido. Nosso endpoint público de rastreamento se comporta, de propósito, da mesma forma quando o token existe e quando não existe.

Tokens desconhecidos e tokens válidos ainda não verificados produzem respostas idênticas, redirecionamentos idênticos, códigos de status HTTP idênticos e páginas de preview idênticas para o crawler do WhatsApp. Da perspectiva de um atacante, não há nenhuma diferença observável entre um token válido e um inválido.

Os destinos de callback permanecem privados

O destino para onde um link de rastreamento envia o navegador depende exclusivamente do estado de verificação da sessão. Até que a verificação seja concluída com sucesso, tokens válidos e inválidos se comportam de forma idêntica e levam a um destino neutro.

As URLs de callback dos clientes só são reveladas depois que a verificação é concluída com sucesso. Isso impede que atacantes descubram a infraestrutura dos clientes testando tokens de verificação.

Sem open redirects

Ao encaminhar usuários verificados, a Phone-Verif sempre usa a URL de callback registrada na criação da sessão de verificação. Nunca aceitamos destinos de callback enviados em requisições posteriores. Isso impede que atacantes montem links maliciosos que redirecionem usuários legítimos para destinos sob o controle deles.

Os resultados da verificação permanecem privados

Os links de rastreamento são anônimos de propósito, porque os usuários que os abrem a partir do WhatsApp não estão autenticados. Os resultados da verificação, incluindo números de telefone e status da verificação, nunca são expostos por endpoints públicos.

O acesso exige uma chave de API válida, e cada requisição é verificada para garantir que o cliente autenticado seja o proprietário da sessão solicitada. As sessões de outros clientes continuam inacessíveis, mesmo que seus identificadores sejam conhecidos.

Controles de acesso com privilégio mínimo

A Phone-Verif segue o princípio do privilégio mínimo em toda a sua arquitetura. Cada componente tem acesso apenas aos dados e às operações necessários para a sua função.

As chaves de API são restritas ao cliente proprietário, os serviços internos são separados por responsabilidade e o acesso aos dados de verificação é restrito por design. Limitar o acesso desnecessário reduz o impacto de possíveis erros ou incidentes de segurança.

Proteção contra força bruta

Mesmo sendo computacionalmente inviável adivinhar os tokens de verificação, a Phone-Verif aplica proteções adicionais contra abuso automatizado. Remetentes que enviam repetidamente tokens inválidos ou malformados recebem atrasos progressivos por meio de backoff exponencial, chegando a um bloqueio temporário se o comportamento abusivo continuar.

Os contadores são mantidos por remetente e expiram automaticamente com o tempo, garantindo que erros ocasionais não prejudiquem os usuários legítimos.

Criptografia em trânsito

Toda a comunicação com a Phone-Verif ocorre por HTTPS, com TLS moderno. As requisições de API, os links de rastreamento, as entregas de webhook e os callbacks dos clientes são criptografados em trânsito, protegendo contra interceptação e adulteração na rede.

Monitoramento contínuo

Monitoramos continuamente a atividade de verificação em busca de padrões anormais, como taxas de falha incomumente altas, envios repetidos de tokens inválidos ou tráfego excessivo de remetentes individuais. O monitoramento nos permite detectar abusos cedo, sem interromper o tráfego legítimo de verificação.

Ambientes isolados

Os ambientes de produção e pré-produção são completamente isolados, com infraestrutura, bancos de dados, armazenamentos de sessão, credenciais e identidades do WhatsApp Business separados. O tráfego de teste nunca pode interagir com sessões de produção, o que reduz o risco de erros operacionais afetarem clientes em produção.

Visão geral da arquitetura de segurança

Usuário

Abre o link de verificação e envia a mensagem de WhatsApp pré-preenchida contendo o token de verificação.

Mensagem com o token de verificação

WhatsApp Business Platform

Entrega a mensagem à Phone-Verif como um webhook assinado com HMAC-SHA256 (X-Hub-Signature-256).

Webhook autenticado

Motor de verificação da Phone-Verif

Todo evento recebido precisa passar por cada controle, em ordem. A falha em qualquer um deles interrompe o fluxo.

  1. Validar a assinatura do webhook

    Verificação HMAC-SHA256 em tempo constante sobre o corpo bruto da requisição

  2. Validar o token de verificação

    Consulta de token de alta entropia com rate limiting por remetente

  3. Verificar o estado da sessão

    A sessão deve estar dentro do prazo, não utilizada e pertencer ao cliente correspondente

  4. Marcar a verificação como concluída

    A sessão é selada como de uso único, impedindo qualquer replay

Somente após a verificação bem-sucedida

API / callback do cliente

O resultado da verificação é entregue ao cliente que criou a sessão, na URL de callback registrada na criação.

Toda verificação segue o mesmo caminho controlado. As mensagens são autenticadas antes de serem processadas, as sessões são validadas antes de serem concluídas e os callbacks dos clientes só são acionados após a verificação bem-sucedida.

À prova de falhas por padrão

Sistemas distribuídos às vezes retornam erros em vez de respostas. Sempre que o sistema não consegue distinguir entre "a verificação falhou" e "a infraestrutura falhou temporariamente", escolhemos sempre a interpretação mais segura.

Erros de infraestrutura nunca consomem tentativas de verificação, invalidam sessões ou rejeitam silenciosamente usuários legítimos. Em vez disso, o usuário simplesmente é convidado a tentar de novo. Tratar a incerteza de forma diferente da falha ajuda a evitar negações de serviço acidentais causadas por problemas transitórios de infraestrutura.

Curta duração por design

As sessões de verificação têm curta duração de propósito. Os tokens permanecem válidos por apenas algumas horas antes de expirar automaticamente, e as sessões expiradas são removidas do armazenamento pouco depois. Limitar por quanto tempo as credenciais continuam úteis reduz significativamente o valor de qualquer token interceptado ou vazado.

Segurança operacional

A segurança também depende de como os sistemas são operados. A Phone-Verif monitora continuamente a saúde do serviço, os padrões de verificação e atividades anormais. Acompanhamos sinais como falhas de verificação incomuns, tentativas inválidas repetidas e padrões de tráfego inesperados para detectar abusos e manter a confiabilidade do serviço. A segurança operacional é um processo contínuo, não uma implementação única.

As melhorias de segurança são contínuas

A segurança nunca está concluída. À medida que novas técnicas de ataque surgem e nossa plataforma evolui, revisamos continuamente nossa implementação, aprimoramos nossos controles e refinamos nossas defesas.

Acreditamos que a transparência é parte importante da construção de confiança. Esta página descreve nossa abordagem de segurança atual e vai evoluir conforme a Phone-Verif crescer.

Divulgação responsável

A segurança é um processo contínuo, e recebemos com prazer relatos responsáveis da comunidade de segurança. Se você acredita ter identificado uma vulnerabilidade na Phone-Verif, entre em contato com security@phone-verif.com com uma descrição do problema e os passos para reproduzi-lo.

Nos comprometemos a confirmar o recebimento dos relatos rapidamente, investigá-los de boa-fé e manter quem os enviou informado durante todo o processo de correção. Pedimos que os testes de segurança evitem interromper o serviço ou acessar dados que não pertencem a você e que os pesquisadores nos deem um prazo razoável para tratar os problemas antes da divulgação pública. Também teremos prazer em dar crédito aos pesquisadores que ajudarem a melhorar a plataforma.

Para mais detalhes, os termos de safe harbor e o escopo, consulte nossa Política de Divulgação de Vulnerabilidades.

Segurança por design

A verificação de número de telefone costuma ser a primeira decisão de segurança que uma aplicação toma. Se essa primeira etapa puder ser comprometida, todo fluxo de autenticação construído sobre ela fica mais fraco. A Phone-Verif foi projetada para tornar essa primeira etapa o mais robusta possível.

De webhooks do WhatsApp autenticados e tokens criptograficamente seguros a endpoints que preservam a privacidade e controles de acesso rigorosos, cada componente existe para reduzir a superfície de ataque.

Os sistemas de segurança mais fortes não são construídos em torno de um único recurso impressionante. Eles nascem de dezenas de decisões cuidadosas que funcionam em conjunto. A maioria dos usuários nunca vai notar essas proteções. E não deveria precisar. A verificação deve parecer simples e, ao mesmo tempo, continuar difícil de atacar.

Tem dúvidas sobre o nosso modelo de segurança?

Teremos prazer em ajudar. Veja como funciona na prática no guia de integração ou conheça ao vivo na demonstração interativa.