Integraciones

MyQ Roger admite múltiples funciones de integración con Microsoft 365, cada una de ellas implementada a través de un registro de aplicaciones de Azure específico. Este enfoque permite flujos de autenticación seguros y específicos para cada finalidad mediante Microsoft Identity y las API relacionadas, como OneDrive, SharePoint, Universal Print y la sincronización de usuarios.

Los usuarios también tienen la opción de registrar y utilizar sus propias aplicaciones de Azure, gestionando los ámbitos y permisos necesarios de forma independiente según las políticas de su organización.

Funcionalidades compatibles

Mediante las integraciones con Microsoft 365, puede gestionar los siguientes aspectos de su inquilino de Roger:

• Inicio de sesión

• Sincronización de usuarios

• SharePoint

• Impresión universal

• OneDrive

Los ámbitos y permisos necesarios para cada uno de ellos se especifican en sus respectivas páginas.

Tipos de aplicación

Las integraciones se pueden gestionar mediante dos tipos diferentes de aplicaciones de Entra ID:

• Aplicaciones divididas: creadas automáticamente mediante una aplicación MyQ Roger; cada función de integración cuenta con un registro de aplicación específico en el inquilino de Azure de MyQ.

• Aplicaciones MyQ Roger: se crean manualmente; se utiliza una aplicación de Entra ID para la integración principal de Roger, junto con la propia aplicación de Entra ID del cliente para la sincronización de usuarios.

Añadir una integración de Microsoft

Para añadir una aplicación de Microsoft 365 a tu inquilino de MyQ Roger:

1. En «Administración» > «Integraciones», selecciona «+ Añadir integración» y elige «Microsoft» (habrá más opciones disponibles en futuras versiones).

   

2. Selecciona cómo añadir la integración:

   1. Crear automáticamente: al elegir esta opción, se utilizará automáticamente un conjunto predefinido de aplicaciones de MyQ Roger, una por función, como MyQ Roger para OneDrive o MyQ Roger Entra ID Connector. Solo tienes que seleccionar «Crear automáticamente», hacer clic en «Guardar», hacer clic en «Seleccionar inquilino» e iniciar sesión en la instancia de Entra ID correspondiente. Las integraciones creadas automáticamente solo funcionan en Roger Client si se utiliza la versión 2.5 o superior.

      
      

   2. Configurar manualmente: esta opción le permitirá utilizar la aplicación MyQ Roger heredada (proceso recomendado) o crear integraciones con sus propias aplicaciones personalizadas de Azure.

      

3. Si ha seleccionado «Configurar manualmente»:

   1. Debe disponer de un Azure Active Directory existente en el que deberá:

      1. Crear un nuevo registro de aplicación (https://docs.microsoft.com/en-us/azure/active-directory/develop/quickstart-register-app).

      2. Vaya a «Certificados y secretos» y cree un nuevo secreto. Establezca una fecha de caducidad y copie el valor del secreto (haga una copia de seguridad del valor, ya que no volverá a mostrarse).

      3. El registro de la aplicación debe tener el permiso User.Read.All, yGroup.Read.All (si solo quieres sincronizar determinados grupos). Para configurarlos, selecciona «Permisos de API» > «Añadir un permiso».

   2. A continuación, en el cuadro de diálogo «Añadir integración» de la interfaz de usuario web de Roger:

      1. (Opcional) Introduce el ID de directorio (inquilino): introduce tu ID de inquilino de Azure Entra para restringir las funciones relacionadas con Microsoft a ese inquilino. Si se deja en blanco, estas funciones también se podrán utilizar con cuentas personales. También puedes añadir el ID de inquilino más adelante.

      2. Introduce el ID de la aplicación: en los casos en los que ya existiera una conexión previa a las integraciones con una aplicación de Microsoft 365, este campo aparecerá rellenado con la antigua aplicación MyQ Roger, que puede utilizarse para mantener la configuración de integración heredada de Microsoft. Puedes sustituirlo por los datos de tu aplicación actual.

      3. Introduzca el secreto de la aplicación: si se modifica el ID de la aplicación, el secreto de la aplicación debe actualizarse en consecuencia.

      4. Haga clic en «Guardar». Se crea la aplicación de Microsoft 365; de forma predeterminada, todas las funciones están desactivadas.

         

Limitaciones

Cada inquilino de Microsoft solo puede tener una instancia habilitada del mismo tipo de función de integración.

Al habilitar una función, el sistema comprueba si ya existe otra función habilitada del mismo tipo para el mismo inquilino de Microsoft. Si es así, se muestra un mensaje de error.

Si se cambia desde la aplicación heredada MyQ Roger, se revocarán los consentimientos relacionados con los almacenamientos en la nube o los servicios de Microsoft y se pedirá a los usuarios que vuelvan a conectarse a través de la nueva aplicación.

Solución de problemas

Eliminación de integraciones y cambio de tipo de integración

Una vez que disponga de una integración de Microsoft existente o haya cambiado de una aplicación heredada a una aplicación dividida, debe seguir los siguientes pasos:

1. Tras añadir una nueva integración con un inquilino de Entra, debe habilitar y volver a ejecutar la sincronización de usuarios con la opción «Gestionar usuarios existentes» activada en la plantilla de sincronización de usuarios.

2. Será necesario volver a habilitar el inicio de sesión, OneDrive, SharePoint e Impresión universal en la nueva integración.

3. Los usuarios con almacenamientos en la nube conectados deberán volver a conectar cada instancia.

4. Los usuarios conectados a la nube deberán volver a autenticarse en Roger Client.