Breadcrumbs

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.

Prior to MyQ Roger Server 2.20, Integration options were managed through Entra ID User Synchronization, Microsoft Universal Print, and Cloud Services Settings. For accounts that managed integrations in this way, the system will continue to support previous settings including all necessary scopes (OneDrive, SharePoint, Universal Print, User Synchronization, and email) under two app registrations, one covering User Synchronization, the other covering the remaining features. This ensures a smooth transition for existing integrations while supporting more granular configurations in the future.

If you experience difficulties using the features in Integrations, for example connecting cloud storages or synchronizing users, please Reapply Consents.

What has Changed?

Integrations were released with Roger Server 2.20 making significant changes to the way your Roger tenant connects with Microsoft 365. A single-app model is no longer used, meaning:

  • Pre-Integrations: All Microsoft features used the same client app.

  • Post-Integrations: Post-Integrations, you will be able to choose to create either:

    • Split Applications: Created automatically using a MyQ Roger Application, Each integration feature will have a dedicated app registration in the MyQ Azure tenant.

      image-20260427-073025.png

    • Custom Applications: Created manually, functions as a Microsoft connection did before Roger 2.20 was released. We do not recommend creating a Custom Application unless you are experienced in creating Microsoft Entra ID Applications.

      image-20260427-073108.png

  • Stored tokens will now be:

    • Bound to specific integration features (Login, User Synchronization, Universal Print, OneDrive)

    • Bound to specific Microsoft organizations (directories/tenants)

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).

    image-20260413-105010.png

  2. Select how to add the integration:

    1. 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.

      image-20260413-105042.png
      image-20260427-073441.png

    2. Set up manually: This option will allow you to use the legacy MyQ Roger App (recommended process) or create integrations with your own custom Azure Apps.

      image-20260413-105127.png

  3. If you selected Set up manually:

    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.

      image-20260413-105159.png

       

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.