Uç Nokta API'leri için Microsoft Defender üzerinden iş ortağı erişimi

Şunlar için geçerlidir:

• Uç Nokta için Microsoft Defender Planı 1
• Uç Nokta için Microsoft Defender Planı 2
• İş için Microsoft Defender

Uç Nokta için Microsoft Defender'ı deneyimlemek ister misiniz? Ücretsiz deneme için kaydolun.

Bu sayfada, müşterileriniz adına Uç Nokta için Microsoft Defender'a programlı erişim elde etmek için bir Microsoft Entra uygulamasının nasıl oluşturulacağı açıklanır.

Uç Nokta için Microsoft Defender, bir dizi programlı API aracılığıyla verilerinin ve eylemlerinin büyük bir kısmını kullanıma sunar. Bu API'ler iş akışlarını otomatikleştirmenize ve Uç Nokta için Microsoft Defender özelliklerine göre yenilik yapmaya yardımcı olur. API erişimi için OAuth2.0 kimlik doğrulaması gerekir. Daha fazla bilgi için bkz . OAuth 2.0 Yetkilendirme Kodu Akışı.

Genel olarak, API'leri kullanmak için aşağıdaki adımları uygulamanız gerekir:

1. Çok kiracılı bir Microsoft Entra uygulaması oluşturun.

2. Uygulamanızın ihtiyaç duyduğu Uç Nokta için Defender kaynaklarına erişmesi için müşteri yöneticinizden yetki (onay) alın.

3. Bu uygulamayı kullanarak erişim belirteci alın.

4. Uç Nokta IÇIN Microsoft Defender API'sine erişmek için belirteci kullanın.

Aşağıdaki adımlar bir Microsoft Entra uygulaması oluşturma, Uç Nokta için Microsoft Defender'a erişim belirteci alma ve belirteci doğrulama konusunda size yol gösterir.

Çok kiracılı uygulamayı oluşturma

1. Genel Yönetici rolüne sahip kullanıcıyla Azure kiracınızda oturum açın.

2. Microsoft Entra Id>Uygulama kayıtları>Yeni kayıt'a gidin.

   

3. Kayıt formunda:

   • Uygulamanız için bir ad seçin.

   • Desteklenen hesap türleri - herhangi bir kuruluş dizinindeki hesaplar.

   • Yeniden yönlendirme URI'si - tür: Web, URI: https://portal.azure.com

     

4. Uygulamanızın Uç Nokta için Microsoft Defender'a erişmesine izin verin ve tümleştirmeyi tamamlamak için gereken minimum izin kümesiyle uygulamayı atayın.

   • Uygulama sayfanızda API İzinleriKuruluşumun kullandığı>izin> API'leri >ekle'yi seçin WindowsDefenderATP yazın ve WindowsDefenderATP'yi seçin.

   • WindowsDefenderATP özgün listede görünmez. Görünmesini görmek için metin kutusuna adını yazmaya başlayın.

     

API izinleri isteme

Hangi izne ihtiyacınız olduğunu belirlemek için, çağırmak istediğiniz API'nin İzinler bölümünü gözden geçirin. Örneğin:

• Gelişmiş sorguları çalıştırmak için Gelişmiş sorguları çalıştır iznini seçin.
• Cihazı yalıtmak için Makineyi yalıtma iznini seçin.

Aşağıdaki örnekte Tüm uyarıları okuma iznini kullanıyoruz:

1. Uygulama izinleri>Alert.Read.All> seçeneğini İzin ekle'yi seçin

   

2. İzin ver'i seçin

   • İzin eklediğinizde, yeni iznin geçerli olması için İzin ver'i seçmeniz gerekir.

   

3. Uygulamaya gizli dizi ekleyin.

   • Sertifikalar & gizli diziler'i seçin, gizli diziye açıklama ekleyin ve Ekle'yi seçin.

   Ekle'yi seçtikten sonra, oluşturulan gizli dizi değerini kopyaladığınızdan emin olun. Gittikten sonra geri alamayacaksınız!

   

4. Uygulama kimliğinizi not edin:

   • Uygulama sayfanızda Genel Bakış'a gidin ve aşağıdaki bilgileri kopyalayın:

     

5. Uygulamayı müşterinizin kiracısına ekleyin.

   Uygulamanızı kullanmak istediğiniz her müşteri kiracısında onaylanması gerekir. Uygulamanız müşteriniz adına Uç Nokta için Microsoft Defender uygulamasıyla etkileşimde bulunduğundan bu onay gereklidir.

   Müşterinizin kiracısından Genel Yöneticiye sahip bir kullanıcının onay bağlantısını seçip uygulamanızı onaylaması gerekir.

   Onay bağlantısı şu biçimdedir:

   https://login.microsoftonline.com/common/oauth2/authorize?prompt=consent&client_id=00000000-0000-0000-0000-000000000000&response_type=code&sso_reload=true
   

   Burada 00000000-0000-0000-0000-000000000000 Uygulama Kimliğiniz ile değiştirilmelidir.

   Onay bağlantısını seçtikten sonra müşterinin kiracısının Genel Yöneticisi olarak oturum açın ve uygulamayı onaylayın.

   

   Ayrıca, müşterinizden kiracı kimliğini istemeniz ve belirteci alırken gelecekte kullanmak üzere kaydetmeniz gerekir.

6. Bitti! Bir uygulamayı başarıyla kaydettiniz! Belirteç alma ve doğrulama için aşağıdaki örneklere bakın.

Erişim belirteci örneği alma

Müşteriniz adına erişim belirteci almak için aşağıdaki belirteç alımlarında müşterinin kiracı kimliğini kullanın.

Microsoft Entra belirteci hakkında daha fazla bilgi için bkz. Microsoft Entra öğreticisi.

PowerShell kullanma

# That code gets the App Context Token and save it to a file named "Latest-token.txt" under the current directory
# Paste below your Tenant ID, App ID and App Secret (App key).

$tenantId = '' ### Paste your tenant ID here
$appId = '' ### Paste your Application ID here
$appSecret = '' ### Paste your Application key here

$resourceAppIdUri = 'https://api.securitycenter.microsoft.com'
$oAuthUri = "https://login.microsoftonline.com/$TenantId/oauth2/token"
$authBody = [Ordered] @{
    resource = "$resourceAppIdUri"
    client_id = "$appId"
    client_secret = "$appSecret"
    grant_type = 'client_credentials'
}
$authResponse = Invoke-RestMethod -Method Post -Uri $oAuthUri -Body $authBody -ErrorAction Stop
$token = $authResponse.access_token
Out-File -FilePath "./Latest-token.txt" -InputObject $token
return $token

C kullanma#

1. Yeni bir Konsol Uygulaması oluşturun.

2. NuGet Microsoft.Identity.Client'ı yükleyin.

3. Kodu kullanarak aşağıdakileri ekleyin:

    using Microsoft.Identity.Client;
   

   Bu kod NuGet Microsoft.Identity.Clientile test edilmiştir.

4. Uygulamanıza aşağıdaki kodu kopyalayın/yapıştırın (üç değişkeni güncelleştirmeyi unutmayın: tenantId, appIdve appSecret).

   string tenantId = "00000000-0000-0000-0000-000000000000"; // Paste your own tenant ID here
   string appId = "11111111-1111-1111-1111-111111111111"; // Paste your own app ID here
   string appSecret = "22222222-2222-2222-2222-222222222222"; // Paste your own app secret here for a test, and then store it in a safe place! 
   const string authority = https://login.microsoftonline.com;
   const string audience = https://api.securitycenter.microsoft.com;
   
   IConfidentialClientApplication myApp = ConfidentialClientApplicationBuilder.Create(appId).WithClientSecret(appSecret).WithAuthority($"{authority}/{tenantId}").Build();
   
   List<string> scopes = new List<string>() { $"{audience}/.default" };
   
   AuthenticationResult authResult = myApp.AcquireTokenForClient(scopes).ExecuteAsync().GetAwaiter().GetResult();
   
   string token = authResult.AccessToken;
   

Python kullanma

Bkz. Python kullanarak belirteç alma.

Curl kullanma

1. Bir komut penceresi açın.

2. Azure uygulama kimliğiniz olarak ayarlayın CLIENT_ID .

3. Azure uygulama gizli dizinize ayarlayın CLIENT_SECRET .

4. Uç Nokta için Microsoft Defender uygulamasına erişmek için uygulamanızı kullanmak isteyen müşterinin Azure kiracı kimliğine ayarlayın TENANT_ID .

5. Aşağıdaki komutu çalıştırın:

   curl -i -X POST -H "Content-Type:application/x-www-form-urlencoded" -d "grant_type=client_credentials" -d "client_id=%CLIENT_ID%" -d "scope=https://securitycenter.onmicrosoft.com/windowsatpservice/.default" -d "client_secret=%CLIENT_SECRET%" "https://login.microsoftonline.com/%TENANT_ID%/oauth2/v2.0/token" -k
   

   Aşağıdaki kod parçacığına benzer bir yanıt alırsınız:

   {"token_type":"Bearer","expires_in":3599,"ext_expires_in":0,"access_token":"eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsIn <truncated> aWReH7P0s0tjTBX8wGWqJUdDA"}
   

Belirteci doğrulama

Doğru belirteci aldığınızı onaylayın.

1. Kodunu çözmek için önceki adımda aldığınız belirteci JWT'ye kopyalayın/yapıştırın.

2. Uygun izinlere sahip bir rol talebi aldığınızdan emin olun.

   Aşağıdaki ekran görüntüsünde, Uç Nokta için Microsoft Defender'a yönelik birden çok izne sahip bir Uygulamadan alınan kodu çözülen belirteci görebilirsiniz:

   

   "tid" talebi, belirtecin ait olduğu kiracı kimliğidir.

Uç Nokta IÇIN Microsoft Defender API'sine erişmek için belirteci kullanma

1. Kullanmak istediğiniz API'yi seçin. Daha fazla bilgi için bkz. Uç Nokta API'leri için Desteklenen Microsoft Defender.

2. Gönderdiğiniz Bearer {token} Http isteğinde Yetkilendirme üst bilgisini ayarlayın (Taşıyıcı, Yetkilendirme şemasıdır). Belirtecin Süre sonu süresi bir saattir (aynı belirteçle birden fazla istek gönderebilirsiniz).

   C# kullanarak uyarıların listesini almak için istek gönderme örneği aşağıda verilmiştir:

   var httpClient = new HttpClient();
   
   var request = new HttpRequestMessage(HttpMethod.Get, "https://api.securitycenter.microsoft.com/api/alerts");
   
   request.Headers.Authorization = new AuthenticationHeaderValue("Bearer", token);
   
   var response = httpClient.SendAsync(request).GetAwaiter().GetResult();
   
    // Do something useful with the response
   

Ayrıca bkz.

• Desteklenen Uç Nokta için Microsoft Defender API'leri
• Kullanıcı adına Uç Nokta için Microsoft Defender'a erişme