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 (apenas Cloud)​

Esta opção de serviço de email embutido é ideal para começar rapidamente tanto para testes 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 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 totalmente seu modelo de email, nome do remetente, 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 nos contatar. Para usuários do OSS, você pode implementar seu conector (OSS) se o requisito for urgente. Sempre recebemos 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 seu provedor escolhido passo a passo.
  4. Clique em "Salvar e Concluir" para finalizar.

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 esta 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, "migrar" a configuração para produção, e então salvar a configuração.

Habilitar cadastro ou login por email​

Uma vez que você adiciona com sucesso o conector de email e completa 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 "Pré-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 nos contatar por email.

Para colaboradores, 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 nos conectores de email do 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 este 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.