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
- 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. - Na página Overview do aplicativo, copie o Application (client) ID e o Directory (tenant) ID.
- Vá para Certificates & secrets > Client secrets > New client secret, e copie o Value do segredo. Ele é exibido apenas uma vez.
- Vá para API permissions > Add a permission > Microsoft Graph > Application permissions, e selecione Mail.Send.
- 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
-
No console de administração do Casdoor, vá para Identity > Providers e adicione um provedor.
-
Defina Category como
Emaile Type comoMicrosoft Graph. O Casdoor preenche automaticamente o endpoint, a URL do token e o escopo. -
Preencha os campos:
Campo Valor Client ID O Application (client) ID do aplicativo Client secret O Value do segredo do cliente From address A caixa de correio que envia os e-mails, por exemplo, noreply@contoso.com. O Casdoor chamasendMailpara esta caixa de correio, portanto, é obrigatórioFrom name (Opcional) O nome de exibição do remetente Endpoint https://graph.microsoft.com/v1.0. Altere apenas para uma nuvem nacional, por exemplo,https://graph.microsoft.us/v1.0Token URL https://login.microsoftonline.com/<tenant-id>/oauth2/v2.0/token, com<tenant-id>substituído pelo Directory (tenant) IDScope https://graph.microsoft.com/.default -
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.
-
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
- 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.
- 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
| Error | Cause |
|---|---|
the token URL of the Microsoft Graph email provider is required | Token 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 emails | From address está vazio ou não é um endereço de e-mail |
oauth2: cannot fetch token com um código AADSTS | O 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 403 | O 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 404 | O From address não é uma caixa de correio do tenant |