Hämta data från Intune Data Warehouse API med en REST-klient

Du kan komma åt den Intune Data Warehouse datamodellen via RESTful-slutpunkter. För att få åtkomst till dina data måste klienten auktorisera med Microsoft Entra ID med OAuth 2.0. För att aktivera åtkomst konfigurerar du först en inbyggd app i Azure och beviljar behörigheter till Microsoft Intune API. Din lokala klient får auktorisering och sedan kan klienten kommunicera med Data Warehouse slutpunkterna via den inbyggda appen.

Stegen för att konfigurera en klient för att hämta data från Data Warehouse API kräver att du:

1. Skapa en klientapp som en inbyggd app i Azure
2. Ge klientappen åtkomst till Microsoft Intune API
3. Skapa en lokal REST-klient för att hämta data

Använd följande steg för att lära dig hur du auktoriserar och kommer åt API:et med en REST-klient. Först ska du titta på hur du använder en allmän REST-klient med Postman. Postman är ett vanligt verktyg för felsökning och utveckling av REST-klienter som ska fungera med API:er. Mer information om Postman finns på Postmans webbplats. Sedan kan du titta på ett C#-kodexempel. Exemplet innehåller ett exempel på hur du auktoriserar en klient och hämtar data från API:t.

Skapa en klientapp som en inbyggd app i Azure

Skapa en inbyggd app i Azure. Den här inbyggda appen är klientappen. Klienten som körs på den lokala datorn refererar till Intune Data Warehouse-API:et när den lokala klienten begär autentiseringsuppgifter.

1. Logga in på Microsoft Entra administrationscenter.
2. Välj Microsoft Entra ID>Appregistreringar för att öppna fönstret Appregistreringar.
3. Välj Ny appregistrering.
4. Skriv appinformationen.
   1. Ange ett eget namn, till exempel "Intune Data Warehouse Client" för namnet.
   2. Välj Konton endast i den här organisationskatalogen (endast Microsoft – Enskild klientorganisation) för de kontotyper som stöds.
   3. Ange en URL för omdirigerings-URI:n. Omdirigerings-URI:n beror på det specifika scenariot, men om du planerar att använda Postman skriver du https://www.getpostman.com/oauth2/callback. Du använder motringningen för klientautentiseringssteget när du autentiserar till Microsoft Entra ID.
5. Välj Registrera.
6. Anteckna program-ID (klient) för den här appen. Du kommer att använda ID:t i nästa avsnitt.

Ge klientappen åtkomst till Microsoft Intune API

Nu har du en app definierad i Azure. Bevilja åtkomst från den inbyggda appen till Microsoft Intune API.

1. Logga in på Microsoft Entra administrationscenter.
2. Välj Microsoft Entra ID>Appregistreringar för att öppna fönstret Appregistreringar.
3. Välj appen som du behöver för att bevilja åtkomst. Du gav appen ett namn, till exempel Intune Data Warehouse Klient.
4. Välj API-behörigheter>Lägg till en behörighet.
5. Hitta och välj Intune API. Det heter Microsoft Intune API.
6. Välj rutan Delegerade behörigheter och klicka på rutan Hämta informationslagerinformation från Microsoft Intune.
7. Klicka på Lägg till behörigheter.
8. Du kan också välja Bevilja administratörsmedgivande för Microsoft i fönstret Konfigurerade behörigheter och sedan välja Ja. Detta ger åtkomst till alla konton i den aktuella katalogen. Det gör att dialogrutan för medgivande inte visas för alla användare i klientorganisationen. Mer information finns i Integrera program med Microsoft Entra ID.
9. Välj Certifikat & hemligheter>+ Ny klienthemlighet och generera en ny hemlighet. Se till att kopiera den på en säker plats eftersom du inte kommer att kunna komma åt den igen.

Hämta data från Microsoft Intune API med Postman

Du kan arbeta med Intune Data Warehouse-API:et med en allmän REST-klient, till exempel Postman. Postman kan ge insikter om funktionerna i API:et, den underliggande OData-datamodellen och felsöka anslutningen till API-resurserna. I det här avsnittet hittar du information om hur du genererar en Auth2.0-token för din lokala klient. Klienten behöver token för att autentisera med Microsoft Entra ID och komma åt API-resurserna.

Information som du behöver för att ringa samtalet

Du behöver följande information för att ringa ett REST-anrop med Postman:

OData-slutpunkt

Du behöver även slutpunkten. För att få din Data Warehouse slutpunkt behöver du den anpassade feed-URL: en. Du kan hämta OData-slutpunkten från fönstret Data Warehouse.

1. Logga in på Microsoft Intune administrationscenter.
2. Öppna fönstret Data Warehouse genom att välja Reports>Data warehouse.
3. Kopiera URL:en för den anpassade feeden under OData-feed för rapporteringstjänsten. Den ska se ut ungefär så här: https://fef.tenant.manage.microsoft.com/ReportingService/DataWarehouseFEService?api-version=v1.0

Slutpunkten har följande format: https://fef.{yourtenant}.manage.microsoft.com/ReportingService/DataWarehouseFEService/{entity}?api-version={verson-number}

Entiteten dates ser till exempel ut så här:https://fef.tenant.manage.microsoft.com/ReportingService/DataWarehouseFEService/dates?api-version=v1.0

Mer information finns i Intune Data Warehouse API-slutpunkt.

Ring REST-samtalet

Om du vill hämta en ny åtkomsttoken för Postman måste du lägga till auktoriserings-URL: en för Microsoft Entra, lägga till ditt klient-ID och din klienthemlighet. Postman läser in auktoriseringssidan där du skriver in dina autentiseringsuppgifter.

Innan du ringer kontrollerar du att du redan har lagt till motringnings-URL:en i din app i Azure. Motringnings-URL:en är https://www.getpostman.com/oauth2/callback.

Lägg till informationen som används för att begära token

1. Ladda ned Postman om du inte redan har det installerat. Information om hur du laddar ned Postman finns i www.getpostman.com.

2. Öppna Postman. Välj HTTP-åtgärden GET.

3. Klistra in slutpunkts-URL:en i adressen. Den ska se ut ungefär så här:

   https://fef.tenant.manage.microsoft.com/ReportingService/DataWarehouseFEService/dates?api-version=v1.0

4. Välj fliken Auktorisering och välj OAuth 2.0 i listan Typ .

5. Rulla nedåt till avsnittet Konfigurera ny token .

6. Skriv bearer för tokennamnet.

7. Välj Auktoriseringskod som beviljandetyp.

8. Lägg till motringnings-URL:en. Motringnings-URL:en är https://www.getpostman.com/oauth2/callback.

9. Lägg till autentiserings-URL:en. Den ska se ut ungefär så här:

   https://login.microsoftonline.com/common/oauth2/authorize?resource=https://api.manage.microsoft.com/

10. Lägg till URL:en för åtkomsttoken. Den ska se ut ungefär så här:

    https://login.microsoftonline.com/common/oauth2/token

11. Lägg till klient-ID från den inbyggda appen som du skapade i Azure och namngav Intune Data Warehouse Client. Den ska se ut ungefär så här:

    88C8527B-59CB-4679-A9C8-324941748BB4

12. Lägg till klienthemligheten som du genererade inifrån den inbyggda appen som du skapade i Azure. Den ska se ut ungefär så här:

    Ksml3dhDJs+jfK1f8Mwc8

13. Välj Hämta ny åtkomsttoken.

    

14. Skriv dina autentiseringsuppgifter på sidan Active AD-auktorisering. Listan över token i Postman innehåller nu token med namnet Bearer.

15. Välj Använd token. Listan med rubriker innehåller det nya nyckelvärdet för Auktorisering och värdet Bearer <your-authorization-token>.

Skicka samtalet till slutpunkten med Postman

1. Välj Skicka.

2. Returdata visas i Postman-svarstexten.

   

Skapa en REST-klient (C#) för att hämta data från Intune Data Warehouse

Följande exempel innehåller en enkel REST-klient. Koden använder klassen httpClient från .NET-biblioteket . När klienten får autentiseringsuppgifter för Microsoft Entra ID skapar klienten ett GET REST-anrop för att hämta datumentiteten från Data Warehouse API.

1. Öppna Microsoft Visual Studio.

2. Välj Arkiv,>Nytt projekt. Expandera Visual C# och välj Konsolapp (.NET Framework).

3. Namnge projektetIntuneDataWarehouseSamples, bläddra till den plats där du vill spara projektet och välj sedan OK.

4. Högerklicka på namnet på lösningen i Prieskumník riešení och välj sedan Hantera NuGet-paket för lösning. Välj Bläddra och skriv Microsoft.Identity.Client sedan i sökrutan.

   Obs!

   Du måste använda Microsofts autentiseringsbibliotek (MSAL). Mer information finns i Uppdatera dina program så de använder Microsofts autentiseringsbibliotek (MSAL) och Microsoft Graph API.

5. Välj paketet, välj projektet IntuneDataWarehouseSamples under Hantera paket för din lösning och välj sedan Installera.

6. Välj Jag accepterar för att acceptera NuGet-paketlicensen.

7. Öppna Program.cs från Prieskumník riešení.

   

8. Ersätt koden i Program.cs med följande kod:

   namespace IntuneDataWarehouseSamples
   {
   using System;
   using System.Net.Http;
   using System.Net.Http.Headers;
   using Microsoft.Identity.Client;
   
   class Program
   {
    static void Main(string[] args)
   {
   /**
   * TODO: Replace the below values with your own.
   * emailAddress - The email address of the user that you will authenticate as.
   *
   * password  - The password for the above email address.
   *    This is inline only for simplicity in this sample. We do not
   *    recommend storing passwords in plaintext.
   *
   * applicationId - The application ID of the native app that was created in AAD.
   *
   * warehouseUrl   - The data warehouse URL for your tenant. This can be found in
   *      the Microsoft Intune admin center.
   *
   * collectionName - The name of the warehouse entity collection you would like to
   *      access.
   */
   var emailAddress = "intuneadmin@yourcompany.com";
   var password = "password_of(intuneadmin@yourcompany.com)";
   var applicationId = "<Application ID>";
   var warehouseUrl = "https://fef.{yourinfo}.manage.microsoft.com/ReportingService/DataWarehouseFEService?api-version=v1.0";
   var collectionName = "dates";
   
   var msalContext = new AuthenticationContext("https://login.windows.net/common/oauth2/token");
   AuthenticationResult authResult = msalContext.AcquireTokenAsync(
   resource: "https://api.manage.microsoft.com/",
   clientId: applicationId,
   userCredential: new UserPasswordCredential(emailAddress, password)).Result;
   
   var httpClient = new HttpClient();
   httpClient.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", authResult.AccessToken);
   
   var uriBuilder = new UriBuilder(warehouseUrl);
   uriBuilder.Path += "/" + collectionName;
   
   HttpResponseMessage response = httpClient.GetAsync(uriBuilder.Uri).Result;
   
   Console.Write(response.Content.ReadAsStringAsync().Result);
   Console.ReadKey();
   }
   }
   }
   

9. TODOUppdatera s i kodexemplet.

10. Tryck på Ctrl + F5 för att skapa och köra Intune. DataWarehouseAPIClient-klient i felsökningsläge.

    

11. Granska konsolens utdata. Utdata innehåller data i JSON-format som hämtats från datumentiteten i Intune klientorganisationen.

Nästa steg

Information om auktorisering, API-URL-strukturen och OData-slutpunkter finns i Använd Intune Data Warehouse-API:et.

Du kan också referera till Intune Data Warehouse datamodellen för att hitta de dataentiteter som finns i API:t. Mer information finns i Intune Data Warehouse API-datamodell.