Configurar verificação de email com Aliyun Direct Mail

O conector oficial do Logto para o serviço de email direto da Aliyun.

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

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

💡 Dica

Você pode pular algumas seções se já tiver concluído.

Criar uma conta Aliyun

Vá para Aliyun e crie sua conta Aliyun se você 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 comece 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 o 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 o campo accountName e fromAlias com "Sender Address" e "Email Tag" que foram encontrados na etapa 2. Todos os templates compartilharão este nome de assinatura. (Você pode deixar fromAlias em branco, pois é OPCIONAL.)
   • Você pode adicionar vários templates de conector DM para diferentes casos. Aqui está um exemplo de adição de um único template:
     • 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 adequado.) Para habilitar fluxos de usuário completos, são necessários templates 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'