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

适用于 Microsoft Sentinel 的 Bitsight Data Connector(使用 Azure Functions)连接器

BitSight 数据连接器通过在 Microsoft Sentinel 中引入 BitSight 数据支持基于证据的网络风险监视。

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

连接器属性

连接器属性 说明
Azure 函数应用代码 https://aka.ms/sentinel-BitSight-functionapp
Log Analytics 表 Alerts_data_CL
BitsightBreaches_data_CL
BitsightCompany_details_CL
BitsightCompany_rating_details_CL
BitsightDiligence_historical_statistics_CL
BitsightDiligence_statistics_CL
BitsightFindings_data_CL
BitsightFindings_summary_CL
BitsightGraph_data_CL
BitsightIndustrial_statistics_CL
BitsightObservation_statistics_CL
数据收集规则支持 目前不支持
支持的服务 BitSight 支持

查询示例

BitSight 警报事件 - 项目组合中所有公司的警报事件。

Alerts_data_CL

| sort by TimeGenerated desc

BitSight 违规事件 - 项目组合中所有公司的违规事件。

BitsightBreaches_data_CL

| sort by TimeGenerated desc

BitSight 公司详细信息事件 - 项目组合中所有公司的公司详细信息事件。

BitsightCompany_details_CL

| sort by TimeGenerated desc

BitSight 公司评级事件 - 所有公司的公司评级事件。

BitsightCompany_rating_details_CL

| sort by TimeGenerated desc

BitSight 尽职历史统计信息事件 - 所有公司的尽职历史统计信息事件。

BitsightDiligence_historical_statistics_CL

| sort by TimeGenerated desc

BitSight 尽职统计信息事件 - 所有公司的尽职统计信息事件。

BitsightDiligence_statistics_CL

| sort by TimeGenerated desc

BitSight 结果事件 - 所有公司的结果事件。

BitsightFindings_data_CL

| sort by TimeGenerated desc

BitSight 结果摘要事件 - 所有公司的结果摘要事件。

BitsightFindings_summary_CL

| sort by TimeGenerated desc

BitSight 图形事件 - 所有公司的图形事件。

BitsightGraph_data_CL

| sort by TimeGenerated desc

BitSight 工业统计信息事件 - 所有公司的工业统计信息事件。

BitsightIndustrial_statistics_CL

| sort by TimeGenerated desc

BitSight 观察统计信息事件 - 所有公司的观察统计信息事件。

BitsightObservation_statistics_CL

| sort by TimeGenerated desc

先决条件

若要与 Bitsight Data Connector(使用 Azure Functions)集成,请确保满足以下条件:

供应商安装说明

注意

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

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

步骤 1 - 创建/获取 Bitsight API 令牌的步骤

按照这些说明获取 BitSight API 令牌。

  1. 对于 SPM 应用:请参阅“帐户”页面的“用户首选项”选项卡,转到“设置”>“帐户”>“用户首选项”>“API 令牌”。
  2. 对于 TPRM 应用:请参阅“帐户”页面的“用户首选项”选项卡,转到“设置”>“帐户”>“用户首选项”>“API 令牌”。
  3. 对于经典 BitSight:转到“帐户”页面,转到“设置”>“帐户”>“API 令牌”。

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

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

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

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

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

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

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

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

步骤 4 - 在 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

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

重要说明:在部署 BitSight 数据连接器之前,请准备好工作区 ID 和工作区主密钥(可从以下位置复制)以及 BitSight API 令牌

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

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

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

    部署到 Azure

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

  3. 输入以下信息:

    • 函数名
    • 工作区 ID
    • 工作区密钥
    • API_token
    • 公司
    • Azure_Client_Id
    • Azure_Client_Secret
    • Azure_Tenant_Id
    • Portfolio_Companies_Table_Name
    • Alerts_Table_Name
    • Breaches_Table_Name
    • Company_Table_Name
    • Company_Rating_Details_Table_Name
    • Diligence_Historical_Statistics_Table_Name
    • Diligence_Statistics_Table_Name
    • Findings_Summary_Table_Name
    • Findings_Table_Name
    • Graph_Table_Name
    • Industrial_Statistics_Table_Name
    • Observation_Statistics_Table_Name
    • 日志级别
    • 计划
    • Schedule_Portfolio
  4. 选中“我同意上述条款和条件”复选框。

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

选项 2 - 手动部署 Azure Functions

按照以下分步说明,使用 Azure Functions 手动部署 BitSight 数据连接器(通过 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 中是唯一的。 (例如 BitSightXXXXX)。

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

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

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

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

2. 配置函数应用

  1. 在函数应用中选择“函数应用名称”,然后选择“配置”。
  2. 在“应用程序设置”选项卡中,选择“+ 新建应用程序设置” 。
  3. 分别添加以下每个应用程序设置及其各自的值(区分大小写):
    • 工作区 ID
    • 工作区密钥
    • API_token
    • 公司
    • Azure_Client_Id
    • Azure_Client_Secret
    • Azure_Tenant_Id
    • Portfolio_Companies_Table_Name
    • Alerts_Table_Name
    • Breaches_Table_Name
    • Company_Table_Name
    • Company_Rating_Details_Table_Name
    • Diligence_Historical_Statistics_Table_Name
    • Diligence_Statistics_Table_Name
    • Findings_Summary_Table_Name
    • Findings_Table_Name
    • Graph_Table_Name
    • Industrial_Statistics_Table_Name
    • Observation_Statistics_Table_Name
    • 日志级别
    • 计划
    • Schedule_Portfolio
  4. 输入所有应用程序设置后,单击“保存”。

后续步骤

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