Para integrar G360 ERP con una cuenta de Office 365, será necesario realizar 3 pasos:
- Crear una aplicación dentro de la cuenta de Office 365 del cliente (a través de Azure).
- Conceder los permisos a la aplicación creada.
- Introducir los valores en G360 ERP.
A continuación, veremos los pasos uno a uno.
Paso 1: Crear aplicación en Azure
Para configurar nuestra cuenta de Office 365 en G360 ERP, necesitaremos 3 datos:
- ID Aplicación (cliente).
- ID Directorio (inquilino).
- Valor de Secreto de la aplicación.
Para sacar el ID de Aplicación, ID Directorio y el Valor de Secreto, hay que registrar una nueva aplicación en Azure.
Para ello, accederemos al Portal de Azure (https://portal.azure.com/#home) y dentro del mismo, abrimos Microsoft Entra ID:
Una vez dentro de Microsoft Entra ID, acudiremos a “Registro de Aplicaciones”, seleccionaremos “Aplicaciones propias”, y le daremos a “+ Nuevo Registro”:
Deberemos introducir nombre con el cual reconoceremos la aplicación (por ejemplo, G360 ERP – MAIL), y le daremos los tipos de cuenta que queremos, que sean compatibles (recomendamos la 3º opción, “Cuentas en cualquier directorio organizacional”).
Una vez introducido, pulsaremos sobre “Registrar”:
Ahora, en Información General de la aplicación, ya tendremos dos de los primeros datos que necesitamos (“ID de aplicación” e “ID de directorio”):
El siguiente paso, será crear un Valor Secreto. Para ello, dentro de Azure en la configuración de la aplicación, acudiremos a “Certificados y Secretos”, pulsaremos sobre “Nuevo secreto de cliente”, e indicaremos:
- Descripción: introduciremos cualquier descripción que queramos.
- Periodo de Expiración: periodo de vigencia que deseemos (importante, habrá que renovarlo cuando expire).
Pulsaremos “Agregar”:
MUY IMPORTANTE, SÓLO en el momento de la creación se mostrará el VALOR, el cual es el dato que necesitamos, con lo cual deberemos copiarlo en este momento. Sino lo hacemos, habrá que generar un nuevo secreto.
Con este último paso, ya tenemos los 3 datos que necesitamos configurar en G360 ERP (ID aplicación, ID Directorio y Valor secreto).
Paso 2: Asignar permisos para Leer y Enviar correos
Una vez registrada la aplicación, debemos conceder permisos para Leer y Mandar mails.
Volveremos a entrar en Microsoft Entra ID, iremos a “Registro de Aplicaciones”, pulsaremos sobre “Todas las aplicaciones” y abriremos la aplicación que hemos dado de alta (en este ejemplo, G360 ERP – MAIL):
Nos llevará a la página donde vendrán todos los detalles y configuraciones de la aplicación.
Ahora, concederemos los permisos para enviar y leer correos a través de la API. Para ello, realizaremos los siguientes pasos:
- Desplegar el menú “Administrar” y pulsar sobre “Permisos API”.
- Seleccionar Microsoft Graph (se abrirá una ventana en la parte derecha).
- Marcaremos la opción “Permisos de la aplicación”.
- Buscaremos dentro de los permisos, concretamente 2, y los marcaremos:
- Mail.Send.
- Mail.Read.
- Pulsaremos sobre actualizar permisos.
- Concederemos consentimiento de Administrador.
IMPORTANTE: debe quedar tal y como está en la captura de pantalla, es decir:
- Mail.Read y Mail.Send, deben tener los siguientes valores:
- Tipo: Aplicación.
- Se necesita el consentimiento de administrador: SI.
- Estado: Concedido.
Paso 3: Configurar integración en G360 ERP
El primer paso, será crear una integración para la cuenta de Office 365. Para ello, acudiremos a Configuración > Integraciones, pulsaremos sobre Nueva, e introduciremos:
- Descripción: la que queramos.
- Tipo: seleccionar Correo office 365.
- ID aplicación: introduciremos el ID de aplicación (cliente) generado en los pasos anteriores.
- ID directorio (inquilino): introduciremos el ID generado en los pasos anteriores.
Ahora, acudiremos a la configuración de la cuenta de correo (en este caso, una cuenta del usuario). Pulsaremos sobre el usuario logueado, y abriremos la opción “Configurar mail”:
Iremos al apartado “Configuración de cuenta” e indicaremos:
- Proveedor la correo: seleccionar Office 365.
- Dirección de correo: introducir la dirección del usuario.
- Token: introduciremos el Valor Secreto generado de la aplicación.
Por último y para comprobar que todo funciona correctamente, enviaremos un mail de prueba. Para ello, acudiremos a Utilidades > Envío de mail, introduciremos destinatario, asunto y cuerpo, y pulsaremos enviar:
Si al enviar, sale el mensaje “El e-mail se envió correctamente”, quiere decir que tanto la configuración de la aplicación en Azure como los datos introducidos en G360 ERP, están correctos: