Pular para o conteúdo principal

Send email with Microsoft Graph

Este guia explica como enviar os e-mails do Casdoor a partir de uma caixa de correio do Microsoft 365 usando a API sendMail do Microsoft Graph. O Casdoor obtém um token apenas de aplicativo (app-only) do Microsoft Entra ID com o fluxo de credenciais de cliente e chama POST /users/<mailbox>/sendMail. Ele não usa SMTP, portanto funciona em tenants onde o SMTP AUTH está desativado. Para enviar via SMTP, veja Microsoft 365.


Resultados da aprendizagem​

  • Registrar um aplicativo no Microsoft Entra ID que possa enviar e-mails como uma caixa de correio.
  • Adicionar o Microsoft Graph como provedor de e-mail no Casdoor e testá-lo.

O que você precisa​

  • Um tenant do Microsoft 365 e uma caixa de correio que envia os e-mails, por exemplo, noreply@contoso.com. Uma caixa de correio compartilhada funciona.
  • Uma conta que pode registrar aplicativos e conceder consentimento administrativo no Microsoft Entra ID
  • Acesso de administrador ao console de administração do Casdoor

Registrar um aplicativo no Microsoft Entra ID​

  1. No Centro de administração do Microsoft Entra, abra App registrations e clique em New registration. Insira um nome, como Casdoor email, mantenha Accounts in this organizational directory only e clique em Register.
  2. Na página Overview do aplicativo, copie o Application (client) ID e o Directory (tenant) ID.
  3. Vá para Certificates & secrets > Client secrets > New client secret, e copie o Value do segredo. Ele é exibido apenas uma vez.
  4. Vá para API permissions > Add a permission > Microsoft Graph > Application permissions, e selecione Mail.Send.
  5. Clique em Grant admin consent para sua organização.

A permissão de aplicativo Mail.Send permite que o app envie como qualquer caixa de correio do tenant. Para limitá-la à caixa de correio remetente, use RBAC for Applications in Exchange Online ou uma política de acesso de aplicativo.

Adicione o provedor no Casdoor​

  1. No console de administração do Casdoor, vá para Identity > Providers e adicione um provedor.

  2. Defina Category como Email e Type como Microsoft Graph. O Casdoor preenche automaticamente o endpoint, a URL do token e o escopo.

  3. Preencha os campos:

    CampoValor
    Client IDO Application (client) ID do aplicativo
    Client secretO Value do segredo do cliente
    From addressA caixa de correio que envia os e-mails, por exemplo, noreply@contoso.com. O Casdoor chama sendMail para esta caixa de correio, portanto, é obrigatório
    From name(Opcional) O nome de exibição do remetente
    Endpointhttps://graph.microsoft.com/v1.0. Altere apenas para uma nuvem nacional, por exemplo, https://graph.microsoft.us/v1.0
    Token URLhttps://login.microsoftonline.com/<tenant-id>/oauth2/v2.0/token, com <tenant-id> substituído pelo Directory (tenant) ID
    Scopehttps://graph.microsoft.com/.default
  4. Escreva o Email title e o Email content. Veja Templates. O Casdoor envia o conteúdo como HTML e não mantém uma cópia em Sent Items.

  5. Salve o provedor.

Enable proxy envia a solicitação de token e as chamadas de API através do proxy SOCKS5 do Casdoor. Veja Proxy.

Verificar o resultado​

  1. Clique em Test SMTP Connection. Para este tipo, o Casdoor obtém apenas um token, o que verifica a URL do token, o client ID e o client secret, sem enviar um e-mail.
  2. Clique em Send Testing Email e verifique se a mensagem chega na caixa de correio Test Email.

Em seguida, adicione o provedor à sua aplicação. Veja Adicionar provedores a uma aplicação.

Solução de problemas​

ErrorCause
the token URL of the Microsoft Graph email provider is requiredToken URL está vazio ou ainda contém <tenant-id>
the from address of the Microsoft Graph email provider must be the mailbox that sends the emailsFrom address está vazio ou não é um endereço de e-mail
oauth2: cannot fetch token com um código AADSTSO Microsoft Entra ID recusou a solicitação de token. Verifique o ID do tenant em Token URL, o Client ID e o Client secret, que deve ser o valor do segredo, não seu ID, e não deve estar expirado
Microsoft Graph sendMail failed with status 403O app não tem a permissão de aplicativo Mail.Send com consentimento administrativo, ou uma política de acesso não permite que ele envie como o From address
Microsoft Graph sendMail failed with status 404O From address não é uma caixa de correio do tenant

Veja também​