Jaa


Sovelluksen luominen Microsoft Defender XDR ohjelmointirajapintojen käyttämiseksi käyttäjän puolesta

Koskee seuraavia:

  • Microsoft Defender XDR

Tärkeää

Jotkin tiedot liittyvät tuotteen ennakkoon, jota voidaan muuttaa huomattavasti ennen kaupallista julkaisua. Microsoft ei anna nimenomaisia eikä oletettuja takuita tässä annetuista tiedoista.

Tällä sivulla kuvataan, miten luodaan sovellus, jolla saadaan Microsoft Defender XDR ohjelmallinen käyttöoikeus yksittäisen käyttäjän puolesta.

Jos tarvitset Microsoft Defender XDR ohjelmallisen käyttöoikeuden ilman määritettyä käyttäjää (esimerkiksi jos kirjoitat taustasovellusta tai daemonia), katso Sovelluksen luominen Microsoft Defender XDR käyttämiseksi ilman käyttäjää. Jos tarvitset käyttöoikeuden useille vuokraajille – jos esimerkiksi palvelet suurta organisaatiota tai asiakasryhmää – katso Sovelluksen luominen kumppanin kanssa Microsoft Defender XDR-ohjelmointirajapintojen kautta. Jos et ole varma, millaisen käyttöoikeuden tarvitset, katso Aloittaminen.

Microsoft Defender XDR paljastaa suuren osan tiedoistaan ja toiminnoistaan ohjelmallisten ohjelmointirajapintojen avulla. Näiden ohjelmointirajapintojen avulla voit automatisoida työnkulkuja ja hyödyntää Microsoft Defender XDR ominaisuuksia. Tämä ohjelmointirajapinnan käyttö edellyttää OAuth2.0-todennusta. Lisätietoja on artikkelissa OAuth 2.0 -valtuutuskoodin kulku.

Yleensä sinun on suoritettava seuraavat vaiheet, jotta voit käyttää näitä ohjelmointirajapintoja:

  • Luo Microsoft Entra sovellus.
  • Hanki käyttöoikeustietue tämän sovelluksen avulla.
  • Käytä tunnusta Microsoft Defender XDR-ohjelmointirajapintaan.

Tässä artikkelissa kerrotaan, miten:

  • Microsoft Entra sovelluksen luominen
  • Hanki Microsoft Defender XDR käyttöoikeustietue
  • Tunnuksen vahvistaminen

Huomautus

Kun käytät Microsoft Defender XDR-ohjelmointirajapintaa käyttäjän puolesta, tarvitset oikeat sovelluksen käyttöoikeudet ja käyttöoikeudet.

Vihje

Jos sinulla on oikeus suorittaa toiminto portaalissa, sinulla on oikeus suorittaa toiminto ohjelmointirajapinnassa. Lisätietoja rooleista ja käyttöoikeuksista on artikkelissa Microsoft Defender XDR käyttöoikeuksien hallinta Microsoft Entra yleisillä rooleilla.

Luo sovellus

  1. Kirjaudu sisään Azureen.

  2. Siirry kohtaan Microsoft Entra ID>Sovelluksen rekisteröinnit>Uusi rekisteröinti.

    Uusi rekisteröinti -vaihtoehto Azure-portaali Hallinta-ruudussa

  3. Valitse lomakkeeseen sovelluksesi nimi ja anna seuraavat tiedot uudelleenohjauksen URI:lle ja valitse sitten Rekisteröi.

    Sovelluksen rekisteröintiruutu Azure-portaali

  4. Valitse sovellussivulla ohjelmointirajapinnan käyttöoikeudetLisää käyttöoikeuksien>ohjelmointirajapinnat>, joita organisaationi käyttää>, kirjoita Microsoft Threat Protection ja valitse Microsoft Threat Protection. Sovelluksesi voi nyt käyttää Microsoft Defender XDR.

    Vihje

    Microsoft Threat Protection on Microsoft Defender XDR entinen nimi, eikä sitä näytetä alkuperäisessä luettelossa. Sinun on alettava kirjoittaa sen nimeä tekstiruutuun, jotta näet sen näkyvän.

    Organisaatiosi ohjelmointirajapinnat-ruutu Microsoft Defender portaalissa

    • Valitse Delegoidut käyttöoikeudet. Valitse skenaarioon liittyvät käyttöoikeudet (esimerkiksi Tapaus.Luku) ja valitse sitten Lisää käyttöoikeuksia.

      Delegoidut käyttöoikeudet -ruutu Microsoft Defender portaalissa

    Huomautus

    Sinun on valittava skenaarioon liittyvät käyttöoikeudet. Kaikkien tapausten lukeminen on vain esimerkki. Voit selvittää, minkä käyttöoikeuden tarvitset, katsomalla käyttöoikeusosiota ohjelmointirajapinnassa, johon haluat soittaa.

    Jos haluat esimerkiksi suorittaa kehittyneitä kyselyitä, valitse Suorita kehittyneet kyselyt -käyttöoikeus. jos haluat eristää laitteen, valitse Eristä kone -käyttöoikeus.

  5. Valitse Myönnä järjestelmänvalvojan suostumus. Aina, kun lisäät käyttöoikeuden, sinun on valittava Myönnä järjestelmänvalvojan suostumus , jotta se tulee voimaan.

    Järjestelmänvalvojan suostumuksen myöntämisruutu Microsoft Defender portaalissa

  6. Tallenna sovellustunnuksesi ja vuokraajatunnuksesi jonnekin turvalliseen paikkaan. Ne on lueteltu sovellussivulla Yleiskatsaus-kohdassa .

    Yleiskatsaus-ruutu Microsoft Defender portaalissa

Käyttöoikeustietueen hankkiminen

Lisätietoja Microsoft Entra tunnuksista on Microsoft Entra opetusohjelmassa.

Käyttöoikeustietueen hankkiminen käyttäjän puolesta PowerShellin avulla

MSAL.PS kirjaston avulla voit hankkia käyttöoikeustietueita, joilla on delegoidut käyttöoikeudet. Saat käyttöoikeustietueen käyttäjän puolesta suorittamalla seuraavat komennot:

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

Tunnuksen vahvistaminen

  1. Kopioi ja liitä tunnus JWT :hen sen koodaamiseksi.
  2. Varmista, että koodatun tunnuksen roolit sisältävät halutut käyttöoikeudet.

Seuraavassa kuvassa näet sovelluksesta hankitun koodatun tunnuksen, jolla on Incidents.Read.All, Incidents.ReadWrite.Allja AdvancedHunting.Read.All -käyttöoikeudet:

Käyttöoikeudet-osa Microsoft Defender portaalin Koodatun tunnuksen ruudussa

Microsoft Defender XDR-ohjelmointirajapinnan käyttäminen tunnuksen avulla

  1. Valitse ohjelmointirajapinta, jota haluat käyttää (tapaukset tai kehittynyt metsästys). Lisätietoja on kohdassa Tuetut Microsoft Defender XDR-ohjelmointirajapinnat.
  2. Määritä lähetettävässä http-pyynnössä valtuutusotsikoksi "Bearer" <token>, haltija on valtuutusmalli ja tunnus on vahvistettu tunnus.
  3. Tunnus vanhenee tunnin kuluessa. Voit lähettää tänä aikana useamman kuin yhden pyynnön samalla tunnuuksella.

Seuraavassa esimerkissä näytetään, miten voit lähettää pyynnön, jotta saat luettelon tapauksista C#:n avulla.

    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();

Vihje

Haluatko tietää lisää? Ota yhteyttä Microsoft Security -yhteisöön Tech Community -yhteisössä: Microsoft Defender XDR Tech Community.