OAUTH2

A partir de la versión 5.0.0.80. Para poder enviar correos mediante Oauth2 necesitaremos una cuenta de Azure y configurar el ERP con unas especificaciones. 

TABLA DE CONTENIDOS

• CONFIGURACIÓN DE AZURE
  • CREAR NUEVO REGISTRO DE APLICACIONES
  • AGREGAR URI DE REDIRECCIÓN
  • AGREGAR UNA PLATAFORMA
  • CREAR CERTIFICADOS Y SECRETOS
  • AÑADIR PERMISOS PARA LA API
• CONFIGURACIÓN DE ERP
  • INSTALACIÓN CON EL INSTALADOR
  • HABILITAR Y CONFIGURAR PARÁMETROS
  • CONFIGURACIÓN EFACTURA
  • COMPLETAR EL ENVÍO DE OAUTH2
  • ENVÍOS DE OBJETOS

NOTA:
Antes de empezar con la guía, se recuerda que la guía de configuración de Azure la ofrecemos para facilitar la configuración, pero no damos soporte puesto que no es nuestra aplicación.

CONFIGURACIÓN DE AZURE

Primero nos creamos una cuenta de Azure.

CREAR NUEVO REGISTRO DE APLICACIONES

• Buscamos Registro de aplicaciones.

• Creamos un Nuevo registro.

• Rellenamos los datos de Nombre, tipos de cuentas que pueden acceder a nuestra aplicación y si lo necesitamos generamos una URI, en este caso se generará más adelante.

• Una vez creado el nuevo registro, vamos al apartado de todas las aplicaciones y entramos en el registro creado.

AGREGAR URI DE REDIRECCIÓN

• Agregar un URI de redirección.

AGREGAR UNA PLATAFORMA

• Una vez dentro agregamos una plataforma.

• Seleccionamos los tres checks que aparecen y le damos al botón de configurar que se muestra en la parte inferior.

• Añadimos 3 URI nuevas con el botón de agregar.

1. http://localhost
2. erp://account/Account/AzureAuth
3. http://localhost:5000/api/mail/mailtoken

CREAR CERTIFICADOS Y SECRETOS

• Nos vamos al apartado de Certificados y secretos y añadimos un Nuevo secreto de cliente.

NOTA: 
La clave que se genera solo se podrá copiar una única vez. Si la pierdes deberás de generar una nueva.

• Se nos  genera una clave y la guardamos tanto el valor como el id. de secreto.

AÑADIR PERMISOS PARA LA API

• Ahora debemos indicarle algunos permisos necesarios para que nuestra aplicación funcione.

• Para empezar a añadir los permisos entramos en el apartado de Microsoft Graph.
  
• Estos son todos los permisos necesarios, una vez añadidos, le damos a conceder consentimiento de administrador para Directorio predeterminado.

CONFIGURACIÓN DE ERP

Para poder hacer funcionar el envío por Oauth2 hace falta tener:

• ERP
• API
• AhoraEfactura (servicio) 

Nota:
La API y la eFactura deben mostrar la misma versión que el ERP.

INSTALACIÓN CON EL INSTALADOR

En el caso de no tener ni la eFactura ni la API. Podemos utilizar el instalador para instalar los módulos.

HABILITAR Y CONFIGURAR PARÁMETROS

Después de la instalación de la API y de la eFactura, tenemos que habilitar y configurar los parámetros dentro del ERP:

1. ENVIO_CORREO_AUTOMATICO
2. API_URL
3. HABILITAR_EFACTURA

• Añadimos la misma URL que nos muestra el archivo de configuración de la API.

Al activar el último parámetro eFactura, ya nos saldrá el Nodo. El parámetro de la eFactura es de sesión, por lo que habrá que salir y entrar en el ERP de nuevo.

CONFIGURACIÓN EFACTURA

• En el objeto del cliente indicamos los datos de la eFactura que vamos a utilizar.

• El siguiente paso será configurar un envío, tenemos que indicar el tipo de Documento, el tipo de envío y marcar el check de habilitado.

COMPLETAR EL ENVÍO DE OAUTH2

• Después de tener configurado el envío de correo, vamos a añadir el envío por oauth2.
  • Client Id: Tenemos que indicar el Id. de aplicación (cliente) que se encuentra en Azure --> Registro de aplicaciones --> La clave que hemos generado --> Información general.
    
  • Client Secret: Tenemos que indicar el valor que se encuentra en Azure --> Registro de aplicaciones --> La clave que hemos generado --> Certificados y Secretos.
  • Tenent Id:  Tenemos que indicar el  Id. de directorio (inquilino) que se encuentra en Azure --> Registro de aplicaciones --> La clave que hemos generado --> Información general.
    Una vez tenemos estos datos le damos al botón de guardar y veremos que aparecen dos botones nuevos.
    
  • Autorizar Aplicación: Donde indicaremos el correo y la contraseña del usuario, una vez registrado aparecerá una ventana indicando que podemos cerrar la ventana y finalmente nos mostrará un mensaje indicando que la comprobación de permisos es correcta.
    
    

• Usuario API: Indicaremos el empleado que vamos a utilizar y la contraseña del empleado

Nota:
Tiene que ser un empleado diferente al que está registrado en la aplicación. Por ejemplo si en la aplicación nos hemos registrado con el empleado ahora, utilizaremos otro empleado diferente para este punto

 

Después de rellenar toda la información, será necesario reiniciar para que los datos estén correctamente actualizados.

ENVÍOS DE OBJETOS

Ahora configuraremos el servidor de correo que se encuentra en la pestaña de Mantenimientos --> Mantenimiento e-factura --> Servidor Correo. Aquí indicamos el correo desde donde se envía. 

Finalmente le damos a enviar y nos lo enviará a nuestro correo.