Configurar verificação de email com Aliyun Direct Mail

O conector oficial do Logto para o serviço de email direto 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 de nuvem primário na Ásia, oferecendo muitos serviços de nuvem, incluindo DM (email direto). O Aliyun DM Connector é um plugin fornecido pela equipe Logto para chamar as APIs do serviço Aliyun DM, 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 por email (ou, em outras palavras, código de verificação).

Configurar um serviço de email no Console do Aliyun DirectMail

Criar uma conta Aliyun

Acesse Aliyun e crie sua conta Aliyun se você ainda não tiver uma.

Habilitar e configurar o Aliyun Direct Mail

Vá para a página do console do serviço DM e faça login. Habilite o serviço Direct Mail clicando no botão "Apply to enable" (申请开通) no canto superior esquerdo da página e inicie o processo de configuração.

A partir da página do console de administração do DM, você deve:

1. Ir para "Email Domains" (发信域名) na barra lateral e adicionar "New Domain" (新建域名) seguindo as instruções.
2. Personalizar "Sender Addresses" (发信地址) e "Email Tags" (邮件标签) respectivamente.

Após concluir a configuração, há duas maneiras diferentes de testar:

• Vá para a página de visão geral do DirectMail, encontre "Operation Guide" (操作引导) na parte inferior da página e clique em "Send Emails" (发送邮件). Você encontrará todos os diferentes tipos de métodos de teste.
• Siga o caminho "Send Emails" (发送邮件) -> "Email Tasks" (发送邮件) na barra lateral para criar uma tarefa de teste.

Compor o JSON do conector

1. Na página do console de administração do DM, passe o mouse sobre seu avatar no canto superior direito e vá para "AccessKey Management" (AccessKey 管理), e clique em "Create 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 "Sender Addresses" (发信地址) ou "Email Tags" (邮件标签) que você acabou de visitar na página do console de administração do DM, você pode encontrar facilmente Sender Address ou Email Tag.
3. Preencha as configurações do Aliyun DM Connector:
   • Preencha os campos accessKeyId e accessKeySecret com os pares de chave de acesso que você obteve na etapa 1.
   • Preencha os campos accountName e fromAlias com "Sender Address" e "Email Tag" que foram encontrados na etapa 2. Todos os modelos compartilharão este nome de assinatura. (Você pode deixar fromAlias em branco, pois é OPCIONAL.)
   • Você pode adicionar vários modelos de conector DM para diferentes casos. Aqui está um exemplo de adição de um único modelo:
     • Preencha o campo subject, que funcionará como título do email enviado.
     • Preencha o campo content com conteúdos de tipo string arbitrários. Não se esqueça de deixar o espaço reservado {{code}} para o código de verificação aleatório.
     • 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 apropriado.) Para habilitar fluxos de usuário completos, são necessários modelos com usageType Register, SignIn, ForgotPassword e Generic.

Testar o conector Aliyun DM

Você pode digitar um endereço de email e clicar em "Send" para ver se as configurações funcionam antes de "Save and Done".

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

Tipos de configuração

Nome	Tipo
accessKeyId	string
accessKeySecret	string
accountName	string
fromAlias	string (OPCIONAL)
templates	Template[]

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