Security Hub の EventBridge イベント形式

Security Hub Findings - Imported、Security Findings - Custom Action、および Security Hub Insight Results イベントタイプでは、次のイベント形式を使用します。

イベント形式は、Security Hub が EventBridge にイベントを送信するときに使用される形式です。

Security Hub Findings - Imported

Security Hub から EventBridge に送信される Security Hub Findings - Imported イベントには、次の形式が使用されます。

{
   "version":"0",
   "id":"CWE-event-id",
   "detail-type":"Security Hub Findings - Imported",
   "source":"aws.securityhub",
   "account":"111122223333",
   "time":"2019-04-11T21:52:17Z",
   "region":"us-west-2",
   "resources":[
      "arn:aws:securityhub:us-west-2::product/aws/macie/arn:aws:macie:us-west-2:111122223333:integtest/trigger/6294d71b927c41cbab915159a8f326a3/alert/f2893b211841"
   ],
   "detail":{
      "findings": [{
         <finding content>
       }]
   }
}

<finding content> は、イベントによって送信される結果の JSON 形式のコンテンツです。各イベントは 1 つの結果を送信します。

結果の属性の詳細なリストについては、「AWS セキュリティ検索フォーマット (ASFF)」を参照してください。

このようなイベントによってトリガーされる EventBridge ルールを設定する方法については、「自動的に送信される結果の EventBridge ルールの設定」を参照してください。

Security Hub Findings - Custom Action

Security Hub から EventBridge に送信される Security Hub Findings - Custom Action イベントには、次の形式が使用されます。各結果は個別のイベントで送信されます。

{
  "version": "0",
  "id": "1a1111a1-b22b-3c33-444d-5555e5ee5555",
  "detail-type": "Security Hub Findings - Custom Action",
  "source": "aws.securityhub",
  "account": "111122223333",
  "time": "2019-04-11T18:43:48Z",
  "region": "us-west-1",
  "resources": [
    "arn:aws:securityhub:us-west-1:111122223333:action/custom/custom-action-name"
  ],
  "detail": {
    "actionName":"custom-action-name",
    "actionDescription": "description of the action",
    "findings": [
      {
        <finding content>
      }
    ]
  }
}

<finding content> は、イベントによって送信される結果の JSON 形式のコンテンツです。各イベントは 1 つの結果を送信します。

結果の属性の詳細なリストについては、「AWS セキュリティ検索フォーマット (ASFF)」を参照してください。

このようなイベントによってトリガーされる EventBridge ルールを設定する方法については、「カスタムアクションを使用して結果とインサイト結果を EventBridge に送信する」を参照してください。

Security Hub Insight Results

Security Hub から EventBridge に送信される Security Hub Insight Results イベントには、次の形式が使用されます。

{ 
  "version": "0",
  "id": "1a1111a1-b22b-3c33-444d-5555e5ee5555",
  "detail-type": "Security Hub Insight Results",
  "source": "aws.securityhub",
  "account": "111122223333",
  "time": "2017-12-22T18:43:48Z",
  "region": "us-west-1",
  "resources": [
      "arn:aws:securityhub:us-west-1:111122223333::product/aws/macie:us-west-1:222233334444:test/trigger/1ec9cf700ef6be062b19584e0b7d84ec/alert/f2893b211841"
  ],
  "detail": {
    "actionName":"name of the action",
    "actionDescription":"description of the action",
    "insightArn":"ARN of the insight",
    "insightName":"Name of the insight",
    "resultType":"ResourceAwsIamAccessKeyUserName",
    "number of results":"number of results, max of 100",
    "insightResults": [
        {"result 1": 5},
        {"result 2": 6}
    ]
  }
}

このようなイベントによってトリガーされる EventBridge ルールを作成する方法については、「カスタムアクションを使用して結果とインサイト結果を EventBridge に送信する」を参照してください。