Pular para o conteúdo principal

Conectores de email

Um conector de email integra seu serviço de entrega de email com o Logto para permitir a verificação segura do usuário por meio de email. Uma vez configurado, você pode enviar senhas de uso único (OTPs) para cadastro, login, redefinição de senha, vinculação de conta, convites de membros e validação de operações de alto risco.

Escolha seu conector de email​

Logto oferece três tipos de opções de conectores de email:

Serviço de Email Logto Gratuito (somente Cloud)​

Esta opção de serviço de email embutido é ideal para começar rapidamente tanto para teste quanto para produção. Ela elimina a necessidade de integrações de terceiros e oferece entrega de email gratuita e confiável. Basta personalizar sua marca básica para os modelos de email pré-desenhados.

O conector do Serviço de Email Logto agora oferece capacidades de personalização de marca, incluindo logotipo, informações da empresa e nome do remetente.

No entanto, embora seja conveniente, há algumas limitações a serem observadas — você não pode personalizar o endereço de email do remetente, domínio ou o conteúdo específico do email.

Conecte-se com seu provedor de serviço de email (ESP) preferido usando os guias passo a passo do Logto.

Essas opções permitem que você personalize completamente seus modelos de email, nome do remetente, adicione variáveis, etc., para melhor atender à sua marca.

Oferecemos suporte pronto para uso para os seguintes provedores de serviço de email:

Personalize seu conector de email​

Se nenhuma das soluções acima atender às suas necessidades, você também pode optar por se conectar ao seu serviço de email desejado usando o Protocolo de Transferência de Correio Simples (SMTP).

Se você já possui seu próprio serviço de email e não é elegível para usar uma conexão SMTP, também fornecemos um "conector de email HTTP".

Quando precisa enviar um email, ele envia uma chamada de API para o endpoint configurado para completar o fluxo de autenticação dependente de email. Observe que, para evitar erros no fluxo de autenticação, o endpoint configurado precisa retornar uma resposta 200 após receber o WebHook para informar ao Logto que recebeu a notificação para enviar o email. Nesse caso, você precisa monitorar seu próprio serviço de email para garantir a entrega bem-sucedida.

Se nossos conectores padrão não atenderem aos seus requisitos específicos, não hesite em entrar em contato conosco. Para usuários do OSS, você pode implementar seu conector (OSS) se o requisito for urgente. Sempre damos boas-vindas a contribuições; seu esforço pode muito bem ajudar outros membros da comunidade com as mesmas necessidades.

Etapas de configuração​

Siga as etapas abaixo para adicionar um conector de email:

  1. Navegue até Console > Conectores > Conectores de Email e SMS.
  2. Para adicionar um novo conector de email, clique no botão "Configurar" e selecione seu provedor de email desejado.
  3. Revise a documentação README e configure para o provedor escolhido passo a passo.
  4. Clique em "Salvar e Concluir" para finalizar.
nota:

Para garantir que emails críticos (como códigos de verificação) cheguem de forma confiável às caixas de entrada dos usuários e evitem filtros de spam, concentre-se em duas prioridades:

  • Configurar autenticação de email (SPF, DKIM, DMARC) Provedores de email (Gmail, Outlook, etc.) usam esses protocolos para verificar se você não é um spammer. A falta dessas configurações pode fazer com que seus emails caiam no spam ou sejam rejeitados.
    • SPF (Sender Policy Framework): Lista servidores / IPs autorizados a enviar emails para seu domínio.
    • DKIM (DomainKeys Identified Mail): Adiciona uma assinatura digital para provar que os emails não foram adulterados.
    • DMARC (Domain-based Message Authentication): Informa aos receptores como lidar com emails que falham no SPF / DKIM.
  • Separar emails de autenticação e marketing Emails de marketing frequentemente geram reclamações de spam ou altas taxas de rejeição. Se os emails de autenticação compartilharem o mesmo domínio / IP, sua entregabilidade será prejudicada.
    • Use um Domínio Dedicado: Envie emails de verificação de @auth.seudominio.com, marketing de @marketing.seudominio.com.
    • IP Dedicado: Solicite um IP exclusivo para emails de autenticação e aqueça-o lentamente.
    • Correspondência do Endereço "De": Certifique-se de que o domínio do remetente esteja alinhado com os registros SPF / DKIM / DMARC.

Alterar conector de email​

Você pode notar que apenas um conector de email pode ser adicionado.

Quando você já tem um conector de email, só pode selecionar "Alterar conector de email". Ao realizar essa operação no console, ela entra em vigor imediatamente após ser salva, portanto, certifique-se de testar sua configuração antes de salvar.

Para garantir a estabilidade do seu serviço, os usuários do Cloud podem criar um tenant de desenvolvimento para o ambiente de desenvolvimento. Após testar a configuração no ambiente de desenvolvimento, "migre" a configuração para produção e, em seguida, salve a configuração.

Ativar cadastro ou login por email​

Depois de adicionar com sucesso o conector de email e concluir a configuração, você pode habilitar as configurações de login e cadastro que dependem de email + código de verificação, de acordo com suas necessidades de negócios.

  1. Navegue até: Console > Experiência de login > Cadastro e login
  2. Definir métodos de cadastro: Escolha "Endereço de email" ou "Endereço de email ou número de telefone" como o identificador de cadastro. Nota: a verificação de email é atualmente obrigatória durante o cadastro.
  3. Definir métodos de login: O identificador de cadastro escolhido automaticamente se torna um método de login. Clique em "Adicionar outro" para opções adicionais de login.
  4. Salvar Alterações e Testar: Clique em "Salvar alterações" para implementar a nova experiência de login. Lembre-se de usar a "Visualização ao vivo" para testar a funcionalidade.
atenção:

Como nossas configurações entram em vigor imediatamente, excluir o conector de email existente pode afetar os processos normais de login e registro dos usuários finais.

Por exemplo, se o identificador de login incluir a combinação "email + código de verificação", excluir o conector de email existente impedirá que os usuários recebam códigos de verificação por email e resultará em um erro no fluxo de login.

Esteja ciente dos riscos potenciais ao operar em conectores.

FAQs​

Como personalizar o nome do remetente do email?​

Ainda estamos trabalhando em mais conectores. Se você precisar de mais opções, basta nos informar suas necessidades no Discord e registrar uma Solicitação de Recurso no GitHub. Se precisar de mais assistência, você também pode entrar em contato conosco por email.

Para contribuidores, fornecemos um método de criação de conector fácil de estender, permitindo que você personalize seu próprio conector com base em seus cenários específicos. Você é sempre bem-vindo para enviar um pull request para o Logto, para que outros na comunidade também possam se beneficiar do seu trabalho.

Como posso restringir endereços IP para solicitações de email em conectores de email Logto?​

Uma solução alternativa é usar o conector de email HTTP do Logto.

Implemente um endpoint de API em seu servidor que chame o serviço de email relevante e acione esse endpoint de API através do conector de email HTTP do Logto. Dessa forma, você terá controle total sobre o endereço IP do seu endpoint de API e poderá adicionar os endereços IP correspondentes à lista de permissões na configuração do provedor de serviço de email.