Alkalmazás létrehozása Microsoft Defender XDR API-k felhasználó nevében való eléréséhez

Érintett szolgáltatás:

• Microsoft Defender XDR

Ez az oldal bemutatja, hogyan hozhat létre alkalmazásokat, hogy programozott hozzáférést kapjon Microsoft Defender XDR egyetlen felhasználó nevében.

Ha meghatározott felhasználó nélküli Microsoft Defender XDR programozott hozzáférésre van szüksége (például háttéralkalmazás vagy démon írásakor), olvassa el az Alkalmazás létrehozása Microsoft Defender XDR felhasználó nélküli eléréséhez című témakört. Ha több bérlőnek kell hozzáférést biztosítania – például egy nagy szervezetnek vagy egy ügyfélcsoportnak –, olvassa el az Alkalmazás létrehozása partneri hozzáféréssel Microsoft Defender XDR API-khoz című témakört. Ha nem tudja biztosan, hogy milyen típusú hozzáférésre van szüksége, olvassa el az Első lépések című témakört.

Microsoft Defender XDR az adatok és műveletek nagy részét programozott API-k segítségével teszi elérhetővé. Ezek az API-k segítenek automatizálni a munkafolyamatokat, és kihasználni Microsoft Defender XDR képességeit. Ehhez az API-hozzáféréshez OAuth2.0-hitelesítés szükséges. További információ: OAuth 2.0 engedélyezési kódfolyamat.

Ezeknek az API-knak a használatához általában a következő lépéseket kell elvégeznie:

• Hozzon létre egy Microsoft Entra alkalmazást.
• Hozzáférési jogkivonat lekérése ezzel az alkalmazással.
• A jogkivonattal érheti el Microsoft Defender XDR API-t.

Ez a cikk a következő lépéseket ismerteti:

• Microsoft Entra-alkalmazás létrehozása
• Hozzáférési jogkivonat lekérése a Microsoft Defender XDR
• A jogkivonat ellenőrzése

Alkalmazás létrehozása

1. Jelentkezzen be az Azure-ba.

2. Lépjen a Microsoft Entra ID>Alkalmazásregisztrációk>Új regisztráció elemre.

   

3. Az űrlapon válasszon egy nevet az alkalmazásnak, és adja meg a következő adatokat az átirányítási URI-hoz, majd válassza a Regisztráció lehetőséget.

   

   • Alkalmazás típusa: Nyilvános ügyfél
   • Átirányítási URI:https://portal.azure.com

4. Az alkalmazás oldalán válassza az API-engedélyek>Engedély hozzáadása>API-kat>, írja be a Microsoft Threat Protection kifejezést, majd válassza a Microsoft Threat Protection lehetőséget. Az alkalmazás most már hozzáférhet Microsoft Defender XDR.

   Tipp

   A Microsoft Threat Protection a Microsoft Defender XDR korábbi neve, és nem jelenik meg az eredeti listában. A megjelenítendő szövegmezőbe be kell írnia a nevét.

   

   • Válassza a Delegált engedélyek lehetőséget. Válassza ki a forgatókönyv megfelelő engedélyeit (például Incident.Read), majd válassza az Engedélyek hozzáadása lehetőséget.

     

   Megjegyzés:

   Ki kell választania a forgatókönyvéhez tartozó megfelelő engedélyeket. Az összes incidens elolvasása csak egy példa. Annak megállapításához, hogy melyik engedélyre van szüksége, tekintse meg a meghívni kívánt API Engedélyek szakaszát.

   Speciális lekérdezések futtatásához például válassza a "Speciális lekérdezések futtatása" engedélyt; az eszköz elkülönítéséhez válassza a "Gép elkülönítése" engedélyt.

5. Válassza a Rendszergazdai hozzájárulás megadása lehetőséget. Minden alkalommal, amikor hozzáad egy engedélyt, a rendszergazdai hozzájárulás megadása lehetőséget kell választania ahhoz, hogy érvénybe lépjen.

   

6. Jegyezze fel az alkalmazásazonosítót és a bérlőazonosítót biztonságos helyen. Ezek az alkalmazásoldal Áttekintés területén jelennek meg.

   

Hozzáférési jogkivonat lekérése

A Microsoft Entra tokenekről az Microsoft Entra oktatóanyagban talál további információt.

Hozzáférési jogkivonat lekérése egy felhasználó nevében a PowerShell használatával

A MSAL.PS kódtár használatával szerezzen be delegált engedélyekkel rendelkező hozzáférési jogkivonatokat. A hozzáférési jogkivonat felhasználó nevében történő lekéréséhez futtassa az alábbi parancsokat:

Install-Module -Name MSAL.PS # Install the MSAL.PS module from PowerShell Gallery

$TenantId = " " # Paste your directory (tenant) ID here.
$AppClientId="xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" # Paste your application (client) ID here.

$MsalParams = @{
   ClientId = $AppClientId
   TenantId = $TenantId
   Scopes   = 'https://graph.microsoft.com/User.Read.All','https://graph.microsoft.com/Files.ReadWrite','https://api.securitycenter.windows.com/AdvancedQuery.Read'
}

$MsalResponse = Get-MsalToken @MsalParams
$AccessToken  = $MsalResponse.AccessToken
 
$AccessToken # Display the token in PS console

A jogkivonat ellenőrzése

1. Másolja és illessze be a jogkivonatot a JWT-be a dekódolásához.
2. Győződjön meg arról, hogy a dekódolt jogkivonaton belüli szerepkörjogcím tartalmazza a kívánt engedélyeket.

Az alábbi képen egy alkalmazásból beszerzett dekódolt jogkivonatot láthat, amely Incidents.Read.Alla , Incidents.ReadWrite.Alla és AdvancedHunting.Read.All az engedélyekkel rendelkezik:

A jogkivonat használata a Microsoft Defender XDR API eléréséhez

1. Válassza ki a használni kívánt API-t (incidensek vagy speciális veszélyforrás-keresés). További információ: Támogatott Microsoft Defender XDR API-k.
2. Az elküldeni kívánt HTTP-kérelemben állítsa az engedélyezési fejlécet a következőre "Bearer" <token>: , Tulajdonos az engedélyezési séma, a jogkivonat pedig az érvényesített jogkivonat.
3. A jogkivonat egy órán belül lejár. Ez idő alatt több kérést is küldhet ugyanazzal a jogkivonattal.

Az alábbi példa bemutatja, hogyan küldhet kérést az incidensek listájának lekéréséhez a C# használatával.

    var httpClient = new HttpClient();
    var request = new HttpRequestMessage(HttpMethod.Get, "https://api.security.microsoft.com/api/incidents");

    request.Headers.Authorization = new AuthenticationHeaderValue("Bearer", token);

    var response = httpClient.SendAsync(request).GetAwaiter().GetResult();

Kapcsolódó cikkek

• Microsoft Defender XDR API-k áttekintése
• Az Microsoft Defender XDR API-k elérése
• "Hello world" alkalmazás létrehozása
• Alkalmazás létrehozása Microsoft Defender XDR felhasználó nélkül való eléréséhez
• Alkalmazás létrehozása több-bérlős partneri hozzáféréssel Microsoft Defender XDR API-khoz
• További információ az API-korlátokról és a licencelésről
• A hibakódok ismertetése
• OAuth 2.0-hitelesítés felhasználói bejelentkezéshez és API-hozzáféréshez