Skip to main content

Connect to Intune

To upload packages to Microsoft Intune using Master Packager Toolbox, you must first connect to your Intune tenant. There are two connection options:

  • Option 1: Sign in with Microsoft Account — sign in and approve the required permissions. Recommended for most users.
  • Option 2: Custom Application Registration — register your own Microsoft Entra application for full control over permissions. Recommended for advanced users.

Option 1: Sign in with Microsoft Account

Sign in using an account that has one of the following roles in your Microsoft Entra tenant:

  • Global Administrator
  • Cloud Application Administrator
  • Application Administrator

This is required to register a Microsoft Entra application that allows Master Packager Toolbox to communicate with the Microsoft Graph API.

note

This registration only needs to be done once. After the application is registered, any user in your tenant can sign in — not just administrators.

If you do not have the required permissions, you will receive the following message:

Microsoft Entra "Need admin approval" dialog shown when the signed-in account cannot consent to the Master Packager Toolbox Intune app

If your organization has allowed users to request admin approval, you will see the following message instead:

Microsoft Entra "Approval required" dialog listing the requested Intune permissions with a justification field for requesting admin approval

If you have the required permissions, tick the consent checkbox and click Accept.

Microsoft Entra "Permissions requested" dialog with the "Consent on behalf of your organization" checkbox and the Accept button

Option 2: Custom Application Registration

If you need more control over the permissions granted to the application, you can register your own Microsoft Entra application. Follow the Microsoft guide: Register an application.

Microsoft Entra admin center "Register an application" page showing the Name, Supported account types, and Redirect URI fields

Step 1: Configure API Permissions

Once you have registered your application, open the API permissions section and add the permissions listed below as Delegated permissions under Microsoft Graph.

Required Permissions

These permissions are mandatory for Master Packager Toolbox to function:

PermissionDescription
DeviceManagementApps.ReadWrite.AllRead and write Microsoft Intune apps. Without this permission, you cannot upload apps.
offline_accessMaintain access to data without requiring repeated sign-ins.
openidAllow users to sign in with their work or school accounts.
profileAccess basic user profile information (name, picture, email address).

Optional Permissions

These permissions enhance functionality but are not required:

PermissionDescription
Group.Read.AllRead all groups. Required to assign Intune applications to groups.
Organization.Read.AllRead organization information. Required to display tenant name and logo.

API permissions page of a custom Microsoft Entra app registration showing the Add a permission and Grant admin consent options

Request API permissions pane with Delegated permissions selected and the DeviceManagementApps.ReadWrite.All Microsoft Graph permission ticked

Step 2: Configure Authentication

After adding the permissions, navigate to the Authentication section and add a redirect URI.

Authentication section of a Microsoft Entra app registration showing Platform configurations and the Add a platform button

  1. Click Add a platform and select Mobile and desktop applications.

  2. Under Custom redirect URIs, add the following URI, replacing <Your-Application-ID> with the Application (client) ID from the application's Overview page:

    ms-appx-web://Microsoft.AAD.BrokerPlugin/<Your-Application-ID>

Redirect URIs page with the ms-appx-web://Microsoft.AAD.BrokerPlugin custom redirect URI entered for the Mobile and desktop applications platform

Step 3: Apply the Application ID in Master Packager Toolbox

  1. Open Master Packager Toolbox and go to Settings.
  2. Under Intune Settings, expand Intune connection settings.
  3. Click the edit icon and enter the Application (client) ID of the application you registered in Microsoft Entra.
  4. Check that Scopes matches the API permissions granted to that application in Microsoft Entra.
  5. Go to the Intune section and click Add Tenant.

Intune connection settings in Master Packager Toolbox showing the Application (client) ID, Tenant ID, and Scopes fields for a custom Microsoft Entra app registration

warning

The scopes listed here must not request more than the API permissions granted to your application in Microsoft Entra. If a scope is requested that the application was not granted, the connection fails. Remove any scope you did not add in Step 1 — for example, remove Group.Read.All and Organization.Read.All if you granted only the required permissions.

The sign-in window uses your custom Application ID and scopes instead of the default ones. Sign in with your credentials.

You are now ready to upload packages to Intune.