Configurar verificação de email com Aliyun Direct Mail

O conector oficial do Logto para o serviço de correio 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 dos principais provedores de serviços em nuvem na Ásia, oferecendo muitos serviços em nuvem, incluindo DM (correio direto). O Conector DM da Aliyun é um plugin fornecido pela equipe do Logto para chamar as APIs do serviço DM 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 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

Vá para Aliyun e crie sua conta Aliyun se você ainda não tiver uma.

Habilitar e configurar o Aliyun Direct Mail

Acesse 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 o Sender Address ou Email Tag.
3. Preencha as configurações do Conector DM da Aliyun:
   • 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 completos de usuários, são necessários templates com usageType Register, SignIn, ForgotPassword e Generic.

Testar o conector DM da Aliyun

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 o 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'