Azure Custom Application Permissions

Overview

This document is intended to go over the custom permissions necessary for the advanced features of ImmyBot.

Create an App Registration

Navigate to: https://aad.portal.azure.com/

  1. Click on app registration

alt

  1. Click on new registration

alt

  1. Name it something recognizable such as "ImmyBot Custom Application"
  2. Select second radial button for (Any Microsoft Entra ID tenant – Multitenant)"
  3. Add your Web redirect URI
  4. Click Register alt
Warning

Your app registration must have a Web redirect url of https://<your-domain>.immy.bot/consent-callback, replacing <your-domain> appropriately

Grant Permissions

  1. Click on API Permissions

  2. Click Add Permissions

  3. Click on Microsoft Graph alt text

  4. Click on Application Permissions alt text

  5. Add the following permissions

    Permission Permission Type Required Notes
    DelegatedAdminRelationship.Read.All Application Yes
    Directory.Read.All Application Yes
    User.Read Delegated Yes
    DeviceManagementScripts.ReadWrite.All Application No Needed for using the Deploy Immy Agent to Intune task
    DeviceManagementConfiguration.ReadWrite.All Application No Needed for using the Enroll in Autopilot task
    DeviceManagementManagedDevices.ReadWrite.All Application No Needed for using Sync Primary User With Intune task
    Application.ReadWrite.All Application No Needed for using Add Azure Sync Fabric to Tenant task

    alt text

  6. Click Grant Admin Consent for <‘your Azure tenant name’> alt text

Create Client Secret

  1. Click on Certificates & Secrets which is under Manage
  2. Click on New Client Secret
  3. Create a meaningful description
  4. Set the Expires timeline to 24 months
  5. Click Add
  6. Copy the Secret Value and paste it into ImmyBot

Please see GDAP Customers if you want ImmyBot to access your customers’ data.

Note

Copy the Application (client) ID and Client Secret Value into the form in ImmyBot. The form in ImmyBot is located under Show More -> Azure and will be shown when you select Custom for the permission level

Was this article helpful?