建立應用程式，在沒有使用者的情況下存取 適用於端點的 Microsoft Defender

# This script acquires the App Context Token and stores it in the variable $token for later use.
# Paste your Tenant ID, App ID, and App Secret (App key) into the quotes below.

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

$sourceAppIdUri = 'https://api.securitycenter.microsoft.com/.default'
$oAuthUri = "https://login.microsoftonline.com/$TenantId/oauth2/v2.0/token"
$authBody = [Ordered] @{
    scope = "$sourceAppIdUri"
    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
$token

用 Python 取得 token。

以下程序假設 Curl for Windows 已經安裝在您的電腦上。

1. 打開命令提示字元，並設定CLIENT_ID為你的 Azure 應用程式 ID。

2. 設定CLIENT_SECRET為你的 Azure 應用程式秘密。

3. 設定TENANT_ID為想使用你的應用程式存取 Defender for Endpoint 的客戶的 Azure 租戶 ID。

4. 執行下列命令，向 Microsoft 身分識別平台要求僅限應用程式的存取權杖，並將其傳回以供後續 API 呼叫使用：

   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://api.securitycenter.microsoft.com/.default" -d "client_secret=%CLIENT_SECRET%" "https://login.microsoftonline.com/%TENANT_ID%/oauth2/v2.0/token" -k
   

   成功的回應會傳回一個 JSON 物件，其中包含 Bearer 權杖類型、以秒為單位的到期時間，以及您用於 API 呼叫的 access_token 值。 這個回應類似以下範例：

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

驗證代幣

請依照以下的代幣驗證步驟確認你拿到了正確的代幣。 你可以用同一個令牌發送多個請求。 代幣一小時後到期。

1. 將 你在前一步取得的存取權杖 複製貼上到 JWT 解碼器（jwt.ms） 中來解碼。

2. 確認你獲得了符合所需權限的角色申請。

使用該令牌存取 適用於端點的 Microsoft Defender API

取得有效憑證後，請在 API 請求中使用該憑證，如下：

1. 選擇您要使用的受支援的 Defender for Endpoint API。

2. 在傳送至 http 的 Bearer {token} 請求中，設定授權標頭。 Bearer 是授權配置。

範例

以下 C# 摘要會使用先前取得的持有憑證向 Defender for Endpoints 警示端點發送經過認證的 GET 請求，並取得警示清單。

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