将 Security Hub 与自定义产品集成 - Amazon Security Hub
自定义产品集成的要求和建议更新来自自定义产品的结果示例自定义集成
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

将 Security Hub 与自定义产品集成

除了集成 Amazon 服务和第三方产品生成的调查结果外，Sec Amazon urity Hub 还可以使用其他定制安全产品生成的调查结果。

你可以使用以下方法将这些发现发送到 Security Hub BatchImportFindingsSecurity Hub API 的运行。您可以使用相同的操作来更新自定义产品中已发送到 Security Hub 的调查发现。

设置自定义集成时，请使用《Security Hub 合作伙伴集成指南》中提供的指南和清单。

自定义产品集成的要求和建议

在成功调用 BatchImportFindings API 操作之前，您必须启用 Security Hub。

您还必须使用 Amazon 安全调查结果格式 (ASFF) 提供自定义产品的调查发现详细信息。查看自定义产品集成的以下要求和建议：

设置产品 ARN

启用 Security Hub 时，会在当前账户中为 Security Hub 生成一个默认的产品 Amazon 资源名称（ARN）。

该产品 ARN 具有以下格式：arn:aws:securityhub:<region>:<account-id>:product/<account-id>/default。例如，arn:aws:securityhub:us-west-2:123456789012:product/123456789012/default。

调用 BatchImportFindings API 操作时，请使用此产品 ARN 作为 ProductArn 属性的值。

设置公司名称和产品名称

您可以使用 BatchImportFindings 为将调查发现发送到 Security Hub 的自定义集成设置首选公司名称和产品名称。

您指定的名称将替换预先配置的公司名称和产品名称（分别称为“个人名称”和“默认名称”），并显示在 Security Hub 控制台和每个调查发现的 JSON 中。请参阅 BatchImportFindings 用于寻找提供者。

设定调查结果 IDs

您必须使用Id属性提供、管理和增加自己的调查结果 IDs。

每个新调查发现应具有唯一的调查发现 ID。如果自定义产品发送了多个具有相同调查发现 ID 的调查发现，则 Security Hub 仅会处理第一个调查发现。

设置账户 ID

您必须使用 AwsAccountId 属性指定您自己的账户 ID。

设置创建日期和更新日期

您必须为 CreatedAt 和 UpdatedAt 属性提供您自己的时间戳。

更新来自自定义产品的结果

除了从自定义产品发送新结果以外，您还可以使用 BatchImportFindings API 操作更新来自自定义产品的现有结果。

要更新现有结果，请使用现有结果 ID（通过 Id 属性）。使用请求中更新的相应信息（包括修改后的 UpdatedAt 时间戳）重新发送完整的结果。

示例自定义集成

您可以使用以下示例自定义产品集成作为指南来创建您自己的自定义解决方案：

发送来自的调查结果 Chef InSpec 扫描到 Security Hub

您可以创建一个运行以下内容的 Amazon CloudFormation 模板 厨师 InSpec 合规性扫描，然后将发现的结果发送到 Security Hub。

有关更多详细信息，请参阅持续合规性监控 Chef InSpec 还有 Sec Amazon urity Hub 。

发送检测到的容器漏洞 Trivy 到 Security Hub

您可以创建一个使用以下 Amazon CloudFormation 内容的模板 AquaSecurityTrivy 扫描容器中是否存在漏洞，然后将这些漏洞发现发送到 Security Hub。

有关更多详细信息，请参阅如何使用构建用于容器漏洞扫描的 CI/CD 管道 Trivy 还有 Sec Amazon urity Hub 。