Configurar verificação SMS com Tencent Short Message Service

O conector oficial do Logto para o Tencent Short Message Service.

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.

Introdução

Tencent Cloud é um provedor de serviços de nuvem primário na Ásia, oferecendo vários serviços, incluindo SMS (serviço de mensagens curtas).

O conector Tencent Short Message Service é uma integração oficial do Logto que ajuda os usuários finais a se registrarem ou fazerem login usando códigos de verificação por SMS.

Configurar um serviço de mensagens curtas no Tencent Cloud

Criar uma conta no Tencent Cloud

Vá para o site do Tencent Cloud e registre sua conta se você ainda não tiver uma.

Ativar e Configurar o SMS do Tencent Cloud

1. Faça login com sua conta no site do Tencent Cloud e vá para a página do console de serviço SMS.
2. Clique no botão “Free Trial” (免费试用) na página do serviço SMS e siga as etapas de configuração.
3. Concorde com os “Termos de Ativação do Serviço SMS” (短信开通服务条款) e clique em “Ativar Serviço” (开通服务) para prosseguir.
4. No “Visão Geral do Console SMS” (短信服务控制台概览), escolha “Mensagens Domésticas” (国内消息) ou “Mensagens Internacionais/Hong Kong, Macau, Taiwan” (国际/港澳台消息) na barra lateral com base em suas necessidades.
5. Adicione uma assinatura e um modelo para mensagens SMS. Nota:
   • Ao adicionar uma “Assinatura” (签名), selecione “Código de Verificação” (验证码) no campo "Cenários Aplicáveis" (模版类型).
   • Ao adicionar um modelo, escolha “Código de Verificação” como o tipo de modelo.
   • Inclua um espaço reservado {1} no conteúdo do modelo, que será substituído por um código gerado aleatoriamente.
   • Modelos com múltiplos espaços reservados não são suportados. Use ou crie um modelo de espaço reservado único.
6. Envie a assinatura e o modelo para aprovação. Após o envio:
   • Aguarde que eles entrem em vigor.
   • O SMS de teste pode ser enviado a partir do “Visão Geral do Console SMS” (短信服务控制台概览). Assinaturas e modelos aprovados podem ser usados diretamente para testes, ou use os modelos de teste fornecidos se ainda estiverem em revisão.
   • Certifique-se de que sua conta tenha saldo suficiente para testes e pré-registre o número de telefone de teste para receber o SMS com sucesso.

Para orientações detalhadas, clique na guia “Guia de Início Rápido” (新手配置指引) na Visão Geral do Console SMS.

Compor o JSON do conector

1. Vá para a “Visão Geral do Console SMS” e passe o mouse sobre seu avatar no canto superior direito. Navegue até “Gerenciamento de Acesso > Chaves de Acesso > Chaves de API” para gerar seu AccessKey ID e AccessKey Secret após completar a verificação de segurança. Por favor, mantenha-os adequadamente.
2. Na guia “Mensagens Domésticas” (国内消息) ou “Mensagens Internacionais/Hong Kong, Macau, Taiwan” (国际/港澳台消息), recupere o “Nome da Assinatura” (签名名称) e o “Código do Modelo” (模版 CODCE).
   • Para modelos de teste, verifique a guia “Início Rápido” (快速开始) em "Modelos Exclusivos para Teste" (测试专用签名模版).

• Configure o Conector SMS do Tencent Cloud com os seguintes campos:
  • accessKeyId e accessKeySecret: Use as credenciais do passo 1.
  • signName: O nome da assinatura obtido no passo 2. Isso se aplica a todos os modelos.
  • Adicione múltiplos modelos para diferentes cenários, se necessário. Exemplo para um único modelo:
    • templateCode: Recuperado do “Código do Modelo” no passo 2.
    • usageType: Especifique um dos Register, SignIn, ForgotPassword, ou Generic para diferentes cenários (propriedade específica do Logto).
    • Certifique-se de que os modelos estejam configurados para todos os quatro cenários para completar o fluxo.
  • sdkAppId: Encontrado em “Gerenciamento de Aplicativos” (应用管理).
  • region: Especifique a região suportada a partir da “Documentação de Envio” (发送文档).

Testar o conector SMS do Tencent Cloud

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
region	string
sdkAppId	string
templates	Template[]

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

Referências

• Como implementar a função de código de verificação por SMS?