SMTP mediante OAuth para buzones de Microsoft Office 365

1. Registre la aplicación EntraID

• Primero vaya al Centro de administración de EntraID https://entra.microsoft.com e inicie sesión en su tenant.
• En el área Aplicaciones, haga clic en Registros de aplicaciones y luego en Nuevo registro.
  
• En la siguiente sección, sólo es necesario dar un nombre a la app; se pueden conservar los valores predeterminados para los tipos de Cuenta Supported y Redirect URI.

2. Creación de la clave secreta del cliente

• Permanezca en la vista de la app creada y pulse en Certificados y secretos y después en Nuevo secreto de cliente.
  
• Dé un nombre al secreto de cliente y seleccione 24 meses como fecha de caducidad. Recuerde la fecha de caducidad, ya que deberá crear un nuevo secreto de cliente una vez transcurridos los 24 meses para que el envío SMTP en DocuWare funcione sin interrupciones.
• Para la configuración en DocuWare sólo necesitamos la clave secreta del cliente, es decir, el valor, no necesitamos el ID secreto. Tenga en cuenta que el valor sólo es visible directamente después de la creación, en cuanto salga de la página, ya no podrá ver el valor.
  

3. Asignar Permisos SMTP

• Permanezca dentro de la aplicación y cambie a la pestaña Permisos API. Allí, haz clic en Añadir un permiso para dar a la app los permisos necesarios para las funciones SMTP.
  
• En el área Request API permissions, haz clic en APIs my organization uses y busca "Office 365 Exchange Online".
  
• Seleccione el resultado y, a continuación, haga clic en Permisos de aplicación y seleccione SMTP.SendAsApp de la lista. A continuación, haga clic en Añadir permisos
  
• Usted o el Administrador de EntraID deben ahora aprobar la solicitud de autorización.
  

4. Cree el principio de servicio para la aplicación EntraID

• Para este paso, necesitamos un PowerShell con acceso de administrador y algunos ID del Centro de Administración de EntraID.
• En el Centro de Administración de EntraID, vaya a la sección Identidad y luego a Visión General. Copie allí el ID del inquilino.
• Ahora vuelva al área de Aplicaciones, pero ahora a Aplicaciones Empresariales y seleccione la aplicación que creó anteriormente. Copie el ID de Aplicación y el ID de Objeto.
  
  Importante: Para obtener el ID de objeto correcto, debe cambiar la vista de Registro de aplicaciones a Aplicaciones de empresa; de lo contrario, se mostrará un ID de objeto incorrecto.
• Ahora abra PowerShell y conéctese a su tenant con los siguientes comandos:
  Install-Module -Name ExchangeOnlineManagement
  Import-module ExchangeOnlineManagement
  Connect-ExchangeOnline -Organization <tenantId>
• Ahora cree un nuevoprincipio de servicio con el siguiente comando:
  New-ServicePrincipal -AppId [Your appID] -ObjectId [Ihre objectID]
  
• Puede comprobar su entrada mostrando el principio de servicio con Get-ServicePrincipal | fl
• Añada ahora el buzón con el que desea enviar correos electrónicos en DocuWare:
  Add-MailboxPermission -Identity "invoices@example.com" -User [Your objectID] -AccessRights FullAccess
  

5. Configuraciones en DocuWare

El último paso consiste en transferir la información del EntraID a DocuWare.

• Para ello, vaya a DocuWare Configuration -> Mail Services -> Sending y haga clic en New SMTP Ajustes.
• Asigne un nombre a la nueva configuración, seleccione el nombre para mostrar y la dirección de correo electrónico con la que se enviarán los mensajes. A continuación, seleccione Usar autenticación SMTP OAuth.
• Los datos SMTP son obligatorios:
  • Dirección SMTP: smtp-mail.outlook.com
  • Nombre de usuario: Su dirección de correo electrónico que introdujo en el paso 4
  • Cifrado: STARTTLS
  • Puerto 587
• En el área inferior, haga clic en Microsoft e introduzca el ID de aplicación de la app EntraID y el correspondiente secreto de cliente que creó anteriormente.
  
• Puede encontrar el punto final del token OAuth 2.0 (v2) de su aplicación EntraID en el Centro de Administración de EntraID en Aplicaciones -> Registros de aplicaciones -> Nombre de su aplicación -> Puntos finales.
  
• Por último, pruebe su configuración con el botón Enviar correo electrónico de prueba.

Tenga en cuenta: Este artículo es una traducción del idioma inglés. La información contenida en este artículo se basa en la(s) versión(es) original(es) del producto(s) en inglés. Puede haber errores menores, como en la gramática utilizada en la versión traducida de nuestros artículos. Si bien no podemos garantizar la exactitud completa de la traducción, en la mayoría de los casos, encontrará que es lo suficientemente informativa. En caso de duda, vuelva a la versión en inglés de este artículo.