Saltar al contenido principal

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​

  1. 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.
  2. En la página Overview de la aplicación, copia el Application (client) ID y el Directory (tenant) ID.
  3. Ve a Certificates & secrets > Client secrets > New client secret, y copia el Value del secreto. Se muestra solo una vez.
  4. Vaya a API permissions > Add a permission > Microsoft Graph > Application permissions, y seleccione Mail.Send.
  5. 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​

  1. En la consola de administración de Casdoor, ve a Identity > Providers y agrega un proveedor.

  2. Establezca Category en Email y Type en Microsoft Graph. Casdoor rellena el endpoint, la URL del token y el scope.

  3. Complete los campos:

    CampoValue
    Client IDEl Application (client) ID de la aplicación
    Client secretEl Value del secreto de cliente
    From addressEl buzón que envía los correos electrónicos, por ejemplo noreply@contoso.com. Casdoor llama a sendMail para este buzón, por lo que es obligatorio
    From name(Opcional) El nombre visible del remitente
    Endpointhttps://graph.microsoft.com/v1.0. Cámbielo solo para una nube nacional, por ejemplo https://graph.microsoft.us/v1.0
    Token URLhttps://login.microsoftonline.com/<tenant-id>/oauth2/v2.0/token, sustituyendo <tenant-id> por el Directory (tenant) ID
    Scopehttps://graph.microsoft.com/.default
  4. 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.

  5. 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​

  1. 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.
  2. 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​

ErrorCause
the token URL of the Microsoft Graph email provider is requiredToken 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 emailsFrom address está vacío o no es una dirección de correo electrónico
oauth2: cannot fetch token con un código AADSTSMicrosoft 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 403La 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 404El From address no es un buzón del inquilino

Véase también​