Configurar verificação SMS com Tencent Short Message Service

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

dica

Neste guia, assumimos que você tem conhecimento básico sobre Conectores (Connectors) do Logto. Se não tiver, confira o guia Configurar conectores para começar.

腾讯云短信服务 Logto 官方连接器 中文文档

腾讯云短信连接器

A Tencent é um importante fornecedor de serviços em nuvem na Ásia, oferecendo diversos serviços em nuvem, incluindo serviços de mensagens curtas.

Este conector é o conector oficial do Logto para o serviço de mensagens curtas da Tencent, ajudando os usuários finais a se registrarem e fazerem login através de códigos de verificação por SMS.

Configurar um serviço de mensagens curtas no console da Tencent

💡 Dica

Você pode pular as partes que já completou.

Criar uma conta Tencent

Vá para Tencent Cloud e complete o registro da conta.

Ativar e configurar o serviço de mensagens curtas da Tencent

1. Faça login com a conta que você acabou de registrar na Tencent Cloud e vá para o console de serviços de mensagens.
2. Clique no botão "Teste gratuito" no canto superior esquerdo da página de serviços de mensagens e inicie o processo de configuração.
3. Leia e concorde com os "Termos de ativação do serviço de mensagens" e "Ativar serviço" para continuar.
4. Agora você está no "Visão geral do console de serviços de mensagens", de acordo com seu cenário de usuário, clique em "Mensagens domésticas" ou "Mensagens internacionais / Hong Kong, Macau e Taiwan" na barra lateral.
5. Siga as instruções para adicionar assinaturas e modelos, e forneça os materiais e informações necessários para revisão:
   • Nota: Ao adicionar uma assinatura, selecione "Código de verificação" na coluna "Cenário aplicável", e ao adicionar um modelo, selecione "Código de verificação" no "Tipo de modelo", pois nosso objetivo é enviar códigos de verificação. Atualmente, não suportamos outros tipos de mensagens de texto além de códigos de verificação.
   • Certifique-se de incluir um espaço reservado {1} no conteúdo do modelo, que será substituído pelo código de verificação gerado aleatoriamente na mensagem enviada.
   • Atualmente, não suportamos múltiplos espaços reservados, escolha ou crie um modelo com apenas um espaço reservado.
6. Após enviar a solicitação de assinatura e modelo de SMS, você precisará aguardar sua ativação. Nesse momento, podemos voltar para a Visão geral do console de serviços de mensagens para enviar uma mensagem de teste. Se sua assinatura e modelo já foram aprovados, você pode usá-los diretamente para testar; se ainda não foram aprovados, a Tencent também fornece um modelo de teste para uso. - Antes de enviar uma mensagem de teste, você pode precisar fazer uma pequena recarga na conta. - É necessário vincular antecipadamente o número de telefone usado para o teste para receber a mensagem de teste com sucesso. Clique na guia "Guia de configuração para iniciantes" no topo da Visão geral do console de serviços de mensagens para saber mais.

Escrever o JSON do conector

1. Vá para a Visão geral do console de serviços de mensagens, passe o mouse sobre o avatar no canto superior direito da página, entre em "Gerenciamento de acesso" e clique em "Chaves de acesso" e "Chave API". Após completar a verificação de segurança, você receberá um par de "AccessKey ID" e "AccessKey Secret", guarde-os com segurança.
2. Vá para a guia "Mensagens domésticas" ou "Mensagens internacionais / Hong Kong, Macau e Taiwan" que você acessou anteriormente, você encontrará rapidamente o "Nome da assinatura" e o "Código do modelo".
   • Se você quiser usar o modelo de assinatura de teste, vá para a guia "Início rápido", onde você encontrará sob "Modelo de assinatura de teste".
3. Complete a configuração do conector de serviço de mensagens curtas da Tencent:
   • Use o par de "AccessKey ID" e "AccessKey Secret" que você obteve na etapa 1 para preencher accessKeyId e accessKeySecret, respectivamente.
   • Use o "Nome da assinatura" que você obteve na etapa 2 para preencher o campo signName. Todos os modelos compartilharão esta assinatura.
   • Você pode adicionar vários modelos de serviço de mensagens curtas para diferentes cenários de usuário. Aqui está um exemplo de preenchimento de um único modelo:
     • O campo templateCode é o atributo que você pode usar para controlar o conteúdo da mensagem enviada. Seus valores são obtidos do "Código do modelo" da etapa 2.
     • O campo usageType deve ser preenchido com Register, SignIn, ForgotPassword ou Generic para corresponder aos diferentes cenários de registro, login, esqueci a senha, genérico. (usageType é um atributo do Logto, usado para determinar o cenário de uso.) Para usar o fluxo completo, é necessário configurar modelos para usageType como Register, SignIn, ForgotPassword e Generic.
   • Obtenha o ID do aplicativo em Gerenciamento de aplicativos e preencha o campo sdkAppId.
   • Na documentação de envio, você pode obter as regiões suportadas pelo produto de mensagens, preencha o campo region.

Testar o conector de mensagens curtas da Tencent

Você pode inserir um número de telefone e clicar em "Enviar" para testar se a configuração está funcionando corretamente antes de "Salvar e concluir".

Tudo pronto! Vá em frente e ative o login por código de verificação SMS.

Tipo de configuração

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

| Atributos do modelo | Tipo | Valores enumerados | | ------------------- | ----------- | ------------------ | ----------------------------------------- | | templateCode | string | N/A | | usageType | enum string | 'Register' \ | 'SignIn' | 'ForgotPassword' | 'Generic' |

Referência

• Como implementar a funcionalidade de código de verificação por SMS da Tencent