Skip to content

API de autenticação em dois fatores

Adicione uma camada extra de segurança.

Adicione um segundo fator para proteger contas

Proteja as contas dos usuários exigindo um código de verificação após a autenticação por senha.

O que é autenticação em dois fatores?

A autenticação em dois fatores pede uma segunda prova independente ao lado da senha: algo que você sabe mais algo que você tem. A independência é o ponto inteiro. Um vazamento de base de senhas vale muito menos quando ele sozinho não abre conta nenhuma.

O segundo fator só ajuda na medida em que for genuinamente separado. Um código enviado para um e-mail protegido pela mesma senha não é um segundo fator; uma prova ligada a um aparelho físico é.

A 2FA por SMS e seus limites

O SMS é o segundo fator mais difundido e o mais fraco ainda em uso comum. Códigos podem ser redirecionados por um SIM swap, obtidos por uma página convincente que simplesmente pede para lê-los em voz alta, e atrasados ou perdidos pelo roteamento da operadora. Cada envio também custa dinheiro, o que faz do login um lugar onde atacantes podem gastar o seu orçamento.

Nada disso torna a 2FA por SMS inútil — ela é enormemente melhor do que nenhum segundo fator. Significa apenas que, se você está escolhendo hoje, há pouca razão para escolhê-la como padrão.

A 2FA por WhatsApp

Enviar o desafio pelo WhatsApp tira a operadora do caminho: a entrega é pela internet, a mensagem é criptografada de ponta a ponta e não há cobrança por SMS. Ela também chega num aplicativo que o usuário já tem aberto na maioria dos mercados.

Por si só, porém, isso resolve entrega e custo, não a fraqueza de fundo. Um código continua sendo um código, e um usuário capaz de ler um pode ser convencido a repeti-lo a um atacante.

Reverse OTP como segundo fator

O Reverse OTP muda o que é o segundo fator. Em vez de enviar um segredo ao aparelho e pedir que o usuário o repasse, ele pede que o aparelho envie uma mensagem. O usuário toca num link e envia; o servidor associa a mensagem recebida à sessão de login pendente.

Isso remove por completo o objeto passível de phishing. Não há código na tela para alguém ler em voz alta, nada em trânsito para interceptar e nada que um SIM swap possa redirecionar — a prova vem de uma conta de WhatsApp vinculada ao aparelho, não de um número que uma operadora pode reatribuir.

Implementar 2FA com a API

As chamadas são as mesmas duas do cadastro. Quando um login exigir um segundo fator, abra uma sessão com POST /start-verification usando um identificador ligado àquela tentativa de login e apresente o deep link devolvido. Mantenha a sessão aberta no servidor e conclua o login apenas quando GET /check-verification-status reportar verified.

Duas regras mantêm isso sólido. Vincule a sessão de verificação à tentativa de login, não ao usuário, para que uma sessão concluída nunca possa autorizar outra. E compare o número que a API devolve com o número guardado na conta — um número verificado que não é o daquele usuário é um segundo fator reprovado, não aprovado.

Alternativa e recuperação

Ofereça SMS como alternativa onde o WhatsApp não estiver disponível, na mesma sessão, para que um usuário de um mercado de baixa adoção não fique travado. Além disso, planeje o caso em que o próprio aparelho sumiu: um segundo fator sem caminho de recuperação é uma indisponibilidade em preparação, e usuários que perdem o acesso costumam perder a conta junto.

Códigos de recuperação emitidos no cadastro do fator são a resposta habitual. Seja qual for a escolha, decida antes do lançamento — recuperação desenhada durante um incidente é sempre pior.

Quando a 2FA por telefone é a escolha certa

Para produtos de consumo, segundos fatores por telefone têm uma vantagem decisiva: o usuário já tem o aparelho e não precisa cadastrar nada. É por isso que a adoção deles é muito maior do que a de aplicativos autenticadores ou chaves físicas.

Para contas que protegem valor sério — acesso administrativo, controle financeiro, infraestrutura — uma chave de segurança física continua sendo a escolha mais forte, e as duas combinam bem. Use verificação por telefone onde importa abrangência e chaves onde importa profundidade.

Perguntas frequentes

O que é uma API de 2FA?
É uma interface para acrescentar um segundo fator de autenticação ao seu fluxo de login. Você a chama quando um login precisa ser verificado, mostra ao usuário o que ela devolve e só libera o acesso quando ela reporta o fator satisfeito.
A 2FA por WhatsApp é mais segura que por SMS?
Ela tira a operadora do caminho de entrega, então não fica exposta a SIM swap nem a interceptação SS7, e é criptografada de ponta a ponta. Um fluxo Reverse OTP vai além ao não enviar código nenhum, o que também elimina o risco de phishing.
O Reverse OTP pode sofrer phishing?
Não há código que o usuário possa revelar, o que elimina o ataque comum de convencer alguém a ler em voz alta uma senha de uso único. Nenhum segundo fator é imune a phishing, mas o roteiro usual de engenharia social fica sem nada a pedir.
O que acontece se o usuário perder o telefone?
Ele perde o acesso a esse fator, exatamente como com SMS ou um aplicativo autenticador. Emita códigos de recuperação no cadastro do fator, ou mantenha um segundo fator verificado, e desenhe esse caminho antes do lançamento, não durante um incidente.
Preciso de integrações separadas para 2FA e cadastro?
Não. As duas usam os mesmos endpoints. O que muda é quando você as chama e o que faz com o resultado: no cadastro você guarda o número verificado, no login você o compara com o que já está na conta.

Related

Ideal para

Bancos

Proteja transações financeiras sensíveis e o acesso a contas.

Plataformas SaaS

Proteja contas de clientes e dados de negócio.

Portais administrativos

Adicione um segundo fator para usuários privilegiados.

Aplicações corporativas

Atenda políticas de segurança sem tokens de hardware complexos.

Build your autenticação de dois fatores (2fa) flow today

Start integrating in minutes with clear documentation, SDKs, and global message delivery.