你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

适用于 Microsoft Sentinel 的 Vectra XDR（使用 Azure Functions）连接器

项目
05/02/2024

Vectra XDR 连接器允许通过 Vectra REST API 将 Vectra 检测、审核、实体评分、锁定和运行状况数据引入 Microsoft Sentinel。请参阅 API 文档 https://support.vectra.ai/s/article/KB-VS-1666，了解详细信息。

这是自动生成的内容。如需更改，请联系解决方案提供商。

连接器属性

连接器属性	说明
Azure 函数应用代码	https://aka.ms/sentinel-VectraXDR-functionapp
Kusto 函数别名	VectraDetections
Kusto 函数 URL	https://aka.ms/sentinel-VectraDetections-parser
Log Analytics 表	Detections_Data_CL Audits_Data_CL Entity_Scoring_Data_CL Lockdown_Data_CL Health_Data_CL
数据收集规则支持	目前不支持
支持的服务	Vectra 支持

查询示例

Vectra 检测事件 - 所有检测事件。

Detections_Data_CL

| sort by TimeGenerated desc

Vectra 审核事件 - 所有审核事件。

Audits_Data_CL

| sort by TimeGenerated desc

Vectra 实体评分事件 - 所有实体评分事件。

Entity_Scoring_Data_CL

| sort by TimeGenerated desc

Vectra 锁定事件 - 所有锁定事件。

Lockdown_Data_CL

| sort by TimeGenerated desc

Vectra 运行状况事件 - 所有运行状况事件。

Health_Data_CL

| sort by TimeGenerated desc

先决条件

若要与 Vectra XDR（使用 Azure Functions）集成，请确保拥有：

Microsoft.Web/sites 权限：必须对 Azure Functions 拥有读写权限才能创建函数应用。请参阅文档以详细了解 Azure Functions。
REST API 凭据/权限：运行状况、实体评分、检测、锁定和审核数据收集都需要 Vectra 客户端 ID 和客户端密码。请参阅 https://support.vectra.ai/s/article/KB-VS-1666 上的文档以详细了解 API。

供应商安装说明

注意

此连接器使用 Azure Functions 连接到 Vectra API，以将其日志拉取到 Microsoft Sentinel 中。这可能会导致额外的数据引入成本。有关详细信息，请参阅 Azure Functions 定价页。

（可选步骤）将工作区和 API 授权密钥或令牌安全地存储在 Azure 密钥保管库中。 Azure Key Vault 提供了一种存储和检索键值的安全机制。按照这些说明，将 Azure Key Vault 与 Azure 函数应用结合使用。

注意

此数据连接器依赖于基于 Kusto 函数的分析程序来按预期方式工作。按照检测分析程序、审核分析程序、实体评分分析程序、锁定分析程序和运行状况分析程序的步骤创建 Kusto 函数别名 VectraDetections、VectraAudits、VectraEntityScoring、VectraLockdown 和 VectraHealth。

步骤 1 - Vectra API 凭据的配置步骤

请按照以下说明创建 Vectra 客户端 ID 和客户端密码。

登录到 Vectra 门户
导航到“管理”->“API 客户端”
在“API 客户端”页面中，选择“添加 API 客户端”以创建新客户端。
添加客户端名称，选择角色，然后单击“生成凭据”以获取客户端凭据。
请务必记录客户端 ID 和密钥，以便进行安全保护。需要有这两条信息才能从 Vectra API 获取访问令牌。需要有访问令牌才能向所有 Vectra API 终结点发出请求。

步骤 2：从以下两个部署选项中选择一个来部署连接器和关联的 Azure 函数

重要说明：在部署 Vectra 数据连接器之前，请准备好工作区 ID 和工作区主密钥（可从下面复制）以及 Vectra API 授权凭据

选项 1 - Azure 资源管理器 (ARM) 模板

使用此方法可自动部署 Vectra 连接器。

单击下面的“部署到 Azure” 按钮。
选择首选的“订阅”、“资源组”和“位置”。
输入以下信息：
- 函数名
- 工作区 ID
- 工作区密钥
- Vectra 基 URL https://<vectra-portal-url>
- Vectra 客户端 ID - 运行状况
- Vectra 客户端密钥 - 运行状况
- Vectra 客户端 ID - 实体评分
- Vectra 客户端密码 - 实体评分
- Vectra 客户端 ID - 检测
- Vectra 客户端密码 - 检测
- Vectra 客户端 ID - 审核
- Vectra 客户端密码 - 审核
- Vectra 客户端 ID - 锁定
- Vectra 客户端密码 - 锁定
- StartTime（以 MM/DD/YYYY HH:MM:SS 格式表示）
- 审核表名称
- 检测表名称
- 实体评分表名称
- 锁定表名称
- 运行状况表名称
- 日志级别（默认：信息）
- 锁定计划
- 运行状况计划
- 检测计划
- 审核计划
- 实体评分计划
选中“我同意上述条款和条件”复选框。
单击“购买”进行部署。

选项 2 - 手动部署 Azure Functions

按照以下分步说明，使用 Azure Functions 手动部署 Vectra 数据连接器（通过 Visual Studio Code 进行部署）。

1. 部署函数应用

注意：需要为 Azure 函数开发准备 VS 代码。

下载 Azure 函数应用文件。将存档提取到本地开发计算机。
启动 VS Code。在主菜单中选择“文件”，然后选择“打开文件夹”。
从提取的文件中选择顶级文件夹。
在活动栏中选择 Azure 图标，然后在“Azure: Functions”区域中选择“部署到函数应用”按钮。如果尚未登录，请在活动栏中选择 Azure 图标，然后在“Azure: Functions”区域中选择“登录到 Azure”。如果已登录，请转到下一步。
根据提示提供以下信息：

a. 选择文件夹：从工作区中选择一个文件夹，或浏览到包含函数应用的文件夹。

b. 选择订阅：选择要使用的订阅。

c. 选择“在 Azure 中创建新的函数应用”（不要选择“高级”选项）

d. 为函数应用输入全局唯一名称：键入在 URL 路径中有效的名称。将对你键入的名称进行验证，以确保其在 Azure Functions 中是唯一的。（例如 VECTRAXXXXX）。

e. 选择运行时：选择 Python 3.8 或更高版本。

f. 选择新资源的位置。为了提高性能、降低成本，请选择 Microsoft Sentinel 所在的同一区域。
将开始部署。创建函数应用并应用了部署包之后，会显示一个通知。
转到 Azure 门户，获取函数应用配置。

2. 配置函数应用

在函数应用中选择“函数应用名称”，然后选择“配置”。
在“应用程序设置”选项卡中，选择“+ 新建应用程序设置” 。
分别添加以下每个应用程序设置及其各自的值（区分大小写）：
- 工作区 ID
- 工作区密钥
- Vectra 基 URL https://<vectra-portal-url>
- Vectra 客户端 ID - 运行状况
- Vectra 客户端密钥 - 运行状况
- Vectra 客户端 ID - 实体评分
- Vectra 客户端密码 - 实体评分
- Vectra 客户端 ID - 检测
- Vectra 客户端密码 - 检测
- Vectra 客户端 ID - 审核
- Vectra 客户端密码 - 审核
- Vectra 客户端 ID - 锁定
- Vectra 客户端密码 - 锁定
- StartTime（以 MM/DD/YYYY HH:MM:SS 格式表示）
- 审核表名称
- 检测表名称
- 实体评分表名称
- 锁定表名称
- 运行状况表名称
- 日志级别（默认：信息）
- 锁定计划
- 运行状况计划
- 检测计划
- 审核计划
- 实体评分计划
- logAnalyticsUri（可选）

使用 logAnalyticsUri 替代专用云的 log Analytics API 终结点。例如，如果使用的是公有云，将值留空；如果使用的是 Azure GovUS 云环境，则指定以下格式的值：https://<CustomerId>.ods.opinsights.azure.us。

输入所有应用程序设置后，单击“保存”。

后续步骤

有关详细信息，请转到 Azure 市场中的相关解决方案。