通过

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

适用于 Microsoft Sentinel 的 Armis 警报活动（使用 Azure Functions）连接器

  • 项目

Armis 警报活动连接器提供通过 Armis REST API 将 Armis 警报和活动引入到 Microsoft Sentinel 的功能。 请参阅 API 文档：https://<YourArmisInstance>.armis.com/api/v1/docs 了解详细信息。 连接器提供从 Armis 平台获取警报和活动信息以及识别和确定环境中威胁的优先级的功能。 Armis 使用现有基础结构来发现和识别设备，无需部署任何代理。

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

连接器属性

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

查询示例

Armis 警报事件 - 所有警报。

Armis_Alerts_CL

| sort by TimeGenerated desc

Armis 活动事件 - 所有活动。

Armis_Activities_CL

| sort by TimeGenerated desc

先决条件

若要与 Armis 警报活动（使用 Azure Functions）集成，请确保具备：

  • Microsoft.Web/sites 权限：必须对 Azure Functions 拥有读写权限才能创建函数应用。 请参阅文档以详细了解 Azure Functions。
  • REST API 凭据/权限：需要 Armis 密钥。 请参阅 https://<YourArmisInstance>.armis.com/api/v1/doc 上的文档以详细了解 API

供应商安装说明

注意

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

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

注意

此数据连接器依赖于基于 Kusto 函数的分析程序才能按预期工作，该函数作为解决方案的一部分进行部署。 若要查看 Log Analytics 中的函数代码，请打开 Log Analytics/Microsoft Sentinel 的“日志”边栏选项卡，单击“函数”，搜索别名“ArmisActivities/ArmisAlerts”并加载函数代码。 安装/更新解决方案后，函数通常需要 10-15 分钟才能激活。

步骤 1 - Armis API 的配置步骤

按照这些说明创建 Armis API 密钥。

  1. 登录到 Armis 实例
  2. 导航到“设置” ->“API 管理”
  3. 如果尚未创建密钥，请按“创建”按钮创建密钥
  4. 若要访问密钥，请按“显示”按钮
  5. 现在可以在 Armis 警报活动连接器配置过程中复制并使用密钥

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

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

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

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

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

    部署到 Azure 部署到 Azure Gov

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

  3. 输入以下信息：

    • 函数名
    • 工作区 ID
    • 工作区密钥
    • Armis 密钥
    • Armis URL https://<armis-instance>.armis.com/api/v1/
    • Armis 警报表名称
    • Armis 活动表名称
    • Armis 计划
    • 避免重复项（默认值：true）

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

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

选项 2 - 手动部署 Azure Functions

请按照以下分步说明操作，使用 Azure Functions 手动部署 Armis 警报活动数据连接器（通过 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 中是唯一的。 （例如 ARMISXXXXX）。

    e. 选择运行时：选择 Python 3.11

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

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

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

2. 配置函数应用

  1. 在函数应用中选择“函数应用名称”，然后选择“配置”。
  2. 在“应用程序设置”选项卡中，选择“+ 新建应用程序设置” 。
  3. 分别添加以下每个应用程序设置及其各自的值（区分大小写）：
    • 工作区 ID
    • 工作区密钥
    • Armis 密钥
    • Armis URL https://<armis-instance>.armis.com/api/v1/
    • Armis 警报表名称
    • Armis 活动表名称
    • Armis 计划
    • 避免重复项（默认值：true）
    • logAnalyticsUri（可选）
  • 使用 logAnalyticsUri 替代专用云的 log Analytics API 终结点。 例如，如果使用的是公有云，将值留空；如果使用的是 Azure GovUS 云环境，则指定以下格式的值：https://<CustomerId>.ods.opinsights.azure.us。
  1. 输入所有应用程序设置后，单击“保存”。

后续步骤

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