Microsoft Graph 安全 API 概述
可以使用 Microsoft Graph 安全 API 连接 Microsoft 安全产品、服务和合作伙伴，以简化安全操作并改进威胁防护、检测和响应功能。
Microsoft Graph 安全 API 是一种中介服务 (或中转站) ，它提供单个编程接口来连接多个 Microsoft Graph 安全提供程序 (也称为安全提供程序或) 提供程序。 向 Microsoft Graph 安全 API 发出的请求将联合到所有适用的安全提供程序。 结果以通用架构的形式聚合并返回到发出请求的应用，如下图所示。 有关详细信息，请参阅 Microsoft Graph 安全 API 数据流。
有关授权的信息，请参阅 授权和 Microsoft Graph 安全 API。 若要了解委托的权限和应用权限等权限，请参阅权限。
为何使用 Microsoft Graph 安全 API？
借助 Microsoft Graph 安全 API，可以轻松地与 Microsoft 和合作伙伴的安全解决方案连接。 借助它，可以更容易地实现并丰富这些解决方案的价值。 可以根据要求，使用以下方法之一轻松连接 Microsoft Graph 安全 API：
- 编写代码 – 查找以 C#、Java、NodeJS 等语言编写的代码示例。
- 使用脚本进行连接 – 查找 PowerShell 示例。
- 拖放到工作流和 playbook 中 - 使用适用于 Azure 逻辑应用、Microsoft Flow 和 Power Apps 的 Microsoft Graph 安全连接器。
- 将数据引入报表和仪表板 - 使用 适用于 Power BI 的 Microsoft Graph 安全连接器。
- 使用 Jupyter 笔记本进行连接 – 查找 Jupyter 笔记本示例。
提交威胁并触发整个自动化流
使用统一的安全威胁提交 API 更轻松地跨安全解决方案提交威胁。 使用此功能，不仅可以提交威胁，还可以获取威胁提交结果并触发下游警报流。 新的统一安全威胁提交 API 支持应用程序和委派权限，可帮助构建新的安全解决方案。
调查与电子邮件和协作相关的威胁并触发响应操作
威胁调查和响应功能提供有关Microsoft Defender for Office 365处理的电子邮件的详细元数据和指示器以及相关响应操作。 这些见解可帮助组织的安全团队保护用户免受基于电子邮件或文件的攻击。
统一和标准化警报跟踪
连接一次，即可集成来自任何已集成 Microsoft Graph 的安全解决方案的警报，并跨所有解决方案同步警报状态和分配。 还可以将警报流式传输到安全信息和事件管理 (SIEM) 解决方案，例如使用 Microsoft Graph 安全 API 连接器的 Splunk。 有关解决方案与安全 API 实体集成的详细信息，请参阅 使用 Microsoft Graph 安全 API 的安全解决方案集成。
关联安全警报以改进威胁防护和响应
使用统一警报架构，可以更轻松地跨安全解决方案关联警报。 这样一来，不仅能够接收可操作警报信息，还便于安全分析员使用资产和用户信息来透视和丰富警报，从而更快地响应威胁防护和资产保护。
更新警报标记、状态和分配
标记使用其他上下文或威胁情报发出警报，通知响应和修复。 确保捕获有关警报的评论和反馈，实现所有工作流程的可见性。 保持警报状态和分配同步，使所有集成解决方案都能反映当前状态。 使用 Webhook 订阅获取变更通知。
解锁安全性上下文以推动调查
深入了解与安全相关的清单 (（例如用户、主机和应用) ），然后添加来自其他 Microsoft Graph 提供商的组织上下文 (Microsoft Entra ID、Microsoft Intune、Microsoft 365) ，以将业务和安全上下文整合在一起并改进威胁响应。
自动执行安全工作流和报告
自动执行安全管理、监视和调查，以提高运营效率和缩短响应时间。 通过将 Microsoft Graph 安全性集成到报表和仪表板中，获取更深入的见解和上下文。
深入了解如何针对安全解决方案进行培训
直观显示在组织内运行的不同安全产品中的数据，以获得更深入的安全见解。 发现从数据中学习并针对安全解决方案进行培训的机会。 该架构提供了多个属性，可以使用你的安全数据来构建丰富的探索性数据集。
在 Microsoft 安全解决方案中利用你的威胁智能（预览版）
自动将威胁指标发送到 Microsoft 安全解决方案，以启用 alert、block 或 allow 操作。 直接使用 Microsoft Graph 安全 API 或利用与领先的威胁情报平台的集成。
迅速采取行动应对新威胁（预览版）
采取快速行动来抵御新威胁，例如采取相关措施来阻止安全工具和工作流中的文件、URL、域或 IP 地址。
主动管理安全风险（预览版）
使用 Microsoft 安全功能分数（预览版）了解组织的安全需求，获取改进方法建议，并预测在采纳这些建议后的改进分数。 可以轻松度量一段时间内的进度，并获取有助于提高分数的具体变更的相关见解。
管理电子数据展示工作流
组织依靠 Microsoft Purview 电子数据展示 功能来满足要求，根据内部或外部要求（如诉讼、调查或法规合规性）查找组织中所发生情况的真实信息。
在许多组织中，电子数据展示工作流频繁、关键且数量大。 在存在常见重复任务或大量活动的情况下，API 将帮助提供一种可缩放的方式来一致且有效地重复进程。 许多组织处理大量案例和电子数据展示请求，并且希望自动执行某些任务。 高级电子数据展示的 Microsoft Graph API 提供对 Microsoft Purview 电子数据展示 (高级) 解决方案中提供的大多数函数的 API 访问权限。
根据当前的系统和流程，组织可能具有自动化和集成的各种优先级，从上游流程（如案例创建）到下游流程（如收集、审阅集查询或导出）。 在整个高级电子数据展示工作流中通过 API 支持工作流提供了灵活性和选项。
使用 Microsoft Graph 构建自定义电子数据展示工作流
使用案例管理工具自动执行案例管理和同步。
将标准化标记托盘添加到案例。
创建自定义报告以跟踪案例负载和各个案例的进度。
使用 Microsoft Graph 安全 API 的好处
下表列出了不同安全解决方案通过与 Microsoft Graph 安全 API 集成可以获得的优势。
| 区域 | 优势 |
|---|---|
| 托管安全服务提供程序 (MSSP) |
|
| SIEM 和 IT 风险管理解决方案 |
|
|
应用 （威胁智能、移动、云、IOT、欺诈检测、标识和访问、风险和合规性、防火墙等） |
|
API 参考
在查找此服务的 API 参考？
后续步骤
- 浏览 Microsoft Graph 安全 API 示例
- 想要成为安全提供程序？ 请联系 graphsecfeedback。