Microsoft Endpoint Manager - Multi Tenant

Microsoft Endpoint Manager syncs your hardware assets via API to ScalePad

Use this guide to integrate ScalePad with Microsoft Endpoint Manager. Two configured applications are required to grant access to the device and software information of your tenant and your customer tenants, in order to integrate Microsoft Endpoint Manager with ScalePad.

📘

Known limitation with indirect or unmanaged resellers

The Microsoft Endpoint Manager integration does not support indirect or unmanaged resellers because you need direct access to manage client devices. Indirect providers and Cloud Solution Provider (CSP) direct partners should have no issues, but this is something to be aware of if you purchase through a reseller.

Prerequisites

To use either Microsoft Endpoint Manager integration, users will need:

  • Work (or school) accounts from Microsoft. This includes organizations that use Office 365
  • An active Intune subscription
  • Administrator user credentials for ScalePad, Microsoft Azure, and Microsoft Partner.

Microsoft Partner application setup

Granting Partner application application process

  1. Sign in to your Microsoft Partner Center Dashboard using a global administrator account.
  2. From the Settings menu (gear icon), select Account settings.
  1. On the Account settings page, choose App management.
  2. If
    • You do not have an existing web app registered:
      • Add a new web app
    • You have an existing web app registered:
      • Choose the Add key button
  3. The keys are in the table below the app details. Copy the app registration details:
  • App ID / Client ID
  • Account ID / Tenant ID
  • Key / Client secret

🚧

The Key value is not retrievable after navigating away from the page, so please ensure it is recorded in a safe place.

Configuring Parter application permissions

  1. Sign in to Azure AD from the Azure portal using a global administrator account.
  2. From the Azure Directory admin center, navigate to Azure Active Directory > App registrations > All applications.
  3. Select the application that is registered to the Partner Center in the previous step by using the App Name. By default, this may be called Partner Center Web App.
  1. Navigate to the API permissions section
  2. Ensure that the application has the delegated permissions with admin consent (if this is not the case, see below):
  • Azure Active Directory Graph
    • Directory.AccessAsUser.All
    • User.Read
  • Microsoft Partner Center
    • User_impersonation
  1. Grant the following application permission to:
  • Azure Active Directory Graph
    • Directory.Read.All

If the application does not have the delegated permissions:

  1. Click the add a permission button
  2. In the Request API permissions screen, select APIs my organization uses
  3. Select Windows Azure Active Directory, and then Delegated Permissions
  4. Search and select: User.Read
  5. Search and select: Directory.AccessAsUser.All
  6. Search and select: user_impersonation
  7. Click Add permissions
  8. Click Grant admin consent

Microsoft ScalePad application setup

Creating the ScalePad application setup

We recommend creating a dedicated application that ScalePad uses to access device and software information.

  1. Sign in to Microsoft Azure as a global administrator
  2. From the Azure Directory admin center, navigate to Azure Active Directory > App registrations
  3. Click the +New Registration button
  4. Enter a user-facing display name for the new application registration (for example, ScalePad MEM Integration).
  5. Under Supported account types, make sure Accounts in any organizational directory (Any Azure AD directory – Multitenant) is selected. The rest of the defaults for registration should be left as is.
  6. Click Register to create the application
  7. Under your newly created application, take note of the Application (client) ID and the Directory (tenant) ID.

🚧

When adding the Microsoft Endpoint Manager integration to ScalePad, you will need to add the Application (client) ID and Directory (tenant) ID to the Microsoft Endpoint Manager add integration page .


Configuring ScalePad application permissions

Users/admins are required to grant permissions to applications before they can call APIs. For full functionality, the following permissions are required:

  • Organization.Read.All
  • DeviceManagementManagedDevices.Read.All
  • DeviceManagementApps.Read.All
  1. Navigate to the API permissions section
  2. Click the Add a permission button
  3. In the Request API permissions screen, select Microsoft Graph and then select Application permissions
  4. In the Select permissions section, click the arrows next to DeviceManagementManagedDevices, DeviceManagementManagedApps, and Organization to expand each section or start typing the permission to filter the results.
    • In the DeviceManagementManagedApps module, select the
      DeviceManagementApps.Read.All.
    • In the DeviceManagementManagedDevices module, select the
      DeviceManagementManagedDevices.Read.All.
    • In the Organization module, select the Organization.Read.All.
  5. Click Add permissions

🚧

After adding permissions, you need to add administrator consent for each permission name.

  1. After selecting Add permissions, we will need to add administrator consent. This is done by selecting Grant admin consent

Configuring ScalePad application process:

  1. Navigate to the Azure Active Directory > Groups section
  2. Search for AdminAgents, and then select it. The name must only be AdminAgents
  3. Navigate to the Members section for the group
  4. Select Add members, and search for the ScalePad application that was created (e.g. ScalePad MEM Integration), then click Select.

Granting ScalePad application process

Client secrets, also known as application passwords, are secret strings that the application uses to prove its identity when it requests a token.

  1. Navigate to the Certificates & secrets section
  2. In the Client secrets section, click the New client secret button
  3. Add a description for the client secret. After entering a description, we recommend leaving the default expiry settings to 6 months.

📘

Why 6 months for expiry?

We follow Microsoft's recommendation of a 6-month expiration for client secrets as this period of time is a balance between securing the application's access and convenience of use for our partners. Expiry dates can range from 1 day to 2 years, but Microsoft client secrets must expire eventually. Before a client secret expires, a new one can be created and saved in the existing integration with no downtime.

  1. Click the Add button.
  2. Take note of the Secret ID, as this value is required when adding the integration to ScalePad.

🚧

Keep it private

Keep the Client secret value in a secure location, because this value is not recoverable once navigating away.


Adding ScalePad integration

  1. Navigate to the Microsoft Endpoint Manager Multi-Tenant add integration page and fill in the following information gathered previously, mapping to the following fields:
  • Microsoft Partner Account ID --> Azure Tenant ID
  • Microsoft Partner App ID --> Partner Application (client) ID
  • Microsoft Partner App Key --> Partner Application Client Secret
  • Microsoft ScalePad App ID --> ScalePad Application (client) ID
  • Microsoft ScalePad App Key --> ScalePad Application Client Secret
  1. Click Save Microsoft Endpoint Manager Setup

👍

Setup successful

When you click Save Microsoft Endpoint Manager (Multi-Tenant) Setup, ScalePad will perform a full sync. When finished, you should be able to view your hardware assets in your account, as well as any software assets.

Updated 11 days ago

Microsoft Endpoint Manager - Multi Tenant


Microsoft Endpoint Manager syncs your hardware assets via API to ScalePad

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.