View a markdown version of this page

使用 API 批量修复积压的调查结果 - AWS 上的自动安全响应

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

使用 API 批量修复积压的调查结果

Web 用户界面和 AWS Security Hub CSPM 自定义操作便于以交互方式修复少量发现。要以编程方式处理大量积压的现有发现(例如,在部署解决方案后立即完成),请直接调用解决方案的 REST API。

支持 Web UI 的同一 REST API(AutomatedSecurityResponseApi在 API Gateway 控制台中命名)公开了一个POST /findings/action端点,该端点接受一批要在单个请求中修复的发现结果。这使您可以编写补救待办事项列表的脚本,而不必手动选择调查结果。

注意

此端点仅在启用 Web UI 时可用(在ShouldDeployWebUI设置为 “是” 的情况下部署管理堆栈)。您可以在 API 的 API Gateway 控制prod台中找到该阶段的 API 调用网址。AutomatedSecurityResponseApi

身份验证

所有 API 请求都需要为解决方案的用户池颁发的 Amazon Cognito 访问令牌,该令牌作为不记名令牌在Authorization标题中传递。令牌必须带有作用asr-api/api域。为解决方案的其中一个角色(管理员、委托管理员或账户操作员)使用令牌;Web UI 中应用的基于角色的授权同样适用于 API。要实现无人值守自动化,请使用机器对机器(客户端凭据)OAuth 流程而不是交互式用户登录来获取令牌。

收集调查结果以进行修复

用于POST /findings搜索和翻阅要修复的结果,并收集每个发现findingId的结果。返回的调查结果仅限于您的角色获得授权的账户,因此账户操作员只会收到其分配的账户的调查结果。

调用调查结果操作端点

将收集到的查找 ID 发送到,POST /findings/action并带有 o actionType f Remediate。每个发现都通过 Orchestrator 传送,就像从 Web 用户界面传送一样。

POST /findings/action Authorization: Bearer <access-token> Content-Type: application/json { "actionType": "Remediate", "findingIds": [ "arn:aws:securityhub:us-east-1:111111111111:security-control/Lambda.1/finding/...", "arn:aws:securityhub:us-east-1:111111111111:security-control/S3.5/finding/..." ] }

actionType还接受RemediateAndGenerateTicket,这会修正发现并在您配置的票务渠道中打开票证。它还接受Suppress和Unsuppress,它们在解决方案的默认查找结果视图中隐藏或显示查找结果。 Suppress不会更改调查结果在 AWS Security Hub 或 AWS Security Hub CSPM 中的工作流程状态。它也不会停止全自动补救,尽管逾期未完成的截止日期强制执行扫描会跳过以这种方式抑制的调查结果。Remediate或RemediateAndGenerateTicket请求返回正文为{"status": "IN_PROGRESS"};的 HTTP202,Suppress然后Unsuppress返回 HTTP 200。

重要

每个请求最多发送 50 个查找 ID。要修复较大的待办事项,请将查找 ID 拆分为 50 个或更少的批次,然后每批发出一个请求。API 还受基于速率的规则的保护(请参阅 API Gateway 安全策略中的 AWS WAF 配置),因此请调整连续批次的速度,而不是一次性发送所有批次。

监控进度

通过 API 启动的修复是异步运行的,就像从 Web UI 启动的修复一样。通过解决方案的 Amazon SNS 通知或查询,在 Web UI 的 “执行历史记录” 页面上跟踪他们的进度。POST /remediations