Configurar verificação SMS com Aliyun Short Message Service

O conector oficial do Logto para o serviço de mensagens curtas da Aliyun.

dica:

Este guia assume que você tem um entendimento básico dos Conectores (Connectors) do Logto. Para aqueles que não estão familiarizados, consulte o guia de Conectores para começar.

Introdução

Aliyun é um provedor de serviços em nuvem primário na Ásia, oferecendo muitos serviços em nuvem, incluindo SMS (serviço de mensagens curtas). O Aliyun SMS Connector é um plugin fornecido pela equipe Logto para chamar o serviço SMS da Aliyun, com a ajuda do qual os usuários finais do Logto podem se registrar e fazer login em sua conta Logto via código de verificação SMS.

Configurar um serviço de mensagens curtas no Console SMS da Aliyun

Criar uma conta Aliyun

Vá para o site da Aliyun e registre sua conta Aliyun se você não tiver uma.

Ativar e Configurar o Aliyun Short Message Service

1. Faça login com sua conta Aliyun no site da Aliyun e vá para a página do console do serviço SMS.
2. Clique no botão "Abrir gratuitamente" (免费开通) no canto superior esquerdo da página do serviço SMS e inicie o processo de configuração.
3. Leia e concorde com o "Acordo de ativação do serviço SMS" (短信服务开通条款) e clique em "Assinar um serviço" (开通服务) para prosseguir.
4. Agora você está na página do console do serviço SMS, vá para "China Continental" (国内消息) ou "Fora da China Continental" (国际/港澳台消息) no menu lateral conforme seu caso de uso.
5. Adicione assinatura e modelo seguindo as diretrizes e forneça os materiais ou informações necessárias para revisão.
   • Lembre-se de selecionar "Mensagem de Código de Verificação" (验证码) como "Cenário" (适用场景) ao preencher a aplicação de assinatura e também "Mensagem de Código de Verificação" (验证码) para "Tipo" (模板类型) ao solicitar uma revisão de modelo, pois estamos usando essas assinaturas e modelos para enviar código de verificação. Atualmente, não suportamos o envio de mensagens SMS além de mensagens de texto relacionadas a códigos de verificação.
   • Além disso, use {{code}} como um espaço reservado onde você deseja colocar seu código de verificação digital no conteúdo do modelo.
6. Após enviar sua aplicação de assinatura e modelo SMS, você precisará aguardar para que ela entre em vigor. Neste ponto, podemos voltar para a página do console do serviço SMS e enviar um SMS de teste. Se suas assinaturas e modelos estiverem prontos para uso, você pode testá-los diretamente; se ainda não estiverem em vigor, a Aliyun também fornece modelos de teste.
   • Pode ser necessário recarregar uma pequena quantia de dinheiro antes de enviar mensagens de teste.
   • Você também pode ser solicitado a vincular um número de telefone de teste antes de enviar mensagens de teste. Para mais detalhes, vá para a guia "Início Rápido" (快速学习) no menu lateral da página do console do serviço SMS.

Compor o JSON do conector

1. Na página do console do serviço SMS, passe o mouse sobre seu avatar no canto superior direito e vá para "Gerenciamento de AccessKey" (AccessKey 管理), e clique em "Criar AccessKey" (创建 AccessKey). Você obterá um par "AccessKey ID" e "AccessKey Secret" após concluir a verificação de segurança. Por favor, mantenha-os adequadamente.
2. Vá para a guia "China Continental" (国内消息) ou "Fora da China Continental" (国际/港澳台消息) que você acabou de visitar, você pode encontrar facilmente "Assinatura" (签名名称) e "Código do Modelo" (模板 CODE).
   • Se você quiser usar a assinatura e o modelo apenas para teste, vá para a guia "Início Rápido" (快速学习) em vez disso, e você os encontrará abaixo de "Assinatura e Modelos (Apenas para Teste)".
3. Preencha as configurações do Aliyun SMS Connector:
   • Preencha os campos accessKeyId e accessKeySecret com os pares de chave de acesso que você obteve na etapa 1.
   • Preencha o campo signName com "Assinatura" (签名名称) mencionada na etapa 2. Todos os modelos compartilharão este nome de assinatura.
   • Você pode adicionar vários modelos de conector SMS para diferentes casos. Aqui está um exemplo de adição de um único modelo:
     • Preencha o campo templateCode, que é como você pode controlar o contexto do SMS, com "Código do Modelo" (模板 CODE) da etapa 2.
     • Preencha o campo usageType com Register, SignIn, ForgotPassword ou Generic para diferentes casos de uso. (usageType é uma propriedade do Logto para identificar o caso de uso adequado.) Para habilitar fluxos completos de usuário, são necessários modelos com usageType Register, SignIn, ForgotPassword e Generic.

Testar o conector Aliyun SMS

Você pode digitar um número de telefone e clicar em "Enviar" para ver se as configurações funcionam antes de "Salvar e Concluir".

É isso. Não se esqueça de Habilitar o conector na experiência de login.

Tipos de configuração

Nome	Tipo
accessKeyId	string
accessKeySecret	string
signName	string
templates	Template[]

Propriedades do Modelo	Tipo	Valores do enum
templateCode	string	N/A
usageType	enum string	'Register' | 'SignIn' | 'ForgotPassword' | 'Generic'

Referências

Aliyun SMS - Início Rápido