Pular para o conteúdo principal

Conectores SMS

Configurar um conector SMS permite que você envie senhas de uso único (OTPs) para o número de telefone do usuário. Este mecanismo de autenticação sem senha pode ser utilizado em vários cenários, incluindo cadastro, login, esqueci a senha, processos de vinculação de conta, convites de membros e validação da identidade do usuário. Ele simplifica a autenticação do usuário e melhora a segurança ao minimizar o risco de violações relacionadas a senhas.

Escolha seu conector SMS​

Logto possui alguns conectores SMS integrados que permitem uso imediato:

Se nossos conectores padrão não atenderem aos seus requisitos específicos, não hesite em entrar em contato conosco. Para usuários do Logto OSS, você pode implementar seu conector (OSS) se o requisito for urgente. Sempre damos boas-vindas a contribuições; seu esforço pode ajudar outros membros da comunidade com as mesmas necessidades.

Etapas de configuração​

Siga as etapas abaixo para adicionar um conector SMS:

  1. Navegue até Console > Conector > Conectores de Email e SMS.
  2. Para adicionar um novo conector SMS, clique no botão "Configurar" e selecione seu provedor de SMS desejado.
  3. Revise a documentação README para o provedor escolhido.
  4. Preencha os campos obrigatórios na seção "Configuração de Parâmetros".
  5. Personalize o modelo SMS usando o editor JSON.
  6. Teste sua configuração enviando um código de verificação para seu telefone usando o modelo "Genérico".
  7. Clique em "Salvar e Concluir" para finalizar.

Alterar conector SMS​

Para mudar para outro conector SMS:

  • Acesse a página de detalhes do conector e clique em "Alterar conector" no canto superior direito
  • Alternativamente, exclua o conector existente e crie um novo

Nota: Você pode ter APENAS UM conector SMS ativo.

Quando você já tem um conector SMS, só pode selecionar "Alterar conector SMS". Ao realizar esta operação no console, ela entra em vigor imediatamente após ser salva, portanto, certifique-se de testar sua configuração antes de salvar.

Para garantir a estabilidade do seu serviço, os usuários do Logto Cloud podem criar um tenant de desenvolvimento para o ambiente de desenvolvimento. Após testar a configuração no ambiente de desenvolvimento, "migre" a configuração para produção e, em seguida, salve a configuração.

Habilitar cadastro ou login por número de telefone​

Depois de adicionar com sucesso o conector SMS e concluir a configuração, você pode habilitar as configurações de login e cadastro que dependem de telefone + código de verificação, de acordo com suas necessidades comerciais.

  1. Navegue até: Console > Experiência de login > Cadastro e login
  2. Defina métodos de cadastro: Escolha "Número de telefone" ou "Endereço de email ou número de telefone" como o identificador de cadastro. Nota: A verificação do número de telefone é atualmente obrigatória durante o cadastro.
  3. Defina métodos de login: O identificador de cadastro escolhido automaticamente se torna um método de login. Clique em "Adicionar outro" para opções adicionais de login.
  4. Salvar Alterações e Testar: Clique em "Salvar alterações" para implementar a nova experiência de login. Lembre-se de usar a "Pré-visualização ao vivo" para testar a funcionalidade.
atenção:

Como nossas configurações entram em vigor imediatamente, excluir o conector SMS existente pode afetar os processos normais de login e registro dos usuários finais.

Por exemplo, se o identificador de login incluir a combinação "número de telefone + código de verificação", excluir o conector SMS existente impedirá que os usuários recebam códigos de verificação por email e resultará em um erro no fluxo de login.

Esteja ciente dos riscos potenciais ao operar em conectores.

Perguntas frequentes​

Logto não tem o conector SMS que quero usar. O que devo fazer?​

Ainda estamos trabalhando em mais conectores. Se você precisar de mais opções, basta nos informar suas necessidades no Discord e registrar uma Solicitação de Recurso no GitHub. Se precisar de mais assistência, você também pode entrar em contato conosco por email.

Para usuários do Logto open-source, fornecemos um método de criação de conectores fácil de estender, permitindo que você personalize seu próprio conector com base em seus cenários específicos. Você é sempre bem-vindo para enviar um pull request para o Logto, para que outros na comunidade também possam se beneficiar do seu trabalho.