使用全新的 Microsoft Defender 全面偵測回應 API 來接收所有警示
Microsoft Defender 全面偵測回應通知 API,已在 MS Graph 公開預覽版釋出,是從 SIEM API 遷移客戶的官方且推薦的 API。 此 API 讓客戶能透過單一整合,處理所有 Microsoft Defender 全面偵測回應產品的警示。 我們預計新 API 將於 2023 (第一季 GA) 正式開放。
SIEM API 於 2023 年 12 月 31 日被棄用。 它被宣告為「棄用」,但並未「退休」。這表示直到現在,SIEM API 仍持續為現有客戶運作。 淘汰後,SIEM API 仍會繼續使用,但僅支援安全相關的修補。
自 2024 年 12 月 31 日起,即原始棄用公告三年後,我們保留關閉 SIEM API 的權利,無需另行通知。
欲了解更多新 API 資訊,請參閱部落格公告:Microsoft Graph 中的全新 Microsoft Defender 全面偵測回應 API 現已公開預覽!
API 文件: 使用 Microsoft Graph 安全 API - Microsoft Graph
如果您是使用 SIEM API 的客戶,我們強烈建議您規劃並執行遷移。 本文包含遷移至支援能力的選項資訊:
將MDE警報拉入外部系統 (SIEM/SOAR) 。
閱讀有關全新 Microsoft Defender 全面偵測回應警示與事件 API 的資訊
將 Defender for Endpoint 警示拉入外部系統
如果你將 Defender for Endpoint 警示拉入外部系統,有幾種支援選項,讓組織能靈活使用他們選擇的解決方案:
Microsoft Sentinel 是一個可擴展、雲端原生的 SIEM 與安全協調、自動化及回應 (SOAR) 解決方案。 提供企業內智慧的安全分析與威脅情報,提供攻擊偵測、威脅可視化、主動搜尋及威脅回應的單一解決方案。 Microsoft Defender 連接器讓客戶能輕鬆從所有 Microsoft Defender 產品中擷取所有事件與警示。 欲了解更多整合資訊,請參閱 Microsoft Defender 與 Microsoft Sentinel 的整合。
IBM Security QRadar SIEM 提供集中可視化與智慧安全分析,以識別並防止威脅與漏洞干擾業務運作。 QRadar SIEM 團隊剛宣布推出一套新 DSM,整合於全新 Microsoft Defender 警示 API 中,可拉取 適用於端點的 Microsoft Defender 警示。 新客戶歡迎在新版 DSM 發布時使用。 想了解更多關於新 DSM 及如何輕鬆遷移,請參閱 Microsoft Defender 全面偵測回應 - IBM 文件。
Splunk SOAR 協助客戶在數秒內協調工作流程並自動化任務,讓工作更聰明、回應更快。 Splunk SOAR 已整合於新的 Microsoft Defender 全面偵測回應 API,包括警報 API。 欲了解更多資訊,請參閱 Microsoft Defender 全面偵測回應 |Splunkbase
其他整合可列於 Microsoft Defender 全面偵測回應的技術合作夥伴,或聯絡您的 SIEM / SOAR 供應商了解他們提供的整合。
直接呼叫 Microsoft Defender 全面偵測回應 API
下表提供了 SIEM API 與 Microsoft Defender 警示 API 之間的對應:
| SIEM API 屬性 | 對應 | Microsoft Defender alert API 屬性 |
|---|---|---|
AlertTime |
-> | createdDateTime |
ComputerDnsName |
-> | evidence/deviceEvidence: deviceDnsName |
AlertTitle |
-> | title |
Category |
-> | category |
Severity |
-> | severity |
AlertId |
-> | id |
Actor |
-> | actorDisplayName |
LinkToWDATP |
-> | alertWebUrl |
IocName |
X | IoC 欄位不支援 |
IocValue |
X | IoC 欄位不支援 |
CreatorIocName |
X | IoC 欄位不支援 |
CreatorIocValue |
X | IoC 欄位不支援 |
Sha1 |
-> | evidence/fileEvidence/fileDetails: sha1 (or evidence/processEvidence/imageFile: sha1) |
FileName |
-> | evidence/fileEvidence/fileDetails: fileName (or evidence/processEvidence/image: fileName) |
FilePath |
-> | evidence/fileEvidence/fileDetails: filePath (or evidence/processEvidence/image: filePath) |
IPAddress |
-> | evidence/ipEvidence: ipAddress |
URL |
-> | evidence/urlEvidence: url |
IoaDefinitionId |
-> | detectorId |
UserName |
-> | evidence/userEvidence/userAccount: accountName |
AlertPart |
X | 過時的 (Defender for Endpoint 的警報是原子式且完整的且可更新的,而 SIEM API 則是不可變的偵測紀錄) |
FullId |
X | IoC 欄位不支援 |
LastProcessedTimeUtc |
-> | lastActivityDateTime |
ThreatCategory |
-> | mitreTechniques [] |
ThreatFamilyName |
-> | threatFamilyName |
ThreatName |
-> | threatDisplayName |
RemediationAction |
-> | evidence: remediationStatus |
RemediationIsSuccess |
-> | evidence: remediationStatus (implied) |
Source |
-> | detectionSource (use with serviceSource: microsoftDefenderForEndpoint) |
Md5 |
X | 不支援 |
Sha256 |
-> | evidence/fileEvidence/fileDetails: sha256 (or evidence/processEvidence/imageFile: sha256) |
WasExecutingWhileDetected |
-> | evidence/processEvidence: detectionStatus |
UserDomain |
-> | evidence/userEvidence/userAccount: domainName |
LogOnUsers |
-> | evidence/deviceEvidence: loggedOnUsers [] |
MachineDomain |
-> | 包含於 evidence/deviceEvidence: deviceDnsName |
MachineName |
-> | 包含於 evidence/deviceEvidence: deviceDnsName |
InternalIPV4List |
X | 不支援 |
InternalIPV6List |
X | 不支援 |
FileHash |
-> | 使用或sha1sha256 |
DeviceID |
-> | evidence/deviceEvidence: mdeDeviceId |
MachineGroup |
-> | evidence/deviceEvidence: rbacGroupName |
Description |
-> | description |
DeviceCreatedMachineTags |
-> | evidence: tags [] (for deviceEvidence) |
CloudCreatedMachineTags |
-> | evidence: tags [] (for deviceEvidence) |
CommandLine |
-> | evidence/processEvidence: processCommandLine |
IncidentLinkToWDATP |
-> | incidentWebUrl |
ReportId |
X | 過時的 (Defender for Endpoint 的警報是原子式且完整的且可更新的,而 SIEM API 則是不可變的偵測紀錄) |
LinkToMTP |
-> | alertWebUrl |
IncidentLinkToMTP |
-> | incidentWebUrl |
ExternalId |
X | 已過時 |
IocUniqueId |
X | IoC 欄位不支援 |
利用安全資訊與事件管理 (SIEM) 工具擷取警報
注意事項
適用於端點的 Microsoft Defender Alert 是由一個或多個在裝置上發生的可疑或惡意事件及其相關細節組成。 適用於端點的 Microsoft Defender 警示 API 是最新的警示使用者 API,並包含每個警示的詳細相關證據清單。 欲了解更多資訊,請參閱 警示方法與屬性 及 清單警示。
適用於端點的 Microsoft Defender 支援安全資訊與事件管理 (SIEM) 工具,利用 OAuth 2.0 認證協定從企業租戶Microsoft Entra ID收集資訊,用於註冊Microsoft Entra代表您環境中安裝的特定 SIEM 解決方案或連接器的應用程式。
如需詳細資訊,請參閱: