Pular para o conteúdo principal

Conectores SMS

Configurar um conector SMS permite enviar uma senha única (OTP) 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 processos de cadastro, login, recuperação de senha e vinculação de conta, para validar a identidade do usuário. Ele simplifica a autenticação do usuário e aumenta 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:

Etapas de configuração

Siga as etapas abaixo para adicionar o conector SMS:

  1. Navegue para: Console > Conector > Conectores de Email e SMS
  2. Para adicionar um novo conector SMS:
    1. Clique no botão "Configurar" e selecione seu provedor de SMS desejado
    2. Revise a documentação README para o provedor escolhido
    3. Preencha os campos obrigatórios na seção "Configuração de Parâmetros"
    4. Personalize o modelo SMS usando o editor JSON
    5. Teste sua configuração enviando um código de verificação para seu telefone usando o modelo "Genérico"
    6. Clique em "Salvar e Concluir" para finalizar
  3. Para mudar para outro conector SMS:
    • Acesse a página de detalhes do conector e clique em "Mudar conector" no canto superior direito
    • Alternativamente, exclua o conector existente e crie um novo
nota

Você pode ativar APENAS UM conector SMS.

Quando você já tem um conector de email, só pode selecionar "Mudar conector de email". 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 Cloud podem criar um locatário 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.

Ativar 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 de negócios.

  1. Navegue para: 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

O Logto não possui 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 de código aberto, fornecemos um método de criação de conector 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.