Skip to main content

Intune import

Prerequisites​

Access to the Azure Portal or Microsoft Entra admin center, with at least the Application Developer role (or equivalent) in your tenant.

Create a client secret​

  1. In Azure Portal or Entra admin center, go to App registrations, and select your existing app (or + New registration).
  2. Open Certificates & secrets → + New client secret.
  3. Give it a description (e.g. "App authentication secret — expires 2027"), an expiry (6–12 months recommended, 24 months maximum), and Add.
  4. Copy the secret's Value immediately — it's shown only once; store it securely (e.g. in a secrets manager).

You'll also need the app's Application (client) ID and Directory (tenant) ID, both on its Overview page.

Grant Intune permissions​

  1. On the app registration, open API permissions → + Add a permission → Microsoft Graph.
  2. Choose Application permissions (for a background/daemon import) or Delegated permissions (acting on behalf of a signed-in user).
  3. Search "DeviceManagement" for the permissions you need — common least-privilege choices:
PermissionWhat it allows
DeviceManagementManagedDevices.Read.AllRead devices, compliance status, categories — inventory/reporting
DeviceManagementManagedDevices.ReadWrite.AllRead + manage devices (wipe, retire, sync)
DeviceManagementApps.Read.AllRead apps and app configurations
DeviceManagementApps.ReadWrite.AllRead + create/update/delete apps and configs
DeviceManagementConfiguration.Read.AllRead configuration policies and settings
DeviceManagementConfiguration.ReadWrite.AllRead + create/update policies
DeviceManagementServiceConfig.Read.AllRead tenant-wide Intune settings
DeviceManagementServiceConfig.ReadWrite.AllRead + modify tenant-wide Intune settings
DeviceManagementRBAC.Read.AllRead role-based access control settings
DeviceManagementScripts.Read.All / .ReadWrite.AllRead, or read + manage, PowerShell/Shell scripts
  1. Grant admin consent for [your tenant], and confirm — this applies the permissions tenant-wide, and is required before the import can actually read data.

Creating the import source in Starhive​

Use the client ID, tenant ID, and client secret from above to configure the import source.

Not a mockup candidate

The Azure/Entra screens above are Microsoft's own admin console, not Starhive's — not something to mock up from Starhive's frontend code. The final "Creating the import source" step is Starhive's own UI (shared with every other Connection), but isn't mocked up here yet.