This article summarizes the application registration models, authentication settings, redirect URIs, API permissions, and scopes used by MyQ integrations with Microsoft services.
Use this reference when:
-
registering an application manually
-
reviewing an automatically configured enterprise application
-
planning whether integrations can share an application registration
-
troubleshooting permissions, authentication, or consent
For the recommended automatic workflow, see Automatic App Registration.
Registration Models
Some integrations can be configured automatically from MyQ. Other integrations require a manual application registration in Microsoft Entra ID.
For Microsoft Entra ID, OneDrive for Business, and SharePoint Online, manual setup can use one shared application registration or separate application registrations for each integration.
Do not use a shared application with Microsoft Exchange Online or Universal Print.
|
Integration |
Setup |
Registration model |
Client Secret |
Public client flow |
|---|---|---|---|---|
|
Microsoft Entra ID / Microsoft Graph |
Automatic or manual |
Shared or dedicated |
Yes |
No |
|
OneDrive for Business |
Automatic or manual |
Shared with Entra ID/SharePoint, or dedicated |
Yes |
No |
|
SharePoint Online |
Automatic or manual |
Shared with Entra ID/OneDrive, or dedicated |
Yes |
No |
|
Exchange Online |
Manual |
Dedicated |
No |
Yes |
|
Universal Print |
Manual |
Dedicated |
No |
Yes |
A manually registered application can be shared by Microsoft Entra ID, OneDrive for Business, and SharePoint Online, provided it contains all settings and permissions required by the enabled integrations.
Do not share this application registration with Exchange Online or Universal Print. These integrations require dedicated registrations with different authentication configurations.
Application Registration and Service Principal
A manually registered application is represented in two places in the Microsoft Entra admin center:
-
App registrations contains the application definition, including its identifiers, authentication settings, credentials, redirect URIs, and requested API permissions.
-
Enterprise applications contains the service principal representing the application in the customer’s tenant. Access, consent, and tenant-specific permissions are managed here.
Automatic setup creates and configures the service principal used by MyQ.
Information Required by MyQ
For a manually configured integration, obtain the following information from the application’s Overview page:
-
Application (client) ID
-
Directory (tenant) ID
-
Client secret, when required
Redirect URIs
For Microsoft Entra ID, OneDrive for Business, and SharePoint Online, manual setup can use one shared application registration or separate application registrations for each integration.
Microsoft Exchange Online and Universal Print use different application configurations and should not use the shared manual registration procedure for Microsoft Entra ID, OneDrive for Business, and SharePoint Online.
|
Integration or feature |
Setup method |
Platform |
Redirect URI |
|---|---|---|---|
|
Microsoft Entra ID / Microsoft Graph |
Manual |
Web |
|
|
Microsoft Entra ID SSO helper |
Manual |
Single-page application |
|
|
MyQ Desktop Client Seamless SSO |
Manual, when used |
Mobile and desktop applications |
|
|
OneDrive for Business |
Manual |
Web |
|
|
SharePoint Online |
Manual |
Web |
|
|
Microsoft Exchange Online |
Manual |
Mobile and desktop applications |
|
|
Universal Print |
Manual |
Mobile and desktop applications |
Select the mobile and desktop redirect URI in Microsoft Entra ID. |
Replace:
-
{hostname:port}with the hostname and HTTPS port of the MyQ server. -
{Application-client-ID}with the Application client ID of the application registration.
Connecting to the Application from MyQ
If you use automatic registration, MyQ gets the client and tenant information silently.
If you configure any integration manually, get these details from your application registration Overview page:
-
Application (client) ID
-
Directory (tenant)
-
Client secret (Entra ID, OneDrive for Business and SharePoint Online)
Permissions Used During Automatic Setup
The permissions used to create and configure the application are separate from the permissions that the resulting application uses at runtime.
|
Permission |
API |
Type |
Purpose |
|---|---|---|---|
|
|
Microsoft Graph |
Delegated |
Create or update the connector application credential. |
|
|
Microsoft Graph |
Delegated |
Read tenant information, including the default domain name. |
Runtime Permissions
Microsoft Entra ID Permissions
|
Permission |
API |
Type |
Purpose |
|---|---|---|---|
|
|
Microsoft Graph |
Application |
Read groups and group membership. |
|
|
Microsoft Graph |
Application |
Read users. |
|
|
Microsoft Graph |
Delegated |
Sign in and read the signed-in user's profile. |
OneDrive Permissions
|
Permission |
API |
Type |
Purpose |
|---|---|---|---|
|
|
Microsoft Graph |
Delegated |
Read and write files available to the signed-in user. |
|
|
Microsoft Graph |
Delegated |
Identify the signed-in user. |
|
|
Microsoft Graph |
Application |
Access users' files without individual user authorization. |
SharePoint Permissions
|
Permission |
API |
Type |
Purpose |
|---|---|---|---|
|
|
Microsoft Graph |
Delegated |
Identify the signed-in user. |
|
|
Microsoft Graph |
Delegated |
Read and write SharePoint content available to the signed-in user. |
|
|
Microsoft Graph |
Delegated |
Read sites in the tenant. |
|
|
Microsoft Graph |
Application |
Read and write content without individual user authorization. |
Microsoft Exchange Online Permissions
|
Permission |
API |
Type |
Purpose |
|---|---|---|---|
|
|
Microsoft Graph |
Delegated |
Sign in and read the mailbox user's profile. |
|
|
Microsoft Graph |
Delegated |
Read, update, create, and delete email in the user's mailbox. This permission does not include sending mail. |
|
|
Microsoft Graph |
Delegated |
Send email from the user's mailbox. |
Microsoft Universal Print Permissions
|
Permission |
API |
Type |
Purpose |
|---|---|---|---|
|
|
Microsoft Graph |
Delegated |
Read and write printer shares. |
|
|
Microsoft Graph |
Delegated |
Register, read, update, and unregister printers. |
|
|
Universal Print |
Delegated |
Create and register printers. |
|
|
Universal Print |
Application |
Read printers without a signed-in user. |
|
|
Universal Print |
Application |
Read and write printer properties and attributes without a signed-in user. |
|
|
Universal Print |
Application |
Read print-job metadata and payload without a signed-in user. |
|
|
Universal Print |
Application |
Read and write basic print-job metadata without a signed-in user. |
Authentication Scopes
Entra ID / Microsoft Graph
Authentication scopes are used during OAuth or OpenID Connect authentication.
|
Integration |
Scope |
Scope ID |
Purpose |
|---|---|---|---|
|
Microsoft Entra ID / Microsoft Graph |
|
— |
Sign in the user and request an ID token. |
|
Microsoft Entra ID / Microsoft Graph |
|
— |
Request the user's email claim. |
|
Microsoft Entra ID / Microsoft Graph |
|
— |
Request basic profile claims. |
Exchange Online
|
Integration |
Scope |
Scope ID |
Purpose |
|---|---|---|---|
|
Microsoft Exchange Online |
|
— |
Allow MyQ to renew access without requiring the mailbox user to authenticate every time. |
Universal Print
|
Integration |
Scope |
Scope ID |
Purpose |
|---|---|---|---|
|
Universal Print |
|
|
Allow MyQ to use a refresh token to obtain new access tokens. |