Intégrations

MyQ Roger prend en charge plusieurs fonctionnalités d’intégration à Microsoft 365, chacune étant mise en œuvre via un enregistrement d’application Azure dédié. Cette approche permet des flux d’authentification sécurisés et spécifiques à chaque usage, grâce à Microsoft Identity et aux API associées telles que OneDrive, SharePoint, Universal Print et la synchronisation des utilisateurs.

Les utilisateurs ont également la possibilité d’enregistrer et d’utiliser leurs propres applications Azure, en gérant de manière indépendante les périmètres et les autorisations requis, conformément aux politiques de leur organisation.

Fonctionnalités prises en charge

Grâce aux intégrations avec Microsoft 365, vous pouvez gérer les aspects suivants de votre tenant Roger :

• Connexion

• Synchronisation des utilisateurs

• SharePoint

• Impression universelle

• OneDrive

Les périmètres et les autorisations requis pour chacun d'entre eux sont précisés sur leurs pages respectives.

Types d’applications

Les intégrations peuvent être gérées à l’aide de deux types d’applications Entra ID différents :

• Applications fractionnées : créées automatiquement à l’aide d’une application MyQ Roger, chaque fonctionnalité d’intégration dispose d’un enregistrement d’application dédié dans le tenant Azure de MyQ.

• Applications MyQ Roger : créées manuellement, une application Entra ID est utilisée pour l’intégration Roger principale, en association avec l’application Entra ID propre au client pour la synchronisation des utilisateurs.

Ajout d’une intégration Microsoft

Pour ajouter une application Microsoft 365 à votre tenant MyQ Roger :

1. Dans Administration > Intégrations, sélectionnez + Ajouter une intégration, puis choisissez Microsoft (d'autres options seront disponibles dans les prochaines versions).

   

2. Sélectionnez la méthode d’ajout de l’intégration :

   1. Créer automatiquement : le choix de cette option entraînera l’utilisation automatique d’un ensemble prédéfini d’applications MyQ Roger, à raison d’une par fonctionnalité, telles que MyQ Roger pour OneDrive ou MyQ Roger Entra ID Connector. Il suffit de sélectionner « Créer automatiquement », de cliquer sur « Enregistrer », puis sur « Sélectionner un tenant », et de se connecter à l’instance Entra ID concernée. Les intégrations créées automatiquement ne fonctionnent dans Roger Client qu’à partir de la version 2.5.

      
      

   2. Configurer manuellement : cette option vous permettra d’utiliser l’ancienne application MyQ Roger (procédure recommandée) ou de créer des intégrations avec vos propres applications Azure personnalisées.

      

3. Si vous avez sélectionné « Configuration manuelle » :

   1. Vous devez disposer d’un Azure Active Directory existant dans lequel vous devrez :

      1. Créer un nouvel enregistrement d’application (https://docs.microsoft.com/en-us/azure/active-directory/develop/quickstart-register-app).

      2. Accéder à la section « Certificats et secrets » et créer un nouveau secret. Définir une date d’expiration et copier la valeur du secret (sauvegardez cette valeur, elle ne s’affichera plus par la suite).

      3. L’enregistrement d’application doit disposer de l’autorisation User.Read.All, etGroup.Read.All (si vous souhaitez uniquement synchroniser certains groupes). Pour les configurer, sélectionnez « Autorisations API » > « Ajouter une autorisation ».

   2. Ensuite, dans la boîte de dialogue « Ajouter une intégration » de l’interface utilisateur Web de Roger :

      1. (Facultatif) Saisissez l’ID du répertoire (locataire) : saisissez l’ID de votre locataire Azure Entra pour limiter les fonctionnalités liées à Microsoft à ce locataire. Si ce champ est laissé vide, ces fonctionnalités peuvent également être utilisées avec des comptes personnels. Vous pouvez également ajouter l’ID du locataire ultérieurement.

      2. Saisissez l’ID d’application : si une connexion antérieure à Integrations existait avec une application Microsoft 365, ce champ est prérempli avec l’ancienne application MyQ Roger, qui peut être utilisée pour conserver la configuration d’intégration Microsoft existante. Vous pouvez le remplacer par les informations de votre application actuelle.

      3. Saisissez la clé secrète de l’application : si l’ID d’application est modifié, la clé secrète de l’application doit être mise à jour en conséquence.

      4. Cliquez sur « Enregistrer ». L’application Microsoft 365 est créée ; par défaut, toutes les fonctionnalités sont désactivées.

         

Restrictions

Chaque locataire Microsoft ne peut disposer que d’une seule instance activée du même type de fonctionnalité d’intégration.

Lors de l’activation d’une fonctionnalité, le système vérifie si une autre fonctionnalité activée du même type existe déjà pour le même locataire Microsoft. Si c’est le cas, un message d’erreur s’affiche.

En cas de migration depuis l’ancienne application MyQ Roger, les autorisations relatives aux espaces de stockage cloud ou aux services Microsoft seront révoquées et les utilisateurs seront invités à se reconnecter via la nouvelle application.

Dépannage

Suppression d’intégrations et modification du type d’intégration

Une fois que vous disposez d’une intégration Microsoft existante ou que vous êtes passé d’une application héritée à une application « split », procédez comme suit :

1. Après avoir ajouté une nouvelle intégration avec un locataire Entra, vous devez activer et relancer la synchronisation des utilisateurs en activant l’option « Gérer les utilisateurs existants » dans le modèle de synchronisation des utilisateurs.

2. La connexion, OneDrive, SharePoint et Universal Print doivent être réactivés dans la nouvelle intégration.

3. Les utilisateurs disposant de stockages cloud connectés devront reconnecter chaque instance.

4. Les utilisateurs connectés au cloud devront se réauthentifier dans Roger Client.