Configurar verificação de email com Aliyun Direct Mail
O conector oficial do Logto para o serviço de email direto da Aliyun.
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:
- Ir para "Email Domains" (发信域名) na barra lateral e adicionar "New Domain" (新建域名) seguindo as instruções.
- 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
- 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.
- 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.
- Preencha as configurações do Aliyun DM Connector:
- Preencha os campos
accessKeyIdeaccessKeySecretcom os pares de chave de acesso que você obteve na etapa 1. - Preencha o campo
accountNameefromAliascom "Sender Address" e "Email Tag" que foram encontrados na etapa 2. Todos os templates compartilharão este nome de assinatura. (Você pode deixarfromAliasem 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
contentcom 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
usageTypecomRegister,SignIn,ForgotPasswordouGenericpara 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 comusageTypeRegister,SignIn,ForgotPasswordeGeneric.
- Preencha o campo
- Preencha os campos
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' |