Enviar correo electrónico con Microsoft Graph
Esta guía explica cómo enviar los correos electrónicos de Casdoor desde un buzón de Microsoft 365 con la API sendMail de Microsoft Graph. Casdoor obtiene un token solo para aplicaciones de Microsoft Entra ID mediante el flujo de credenciales de cliente y llama a POST /users/<mailbox>/sendMail. No usa SMTP, por lo que funciona en inquilinos donde SMTP AUTH está desactivado. Para enviar a través de SMTP en su lugar, consulte Microsoft 365.
Resultados del aprendizaje
- Registrar una aplicación en Microsoft Entra ID que pueda enviar correo como un buzón.
- Agregar Microsoft Graph como proveedor de correo electrónico en Casdoor y probarlo.
Requisitos
- Un inquilino de Microsoft 365 y un buzón que envía los correos electrónicos, por ejemplo
noreply@contoso.com. Un buzón compartido funciona. - Una cuenta que pueda registrar aplicaciones y otorgar el consentimiento de administrador en Microsoft Entra ID
- Acceso de administrador a la consola de administración de Casdoor
Registrar una aplicación en Microsoft Entra ID
- En el centro de administración de Microsoft Entra, abre App registrations y haz clic en New registration. Introduce un nombre, como
Casdoor email, mantén Accounts in this organizational directory only, y haz clic en Register. - En la página Overview de la aplicación, copia el Application (client) ID y el Directory (tenant) ID.
- Ve a Certificates & secrets > Client secrets > New client secret, y copia el Value del secreto. Se muestra solo una vez.
- Vaya a API permissions > Add a permission > Microsoft Graph > Application permissions, y seleccione Mail.Send.
- Haz clic en Grant admin consent para tu organización.
El permiso de aplicación Mail.Send permite que la aplicación envíe como cualquier buzón del inquilino. Para limitarlo al buzón de envío, utilice RBAC para aplicaciones en Exchange Online o una política de acceso de aplicación.
Agrega el proveedor en Casdoor
-
En la consola de administración de Casdoor, ve a Identity > Providers y agrega un proveedor.
-
Establezca Category en
Emaily Type enMicrosoft Graph. Casdoor rellena el endpoint, la URL del token y el scope. -
Complete los campos:
Campo Value Client ID El Application (client) ID de la aplicación Client secret El Value del secreto de cliente From address El buzón que envía los correos electrónicos, por ejemplo noreply@contoso.com. Casdoor llama asendMailpara este buzón, por lo que es obligatorioFrom name (Opcional) El nombre visible del remitente Endpoint https://graph.microsoft.com/v1.0. Cámbielo solo para una nube nacional, por ejemplohttps://graph.microsoft.us/v1.0Token URL https://login.microsoftonline.com/<tenant-id>/oauth2/v2.0/token, sustituyendo<tenant-id>por el Directory (tenant) IDScope https://graph.microsoft.com/.default -
Escriba el Email title y el Email content. Consulte Plantillas. Casdoor envía el contenido como HTML y no guarda una copia en Sent Items.
-
Guarde el proveedor.
Enable proxy envía la solicitud de token y las llamadas a la API a través del proxy SOCKS5 de Casdoor. Consulte Proxy.
Verificar el resultado
- Haga clic en Test SMTP Connection. Para este tipo, Casdoor solo obtiene un token, lo que verifica la URL del token, el ID de cliente y el secreto de cliente, sin enviar un correo electrónico.
- Haz clic en Send Testing Email y verifica que el mensaje llegue al buzón de Test Email.
Luego añade el proveedor a tu aplicación. Consulta Añadir proveedores a una aplicación.
Resolución de problemas
| Error | Cause |
|---|---|
the token URL of the Microsoft Graph email provider is required | Token URL está vacío o aún contiene <tenant-id> |
the from address of the Microsoft Graph email provider must be the mailbox that sends the emails | From address está vacío o no es una dirección de correo electrónico |
oauth2: cannot fetch token con un código AADSTS | Microsoft Entra ID rechazó la solicitud de token. Verifica el tenant ID en Token URL, el Client ID, y el Client secret, que debe ser el valor del secreto, no su ID, y no debe estar caducado |
Microsoft Graph sendMail failed with status 403 | La aplicación no tiene el permiso de aplicación Mail.Send con consentimiento de administrador, o una política de acceso no le permite enviar como el From address |
Microsoft Graph sendMail failed with status 404 | El From address no es un buzón del inquilino |