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

适用于 Microsoft Sentinel 的 Dataminr Pulse Alerts Data Connector（使用 Azure Functions）连接器

  • 项目

Dataminr Pulse Alerts Data Connector 可将 AI 支持的实时智能引入 Microsoft Sentinel，以加快威胁检测和响应速度。

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

连接器属性

连接器属性 说明
Azure 函数应用代码 https://aka.ms/sentinel-DataminrPulseAlerts-functionapp
Log Analytics 表 DataminrPulse_Alerts_CL
数据收集规则支持 目前不支持
支持的服务 Dataminr 支持

查询示例

所有警报类型的 Dataminr 脉冲警报数据

DataminrPulse_Alerts_CL

| sort by TimeGenerated desc

先决条件

若要与 Dataminr Pulse Alerts Data Connector（使用 Azure Functions）集成，请确保拥有：

  • Azure 订阅：需要有具有所有者角色的 Azure 订阅才能在 Microsoft Entra ID 中注册应用程序，并将参与者的角色分配给资源组中的应用。
  • Microsoft.Web/sites 权限：必须对 Azure Functions 拥有读写权限才能创建函数应用。 请参阅文档以详细了解 Azure Functions。
  • 所需的 Dataminr 凭据/权限：

a. 用户必须具有有效的 Dataminr Pulse API 客户端 ID和机密才能使用此数据连接器。

b. 必须在 Dataminr Pulse 网站中配置一个或多个 Dataminr Pulse 监视列表。

供应商安装说明

注意

此连接器使用 Azure Functions 连接到 DataminrPulse，后者将通过 Dataminr RTAP 推送日志，并将日志引入 Microsoft Sentinel。 此外，该连接器将从自定义日志表中提取引入的数据，并将威胁情报指标创建到 Microsoft Sentinel 威胁情报中。 这可能会导致额外的数据引入成本。 有关详细信息，请参阅 Azure Functions 定价页。

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

步骤 1 - Dataminr Pulse 客户端 ID 和客户端机密的凭据

  • 从 Dataminr Customer Success Manager (CSM) 获取 Dataminr Pulse 用户 ID/密码和 API 客户端 ID/机密。

步骤 2 - 在 Dataminr Pulse 门户中配置监视列表。

请按照本部分中的步骤在门户中配置监视列表：

  1. 登录 Dataminr Pulse 网站。

  2. 单击“设置”齿轮图标，然后选择“管理列表”。

  3. 选择要创建的监视列表的类型（网络、主题、公司等），然后单击“新建列表”按钮。

  4. 为新的监视列表提供一个名称，并为其选择突出显示的颜色或保留默认颜色。

  5. 配置监视列表后，单击“保存”以进行保存。

步骤 3 - Microsoft Entra ID 中应用程序的应用注册步骤

此集成需要在 Azure 门户中进行应用注册。 请按照本部分中的步骤在 Microsoft Entra ID 中创建新应用程序：

  1. 登录 Azure 门户。
  2. 搜索并选择 Microsoft Entra ID。
  3. 在“管理”下，选择“应用注册”>“新建注册”。
  4. 输入应用程序的显示名称。
  5. 选择“注册”，完成初始应用注册。
  6. 注册完成后，Azure 门户会显示应用注册的“概述”窗格。 你可以看到“应用程序(客户端) ID”和“租户 ID”。 执行 DataminrPulse Data Connector 时，需要客户端 ID 和租户 ID 作为配置参数。

参考链接：/azure/active-directory/develop/quickstart-register-app

步骤 4 - 在 Microsoft Entra ID 中为应用程序添加客户端密码

客户端密码有时称为应用程序密码，是执行 DataminrPulse Data Connector 所需的字符串值。 请按照本部分中的步骤创建新的客户端密码：

  1. 在 Azure 门户中的“应用注册”中，选择你的应用程序。
  2. 选择“证书和机密”>“客户端密码”>“新建客户端密码”。
  3. 添加客户端机密的说明。
  4. 选择机密的过期时间，或指定自定义的生存期。 限制为 24 个月。
  5. 选择 添加 。
  6. 记录机密的值，以便在客户端应用程序代码中使用。 退出此页面后，此机密值永不再显示。 机密值是必需的，将作为执行 DataminrPulse Data Connector 的配置参数。

参考链接：/azure/active-directory/develop/quickstart-register-app#add-a-client-secret

步骤 5 - 在 Microsoft Entra ID 中为应用程序分配参与者角色

请按照本部分中的步骤分配角色：

  1. 在 Azure 门户中，转到“资源组”并选择相应资源组。
  2. 从左侧面板转到“访问控制(IAM)”。
  3. 单击“添加”，然后选择“添加角色分配”。
  4. 选择“参与者”作为角色，然后单击“下一步”。
  5. 在“将访问权限分配给”中选择 User, group, or service principal。
  6. 单击“添加成员”，然后在键入你创建的应用名称并选择该应用。
  7. 现在，单击“查看 + 分配”，然后再次单击“查看 + 分配”。

参考链接：/azure/role-based-access-control/role-assignments-portal

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

重要说明：在部署 Dataminr Pulse Microsoft Sentinel 数据连接器之前，请准备好工作区 ID 和工作区主密钥（可从下面复制）。

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

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

  1. 单击下面的“部署到 Azure” 按钮。

    部署到 Azure

  2. 选择首选的“订阅”、“资源组”和“位置”。

  3. 输入以下信息：函数名称 工作区 ID 工作区密钥 AlertsTableName BaseURL ClientId ClientSecret AzureClientId AzureClientSecret AzureTenantId AzureResourceGroupName AzureWorkspaceName AzureSubscriptionId Schedule LogLevel

  4. 选中“我同意上述条款和条件”复选框。

  5. 单击“购买”进行部署。

选项 2 - 手动部署 Azure Functions

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

  1. 部署函数应用

注意

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

  1. 下载 Azure 函数应用文件。 将存档提取到本地开发计算机。

  2. 启动 VS Code。 在主菜单中选择“文件”，然后选择“打开文件夹”。

  3. 从提取的文件中选择顶级文件夹。

  4. 在活动栏中选择 Azure 图标，然后在“Azure: Functions”区域中选择“部署到函数应用”按钮。 如果尚未登录，请在活动栏中选择 Azure 图标，然后在“Azure: Functions”区域中选择“登录到 Azure”。如果已登录，请转到下一步。

  5. 根据提示提供以下信息：

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

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

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

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

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

    f. 选择新资源的位置。 为了提高性能、降低成本，请选择 Microsoft Sentinel 所在的同一区域。

  6. 将开始部署。 创建函数应用并应用了部署包之后，会显示一个通知。

  7. 转到 Azure 门户，获取函数应用配置。

  1. 配置函数应用
  1. 在函数应用中选择“函数应用名称”，然后选择“配置”。
  2. 在“应用程序设置”选项卡中，选择“+ 新建应用程序设置” 。
  3. 分别添加以下每个应用程序设置及其各自的值（区分大小写）：函数名称 工作区 ID 工作区密钥 AlertsTableName BaseURL ClientId ClientSecret AzureClientId AzureClientSecret AzureTenantId AzureResourceGroupName AzureWorkspaceName AzureSubscriptionId Schedule LogLevel logAnalyticsUri（可选）
  • 使用 logAnalyticsUri 替代专用云的 log Analytics API 终结点。 例如，如果使用的是公有云，将值留空；如果使用的是 Azure GovUS 云环境，则指定以下格式的值：https://<CustomerId>.ods.opinsights.azure.us。
  1. 输入所有应用程序设置后，单击“保存”。

步骤 7 - 部署后步骤

  1. 获取函数应用终结点
  1. 转到“Azure 函数概述”页面，并单击左侧边栏选项卡中的“函数”。
  2. 单击名为“DataminrPulseAlertsHttpStarter”的函数。
  3. 转到“GetFunctionurl”并复制函数 URL。
  4. 在复制的函数 URL 中将 {functionname} 替换为“DataminrPulseAlertsSentinelOrchestrator”。
  1. 使用函数 URL 在 Dataminr RTAP 中添加集成设置
  1. 打开任何 API 请求工具（如 Postman）。
  2. 单击“+”来创建新请求。
  3. 选择“POST”作为 HTTP 请求方法。
  4. 输入在第一部分的请求 URL 部分中准备的 url。
  5. 在正文中，选择原始 JSON 并提供如下请求正文（区分大小写）：{ "integration-settings": "ADD", "url": "(URL part from copied Function-url)", "token": "(value of code parameter from copied Function-url)" }
  6. 提供所有必需的详细信息后，单击“发送”。
  7. 你将在状态代码为 200 的 HTTP 响应中收到一个集成设置 ID。
  8. 保存集成 ID 以供将来参考。

现在，我们完成了为 Dataminr RTAP 添加集成设置的操作。 一旦 Dataminr RTAP 发送警报数据，就会触发函数应用，你应该能够在名为“DataminrPulse_Alerts_CL”的 LogAnalytics 工作区表看到 Dataminr Pulse 中的警报数据。

后续步骤

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