Integrations

MyQ Roger supports multiple Microsoft 365 integration features, each implemented through a dedicated Azure App Registration. This approach enables secure and purpose-specific authentication flows using Microsoft Identity and related APIs such as OneDrive, SharePoint, Universal Print, and User Synchronization.

Users also have the option to register and use their own Azure applications, managing the required scopes and permissions independently according to their organizational policies.

Features Supported

Using Integrations with Microsoft 365 you can manage the following aspects of your Roger tenant:

• Login

• User Synchronization

• Universal Print

• OneDrive

Adding a Microsoft Integration

To add a Microsoft 365 application to your MyQ Roger Tenant:

1. In Administration>Integrations select + Add Integration and choose Microsoft (other options will become available with later releases).

   

2. Select Set up manually and choose:

   

   1. Use MyQ Roger application: This option will allow you to use the legacy MyQ Roger App (recommended process) or create integrations with your own custom Azure Apps.

   2. Use my own Microsoft Entra application: You must have existing Azure Active directory where you will:

      1. Create new App registration (https://docs.microsoft.com/en-us/azure/active-directory/develop/quickstart-register-app).

      2. Go to Certificates & secrets and Create new secret. Set an expiration date and copy the secret value (back up the value, it will not be displayed again).

      3. The App registration must have the permission User.Read.All, andGroup.Read.All (if you only want to synchronize certain groups). To set them, select API permissions > Add a permission.

      4. Then in the Add Integration dialogue in the Roger Web UI:

         1. (Optional) Enter the Directory (Tenant) ID: Enter your Azure Entra Tenant ID to restrict Microsoft-related features to that tenant. If left blank, these features can also be used with personal accounts. You can also add the Tenant ID later.

         2. Enter the Application ID: In cases where a pre-Integrations connection with a Microsoft 365 Application existed, this is pre-filled with the former MyQ Roger application, which can be used to maintain the legacy Microsoft integration setup. You can replace it with your current application details.

         3. Enter Application Secret: If the Application ID is changed, the Application Secret must be updated to correspond.

         4. Click Save. The Microsoft 365 Application is created, by default all features are disabled.

            

             

Limitations

Each Microsoft tenant can have only one enabled instance of the same integration feature type.

When enabling a feature, the system checks whether another enabled feature of the same type already exists for the same Microsoft tenant. If it does, an error message is shown.

If switching from the legacy MyQ Roger app, the consents related to cloud storages or Microsoft services will be revoked and users will be prompted to reconnect via the new app.

Split App Integrations (Feature Flag)

This option is currently only available to accounts that have had the feature manually enabled via MyQ Support.

1. In Administration>Integrations select + Add Integration and choose Microsoft.

   

2. Create automatically: Choosing this option will automatically use a predefined set of MyQ Roger applications, one per feature, such as MyQ Roger for OneDrive or MyQ Roger Entra ID Connector. Simply select Create automatically, click Save, click Select tenant, and log into the relevant Entra ID instance.