你当前正在访问 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)集成,请确保满足以下条件:
- Microsoft.Web/sites 权限:必须对 Azure Functions 拥有读写权限才能创建函数应用。 请参阅文档以详细了解 Azure Functions。
- REST API 凭据/权限:需要 BitSight API 令牌。 请参阅文档以详细了解 API 令牌。
供应商安装说明
注意
此连接器使用 Azure Functions 连接到 BitSight API,以将其日志拉取到 Microsoft Sentinel 中。 这可能会导致额外的数据引入成本。 有关详细信息,请参阅 Azure Functions 定价页。
(可选步骤)将工作区和 API 授权密钥或令牌安全地存储在 Azure 密钥保管库中。 Azure Key Vault 提供了一种存储和检索键值的安全机制。 按照这些说明,将 Azure Key Vault 与 Azure 函数应用结合使用。
步骤 1 - 创建/获取 Bitsight API 令牌的步骤
按照这些说明获取 BitSight API 令牌。
- 对于 SPM 应用:请参阅“帐户”页面的“用户首选项”选项卡,转到“设置”>“帐户”>“用户首选项”>“API 令牌”。
- 对于 TPRM 应用:请参阅“帐户”页面的“用户首选项”选项卡,转到“设置”>“帐户”>“用户首选项”>“API 令牌”。
- 对于经典 BitSight:转到“帐户”页面,转到“设置”>“帐户”>“API 令牌”。
步骤 2 - Microsoft Entra ID 中应用程序的应用注册步骤
此集成需要在 Azure 门户中进行应用注册。 请按照本部分中的步骤在 Microsoft Entra ID 中创建新应用程序:
- 登录 Azure 门户。
- 搜索并选择 Microsoft Entra ID。
- 在“管理”下,选择“应用注册”>“新建注册”。
- 输入应用程序的显示名称。
- 选择“注册”,完成初始应用注册。
- 注册完成后,Azure 门户会显示应用注册的“概述”窗格。 你可以看到“应用程序(客户端) ID”和“租户 ID”。 执行 BitSight Data Connector 时,需要客户端 ID 和租户 ID 作为配置参数。
参考链接: /azure/active-directory/develop/quickstart-register-app
步骤 3 - 在 Microsoft Entra ID 中为应用程序添加客户端密码
客户端密码有时称为应用程序密码,是执行 BitSight Data Connector 所需的字符串值。 请按照本部分中的步骤创建新的客户端密码:
- 在 Azure 门户中的“应用注册”中,选择你的应用程序。
- 选择“证书和机密”>“客户端密码”>“新建客户端密码”。
- 添加客户端机密的说明。
- 选择机密的过期时间,或指定自定义的生存期。 限制为 24 个月。
- 选择 添加 。
- 记录机密的值,以便在客户端应用程序代码中使用。 退出此页面后,此机密值永不再显示。 机密值是必需的,将作为执行 BitSight Data Connector 的配置参数。
参考链接: /azure/active-directory/develop/quickstart-register-app#add-a-client-secret
步骤 4 - 在 Microsoft Entra ID 中为应用程序分配参与者角色
请按照本部分中的步骤分配角色:
- 在 Azure 门户中,转到“资源组”并选择相应资源组。
- 从左侧面板转到“访问控制(IAM)”。
- 单击“添加”,然后选择“添加角色分配”。
- 选择“参与者”作为角色,然后单击“下一步”。
- 在“将访问权限分配给”中选择
User, group, or service principal
。 - 单击“添加成员”,然后在键入你创建的应用名称并选择该应用。
- 现在,单击“查看 + 分配”,然后再次单击“查看 + 分配”。
参考链接: /azure/role-based-access-control/role-assignments-portal
步骤 5:从以下两个部署选项中选择一个来部署该连接器和关联的 Azure 函数
重要说明:在部署 BitSight 数据连接器之前,请准备好工作区 ID 和工作区主密钥(可从以下位置复制)以及 BitSight API 令牌。
选项 1 - Azure 资源管理器 (ARM) 模板
使用此方法自动部署 BitSight 连接器。
单击下面的“部署到 Azure” 按钮。
选择首选的“订阅”、“资源组”和“位置”。
输入以下信息:
- 函数名
- 工作区 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
选中“我同意上述条款和条件”复选框。
单击“购买”进行部署。
选项 2 - 手动部署 Azure Functions
按照以下分步说明,使用 Azure Functions 手动部署 BitSight 数据连接器(通过 Visual Studio Code 进行部署)。
1. 部署函数应用
注意:需要为 Azure 函数开发准备 VS 代码。
下载 Azure 函数应用文件。 将存档提取到本地开发计算机。
启动 VS Code。 在主菜单中选择“文件”,然后选择“打开文件夹”。
从提取的文件中选择顶级文件夹。
在活动栏中选择 Azure 图标,然后在“Azure: Functions”区域中选择“部署到函数应用”按钮。 如果尚未登录,请在活动栏中选择 Azure 图标,然后在“Azure: Functions”区域中选择“登录到 Azure”。如果已登录,请转到下一步。
根据提示提供以下信息:
a. 选择文件夹:从工作区中选择一个文件夹,或浏览到包含函数应用的文件夹。
b. 选择订阅:选择要使用的订阅。
c. 选择“在 Azure 中创建新的函数应用”(不要选择“高级”选项)
d. 为函数应用输入全局唯一名称:键入在 URL 路径中有效的名称。 将对你键入的名称进行验证,以确保其在 Azure Functions 中是唯一的。 (例如 BitSightXXXXX)。
e. 选择运行时:选择 Python 3.8 或更高版本。
f. 选择新资源的位置。 为了提高性能、降低成本,请选择 Microsoft Sentinel 所在的同一区域。
将开始部署。 创建函数应用并应用了部署包之后,会显示一个通知。
转到 Azure 门户,获取函数应用配置。
2. 配置函数应用
- 在函数应用中选择“函数应用名称”,然后选择“配置”。
- 在“应用程序设置”选项卡中,选择“+ 新建应用程序设置” 。
- 分别添加以下每个应用程序设置及其各自的值(区分大小写):
- 工作区 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
- 输入所有应用程序设置后,单击“保存”。
后续步骤
有关详细信息,请转到 Azure 市场中的相关解决方案。