Microsoft Defender for Endpoint
本文說明如何將 Microsoft Defender for Endpoint 與 Google SecOps 整合。
用途
調查特定案件時,使用 Microsoft Defender for Endpoint 收集的資料進行擴充。
分析師可以運用 Microsoft Defender for Endpoint 收集並儲存的資料進行調查,例如取得 Microsoft Defender for Endpoint 偵測到的警示資訊,或列出在 Microsoft Defender for Endpoint 註冊的機器。
在潛在安全事件中執行主動應變措施,例如將特定主機與網路隔離,或執行防毒掃描。
監控及檢查 Microsoft Defender for Endpoint 警告,這些警告會由對應的連接器擷取為 Google Security Operations 警告。
必要條件
在 Google SecOps 平台設定整合功能前,請務必完成下列前置步驟:
建立 Microsoft Entra 應用程式。
設定應用程式的 API 權限。
建立用戶端密鑰。
存取 Microsoft Defender for Endpoint API 時,建議使用應用程式內容,而非使用者內容。
建立 Microsoft Entra 應用程式
以使用者管理員或密碼管理員身分登入 Azure 入口網站。
選取「Microsoft Entra ID」。
依序前往「App registrations」>「New registration」。
輸入應用程式名稱。
按一下「註冊」。
儲存「Application (client) ID」和「Directory (tenant) ID」值,稍後設定整合參數時會用到。
設定 API 權限
依序前往 「API Permissions」 > 「Add a permission」 > 「APIs my organization uses」。「Request API permissions」對話方塊隨即開啟。
在「Search」欄位中輸入
WindowsDefenderATP。依序選取「WindowsDefenderATP」>「應用程式權限」。
在「快訊」權限類型下方,選取下列權限:
Alert.Read.All
按一下「Add permissions」。
在「API Permissions」頁面,點選「Add a permission」。
依序選取 「Microsoft Graph」 > 「Delegated permissions」。
在「Select Permissions」(選取權限) 部分,選取下列必要權限:
User.Read
按一下「Add permissions」。
在「API Permissions」頁面,點選「Add a permission」。
依序選取「WindowsDefenderATP」>「Application permissions」。
在「Select Permissions」(選取權限) 部分,選取下列必要權限:
AdvancedQuery.Read.AllAlert.Read.AllAlert.ReadWrite.AllEvent.WriteFile.Read.AllIp.Read.AllMachine.IsolateMachine.Read.AllMachine.ReadWrite.AllMachine.ScanMachine.StopAndQuarantineTi.ReadWriteUrl.Read.AllUser.Read.All
按一下「Grant admin consent for
ORGANIZATION_NAME」。畫面顯示「Grant admin consent confirmation」對話方塊時,按一下「Yes」。
以下是取得 Defender ATP 快訊的 API 要求範例 (請注意,$expand 參數用於擷取 IP 位址、網域和檔案的相關資料):
GET /api/alerts?$expand=files,ips,domains HTTP/1.1
Host: api.securitycenter.windows.com
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJ...
User-Agent: PostmanRuntime/7.19.0
Accept: */ *
Cache-Control: no-cache
Postman-Token: 2dc0f885-068a-45d4-81a6-2da0d23a58ad,d3dd0e6e-83ab-4d27-94d2-0f3889dff324
Host: api.securitycenter.windows.com
Accept-Encoding: gzip, deflate
Connection: keep-alive
cache-control: no-cache
如要進一步瞭解要求參數和要求選項 (例如篩選或展開),請參閱 Microsoft 說明文件中的「支援的 Microsoft Defender for Endpoint API」。
建立用戶端密鑰
依序前往「Certificates and secrets」(憑證和密鑰) >「New client secret」(新增用戶端密鑰)。
提供用戶端密鑰的說明,並設定到期期限。
按一下「新增」。
儲存用戶端密鑰的值 (而非密鑰 ID),以便在設定整合時,將其做為
Client Secret參數值使用。用戶端密鑰值只會顯示一次。
啟用 SIEM 整合 - 已淘汰
在導覽窗格中,依序選取「設定」 >「SIEM」。
選取「啟用 SIEM 整合功能」。
這會啟用 SIEM 連接器存取詳細資料部分,並預先填入值,然後在 Azure AD 租用戶下建立應用程式。
- 選擇「Generic API」做為 SIEM 類型。
- 複製個別值,或選取「Save details to file」(將詳細資料儲存至檔案),下載包含所有值的檔案。
- 您需要使用這個頁面顯示的值,產生權杖來存取偵測資料:用戶端 ID、用戶端密鑰、資源。
將 Microsoft Defender for Endpoint 與 Google SecOps 整合
如要瞭解如何在 Google SecOps 中設定整合功能,請參閱「設定整合功能」一文。
整合參數
如要設定整合,請使用下列參數:
| 參數 | |
|---|---|
Client ID |
必要 要用於整合作業的 Microsoft Entra 應用程式用戶端 (應用程式) ID。 |
Client Secret |
必要 Microsoft Entra 應用程式的用戶端密鑰值,用於整合。 |
Azure Active Directory ID |
必要 Microsoft Entra ID (租戶 ID) 值。 |
Verify SSL |
選用 如果選取這個選項,系統會驗證 Microsoft 365 Defender 伺服器連線的 SSL 憑證是否有效。 預設為選取。 |
API Root |
必要 與整合功能搭配使用的 API 根網址。為提高效能,您可以使用最靠近您所在位置的伺服器:
預設值為 |
動作
刪除實體指標
刪除 Microsoft Defender for Endpoint 中的實體指標。
參數
不適用
執行日期
這項動作會對下列實體執行:
- IP 位址
- 網址
- Filehash
動作結果
指令碼執行結果
| 指令碼執行結果名稱 | 價值選項 | 範例 |
|---|---|---|
| is_success | True/False | is_success:False |
案件總覽
| 結果類型 | 值 / 說明 | 類型 |
|---|---|---|
| 輸出訊息* | 動作不應失敗,也不應停止應對手冊執行作業: 如果回報 204 狀態碼 (is_success=true):「已成功刪除下列實體,不再做為 Microsoft Defender for Endpoint 的指標:{entity.identifier}。 如果找不到事件 (is_success=true):「The following entities don't exist as indicators in Microsoft Defender for Endpoint: {entity.identifier}. 動作應失敗並停止執行應對手冊: 如果發生嚴重錯誤,例如憑證錯誤、無法連線至伺服器等,系統會回報: 「執行『刪除實體指標』動作時發生錯誤。原因: {0}''.format(error.Stacktrace) |
一般 |
充實實體
根據 Microsoft Defender for Endpoint 的資訊,充實 Google SecOps 主機、IP 位址或檔案雜湊實體。
參數
不適用
用途
這項動作可用於調查裝置活動的自動化動作。 如果裝置已安裝 Microsoft Defender for Endpoint 代理程式,這項動作會從裝置上的 Defender ATP 提取資訊,充實 Google SecOps 實體。這項動作也能用來將 Defender ATP 的資訊,加入快訊檔案雜湊。
執行日期
這項動作會對下列實體執行:
- 主機
- IP 位址
- Filehash
動作結果
指令碼執行結果
| 指令碼執行結果名稱 | 價值選項 | 範例 |
|---|---|---|
| is_success | True/False | is_success:False |
JSON 結果
如果擴充功能適用於 IP 位址或主機:
[
{
"EntityResult": {
"@odata.context": "https://api.securitycenter.windows.com/api/$metadata#Machines/$entity",
"id": "example_id",
"computerDnsName": "example-name",
"firstSeen": "2019-11-18T11:13:04.0588699Z",
"lastSeen": "2019-11-24T18:31:50.581058Z",
"osPlatform": "Windows10",
"osVersion": null,
"osProcessor": "x64",
"version": "1803",
"lastIpAddress": "192.0.2.138",
"lastExternalIpAddress": "203.0.113.28",
"agentVersion": "10.4860.17134.982",
"osBuild": 17134,
"healthStatus": "Active",
"rbacGroupId": 0,
"rbacGroupName": null,
"riskScore": "High",
"exposureLevel": "Medium",
"aadDeviceId": null,
"machineTags": []
}
}
]
如果擴充功能適用於 Filehash:
[
{
"EntityResult": {
"@odata.context": "https://api.securitycenter.windows.com/api/$metadata#Files/$entity",
"sha1": "bdd0d38e113a0c7dd6213cf2e89e6cc6d66b5cdb",
"sha256": "328954033456d5c13e58fb5bcc6c0232f9f62cb6d9185afa51c7913338992491",
"md5": "9512e1cc66a1d36feb0a290cab09087b",
"globalPrevalence": 5205000,
"globalFirstObserved": "2018-06-22T12:59:21.6460311Z",
"globalLastObserved": "2019-11-21T00:24:01.921338Z",
"size": 245760,
"fileType": "APP",
"isPeFile": true,
"filePublisher": "Microsoft Corporation",
"fileProductName": "Microsoft Windows Operating System",
"signer": "Microsoft Windows",
"issuer": "Microsoft Windows Production PCA 2011",
"signerHash": "419e77aed546a1a6cf4dc23c1f977542fe289cf7",
"isValidCertificate": true
},
"EntityResult": {
"@odata.context": "https://api.securitycenter.windows.com/api/$metadata#microsoft.windowsDefenderATP.api.InOrgFileStats",
"sha1": "bdd0d38e113a0c7dd6213cf2e89e6cc6d66b5cdb",
"orgPrevalence": "1",
"orgFirstSeen": "2019-11-19T03:54:15Z",
"orgLastSeen": "2019-11-19T04:21:18Z",
"globalPrevalence": "5205000",
"globalFirstObserved": "2018-06-22T12:59:21.6460311Z",
"globalLastObserved": "2019-11-21T00:24:01.921338Z",
"topFileNames": ["notepad.exe"]
}
}
]
實體擴充
IP 和主機
| 補充資料欄位名稱 | 邏輯 - 應用時機 |
|---|---|
| Defender_ATP.sha1 | 如果 JSON 結果中存在,則傳回 |
| Defender_ATP.sha256 | 如果 JSON 結果中存在,則傳回 |
| Defender_ATP.md5 | 如果 JSON 結果中存在,則傳回 |
| Defender_ATP.globalPrevalence | 如果 JSON 結果中存在,則傳回 |
| Defender_ATP.globalFirstObserved | 如果 JSON 結果中存在,則傳回 |
| Defender_ATP.globalLastObserved | 如果 JSON 結果中存在,則傳回 |
| Defender_ATP.size | 如果 JSON 結果中存在,則傳回 |
| Defender_ATP.fileType | 如果 JSON 結果中存在,則傳回 |
| Defender_ATP.isPeFile | 如果 JSON 結果中存在,則傳回 |
| Defender_ATP.filePublisher | 如果 JSON 結果中存在,則傳回 |
| Defender_ATP.fileProductName | 如果 JSON 結果中存在,則傳回 |
| Defender_ATP.signer | 如果 JSON 結果中存在,則傳回 |
| Defender_ATP.issuer | 如果 JSON 結果中存在,則傳回 |
| Defender_ATP.signerHash | 如果 JSON 結果中存在,則傳回 |
| Defender_ATP.isValidCertificate | 如果 JSON 結果中存在,則傳回 |
| Defender_ATP.orgPrevalence | 如果 JSON 結果中存在,則傳回 |
| Defender_ATP.orgFirstSeen | 如果 JSON 結果中存在,則傳回 |
| Defender_ATP.orgLastSeen | 如果 JSON 結果中存在,則傳回 |
| Defender_ATP.topFileNames | 如果 JSON 結果中存在,則傳回 |
檔案雜湊
| 補充資料欄位名稱 | 邏輯 - 應用時機 |
|---|---|
| Defender_ATP.sha1 | 如果 JSON 結果中存在,則傳回 |
| Defender_ATP.sha256 | 如果 JSON 結果中存在,則傳回 |
| Defender_ATP.md5 | 如果 JSON 結果中存在,則傳回 |
| Defender_ATP.globalPrevalence | 如果 JSON 結果中存在,則傳回 |
| Defender_ATP.globalFirstObserved | 如果 JSON 結果中存在,則傳回 |
| Defender_ATP.globalLastObserved | 如果 JSON 結果中存在,則傳回 |
| Defender_ATP.size | 如果 JSON 結果中存在,則傳回 |
| Defender_ATP.fileType | 如果 JSON 結果中存在,則傳回 |
| Defender_ATP.isPeFile | 如果 JSON 結果中存在,則傳回 |
| Defender_ATP.filePublisher | 如果 JSON 結果中存在,則傳回 |
| Defender_ATP.fileProductName | 如果 JSON 結果中存在,則傳回 |
| Defender_ATP.signer | 如果 JSON 結果中存在,則傳回 |
| Defender_ATP.issuer | 如果 JSON 結果中存在,則傳回 |
| Defender_ATP.signerHash | 如果 JSON 結果中存在,則傳回 |
| Defender_ATP.isValidCertificate | 如果 JSON 結果中存在,則傳回 |
| Defender_ATP.orgPrevalence | 如果 JSON 結果中存在,則傳回 |
| Defender_ATP.orgFirstSeen | 如果 JSON 結果中存在,則傳回 |
| Defender_ATP.orgLastSeen | 如果 JSON 結果中存在,則傳回 |
| Defender_ATP.topFileNames | 如果 JSON 結果中存在,則傳回 |
執行 Live Response 指令
使用「執行即時回應指令」動作,在 Microsoft Defender for Endpoint 中執行即時回應指令。
動作輸入內容
「Execute Live Response Command」動作需要下列參數:
| 參數 | 說明 |
|---|---|
Command |
必填。 代表要執行的指令 (包括類型和參數) 的 JSON 物件。 如要進一步瞭解支援的指令結構,請參閱 Microsoft Defender for Endpoint API 說明文件。 範例格式: |
Comment |
選填。 已執行指令的註解或說明。 |
動作輸出內容
「執行即時回應指令」動作會提供下列輸出內容:
| 動作輸出類型 | 可用性 |
|---|---|
| 案件總覽附件 | 無法使用 |
| 案件總覽連結 | 無法使用 |
| 案件總覽表格 | 無法使用 |
| 補充資訊表格 | 無法使用 |
| JSON 結果 | 可用 |
| 輸出訊息 | 可用 |
| 指令碼執行結果 | 可用 |
JSON 結果
以下範例顯示使用「Execute Live Response Command」動作時,收到的 JSON 結果輸出內容:
{
"Entity": "",
"EntityResult": {
"@odata.context": "https://api.securitycenter.microsoft.com/api/$metadata#MachineActions/$entity",
"id": "00000000-0000-0000-0000-000000000000",
"type": "LiveResponse",
"title": null,
"requestor": "SEC_OPS_USER",
"requestorComment": "Execution of live response command",
"status": "Pending",
"machineId": "MACHINE_ID_HASH",
"computerDnsName": "hostname.domain.local",
"creationDateTimeUtc": "2026-01-04T10:57:33.032Z",
"lastUpdateDateTimeUtc": "2026-01-04T10:57:33.032Z",
"cancellationRequestor": null,
"cancellationComment": null,
"cancellationDateTimeUtc": null,
"errorHResult": 0,
"scope": null,
"externalId": null,
"requestSource": "PublicApi",
"relatedFileInfo": null,
"commands": [],
"troubleshootInfo": null,
"results": {
"filepath": "",
"script_name": "remediation_script.ps1",
"exit_code": 0,
"script_output": "Script completed successfully",
"script_errors": ""
}
}
}
輸出訊息
Execute Live Response Command 動作可傳回下列輸出訊息:
| 輸出訊息 | 訊息說明 |
|---|---|
|
動作已成功執行。 |
|
操作失敗。 請檢查伺服器連線、輸入參數或憑證。 |
指令碼執行結果
下表列出使用「執行即時回應指令」動作時,指令碼結果輸出的值:
| 指令碼結果名稱 | 值 |
|---|---|
is_success |
true或false |
取得目前工作狀態
取得工作的目前狀態。
參數
| 參數顯示名稱 | 類型 | 預設值 | 是否為必要 | 說明 |
|---|---|---|---|---|
| 工作 ID | 字串 | 不適用 | 是 | 工作 ID 清單,以半形逗號分隔。 |
執行日期
這項操作會對所有實體執行。
動作結果
指令碼執行結果
| 指令碼執行結果名稱 | 價值選項 | 範例 |
|---|---|---|
| is_success | True/False | is_success:False |
JSON 結果
[
{
"status": "Succeeded",
"creation_date_time_utc": "2020-02-08T03:24:52.8526634Z",
"cancellation_requestor": null,
"cancellation_date_time_utc": null,
"id": "2e39d22e-60a7-4267-899c-a1471e800000",
"last_update_date_time_utc": "2020-02-08T03:25:35.8345081Z",
"related_file_info": null,
"cancellation_comment": null,
"requestor": "e4fc6454-754d-47f7-bbdb-045fad600000",
"error_h_result": 0,
"scope": "Selective",
"machine_id": "fbc85cf3fbcc8bb14d1a84fcf7bbae4531f00000",
"type": "Isolate",
"requestor_comment": "test"
}
]
接收檔案相關快訊
根據檔案雜湊,從 Microsoft Defender for Endpoint 取得與檔案相關的警示。
參數
| 參數顯示值 | 類型 | 預設值 | 是否為必要 | 說明 |
|---|---|---|---|---|
| 狀態 | 字串 | Unknown、New、InProgress、Resolved | 否 | 指定要尋找的快訊狀態。 參數接受多個值,請以半形逗號分隔。 |
| 嚴重性 | 字串 | 未指定、資訊、低、中、高 | 否 | 指定要尋找的事件嚴重性。 參數接受多個值,請以半形逗號分隔。 |
| 類別 | 字串 | 不適用 | 否 | 指定要尋找的快訊類別。 如未提供,動作會尋找所有類別。 參數接受多個值,請以半形逗號分隔。 可能的值:'Collection'、'CommandAndControl'、'CredentialAccess'、'DefenseEvasion'、'Discovery'、'Execution'、'Exfiltration'、'Exploit'、'InitialAccess'、'LateralMovement'、'Malware'、'Persistence'、'PrivilegeEscalation'、'Ransomware'、'SuspiciousActivity'、'UnwantedSoftware'。 |
| 事件 ID | 整數 | 不適用 | 否 | 指定 Microsoft Defender 事件 ID,找出相關警告。 |
用途
調查來自 Defender ATP 連接器的快訊時,如果檔案與任何快訊相關聯,可以使用這項動作收集資訊,瞭解檔案是否為惡意。
執行日期
這項動作會對 Filehash 實體執行。
動作結果
指令碼執行結果
| 指令碼執行結果名稱 | 價值選項 | 範例 |
|---|---|---|
| is_success | True/False | is_success:False |
JSON 結果
{
"@odata.context": "https://api.securitycenter.windows.com/api/$metadata#Alerts",
"value": [
{
"id": "example_id",
"incidentId": 2,
"investigationId": 1,
"assignedTo": null,
"severity": "Medium",
"status": "New",
"classification": null,
"determination": null,
"investigationState": "TerminatedBySystem",
"detectionSource": "WindowsDefenderAtp",
"category": "DefenseEvasion",
"threatFamilyName": null,
"title": "Suspicious process injection observed",
"description": "A process abnormally injected code into another process, As a result, unexpected code may be running in the target process memory. Injection is often used to hide malicious code execution within a trusted process. \nAs a result, the target process may exhibit abnormal behaviors such as opening a listening port or connecting to a command and control server.",
"alertCreationTime": "2019-11-19T03:56:37.7335862Z",
"firstEventTime": "2019-11-19T03:54:15.7698362Z",
"lastEventTime": "2019-11-19T03:54:15.7698362Z",
"lastUpdateTime": "2019-11-20T10:13:31.7266667Z",
"resolvedTime": null,
"machineId": "machine-id",
"alertUser": {
"accountName": "example.user",
"domainName": "EXAMPLELAB"
},
"comments": [],
"alertFiles": [
{
"sha1": "1b3b40fbc889fd4c645cc12c85d0805ac36ba254",
"sha256": "d3f8fade829d2b7bd596c4504a6dae5c034e789b6a3defbe013bda7d14466677",
"filePath": "C:\\Windows\\System32\\WindowsPowerShell\\v1.0\\powershell.exe",
"fileName": "powershell.exe"
},{
"sha1": "bdd0d38e113a0c7dd6213cf2e89e6cc6d66b5cdb",
"sha256": "328954033456d5c13e58fb5bcc6c0232f9f62cb6d9185afa51c7913338992491",
"filePath": "C:\\Windows\\System32\\notepad.exe",
"fileName": "notepad.exe"
}
],
"alertDomains": [],
"alertIps": [],
"alertProcesses": []
}
]
}
取得與檔案相關的機器
根據檔案雜湊,從 Microsoft Defender for Endpoint 取得與檔案相關的機器。
參數
| 參數顯示名稱 | 類型 | 預設值 | 是否為必要 | 說明 |
|---|---|---|---|---|
| 機器名稱 | 字串 | 不適用 | 否 | 指定要尋找的完整機器名稱。 |
| 機器 IP 位址 | 字串 | 不適用 | 否 | 指定要尋找的機器 IP 位址。 |
| 機器風險評分 | 字串 | 不適用 | 否 | 指定要尋找的機器風險評分。 參數接受多個值,請以半形逗號分隔。 |
| 機器健康狀態 | 字串 | Active、Inactive、ImpairedCommunication、NoSensorData、NoSensorDataImpairedCommunication | 否 | 指定要尋找的機器健康狀態。 參數接受多個值,請以半形逗號分隔。 |
| 機器 OS 平台 | 字串 | 不適用 | 否 | 指定要尋找的機器 OS 平台。 |
| RBAC 群組 ID | 字串 | 不適用 | 否 | 指定要尋找的 RBAC 群組 ID。 |
用途
調查來自 Defender ATP 連接器的警示時,這項動作可用於收集資訊,瞭解這個檔案在 Defender ATP 中註冊到哪些機器。
執行日期
這項動作會對 Filehash 實體執行。
動作結果
指令碼執行結果
| 指令碼執行結果名稱 | 價值選項 | 範例 |
|---|---|---|
| is_success | True/False | is_success:False |
JSON 結果
{
"@odata.context": "https://api.securitycenter.windows.com/api/$metadata#Machines",
"value": [
{
"id": "example_id",
"computerDnsName": "example-name",
"firstSeen": "2019-11-18T11:13:04.0588699Z",
"lastSeen": "2019-11-20T19:35:36.4619266Z",
"osPlatform": "Windows10",
"osVersion": null,
"osProcessor": "x64",
"version": "1803",
"lastIpAddress": "192.0.2.1",
"lastExternalIpAddress": "203.0.113.121",
"agentVersion": "10.4860.17134.982",
"osBuild": 17134,
"healthStatus": "Active",
"rbacGroupId": 0,
"rbacGroupName": null,
"riskScore": "High",
"exposureLevel": "Medium",
"aadDeviceId": null,
"machineTags": []
}
]
}
取得使用者的機器記錄
取得使用者在特定機器上的登入資訊。
參數
不適用
用途
這項動作可用於調查,從 Defender ATP 伺服器取得特定詳細資料,瞭解使用者在有問題的機器上登入哪些內容。
執行日期
這項動作會對下列實體執行:
- 主機
- IP 位址
動作結果
指令碼執行結果
| 指令碼執行結果名稱 | 價值選項 | 範例 |
|---|---|---|
| is_success | True/False | is_success:False |
JSON 結果
{
"@odata.context": "https://api.securitycenter.windows.com/api/$metadata#Users",
"value": [
{
"id": "example\\example.user",
"accountName": "example.user",
"accountDomain": "example",
"accountSid": null,
"firstSeen": "2019-11-19T03:50:36Z",
"lastSeen": "2019-11-19T03:50:36Z",
"mostPrevalentMachineId": null,
"leastPrevalentMachineId": null,
"logonTypes": "Interactive",
"logOnMachinesCount": 1,
"isDomainAdmin": false,
"isOnlyNetworkUser": null
}
]
}
取得機器建議
使用「Get Machine Recommendations」動作,擷取 Microsoft Defender for Endpoint 中特定機器的安全性建議清單。
這項動作會在下列 Google SecOps 實體上執行:
HostnameIP Address
動作輸入內容
「Get Machine Recommendations」(取得機器建議) 動作需要下列參數:
| 參數 | 說明 |
|---|---|
Max Recommendations To Return |
必填。 每個實體可擷取的最佳化建議數量上限。 最大值為 預設值為 |
動作輸出內容
「Get Machine Recommendations」動作會提供下列輸出內容:
| 動作輸出類型 | 可用性 |
|---|---|
| 案件總覽附件 | 無法使用 |
| 案件總覽連結 | 無法使用 |
| 案件總覽表格 | 無法使用 |
| 補充資訊表格 | 無法使用 |
| JSON 結果 | 可用 |
| 輸出訊息 | 可用 |
| 指令碼執行結果 | 可用 |
JSON 結果
以下範例顯示使用「Get Machine Recommendations」動作時,收到的 JSON 結果輸出內容:
{
"Entity": "",
"EntityResult": [
{
"id": "va-_-7-zip-_-7-zip",
"productName": "7-zip",
"recommendationName": "Update 7-zip to version 25.01.0.0",
"weaknesses": 12,
"vendor": "7-zip",
"recommendedVersion": "25.01.0.0",
"recommendedVendor": "",
"recommendedProgram": "",
"recommendationCategory": "Application",
"subCategory": "",
"severityScore": 0.0,
"publicExploit": true,
"activeAlert": false,
"associatedThreats": [],
"remediationType": "Update",
"status": "Active",
"configScoreImpact": 0.0,
"exposureImpact": 0.0,
"totalMachineCount": 0,
"exposedMachinesCount": 1,
"nonProductivityImpactedAssets": 0,
"relatedComponent": "7-zip",
"hasUnpatchableCve": false,
"tags": [],
"exposedCriticalDevices": 0
}
]
}
輸出訊息
「Get Machine Recommendations」動作可能會傳回下列輸出訊息:
| 輸出訊息 | 訊息說明 |
|---|---|
|
動作已成功執行。 |
Error executing action "Get Machine Recommendations". Reason:
ERROR_REASON |
操作失敗。 請檢查伺服器連線、輸入參數或憑證。 |
指令碼執行結果
下表列出使用「Get Machine Recommendations」(取得機器建議) 動作時,指令碼結果輸出的值:
| 指令碼結果名稱 | 值 |
|---|---|
is_success |
true或false |
接收機器相關快訊
接收與 Defender ATP 中註冊的特定機器相關的警示。
參數
| 參數 | 類型 | 預設值 | 是否為必要 | 說明 |
|---|---|---|---|---|
| 狀態 | 字串 | Unknown、New、InProgress、Resolved | 否 | 指定要尋找的快訊狀態。 參數接受多個值,請以半形逗號分隔。 |
| 嚴重性 | 字串 | 未指定、資訊、低、中、高 | 否 | 指定要尋找的事件嚴重性。 參數接受多個值,請以半形逗號分隔。 |
| 類別 | 字串 | 不適用 | 否 | 指定要尋找的快訊類別。 如未提供,動作會尋找所有類別。 參數接受多個值,請以半形逗號分隔。 可能的值:'Collection'、'CommandAndControl'、'CredentialAccess'、'DefenseEvasion'、'Discovery'、'Execution'、'Exfiltration'、'Exploit'、'InitialAccess'、'LateralMovement'、'Malware'、'Persistence'、'PrivilegeEscalation'、'Ransomware'、'SuspiciousActivity'、'UnwantedSoftware'。 |
| 事件 ID | 整數 | 不適用 | 否 | 指定 Microsoft Defender 事件 ID,找出相關警示。 |
用途
這項動作可用於調查,從 Defender ATP 伺服器取得與特定問題機器相關的警示。
執行日期
這項動作會對下列實體執行:
- 主機
- IP 位址
動作結果
指令碼執行結果
| 指令碼執行結果名稱 | 價值選項 | 範例 |
|---|---|---|
| is_success | True/False | is_success:False |
JSON 結果
{
"@odata.context": "https://api.securitycenter.windows.com/api/$metadata#Alerts",
"value": [
{
"id": "example-id",
"incidentId": 1,
"investigationId": null,
"assignedTo": "testuser@example.com",
"severity": "Informational",
"status": "Resolved",
"classification": "FalsePositive",
"determination": "SecurityTesting",
"investigationState": "UnsupportedAlertType",
"detectionSource": "WindowsDefenderAtp",
"category": "Execution",
"threatFamilyName": null,
"title": "[Test Alert] Suspicious Powershell commandline",
"description": "*** This is a test alert ***\nA suspicious Powershell commandline was found on the machine. This commandline might be used during installation, exploration, or in some cases with lateral movement activities which are used by attackers to invoke modules, download external payloads, and get more information about the system. Attackers usually use Powershell to bypass security protection mechanisms by executing their payload in memory without touching the disk and leaving any trace.",
"alertCreationTime": "2019-11-18T11:17:48.287421Z",
"firstEventTime": "2019-11-18T11:15:06.5226815Z",
"lastEventTime": "2019-11-18T11:15:06.5226815Z",
"lastUpdateTime": "2019-11-20T04:12:03.91Z",
"resolvedTime": "2019-11-20T04:12:03.4976288Z",
"machineId": "machine-id",
"alertUser": {
"accountName": "Administrator",
"domainName": "US-LT-V13007"
},
"comments": [],
"alertFiles": [
{
"sha1": "3ce71813199abae99348f61f0caa34e2574f831c",
"sha256": "9a7c58bd98d70631aa1473f7b57b426db367d72429a5455b433a05ee251f3236",
"filePath": "C:\\Windows\\System32\\cmd.exe",
"fileName": "cmd.exe"
},
{
"sha1": "1b3b40fbc889fd4c645cc12c85d0805ac36ba254",
"sha256": "d3f8fade829d2b7bd596c4504a6dae5c034e789b6a3defbe013bda7d14466677",
"filePath": "C:\\Windows\\System32\\WindowsPowerShell\\v1.0\\powershell.exe",
"fileName": "powershell.exe"
}
],
"alertDomains": [],
"alertIps": [],
"alertProcesses": []
}
]
}
取得機器安全漏洞
使用「Get Machine Vulnerabilities」動作,列出 Microsoft Defender for Endpoint 中與特定機器相關聯的安全漏洞。
這項動作會在下列 Google SecOps 實體上執行:
HostnameIP Address
動作輸入內容
「Get Machine Vulnerabilities」動作需要下列參數:
| 參數 | 說明 |
|---|---|
Severity Filter |
選填。 用於篩選傳回安全漏洞的嚴重性等級。 可能的值如下:
預設值為 |
Threat Filter |
選填。 用於篩選傳回安全漏洞的威脅情報條件。 可能的值如下:
|
Sort By |
選填。 用於排序傳回安全漏洞的欄位。 可能的值如下:
預設值為 |
Sort Order |
選填。 排序結果的顯示順序。 可能的值如下:
預設值為 |
Max Vulnerabilities To Return |
必填。 每個實體要傳回的安全漏洞數量上限。 最大值為 預設值為 |
動作輸出內容
「Get Machine Vulnerabilities」動作會提供下列輸出內容:
| 動作輸出類型 | 可用性 |
|---|---|
| 案件總覽附件 | 無法使用 |
| 案件總覽連結 | 無法使用 |
| 案件總覽表格 | 無法使用 |
| 補充資訊表格 | 無法使用 |
| JSON 結果 | 可用 |
| 輸出訊息 | 可用 |
| 指令碼執行結果 | 可用 |
JSON 結果
以下範例顯示使用「Get Machine Vulnerabilities」動作時,收到的 JSON 結果輸出內容:
{
"Entity": "",
"EntityResult": [
{
"@odata.type": "#microsoft.windowsDefenderATP.api.PublicVulnerabilityDto",
"id": "CVE-2025-21266",
"name": "CVE-2025-21266",
"description": "Summary: The Windows Telephony Service in Microsoft Windows is vulnerable to remote code execution. An attacker can exploit this vulnerability by tricking a user into visiting a malicious website, which would allow them to execute arbitrary code on the system. Impact: If successfully exploited, this vulnerability could allow an attacker to execute arbitrary code on the affected system. This could lead to a complete compromise of the system, enabling the attacker to gain unauthorized access, steal sensitive information, or perform other malicious activities. Remediation: Apply the latest patches and updates provided by the respective vendors. Generated by AI",
"severity": "High",
"cvssV3": 8.8,
"cvssVector": "CVSS:3.1/AV:N/AC:L/PR:N/UI:R/S:U/C:H/I:H/A:H/E:U/RL:O/RC:C",
"exposedMachines": 1,
"publishedOn": "2025-01-14T08:00:00Z",
"updatedOn": "2025-09-09T23:45:43.5Z",
"firstDetected": "2025-01-14T18:31:29Z",
"patchFirstAvailable": null,
"publicExploit": false,
"exploitVerified": false,
"exploitInKit": false,
"exploitTypes": [],
"exploitUris": [],
"cveSupportability": "Supported",
"tags": [],
"epss": 0.01391,
"status": "RemediationRequired"
}
]
}
輸出訊息
「Get Machine Vulnerabilities」動作可能會傳回下列輸出訊息:
| 輸出訊息 | 訊息說明 |
|---|---|
|
動作已成功執行。 |
Error executing action "Get Machine Vulnerabilities". Reason:
ERROR_REASON |
操作失敗。 請檢查伺服器連線、輸入參數或憑證。 |
指令碼執行結果
下表列出使用「Get Machine Vulnerabilities」動作時,指令碼結果輸出的值:
| 指令碼結果名稱 | 值 |
|---|---|
is_success |
true或false |
接收使用者相關快訊
使用「Get User Related Alerts」動作,列出 Microsoft Defender for Endpoint 中與特定使用者相關聯的快訊。
這項動作會在 Google SecOps User 實體上執行。
動作輸入內容
「Get User Related Alerts」動作需要下列參數:
| 參數 | 說明 |
|---|---|
Max Alerts To Return |
必填。 每位使用者可擷取的快訊數量上限。 最大值為 預設值為 |
動作輸出內容
「Get User Related Alerts」動作會提供下列輸出內容:
| 動作輸出類型 | 可用性 |
|---|---|
| 案件總覽附件 | 無法使用 |
| 案件總覽連結 | 無法使用 |
| 案件總覽表格 | 無法使用 |
| 補充資訊表格 | 無法使用 |
| JSON 結果 | 可用 |
| 輸出訊息 | 可用 |
| 指令碼執行結果 | 可用 |
JSON 結果
以下範例顯示使用「Get User Related Alerts」動作時,收到的 JSON 結果輸出內容:
[
{
"Entity": "User@domain.local",
"EntityResult": [
{
"id": "da06788650-4d45-4dcf-ae23-d1071ad426ec_1",
"incident_id": 864492,
"investigation_id": 1778,
"assigned_to": "API-Automated Investigation and Response",
"severity": "Low",
"status": "Resolved",
"classification": null,
"determination": null,
"investigation_state": "Benign",
"detection_source": "WindowsDefenderAv",
"category": "Malware",
"threat_family_name": "Ceprolad",
"title": "An active '' malware ",
"description": "Malware and unwanted software are undesirable applications that perform annoying, disruptive, or harmful actions on affected machines. Some of these undesirable applications can replicate and spread from one machine to another. Others are able to receive commands from remote attackers and perform activities associated with cyber attacks.\n\nA malware is considered active if it is found running on the machine or it already has persistence mechanisms in place. Active malware detections are assigned higher severity ratings.\n\nBecause this malware was active, take precautionary measures and check for residual signs of infection.",
"alert_creation_time": "2026-02-27T06:58:08.1366667Z",
"first_event_time": "2026-02-27T06:55:51.021546Z",
"last_event_time": "2026-02-27T06:55:51.021546Z",
"last_update_time": "2026-02-27T07:13:46.2333333Z",
"resolved_time": "2026-02-27T07:13:44.3513463Z",
"machine_id": "4f683b2d393afc3149b0de4149acc5449acdf07e",
"alert_user": null,
"alert_files": [],
"comments": [],
"alert_domains": null,
"alert_ips": null,
"alert_processes": null
},
{
"id": "da0b1f334d-b5e5-4618-8a2a-d3675e62a93b_1",
"incident_id": 864492,
"investigation_id": null,
"assigned_to": null,
"severity": "Low",
"status": "New",
"classification": null,
"determination": null,
"investigation_state": "UnsupportedAlertType",
"detection_source": "WindowsDefenderAtp",
"category": "Execution",
"threat_family_name": null,
"title": "Suspicious JavaScript process",
"description": "A suspicious JavaScript process was observed on this device. Attackers typically use JavaScript to download secondary payloads, run additional commands, and perform other malicious activities on the target device.",
"alert_creation_time": "2026-02-27T06:58:38.5533333Z",
"first_event_time": "2026-02-27T06:55:32.6699867Z",
"last_event_time": "2026-03-05T07:24:52.7415066Z",
"last_update_time": "2026-03-05T07:28:04.67Z",
"resolved_time": null,
"machine_id": "4f683b2d393afc3149b0de4149acc5449acdf07e",
"alert_user": null,
"alert_files": [],
"comments": [],
"alert_domains": null,
"alert_ips": null,
"alert_processes": null
},
{
"id": "da0cfbb355-b5a5-43a5-adb6-d0879d0b0917_1",
"incident_id": 690846,
"investigation_id": null,
"assigned_to": "analyst@company.onmicrosoft.com",
"severity": "Medium",
"status": "InProgress",
"classification": null,
"determination": null,
"investigation_state": "UnsupportedAlertType",
"detection_source": "WindowsDefenderAtp",
"category": "Execution",
"threat_family_name": null,
"title": "Suspicious behavior by cmd.exe was observed",
"description": "A suspicious behavior by cmd.exe was observed. This behavior may indicate malware installation or other malicious activities on the machine.",
"alert_creation_time": "2025-10-13T10:26:21.3333333Z",
"first_event_time": "2025-10-13T10:23:58.1472359Z",
"last_event_time": "2025-10-13T10:25:22.714708Z",
"last_update_time": "2026-02-13T08:14:22.61Z",
"resolved_time": null,
"machine_id": "4f683b2d393afc3149b0de4149acc5449acdf07e",
"alert_user": null,
"alert_files": [],
"comments": [
{
"comment": "\ud83d\udfe6 Intezer Automated Triage\n===================================\n\u26a0\ufe0f Suspicious - Not Mitigated - Follow Up Required\n===================================\n\n- Title: Suspicious behavior by cmd.exe was observed\n- Source: Microsoft Defender for Endpoint\n- Creation time: 13 Oct 25 | 10:26 UTC\n- External severity: Medium\n- Hosts: \n * workstation-01 (Windows10)\n- Description: A suspicious behavior by cmd.exe was observed. This behavior may indicate malware installation or other malicious activities on the machine.\n- TTPs:\n * Command and Control: Application Layer Protocol [T1071]\n * Defense Evasion: MMC [T1218.014]\n * Execution: Windows Command Shell [T1059.003]\n- Recommended actions: Ensure Device is Patched, Run Intezer Endpoint Scan (https://docs.intezer.com/docs/live-endpoint-analysis), Validate Activity with User\n- Malicious files: APTSimulator_scheduler.bat\n\nView alert: \ud83d\udc49 https://analyze.intezer.com/alerts/da0cfbb355-b5a5-43a5-adb6-d0879d0b0917_1?environment=mde",
"createdBy": "API Action",
"createdTime": "2025-10-13T10:40:32.4733451Z"
}
],
"alert_domains": null,
"alert_ips": null,
"alert_processes": null
},
{
"id": "da0e3de096-1789-43ff-bb2e-6cc22e5037ad_1",
"incident_id": 864492,
"investigation_id": null,
"assigned_to": null,
"severity": "Low",
"status": "New",
"classification": null,
"determination": null,
"investigation_state": "UnsupportedAlertType",
"detection_source": "WindowsDefenderAtp",
"category": "DefenseEvasion",
"threat_family_name": null,
"title": "Suspicious registry modification",
"description": "A suspicious process modified the registry on this device. Registry entries can be added, modified, or removed to change various settings of the system or behavior of a program. Attackers leverage this technique to gain persistence, escalate privileges, launch malicious codes, or to tamper with security products.",
"alert_creation_time": "2026-02-27T06:58:38.7266667Z",
"first_event_time": "2026-02-27T06:56:11.3416006Z",
"last_event_time": "2026-03-05T07:25:30.6007486Z",
"last_update_time": "2026-03-05T07:28:07.39Z",
"resolved_time": null,
"machine_id": "4f683b2d393afc3149b0de4149acc5449acdf07e",
"alert_user": null,
"alert_files": [],
"comments": [],
"alert_domains": null,
"alert_ips": null,
"alert_processes": null
},
{
"id": "da13c4af0a-bd35-4cb2-a556-fa972f3b80da_1",
"incident_id": 864492,
"investigation_id": 1779,
"assigned_to": "API-Automated Investigation and Response",
"severity": "Low",
"status": "Resolved",
"classification": null,
"determination": null,
"investigation_state": "Benign",
"detection_source": "WindowsDefenderAv",
"category": "Malware",
"threat_family_name": "Ceprolad",
"title": "An active '' malware ",
"description": "Malware and unwanted software are undesirable applications that perform annoying, disruptive, or harmful actions on affected machines. Some of these undesirable applications can replicate and spread from one machine to another. Others are able to receive commands from remote attackers and perform activities associated with cyber attacks.\n\nA malware is considered active if it is found running on the machine or it already has persistence mechanisms in place. Active malware detections are assigned higher severity ratings.\n\nBecause this malware was active, take precautionary measures and check for residual signs of infection.",
"alert_creation_time": "2026-03-02T07:26:21.22Z",
"first_event_time": "2026-03-02T07:25:05.4166175Z",
"last_event_time": "2026-03-02T07:25:05.4166175Z",
"last_update_time": "2026-03-02T07:37:19.2666667Z",
"resolved_time": "2026-03-02T07:37:19.1231428Z",
"machine_id": "4f683b2d393afc3149b0de4149acc5449acdf07e",
"alert_user": null,
"alert_files": [],
"comments": [],
"alert_domains": null,
"alert_ips": null,
"alert_processes": null
},
{
"id": "da2052972f-7cc3-42c8-8abf-8ac490d63c35_1",
"incident_id": 690846,
"investigation_id": null,
"assigned_to": "analyst@company.onmicrosoft.com",
"severity": "Medium",
"status": "InProgress",
"classification": null,
"determination": null,
"investigation_state": "UnsupportedAlertType",
"detection_source": "WindowsDefenderAtp",
"category": "Execution",
"threat_family_name": null,
"title": "Suspicious behavior by cmd.exe was observed",
"description": "A suspicious behavior by cmd.exe was observed. This behavior may indicate malware installation or other malicious activities on the machine.",
"alert_creation_time": "2025-10-07T10:25:41.1666667Z",
"first_event_time": "2025-10-07T10:23:44.5677721Z",
"last_event_time": "2025-10-07T10:25:10.6581007Z",
"last_update_time": "2026-02-13T08:14:22.61Z",
"resolved_time": null,
"machine_id": "4f683b2d393afc3149b0de4149acc5449acdf07e",
"alert_user": null,
"alert_files": [],
"comments": [
{
"comment": "\ud83d\udfe6 Intezer Automated Triage\n===================================\n\ud83e\udde8 Generic Threat - APTSimulator_schedu... - Not Mitigated - Escalated\n===================================\n\n- Title: Suspicious behavior by cmd.exe was observed\n- Source: Microsoft Defender for Endpoint\n- Creation time: 07 Oct 25 | 10:25 UTC\n- External severity: Medium\n- Hosts: \n * workstation-01 (Windows10)\n- Description: A suspicious behavior by cmd.exe was observed. This behavior may indicate malware installation or other malicious activities on the machine.\n- TTPs:\n * Command and Control: Application Layer Protocol [T1071]\n * Defense Evasion: MMC [T1218.014]\n * Execution: Windows Command Shell [T1059.003]\n- Recommended actions: Isolation, Stop and Quarantine File, Run Intezer Endpoint Scan (https://docs.intezer.com/docs/live-endpoint-analysis)\n- Malicious files: APTSimulator_scheduler.bat\n\nView alert: \ud83d\udc49 https://analyze.intezer.com/alerts/da2052972f-7cc3-42c8-8abf-8ac490d63c35_1?environment=mde",
"createdBy": "API Action",
"createdTime": "2025-10-07T10:27:41.3867936Z"
},
{
"comment": "\ud83d\udfe6 Intezer Automated Triage (\ud83d\udca1Triage updated \u2192 Risk Deescalated)\n===================================\n\u26a0\ufe0f Suspicious - Not Mitigated - Follow Up Required\n===================================\n\n- Title: Suspicious behavior by cmd.exe was observed\n- Source: Microsoft Defender for Endpoint\n- Creation time: 07 Oct 25 | 10:25 UTC\n- External severity: Medium\n- Hosts: \n * workstation-01 (Windows10)\n- Description: A suspicious behavior by cmd.exe was observed. This behavior may indicate malware installation or other malicious activities on the machine.\n- TTPs:\n * Command and Control: Application Layer Protocol [T1071]\n * Defense Evasion: MMC [T1218.014]\n * Execution: Windows Command Shell [T1059.003]\n- Recommended actions: Ensure Device is Patched, Run Intezer Endpoint Scan (https://docs.intezer.com/docs/live-endpoint-analysis), Validate Activity with User\n- Malicious files: APTSimulator_scheduler.bat\n\nView alert: \ud83d\udc49 https://analyze.intezer.com/alerts/da2052972f-7cc3-42c8-8abf-8ac490d63c35_1?environment=mde",
"createdBy": "API Action",
"createdTime": "2025-10-07T10:32:21.417826Z"
}
],
"alert_domains": null,
"alert_ips": null,
"alert_processes": null
},
{
"id": "da2068d331-0335-4479-9f96-e8f33db81aa9_1",
"incident_id": 864492,
"investigation_id": 1780,
"assigned_to": "API-Automated Investigation and Response",
"severity": "Low",
"status": "Resolved",
"classification": null,
"determination": null,
"investigation_state": "Benign",
"detection_source": "WindowsDefenderAv",
"category": "Malware",
"threat_family_name": "Ceprolad",
"title": "An active 'Ceprolad' malware in a command line was prevented from executing",
"description": "Malware and unwanted software are undesirable applications that perform annoying, disruptive, or harmful actions on affected machines. Some of these undesirable applications can replicate and spread from one machine to another. Others are able to receive commands from remote attackers and perform activities associated with cyber attacks.\n\nA malware is considered active if it is found running on the machine or it already has persistence mechanisms in place. Active malware detections are assigned higher severity ratings.\n\nBecause this malware was active, take precautionary measures and check for residual signs of infection.",
"alert_creation_time": "2026-03-05T07:26:09.89Z",
"first_event_time": "2026-03-05T07:25:08.6889036Z",
"last_event_time": "2026-03-05T07:25:08.6889036Z",
"last_update_time": "2026-03-05T07:37:44.9066667Z",
"resolved_time": "2026-03-05T07:37:44.65021Z",
"machine_id": "4f683b2d393afc3149b0de4149acc5449acdf07e",
"alert_user": null,
"alert_files": [],
"comments": [],
"alert_domains": null,
"alert_ips": null,
"alert_processes": null
},
{
"id": "da29243e25-be1e-47b7-9d40-e626df36345c_1",
"incident_id": 688299,
"investigation_id": null,
"assigned_to": null,
"severity": "Medium",
"status": "InProgress",
"classification": null,
"determination": null,
"investigation_state": "UnsupportedAlertType",
"detection_source": "WindowsDefenderAtp",
"category": "Persistence",
"threat_family_name": null,
"title": "New group added suspiciously",
"description": "A new group was added after suspicious activities were detected. An attacker might add new users to the group in an attempt to gain a better foothold on the machine or network.",
"alert_creation_time": "2025-09-18T14:59:47.52Z",
"first_event_time": "2025-09-18T14:53:30.7348596Z",
"last_event_time": "2025-09-21T14:53:43.8093531Z",
"last_update_time": "2025-09-21T14:56:44.5166667Z",
"resolved_time": null,
"machine_id": "4f683b2d393afc3149b0de4149acc5449acdf07e",
"alert_user": null,
"alert_files": [],
"comments": [
{
"comment": "\ud83d\udfe6 Intezer Automated Triage\n===================================\n\u26a0\ufe0f Suspicious - APTSimulator_schedu... - Not Mitigated - Follow Up Required\n===================================\n\n- Title: New group added suspiciously\n- Source: Microsoft Defender for Endpoint\n- Creation time: 18 Sep 25 | 14:59 UTC\n- External severity: Medium\n- Hosts: \n * workstation-01 (Windows10)\n- Description: A new group was added after suspicious activities were detected. An attacker might add new users to the group in an attempt to gain a better foothold on the machine or network.\n- TTPs:\n * Command and Control: Application Layer Protocol [T1071]\n * Discovery: Local Groups [T1069.001]\n * Persistence: Account Manipulation [T1098]\n- Recommended actions: Ensure Device is Patched, Run Intezer Endpoint Scan (https://docs.intezer.com/docs/live-endpoint-analysis), Validate Activity with User\n\nView alert: \ud83d\udc49 https://analyze.intezer.com/alerts/da29243e25-be1e-47b7-9d40-e626df36345c_1?environment=mde",
"createdBy": "API Action",
"createdTime": "2025-09-18T15:03:43.2796289Z"
}
],
"alert_domains": null,
"alert_ips": null,
"alert_processes": null
},
{
"id": "da2be6df1c-2401-4545-8111-5f75d0fd0223_1",
"incident_id": 690846,
"investigation_id": null,
"assigned_to": "analyst@company.onmicrosoft.com",
"severity": "Low",
"status": "InProgress",
"classification": null,
"determination": null,
"investigation_state": "UnsupportedAlertType",
"detection_source": "WindowsDefenderAtp",
"category": "Execution",
"threat_family_name": null,
"title": "Suspicious JavaScript process",
"description": "A suspicious JavaScript process was observed on this device. Attackers typically use JavaScript to download secondary payloads, run additional commands, and perform other malicious activities on the target device.",
"alert_creation_time": "2025-10-01T10:26:20.6566667Z",
"first_event_time": "2025-10-01T10:24:19.1071611Z",
"last_event_time": "2025-10-07T10:24:27.1065475Z",
"last_update_time": "2026-02-13T08:14:22.61Z",
"resolved_time": null,
"machine_id": "4f683b2d393afc3149b0de4149acc5449acdf07e",
"alert_user": null,
"alert_files": [],
"comments": [
{
"comment": "\ud83d\udfe6 Intezer Automated Triage\n===================================\n\u26a0\ufe0f Suspicious - en-US.js - Not Mitigated - Follow Up Required\n===================================\n\n- Title: Suspicious JavaScript process\n- Source: Microsoft Defender for Endpoint\n- Creation time: 01 Oct 25 | 10:26 UTC\n- External severity: Low\n- Hosts: \n * workstation-01 (Windows10)\n- Description: A suspicious JavaScript process was observed on this device. Attackers typically use JavaScript to download secondary payloads, run additional commands, and perform other malicious activities on the target device.\n- TTPs:\n * Command and Control: Application Layer Protocol [T1071]\n * Defense Evasion: Indicator Removal on Host [T1070]\n * Defense Evasion: Indicator Removal on Host: Timestomp [T1070.006]\n- Recommended actions: Ensure Device is Patched, Run Intezer Endpoint Scan (https://docs.intezer.com/docs/live-endpoint-analysis), Validate Activity with User\n\nView alert: \ud83d\udc49 https://analyze.intezer.com/alerts/da2be6df1c-2401-4545-8111-5f75d0fd0223_1?environment=mde",
"createdBy": "API Action",
"createdTime": "2025-10-01T10:30:36.462226Z"
}
],
"alert_domains": null,
"alert_ips": null,
"alert_processes": null
},
{
"id": "da37252b75-0446-4a7b-99b4-e64886557bd3_1",
"incident_id": 688299,
"investigation_id": null,
"assigned_to": null,
"severity": "Low",
"status": "InProgress",
"classification": null,
"determination": null,
"investigation_state": "UnsupportedAlertType",
"detection_source": "WindowsDefenderAtp",
"category": "Execution",
"threat_family_name": null,
"title": "Suspicious JavaScript process",
"description": "A suspicious JavaScript process was observed on this device. Attackers typically use JavaScript to download secondary payloads, run additional commands, and perform other malicious activities on the target device.",
"alert_creation_time": "2025-09-18T14:59:46.57Z",
"first_event_time": "2025-09-18T14:54:11.4061419Z",
"last_event_time": "2025-09-21T14:54:00.575478Z",
"last_update_time": "2025-09-21T14:56:36.6533333Z",
"resolved_time": null,
"machine_id": "4f683b2d393afc3149b0de4149acc5449acdf07e",
"alert_user": null,
"alert_files": [],
"comments": [
{
"comment": "\ud83d\udfe6 Intezer Automated Triage\n===================================\n\u26a0\ufe0f Suspicious - wscript.exe - Not Mitigated - Follow Up Required\n===================================\n\n- Title: Suspicious JavaScript process\n- Source: Microsoft Defender for Endpoint\n- Creation time: 18 Sep 25 | 14:59 UTC\n- External severity: Low\n- Hosts: \n * workstation-01 (Windows10)\n- Description: A suspicious JavaScript process was observed on this device. Attackers typically use JavaScript to download secondary payloads, run additional commands, and perform other malicious activities on the target device.\n- TTPs:\n * Command and Control: Application Layer Protocol [T1071]\n * Defense Evasion: Indicator Removal on Host [T1070]\n * Defense Evasion: Indicator Removal on Host: Timestomp [T1070.006]\n- Recommended actions: Ensure Device is Patched, Run Intezer Endpoint Scan (https://docs.intezer.com/docs/live-endpoint-analysis), Validate Activity with User\n\nView alert: \ud83d\udc49 https://analyze.intezer.com/alerts/da37252b75-0446-4a7b-99b4-e64886557bd3_1?environment=mde",
"createdBy": "API Action",
"createdTime": "2025-09-18T15:06:13.2743521Z"
}
],
"alert_domains": null,
"alert_ips": null,
"alert_processes": null
}
]
}
]
輸出訊息
「Get User Related Alerts」動作可傳回下列輸出訊息:
| 輸出訊息 | 訊息說明 |
|---|---|
|
動作已成功執行。 |
Error executing action "Get User Related Alerts". Reason:
ERROR_REASON |
操作失敗。 請檢查伺服器連線、輸入參數或憑證。 |
指令碼執行結果
下表列出使用「Get User Related Alerts」動作時,指令碼結果輸出的值:
| 指令碼結果名稱 | 值 |
|---|---|
is_success |
true或false |
隔離機器
使用 Microsoft Defender for Endpoint 隔離機器。機器可以設定為完全隔離或選擇性隔離。Outlook、商務用 Skype 和 Teams 應用程式在隔離的機器上仍可繼續運作。
參數
| 參數顯示名稱 | 類型 | 預設值 | 是否為必要 | 說明 |
|---|---|---|---|---|
| 隔離類型 | DDL | 完整 可能的值:
|
是 | 指定隔離類型。 |
| 註解 | 字串 | 不適用 | 是 | 請說明需要隔離機器的原因。 |
| 要建立洞察嗎? | 核取方塊 | 已勾選 | 如果啟用,這項動作在執行成功後,會建立包含相關資訊的 Google SecOps Insight。 |
用途
隔離疑似遭感染的機器。舉例來說,Defender ATP 連接器快訊已擷取至 Google SecOps 伺服器,在快訊分析期間,發現與快訊機器 (案件實體) 相關,可能已遭感染,需要隔離。
執行日期
這項動作會在下列動作中執行:
- 主機
- IP 位址
動作結果
指令碼執行結果
如果 API 端點針對執行的「每個」實體傳回 201 狀態,且 JSON 回應中的「status」為「Pending」,表示 API 要求已成功執行,則為 True。如果至少有一個實體的操作失敗,最終結果應為失敗 (False)。
| 指令碼執行結果名稱 | 價值選項 | 範例 |
|---|---|---|
| is_success | True/False | is_success:False |
JSON 結果
{
"@odata.context": "https://api.securitycenter.windows.com/api/$metadata#MachineActions/$entity",
"id": "example-id",
"type": "Isolate",
"requestor": "requestor-id",
"requestorComment": "Machine Isolation due to alert ...",
"status": "Pending",
"machineId": "machine-id",
"creationDateTimeUtc": "2019-11-21T03:55:59.5419077Z",
"lastUpdateDateTimeUtc": "2019-11-21T03:55:59.5419077Z",
"cancellationRequestor": null,
"cancellationComment": null,
"cancellationDateTimeUtc": null,
"errorHResult": 0,
"scope": null,
"relatedFileInfo": null
}
深入分析
- 洞察邏輯:如果機器是使用 Defender ATP 代理程式隔離,請建立洞察資料來指出這點。
- 類型:實體。
- Title (字串):實體。
- IdentifierMessage: "Host was isolated using Microsoft Defender for Endpoint."
列出警告
根據提供的搜尋條件,列出 Microsoft Defender for Endpoint 快訊。這項動作會以表格和 JSON 檢視表單的形式,傳回找到的警示資訊,並將原始警示資料儲存並附加至動作輸出 JSON 檔案。
參數
| 參數顯示名稱 | 類型 | 預設值 | 是否為必要 | 說明 |
|---|---|---|---|---|
| 時間範圍 | 整數 | 3 | 否 | 指定擷取快訊的時間範圍 (以小時為單位)。 |
| 狀態 | 字串 | Unknown、New、InProgress、Resolved | 否 | 指定要尋找的快訊狀態。 參數接受多個值,請以半形逗號分隔。 |
| 嚴重性 | 字串 | 不適用 | 否 | 指定要尋找的事件嚴重性。 如未提供,動作會尋找所有嚴重性。 參數接受多個值,請以半形逗號分隔。 可能的值:UnSpecified、Informational、Low、Medium 和 High |
| 類別 | 字串 | 不適用 | 否 | 指定要尋找的快訊類別。 如未提供,動作會尋找所有類別。 參數接受多個值,請以半形逗號分隔。 可能的值: 'Collection'、'CommandAndControl'、'CredentialAccess'、'DefenseEvasion'、 'Discovery'、'Execution'、'Exfiltration'、'Exploit'、'InitialAccess'、 'LateralMovement'、'Malware'、'Persistence'、'PrivilegeEscalation'、 'Ransomware'、'SuspiciousActivity'、'UnwantedSoftware'。 |
| 事件 ID | 整數 | 不適用 | 否 | 指定 Microsoft Defender 事件 ID,找出相關警示。 |
用途
這項動作可用於查看 Defender ATP 警告,並傳送至 Google SecOps 伺服器,供使用者參考。舉例來說,處理來自 Defender ATP 連接器的警告時,使用者會設定「List Warnings」動作,接受已處理的警告 IncidentId 做為輸入參數,從 Defender ATP 伺服器提取詳細資料,其中包含屬於單一 Defender ATP 事件的其他警告。
執行日期
這項操作會對所有實體執行。
動作結果
指令碼執行結果
| 指令碼執行結果名稱 | 價值選項 | 範例 |
|---|---|---|
| is_success | True/False | is_success:False |
JSON 結果
{
"@odata.context": "https://api.securitycenter.windows.com/api/$metadata#Alerts",
"value": [
{
"id": "example_id",
"incidentId": 2,
"investigationId": null,
"assignedTo": null,
"severity": "Medium",
"status": "New",
"classification": null,
"determination": null,
"investigationState": "UnsupportedAlertType",
"detectionSource": "WindowsDefenderAtp",
"category": "Execution",
"threatFamilyName": null,
"title": "Unexpected behavior observed by a process run with no command line arguments",
"description": "The legitimate process by this name does not normally exhibit this behavior when run with no command line arguments. \nSuch unexpected behavior may be a result of extraneous code injected into a legitimate process, or a malicious executable masquerading as the legitimate one by name.",
"alertCreationTime": "2019-11-19T03:56:35.3007009Z",
"firstEventTime": "2019-11-19T03:54:16.0441057Z",
"lastEventTime": "2019-11-19T03:54:16.0441057Z",
"lastUpdateTime": "2019-11-19T03:56:38.45Z",
"resolvedTime": null,
"machineId": "machine-id",
"alertUser": null,
"comments": [],
"alertFiles": [],
"alertDomains": [],
"alertIps": [],
"alertProcesses": []
}
]
}
指標清單
列出 Microsoft Defender for Endpoint 中的指標。
參數
| 參數顯示名稱 | 類型 | 預設值 | 是否為必要 | 說明 |
|---|---|---|---|---|
| 指標 | CSV | 不適用 | 否 | 指定要擷取的指標,並以半形逗號分隔。 |
| 指標類型 | CSV | FileSha1,FileSha256,FileMd5,CertificateThumbprint,IpAddress,DomainName, Url | 否 | 指定要擷取的指標類型清單,並以半形逗號分隔。 可能的值:FileSha1、FileSha256、FileMd5、CertificateThumbprint、IpAddress、DomainName、Url。 |
| 動作 | CSV | Warn,Block,Audit,Alert,AlertAndBlock,BlockAndRemediate,Allowed | 否 | 指定要用於篩選的指標動作清單,並以半形逗號分隔。 可能的值:Warn、Block、Audit、Alert、AlertAndBlock、BlockAndRemediate、Allowed |
| 嚴重性 | CSV | 資訊、低、中、高 | 否 | 指定要用於篩選的嚴重性清單,並以半形逗號分隔。 可能的值:Informational、Low、Medium、High |
| 要傳回的結果數量上限 | 整數 | 50 | 否 | 指定要傳回的指標數量。 |
執行日期
這項動作不會對實體執行。
動作結果
指令碼執行結果
| 指令碼執行結果名稱 | 價值選項 | 範例 |
|---|---|---|
| is_success | True/False | is_success:False |
JSON 結果
{
"id": "18",
"indicatorValue": "110e7d15b011d7fac48f2bd61114db1022197f7a",
"indicatorType": "FileSha1",
"action": "Audit",
"createdBy": "45e9773c-100e-4a9f-ad37-d8e182e9ed26",
"severity": "Informational",
"category": 1,
"application": "demo-test",
"educateUrl": null,
"bypassDurationHours": null,
"title": "test",
"description": "test",
"recommendedActions": "nothing",
"creationTimeDateTimeUtc": "2022-02-08T14:20:34.9071582Z",
"expirationTime": null,
"lastUpdateTime": "2022-02-08T14:20:34.9151307Z",
"lastUpdatedBy": null,
"rbacGroupNames": [],
"rbacGroupIds": [],
"notificationId": null,
"notificationBody": null,
"version": null,
"mitreTechniques": [],
"historicalDetection": false,
"lookBackPeriod": null,
"generateAlert": true,
"additionalInfo": null,
"createdByDisplayName": "Example Defender ATP",
"externalId": null,
"createdBySource": "PublicApi",
"certificateInfo": null
}
案件總覽
| 結果類型 | 值 / 說明 | 類型 |
|---|---|---|
| 輸出訊息* | 動作不應失敗,也不應停止應對手冊執行作業: 如果資料可用 (is_success=true):「Successfully found indicators for the provided criteria in Microsoft Defender for Endpoint.」(已成功在 Microsoft Defender for Endpoint 中找到符合指定條件的指標)。 如果沒有資料 (is_success=false):「在 Microsoft Defender for Endpoint 中,找不到符合指定條件的指標。」 動作應失敗並停止執行應對手冊: 如果發生嚴重錯誤,例如 憑證錯誤、無法連線至伺服器等,系統會回報:「Error executing action "List Indicators". 原因:{0}''.format(error.Stacktrace) 如果提供的「指標類型」參數無效:「執行『列出指標』動作時發生錯誤。原因:「指標類型」參數的值無效。 可能的值:FileSha1、FileSha256、FileMd5、CertificateThumbprint、IpAddress、DomainName、Url。 如果提供無效的「Actions」參數:「Error executing action "List Indicators". 原因:「Actions」參數的值無效。可能的值:Warn、Block、Audit、Alert、AlertAndBlock、BlockAndRemediate、Allowed。 如果提供的「Severity」參數無效:「Error executing action "List Indicators". 原因:「Actions」參數的值無效。可能的值:Informational、Low、Medium、High。 |
一般 |
| 案件總覽表格 | 發現指標 Type: indicatorType Action: action Severity: severity Description: description Title: title Recommendation: recommendedActions |
實體 |
列出機器
根據搜尋時提供的參數,取得在 Microsoft Defender for Endpoint 伺服器註冊的機器相關資訊。
參數
| 參數 | 類型 | 預設值 | 是否為必要 | 說明 |
|---|---|---|---|---|
| 上次出現時間範圍 | 整數 | 不適用 | 否 | 指定要搜尋的上次出現時間範圍 (以小時為單位)。 |
| 機器名稱 | 字串 | 不適用 | 否 | 指定要尋找的完整機器名稱。 |
| 機器 IP 位址 | 字串 | 不適用 | 否 | 指定要尋找的機器 IP 位址。 |
| 機器風險評分 | 字串 | 無、低、中、高 | 否 | 指定要尋找的機器風險評分。 參數接受多個值,請以半形逗號分隔。 |
| 機器健康狀態 | 字串 | Active、Inactive、ImpairedCommunication、NoSensorData、NoSensorDataImpairedCommunication | 否 | 指定要尋找的機器健康狀態。 參數接受多個值,請以半形逗號分隔。 |
| 機器 OS 平台 | 字串 | 不適用 | 否 | 指定要尋找的機器 OS 平台。 |
| RBAC 群組 ID | 字串 | 不適用 | 否 | 指定要尋找的 RBAC 群組 ID。 |
用途
這項動作可用於調查,取得在 Defender ATP 伺服器上註冊的裝置資訊。這項動作通常是手動執行,使用者不必切換回 Defender ATP 控制台,就能查看 Defender ATP 代理程式在哪些機器上運作。
執行日期
這項操作會對所有實體執行。
動作結果
指令碼執行結果
| 指令碼執行結果名稱 | 價值選項 | 範例 |
|---|---|---|
| is_success | True/False | is_success:False |
JSON 結果
{
"@odata.context": "https://api.securitycenter.windows.com/api/$metadata#Machines",
"value": [
{
"id": "example-id",
"computerDnsName": "example-name",
"firstSeen": "2019-11-18T11:13:04.0588699Z",
"lastSeen": "2019-11-20T09:59:28.0646303Z",
"osPlatform": "Windows10",
"osVersion": null,
"osProcessor": "x64",
"version": "1803",
"lastIpAddress": "192.0.2.138",
"lastExternalIpAddress": "203.0.113.35",
"agentVersion": "10.4860.17134.982",
"osBuild": 17134,
"healthStatus": "Active",
"rbacGroupId": 0,
"rbacGroupName": null,
"riskScore": "High",
"exposureLevel": "Medium",
"aadDeviceId": null,
"machineTags": []
},{
"id": "example-id",
"computerDnsName": "example-name",
"firstSeen": "2019-11-20T08:36:16.2721384Z",
"lastSeen": "2019-11-20T08:36:52.7182837Z",
"osPlatform": "Windows10",
"osVersion": null,
"osProcessor": "x64",
"version": "1803",
"lastIpAddress": "192.0.2.141",
"lastExternalIpAddress": "203.0.113.35",
"agentVersion": "10.4850.17134.191",
"osBuild": 17134,
"healthStatus": "Active",
"rbacGroupId": 0,
"rbacGroupName": null,
"riskScore": "None",
"exposureLevel": "Medium",
"aadDeviceId": null,
"machineTags": []
}
]
}
乒乓
使用整合設定頁面提供的參數,測試與 Microsoft Defender for Endpoint 執行個體的連線能力。
參數
不適用
用途
這項動作可用於測試連線能力,並可手動執行,不屬於應對手冊。
執行日期
這項操作會對所有實體執行。
動作結果
指令碼執行結果
| 指令碼執行結果名稱 | 價值選項 | 範例 |
|---|---|---|
| is_success | True/False | is_success:False |
執行進階威脅搜索查詢
執行 Microsoft Defender for Endpoint 進階威脅搜尋查詢。請注意,引號、換行符號或其他特殊符號必須逸出,例如使用反斜線逸出引號。
參數
| 參數顯示名稱 | 類型 | 預設值 | 為必填項目 | 說明 |
|---|---|---|---|---|
| 參數顯示名稱 | 類型 | 預設值 | 是否為必要 | 說明 |
| 查詢 | 字串 | 不適用 | 是 | 要執行的進階威脅搜捕查詢。 |
用途
使用者可以透過威脅搜尋查詢,查詢在處理特定 Defender 警示時,Defender ATP 收集的資料。使用者可以透過這項動作,執行這些進階威脅搜尋查詢。
執行日期
這項操作會對所有實體執行。
動作結果
指令碼執行結果
| 指令碼執行結果名稱 | 價值選項 | 範例 |
|---|---|---|
| is_success | True/False | is_success:False |
JSON 結果
{
"Stats": {
"ExecutionTime": 0.0156652,
"resource_usage": {
"cache": {
"memory": {
"hits": 13,
"misses": 0,
"total": 13
},
"disk": {
"hits": 0,
"misses": 0,
"total": 0
}
},
"cpu": {
"user": "00:00:00.0156250",
"kernel": "00:00:00",
"total cpu": "00:00:00.0156250"
},
"memory": {
"peak_per_node": 33554624
}
},
"dataset_statistics": [
{
"table_row_count": 2,
"table_size": 60
}
]
},
"Schema": [
{
"Name": "EventTime",
"Type": "DateTime"
},
{
"Name": "FileName",
"Type": "String"
},
{
"Name": "InitiatingProcessFileName",
"Type": "String"
}
],
"Results": [
{
"EventTime": "2019-11-18T11:13:07.043128Z",
"FileName": "csc.exe",
"InitiatingProcessFileName": "powershell.exe"
},
{
"EventTime": "2019-11-19T03:54:14.4256361Z",
"FileName": "csc.exe",
"InitiatingProcessFileName": "powershell.exe"
}
]
}
執行防毒掃描
使用 Microsoft Defender for Endpoint 在主機上啟動防毒掃描。Defender ATP 掃描分為兩種:完整或快速。
參數
| 參數顯示名稱 | 類型 | 預設值 | 是否為必要 | 說明 |
|---|---|---|---|---|
| 防毒軟體掃描類型 | DDL | 完整 可能的值:
|
是 | 指定要在機器上啟動完整或快速防毒掃描。 |
| 註解 | 字串 | 不適用 | 是 | 請說明為何需要對機器執行防毒掃描。 |
用途
Defender ATP 連接器發出警示,在處理警示的過程中,系統在與 Google SecOps 案件實體相關的機器上,發現惡意軟體入侵指標,因此使用者決定在機器上執行防毒掃描,嘗試找出主機上的惡意軟體。
執行日期
這項動作會對下列實體執行:
- 主機
- IP 位址
動作結果
指令碼執行結果
如果 API 端點針對執行的「每個」實體傳回 201 狀態,且 JSON 回應中的「status」為「Pending」,表示 API 要求已成功執行,則為 True。如果至少有一個實體的操作失敗,最終結果應為失敗 (False)。
| 指令碼執行結果名稱 | 價值選項 | 範例 |
|---|---|---|
| is_success | True/False | is_success:False |
JSON 結果
{
"@odata.context": "https://api.securitycenter.windows.com/api/$metadata#MachineActions/$entity",
"id": "example-id",
"type": "RunAntiVirusScan",
"requestor": "requestor_id",
"requestorComment": "Run antivirus scan on suspect",
"status": "Pending",
"machineId": "machine-id",
"creationDateTimeUtc": "2019-11-21T11:07:06.611628Z",
"lastUpdateDateTimeUtc": "2019-11-21T11:07:06.611628Z",
"cancellationRequestor": null,
"cancellationComment": null,
"cancellationDateTimeUtc": null,
"errorHResult": 0,
"scope": null,
"relatedFileInfo": null
}
停止並隔離特定機器上的檔案
使用 Microsoft Defender for Endpoint 代理程式,停止在特定機器上執行檔案,並將檔案隔離。動作適用於主機或 IP Google SecOps 實體。
參數
| 參數顯示名稱 | 類型 | 預設值 | 是否為必要 | 說明 |
|---|---|---|---|---|
| 要隔離的 SHA1 檔案雜湊 | 字串 | 不適用 | 是 | 指定要停止並隔離的檔案 SHA-1 雜湊。 注意:SHA-1 雜湊必須使用小寫字母,動作才能找到相符的檔案。 |
| 註解 | 字串 | 不適用 | 是 | 請說明為何需要對機器執行防毒掃描。 |
| 要建立洞察嗎? | 核取方塊 | 已勾選 | 如果啟用,動作執行成功後,會建立 Google SecOps Insight 並提供相關資訊。 |
用途
處理來自 Defender ATP 連接器的快訊時,可以使用「Stop and Quarantine File」動作,阻止特定檔案執行,防止機器遭到入侵。這項操作的需求可能來自進階威脅搜尋,使用者可能會發現一些潛在惡意檔案,而目前使用者想要在單一機器上封鎖這些檔案。
執行日期
這項動作會對下列實體執行:
- 主機
- IP 位址
動作結果
指令碼執行結果
可以是 True 或 False。如果 API 端點針對執行的每個實體傳回狀態 201,且 JSON 回應中的「status」為「Pending」,表示 API 要求已成功執行,則為 True。如果至少有一個實體動作失敗,最終結果應為失敗 (False)。
| 指令碼執行結果名稱 | 價值選項 | 範例 |
|---|---|---|
| is_success | True/False | is_success:False |
JSON 結果
{
"@odata.context": "https://api.securitycenter.windows.com/api/$metadata#MachineActions/$entity",
"id": "example-id",
"type": "StopAndQuarantineFile",
"requestor": "requestor-id",
"requestorComment": "Stopping and quarantining putty",
"status": "Pending",
"machineId": "machine-id",
"creationDateTimeUtc": "2019-11-25T10:05:21.3641296Z",
"lastUpdateDateTimeUtc": "2019-11-25T10:05:21.3641296Z",
"cancellationRequestor": null,
"cancellationComment": null,
"cancellationDateTimeUtc": null,
"errorHResult": 0,
"scope": null,
"relatedFileInfo": {
"fileIdentifier": "d932604ab8e9debe475415851fd26929a0c0dcd1",
"fileIdentifierType": "Sha1"
}
}
深入分析
- 類型:實體。
- Title (字串):實體。
- IdentifierMessage (String):「SHA-1 檔案雜湊為 {0} 的檔案已於 {1} 停止並隔離」。格式 (filehash,entity.Identifier)。
提交實體指標
在 Microsoft Defender for Endpoint 中,將實體提交為指標。
參數
| 參數顯示 名稱 | 類型 | 預設值 | 是否為必要 | 說明 |
|---|---|---|---|---|
| 動作 | DDL | 封鎖 可能的值:
|
是 | 指定要對實體套用的動作。 注意:「Block And Remediate」值僅適用於 filehash 實體。 |
| 嚴重性 | DDL | 高 可能的值:
|
是 | 指定找到實體的嚴重性。 |
| 應用程式 | 字串 | 不適用 | 否 | 指定與實體相關的應用程式。 |
| 指標快訊標題 | 字串 | 不適用 | 是 | 指定快訊標題,以便在環境中識別。 |
| 說明 | 字串 | Google SecOps Remediation | 是 | 指定實體的說明。 |
| 建議做法 | 字串 | 不適用 | 否 | 指定處理實體的應變措施建議。 |
執行日期
這項動作會對下列實體執行:
- IP 位址
- 網址
- Filehash
動作結果
指令碼執行結果
| 指令碼執行結果名稱 | 價值選項 | 範例 |
|---|---|---|
| is_success | True/False | is_success:False |
案件總覽
| 結果類型 | 值 / 說明 | 類型 |
|---|---|---|
| 輸出訊息* | 動作不應失敗,也不應停止應對手冊執行作業: 如果有一個實體的資料可用 (is_success = true):「已成功將下列實體做為指標提交至 Microsoft Defender for Endpoint:{entity.identifier}」。 如果無法取得某個實體的資料 (is_success=true):「動作無法將下列實體做為指標提交至 Microsoft Defender for Endpoint:{entity.identifier}」。 如果系統針對一個實體回報 403 狀態碼: 「執行個體沒有足夠權限,無法提交下列實體: {entity.identifier} 如果所有實體都沒有資料 (is_success=false):「提供的實體皆未做為指標提交至 Microsoft Defender for Endpoint。」 如果實體已是指標:「下列實體已是 Microsoft Defender for Endpoint 中的指標:{entity.identifier}」 動作應失敗並停止執行應對手冊: 如果發生嚴重錯誤,例如憑證錯誤、無法連線至伺服器等:「執行『提交實體指標』動作時發生錯誤。原因: {0}''.format(error.Stacktrace) 如果所有實體都回報 403 狀態碼:「Error executing action 'Submit Entity Indicators'. 原因:由於執行個體權限,未建立任何指標,請檢查設定。 |
一般 |
取消隔離機器
取消隔離先前使用 Microsoft Defender for Endpoint 隔離的機器。
參數
| 參數顯示名稱 | 類型 | 預設值 | 是否為必要 | 說明 |
|---|---|---|---|---|
| 註解 | 字串 | 不適用 | 是 | 請說明為何要取消隔離機器。 |
| 要建立洞察嗎? | 核取方塊 | 已勾選 | 如果啟用,這項動作在執行成功後,會建立包含相關資訊的 Google SecOps Insight。 |
用途
這項動作適用於機器已隔離,但劇本處理期間收集到新資料的情況 (例如,第一部機器已隔離,接著我們為可疑檔案建立威脅指標,並執行「停止並隔離」動作,從受影響的機器中移除這個檔案),我們可以認為從隔離區移除受影響的機器是安全的。
執行日期
這項動作會對下列實體執行:
- 主機
- IP 位址
動作結果
指令碼執行結果
如果 API 端點針對執行的「每個」實體傳回 201 狀態,且 JSON 回應中的「status」為「Pending」,表示 API 要求已成功執行,則為 True。如果至少有一個實體的操作失敗,最終結果應為失敗 (False)。
| 指令碼執行結果名稱 | 價值選項 | 範例 |
|---|---|---|
| is_success | True/False | is_success:False |
JSON 結果
{
"@odata.context": "https://api.securitycenter.windows.com/api/$metadata#MachineActions/$entity",
"id": "example-id",
"type": "Unisolate",
"requestor": "requestor-id",
"requestorComment": "Unisolate machine due to the following remediation measures taken...",
"status": "Pending",
"machineId": "machine-id",
"creationDateTimeUtc": "2019-11-21T03:59:34.7389352Z",
"lastUpdateDateTimeUtc": "2019-11-21T03:59:34.7389352Z",
"cancellationRequestor": null,
"cancellationComment": null,
"cancellationDateTimeUtc": null,
"errorHResult": 0,
"scope": null,
"relatedFileInfo": null
}
深入分析
- 類型:實體
- Title: 實體。
- IdentifierMessage:已移除 Microsoft Defender for Endpoint 隔離。
更新警告內容
更新特定 Microsoft Defender for Endpoint 警告。這項動作可用於關閉 Microsoft Defender for Endpoint 中的警示。
參數
| 參數 | 類型 | 預設值 | 是否為必要 | 說明 |
|---|---|---|---|---|
| 快訊 ID | 字串 | 不適用 | 是 | 指定要更新的 Microsoft Defender for Endpoint 警告 ID。 |
| 狀態 | DDL | 新增 可能的值:
|
否 | 指定要更新的警告狀態。 |
| 指派對象 | 字串 | 不適用 | 否 | 如要更新這個欄位,請指定使用者資訊。 |
| 分類 | DDL | 不明 可能的值:
|
否 | 指定要用來更新快訊的分類。 |
| 判定結果 | DDL | NotAvailable 可能的值:
|
否 | 指定要用來更新快訊的判定結果。 |
用途
使用這項動作更新 Defender ATP 警告。
使用這項動作,介入涉及 Defender ATP 警告分析的工作流程。
在 Google SecOps 處理完警示後,您可以忽略 Defender ATP 警示,讓 Defender ATP 和 Google SecOps 警示清單保持一致。此外,您也可以變更快訊,顯示快訊分析的進度 (例如設定
assignedTo屬性,或將快訊狀態設為inProgress)。
執行日期
這項操作會對所有實體執行。
動作結果
指令碼執行結果
| 指令碼執行結果名稱 | 價值選項 | 範例 |
|---|---|---|
| is_success | True/False | is_success:False |
JSON 結果
{
"@odata.context": "https://api.securitycenter.windows.com/api/$metadata#Alerts/$entity",
"id": "example-id",
"incidentId": 1,
"investigationId": null,
"assignedTo": null,
"severity": "Informational",
"status": "Resolved",
"classification": null,
"determination": null,
"investigationState": "UnsupportedAlertType",
"detectionSource": "WindowsDefenderAtp",
"category": "Execution",
"threatFamilyName": null,
"title": "[Test Alert] Suspicious Powershell commandline",
"description": "*** This is a test alert ***\nA suspicious Powershell commandline was found on the machine. This commandline might be used during installation, exploration, or in some cases with lateral movement activities which are used by attackers to invoke modules, download external payloads, and get more information about the system. Attackers usually use Powershell to bypass security protection mechanisms by executing their payload in memory without touching the disk and leaving any trace.",
"alertCreationTime": "2019-11-18T11:17:48.287421Z",
"firstEventTime": "2019-11-18T11:15:06.5226815Z",
"lastEventTime": "2019-11-18T11:15:06.5226815Z",
"lastUpdateTime": "2019-11-20T04:12:03.6066667Z",
"resolvedTime": "2019-11-20T04:12:03.4976288Z",
"machineId": "machine-id",
"alertUser": {
"accountName": "Administrator",
"domainName": "example-domain"
},
"comments": [],
"alertFiles": [
{
"sha1": "3ce71813199abae99348f61f0caa34e2574f831c",
"sha256": "9a7c58bd98d70631aa1473f7b57b426db367d72429a5455b433a05ee251f3236",
"filePath": "C:\\Windows\\System32\\cmd.exe",
"fileName": "cmd.exe"
},
{
"sha1": "1b3b40fbc889fd4c645cc12c85d0805ac36ba254",
"sha256": "d3f8fade829d2b7bd596c4504a6dae5c034e789b6a3defbe013bda7d14466677",
"filePath": "C:\\Windows\\System32\\WindowsPowerShell\\v1.0\\powershell.exe",
"fileName": "powershell.exe"
}
],
"alertDomains": [],
"alertIps": [],
"alertProcesses": []
}
等待工作狀態
等待工作狀態。
參數
| 參數顯示名稱 | 類型 | 預設值 | 是否為必要 | 說明 |
|---|---|---|---|---|
| 工作 ID | 字串 | 不適用 | 是 | 工作 ID 清單,以半形逗號分隔。 |
執行日期
這項操作會對所有實體執行。
動作結果
指令碼執行結果
| 指令碼執行結果名稱 | 價值選項 | 範例 |
|---|---|---|
| is_success | True/False | is_success:False |
JSON 結果
[
{
"status": "Succeeded",
"creation_date_time_utc": "2020-02-08T03:24:52.8526634Z",
"cancellation_requestor": null,
"cancellation_date_time_utc": null,
"id": "2e39d22e-60a7-4267-899c-a1471e800000",
"last_update_date_time_utc": "2020-02-08T03:25:35.8345081Z",
"related_file_info": null,
"cancellation_comment": null,
"requestor": "e4fc6454-754d-47f7-bbdb-045fad600000",
"error_h_result": 0,
"scope": "Selective",
"machine_id": "fbc85cf3fbcc8bb14d1a84fcf7bbae4531f00000",
"type": "Isolate",
"requestor_comment": "test"
}
]
連接器
如要瞭解如何在 Google SecOps 中設定連接器,請參閱「設定連接器」一文。
如要設定所選連接器,請使用下表列出的連接器專屬參數:
Microsoft Defender ATP 連接器
Microsoft Defender ATP 事件連接器使用的 Defender ATP SIEM API 已於 2022 年 3 月 1 日淘汰。
連接器會定期連線至 Defender ATP API 端點,並提取特定時間範圍內產生的快訊清單。針對已處理的快訊,連接器會在個別要求中,從 Defender ATP 提取偵測資訊。偵測結果含有 AlertId 欄位,可用於將偵測結果與特定警示建立關聯。
連接器參數
使用下列參數設定連接器:
| 參數顯示名稱 | 類型 | 預設值 | 為必填項目 | 說明 |
|---|---|---|---|---|
| 產品欄位名稱 | 字串 | ProductName | 是 | 說明儲存產品名稱的欄位名稱。 |
| 事件欄位名稱 | 字串 | AlertName | 是 | 說明儲存事件名稱的欄位名稱。 |
| 環境欄位名稱 | 字串 | "" | 否 | 說明儲存環境名稱的欄位名稱。 如果找不到環境欄位,環境會是「」。 |
| 環境規則運算式模式 | 字串 | .* | 否 | 規則運算式模式,用於對 預設值為 .*,可擷取所有值並傳回未變更的值。 用於允許使用者使用規則運算式邏輯操控環境欄位。 如果規則運算式模式為空值或空白,或環境值為空值,則最終環境結果為「」。 |
| API 根層級 | 字串 | https://api.securitycenter.windows.com | 是 | 與整合功能搭配使用的 API 根網址。 為提高效能,您可以使用最靠近您所在位置的伺服器:
|
| Azure Active Directory ID | 字串 | 不適用 | 是 | Microsoft Entra 租戶 ID,可在「Active Directory」>「App Registration」>「Your application」>「Directory (tenant) ID」中查看。 |
| 整合用戶端 ID | 字串 | 不適用 | 是 | 在 Microsoft Entra 中註冊應用程式時,為整合新增的用戶端 (應用程式) ID。 |
| 整合用戶端密鑰 | 密碼 | 不適用 | 是 | 為整合註冊 Azure AD 應用程式時輸入的密鑰。 |
| SIEM 用戶端 ID | 字串 | 不適用 | 是 | Microsoft Defender for Endpoint 中已啟用 SIEM 整合的用戶端 (應用程式) ID。 |
| SIEM 用戶端密鑰 | 密碼 | 不適用 | 是 | Microsoft Defender for Endpoint 中已啟用 SIEM 整合功能的密鑰。 |
| 偏移時間 (小時) | 整數 | 24 | 是 | 擷取 X 小時前的快訊。 |
| 每個週期最多可傳送的快訊數量 | 整數 | 100 | 是 | 連接器執行一次時處理的快訊數量。 |
| 要擷取的快訊狀態 | 字串 | Unknown、New、InProgress、Resolved | 是 | 指定 Google SecOps 伺服器應擷取的 Defender ATP 警告狀態。 參數可接受多個值,請以半形逗號分隔。 |
| 要擷取的警告嚴重性 | 字串 | 未指定、資訊、低、中、高 | 是 | 指定 Google SecOps 伺服器應擷取的 Defender ATP 警告嚴重性。 參數可接受多個值,請以半形逗號分隔。 |
| Proxy 伺服器位址 | IP_OR_HOST | 不適用 | 否 | 連線使用的 Proxy 伺服器。 |
| Proxy 伺服器使用者名稱 | 字串 | 不適用 | 否 | Proxy 伺服器使用者名稱。 |
| Proxy 伺服器密碼 | 密碼 | 不適用 | 否 | Proxy 伺服器密碼。 |
連接器規則
連接器不支援封鎖清單或動態清單規則。
連接器支援 Proxy。
Microsoft Defender ATP 連接器 V2
使用 365 Defender 事件 API 擷取 Defender ATP 快訊,取得事件資料。使用連接器動態清單,根據警告 detectionSource 屬性值,只擷取特定類型的警告。
連接器 SourceGroupIdentifier 屬性可用於根據 Defender ATP 事件 ID 將警示分組。
必要條件
設定連接器前,請務必將額外權限授予 Microsoft Entra 應用程式:
以使用者管理員或密碼管理員身分登入 Azure 入口網站。
選取「Microsoft Entra ID」。
依序前往 「API Permissions」 > 「Add a permission」 > 「APIs my organization uses」。
依序選取 「Microsoft Threat Protection」 > 「Application permissions」。
在「Select Permissions」(選取權限) 部分,選取下列必要權限:
Incident.Read.AllIncident.ReadWrite.All
按一下「Add permissions」。
按一下「Grant admin consent for
YOUR_ORGANIZATION_NAME」。
連接器參數
使用下列參數設定連接器:
| 參數顯示名稱 | 類型 | 預設值 | 為必填項目 | 說明 |
|---|---|---|---|---|
| 產品欄位名稱 | 字串 | :: | 是 | 說明儲存產品名稱的欄位名稱。 |
| 事件欄位名稱 | 字串 | EventName | 是 | 說明儲存事件名稱的欄位名稱。 |
| 環境欄位名稱 | 字串 | "" | 否 | 說明儲存環境名稱的欄位名稱。 如果找不到環境欄位,環境會是「」。 |
| 環境規則運算式模式 | 字串 | .* | 否 | 規則運算式模式,用於對 預設值為 .*,可擷取所有值並傳回未變更的值。 用於允許使用者使用規則運算式邏輯操控環境欄位。 如果規則運算式模式為空值或空白,或環境值為空值,則最終環境結果為「」。 |
| Defender ATP API 根層級 | 字串 | https://api.securitycenter.windows.com | 是 | 與整合功能搭配使用的 API 根網址 為提升效能,請使用最靠近您所在位置的伺服器:
|
| 365 Defender API 根層級 | 字串 | https://api.security.microsoft.com | 是 | Microsoft 365 Defender 執行個體的 API 根目錄,用於取得 Google SecOps 事件資料。 |
| Azure Active Directory ID | 字串 | 不適用 | 是 | Microsoft Entra 租戶 ID,可在 Microsoft Entra >「App Registration」(應用程式註冊) > 您的應用程式 >「Directory (tenant) ID」(目錄 (租戶) ID) 中找到。 |
| 整合用戶端 ID | 字串 | 不適用 | 是 | 在 Microsoft Entra 中註冊應用程式時,為整合新增的用戶端 (應用程式) ID。 |
| 整合用戶端密鑰 | 密碼 | 不適用 | 是 | 為整合註冊 Azure AD 應用程式時輸入的密鑰。 |
| 驗證 SSL | 核取方塊 | 已勾選 | 是 | 如果啟用,則會驗證連至 Microsoft 365 Defender 伺服器的 SSL 憑證是否有效。 |
| 偏移時間 (小時) | 整數 | 24 | 是 | 擷取 X 小時前的快訊。 |
| 每個週期最多可傳送的快訊數量 | 整數 | 10 | 是 | 連接器執行一次時處理的快訊數量。 |
| 要擷取的快訊狀態 | 字串 | Unknown、New、InProgress、Resolved | 是 | 指定 Google SecOps 伺服器應擷取的 Defender ATP 快訊狀態。 參數可接受多個值,請以半形逗號分隔。 |
| 要擷取的警告嚴重性 | 字串 | 未指定、資訊、低、中、高 | 是 | 指定 Google SecOps 伺服器應擷取的 Defender ATP 快訊嚴重性。 參數可接受多個值,請以半形逗號分隔。 |
| 停用溢位 | 核取方塊 | 已取消勾選 | 否 | 如果啟用,連接器會忽略溢位機制。 |
| 指令碼逾時 | 整數 | 300 | 是 | 指定連接器執行的逾時時間。 |
| 將許可清單當做黑名單使用 | 核取方塊 | 已取消勾選 | 否 | 如果啟用,動態清單會做為封鎖清單使用。 |
| Proxy 伺服器位址 | IP_OR_HOST | 不適用 | 否 | 連線使用的 Proxy 伺服器。 |
| Proxy 伺服器使用者名稱 | 字串 | 不適用 | 否 | Proxy 伺服器使用者名稱。 |
| Proxy 伺服器密碼 | 密碼 | 不適用 | 否 | Proxy 伺服器密碼。 |
連接器規則
連接器支援動態清單邏輯,會根據 detectionSource Defender ATP 快訊欄位值運作。
還有其他問題嗎?向社群成員和 Google SecOps 專家尋求解答。