Microsoft Intune

Prev Next

Microsoft Intune is a cloud-based endpoint management solution. Intune simplifies app and device management across your device portfolio, including mobile devices, desktop computers, and virtual endpoints. For more information, refer to Microsoft’s official documentation.

Integration Method: API

Tables: Account Change (3001), Entity Management (3004), Group Management (3006), Device Inventory Info (5001), User Inventory Info (5003)

Following events are supported by this integration.

Events

Description

Devices

List properties and relationships of the managedDevice objects.

Audits

Get the list of audit logs generated by Microsoft Entra ID.

Detected Apps

Get the list of applications found.

This integration supports the following versions.

Microsoft Graph API version

v1.0

Prerequisites

  • Access to the Azure portal with an account that has the Global Administrator role. 

  • Access to the DataBee console.

Configuration Overview

  1. Create an application with required permissions to fetch the data.

  2. Create Microsoft Intune Data Feed in the DataBee console with the required Client credentials.

    DataBee Feed Parameter

    Azure Parameter

    Client Key

    Application (client) ID

    Client Secret

    Client Secret Value

    Token URL(<application_id>)

    Directory (Tenant) ID

Azure Configuration

Create an application

  1. Log on to Azure portal with an account that has the Global Administrator role.  

  2. In the search bar, search for App Registrations and select it.
     

  3. On the “App registrations” page, select New registration, theRegister an application” window will appear.
     

  4. On the “Register an application” window:

    1. Under ‘Name’ enter your Application Name then click on Register to create the application.
       

  5. On the app Overview page, copy the Application (client) ID and Directory (tenant) ID for later use.
     Picture 1816940222, Picture 

 

Add Endpoint Access  

Once the application is created, following three permissions are needed on the Graph API.

  • DeviceManagementManagedDevices.Read.All,

  • AuditLog.Read.All

  • Directory.Read.All

This section details how to configure and add permissions to the required endpoints.  

Add Permissions  

From the Azure Active Directory portal:  

  1. Select the application registered in the previous step.

  2. Under Manage, click API Permissions and then click Add a Permission, the “Request API permissions” window will appear. 
     

  3. On “Request API permissions” window, Click on Microsoft APIs then on Microsoft Graph.
     

  4. Click on Application Permissions.
     

  5. The following permissions need to be granted for the endpoint to function properly:  

    Event

    Type

     Permission  

    Devices

    Application

    DeviceManagementManagedDevices.Read.All  

    Audits

    Application

    AuditLog.Read.All

    Audits

    Application

    Directory.Read.All

    Detected Apps

    Application

    DeviceManagementManagedDevices.Read.All

  6. In the Select permissions search bar, enter the permission shown above, and check the box to include them. 
     

  7. Click the Add permissions button after selecting all required permissions.
     

  8. On the “API permissions” page, click Grant Admin Consent for <tenant>
     

  9. Click the Yes button on the consent confirmation.
     

  10. The required permissions are now added for the endpoints. 
     

Create the Client Secret

The final step to access the APIs is creating a Client Secret. To create it from the Azure Portal:  

  1. Select the application created above.

  2. Under Manage, Click Certificates and Secrets, and then Client Secrets
     

  3. Click New client secret. Then “Add a client secret” window appears.
     

  4. In the “Add a client secret” window:

    1. Enter a ‘Description’ for this client secret and select the desired expiry period from the ‘Expires’ drop-list.

    2. Then click on Add to create the client secret.
       

      Note:

      The user needs to re-create the client secret when it expires.

  5. Copy the Value fields for later use.
     

DataBee Configuration

  1. Login to the DataBee UI, navigate to Data > Data Feeds and click the Add New Data Feed button.
     

  2. Search for the Microsoft Intune and select it.
     

  3. Click on the API Ingest.
     

  4. Enter feed contact information and click Next.
     

  5. In the configuration page, enter the following:

    • Authorization Method: OAuth2

    • Client Key: paste the Application (client) ID generated earlier.

    • Client Secret: paste the Client Secret value generated earlier.

    • Token URL: replace <application_id> placeholder with the Directory (Tenant) ID generated earlier.

  6. Click Submit.
     

Troubleshooting Tips

  • If you are facing an invalid client or unauthorized client error this might be possibly due to incorrect credentials. Ensure the client key, client secret and Tenant ID are pasted correctly. Since you cannot view the client secret after the 1st time, re-create it, paste it on a text editor to ensure no spaces or unexpected characters are included and reconfigure the DataBee feed.

  • If you are facing a 403-response code this might be possibly due to missing permission. Ensure that all the required permissions are granted correctly as per the above-mentioned steps.