EventBridge の Webhook Events がサポートされたので試してみた

EventBridge の Webhook Events がサポートされたので試してみた

Amazon EventBridge の Webhook Events を試しました。HMAC 署名、静的トークン、Basic 認証の3方式で curl から送り、SQS 宛ての Subscriber で受け取りました。status での絞り込みと、署名違いの 403 拒否も確認しました。
2026.11.23

はじめに

2026年11月20日に、Amazon EventBridge の enhanced Custom event bus で Webhook Events がサポートされました。

https://aws.amazon.com/about-aws/whats-new/2026/11/amazon-eventbridge-webhook-events/

Custom event bus(以下、bus)に webhook event source を作成すると、EventBridge が HTTPS の URL を払い出します。この URL に届いたリクエストを EventBridge が認証し、受理したものは bus 上でイベントとして扱えます。

この記事では、event source を作り、curl から送った署名付きリクエストを SQS 宛ての Subscriber で受け取るまでを試しました。

検証環境

  • リージョン: 東京(ap-northeast-1)
  • aws-cli: 2.42.1
  • リクエストの送信: curl
  • 署名の計算: openssl dgst
  • 値の取り出し: jq

コマンドの --region は省略し、東京リージョンを既定にして実行しました。

準備

event source と Subscriber が参照する bus、SQS キュー、IAM ロールを先に作りました。

bus とキュー

キューは2つ作りました。全件を受ける all キュー(ebwh-verify-all-q)と、絞り込んだイベントを受ける filter キュー(ebwh-verify-filter-q)です。

aws eventsv2 create-event-bus --name ebwh-verify-bus --description "webhook events verification"
aws sqs create-queue --queue-name ebwh-verify-all-q
aws sqs create-queue --queue-name ebwh-verify-filter-q

bus の状態は list-event-buses で確認しました。

aws eventsv2 list-event-buses

作成の約12秒後に実行した時点で、State は ACTIVE でした。

IAM ロール

event source 用のロールを作りました。

信頼ポリシーでは、events.amazonaws.com がこのロールを引き受けられるようにしました。

trust-policy.json

{
  "Version": "2012-10-17",
  "Statement": [
    { "Effect": "Allow", "Principal": { "Service": "events.amazonaws.com" }, "Action": "sts:AssumeRole" }
  ]
}

権限ポリシーでは、bus への publish と、署名の検証に使うシークレットの読み取りを許可しました。EventBridge は events-webhook! から始まる名前でシークレットを作るため、ReadWebhookSecret の Resource はこの接頭辞のワイルドカードにしました。

webhook-role-policy.json

{
  "Version": "2012-10-17",
  "Statement": [
    { "Sid": "PublishWebhookEvents", "Effect": "Allow", "Action": "events:PutWebhookEvents", "Resource": "arn:aws:events:ap-northeast-1:123456789012:event-busv2/ebwh-verify-bus/<生成ID>" },
    { "Sid": "ReadWebhookSecret", "Effect": "Allow", "Action": "secretsmanager:GetSecretValue", "Resource": "arn:aws:secretsmanager:ap-northeast-1:123456789012:secret:events-webhook!*" }
  ]
}

Resource の bus ARN には、create-event-bus の応答にある EventBusArn の値を入れました。

aws iam create-role \
  --role-name ebwh-verify-webhook-role \
  --assume-role-policy-document file://trust-policy.json

aws iam put-role-policy \
  --role-name ebwh-verify-webhook-role \
  --policy-name webhook-publish-and-read-secret \
  --policy-document file://webhook-role-policy.json

Subscriber が SQS へ配信するためのロールも作りました。

Subscriber 配信用ロール

delivery-role-policy.json

{
  "Version": "2012-10-17",
  "Statement": [
    { "Effect": "Allow", "Action": "sqs:SendMessage", "Resource": [
      "arn:aws:sqs:ap-northeast-1:123456789012:ebwh-verify-all-q",
      "arn:aws:sqs:ap-northeast-1:123456789012:ebwh-verify-filter-q" ] }
  ]
}

信頼ポリシーは trust-policy.json を使い回しました。

aws iam create-role \
  --role-name ebwh-verify-delivery-role \
  --assume-role-policy-document file://trust-policy.json

aws iam put-role-policy \
  --role-name ebwh-verify-delivery-role \
  --policy-name send-to-queues \
  --policy-document file://delivery-role-policy.json

変数の設定

以降のコマンドで使う値を変数に入れました。キューの URL は create-queue の応答の QueueUrl の値です。

export BUS_ARN=arn:aws:events:ap-northeast-1:123456789012:event-busv2/ebwh-verify-bus/<生成ID>
export QUEUE_FILTER_ARN=arn:aws:sqs:ap-northeast-1:123456789012:ebwh-verify-filter-q
export DELIVERY_ROLE_ARN=arn:aws:iam::123456789012:role/ebwh-verify-delivery-role
export QUEUE_ALL_URL=https://sqs.ap-northeast-1.amazonaws.com/123456789012/ebwh-verify-all-q
export QUEUE_FILTER_URL=https://sqs.ap-northeast-1.amazonaws.com/123456789012/ebwh-verify-filter-q

webhook event source

IAM ロールの作成から数十秒を空けて、event source を作成しました。

作成

HMAC 署名で認証する event source を作りました。

source-hmac.json

{
  "WebhookEventsConfiguration": {
    "AuthConfiguration": {
      "HmacAuthConfiguration": {
        "Algorithm": "SHA256",
        "Encoding": "HEX",
        "SignatureHttpHeader": "X-Signature",
        "SignedMessageComposition": "BODY"
      }
    },
    "RoleArn": "arn:aws:iam::123456789012:role/ebwh-verify-webhook-role"
  }
}
aws eventsv2 create-event-source \
  --name ebwh-hmac \
  --event-bus-arn "$BUS_ARN" \
  --configuration file://source-hmac.json | tee src-hmac.json

応答は tee で src-hmac.json に保存しました。この後に使うのは、応答の WebhookUrl と SecretArn です。

{
  "State": "ACTIVE",
  "EventSourceDetails": {
    "WebhookDetails": {
      "WebhookUrl": "<masked>",
      "SecretArn": "arn:aws:secretsmanager:ap-northeast-1:123456789012:secret:events-webhook!EXAMPLE-a1b2c3"
    }
  }
}

シークレット

署名の計算に使う鍵は、SecretArn が指す Secrets Manager のシークレットから取得しました。HMAC の場合、SecretString は JSON ではなく、鍵の文字列そのものでした。URL とシークレットは、送信用の環境変数に入れました。

SECRET_ARN=$(jq -r .EventSourceDetails.WebhookDetails.SecretArn src-hmac.json)
export WEBHOOK_URL=$(jq -r .EventSourceDetails.WebhookDetails.WebhookUrl src-hmac.json)
export SECRET=$(aws secretsmanager get-secret-value --secret-id "$SECRET_ARN" --query SecretString --output text)

Subscriber

SQS 宛ての Subscriber を2つ作りました。1つは全件を受け取る設定、もう1つは DATA スコープのフィルタで status が delivered のものだけを受け取る設定です。どちらも WITH_METADATA で受けたため、Metadata と SystemMetadata も配信されました。

フィルタ付きの Subscriber は次のコマンドで作りました。

aws eventsv2 create-subscriber \
  --name ebwh-sub-filter \
  --event-bus-arn "$BUS_ARN" \
  --type UNORDERED \
  --transformer '{"Type":"WITH_METADATA"}' \
  --filter-configuration '{"Filters":[{"Scope":"DATA","Pattern":"{\"status\":[\"delivered\"]}"}]}' \
  --invoke-configuration "{\"TargetArn\":\"$QUEUE_FILTER_ARN\",\"RoleArn\":\"$DELIVERY_ROLE_ARN\"}"

全件を受ける ebwh-sub-all は、--filter-configuration を付けず、宛先を all キューにして同じ形で作りました。

リクエストの送信と受信

署名付きリクエスト

署名の計算と送信は、次のスクリプトにまとめました。第2引数に値を渡すとその値を署名として送り、none を渡すと署名ヘッダを付けずに送ります。

send-hmac.sh

#!/usr/bin/env bash
# HMAC (SHA256, HEX, BODY) の webhook へ署名付き POST を送る。
# 必要な環境変数: WEBHOOK_URL(作成応答の WebhookUrl), SECRET(Secrets Manager のシークレット値)
# 使い方: send-hmac.sh '<body>' [署名の上書き値|none]
set -euo pipefail
BODY="$1"
if [ "${2:-}" = "none" ]; then
  curl -sS -i -X POST "$WEBHOOK_URL" -H 'Content-Type: application/json' --data-binary "$BODY"
else
  SIG="${2:-$(printf '%s' "$BODY" | openssl dgst -sha256 -hmac "$SECRET" -hex | awk '{print $NF}')}"
  curl -sS -i -X POST "$WEBHOOK_URL" -H 'Content-Type: application/json' -H "X-Signature: $SIG" --data-binary "$BODY"
fi
bash send-hmac.sh '{"orderId":"ORD-1001","status":"delivered","carrier":"example-logistics"}'
HTTP/1.1 200 OK
Content-Type: text/plain
Content-Length: 2

OK

status を in_transit にした ORD-1002 も同じ手順で送り、どちらにも 200 が返りました。キューに届いたメッセージは、次のコマンドで確認しました。

aws sqs receive-message \
  --queue-url "$QUEUE_ALL_URL" \
  --max-number-of-messages 10 \
  --wait-time-seconds 10 \
  --query 'Messages[].Body'

filter キューも --queue-url "$QUEUE_FILTER_URL" に変えて同じように受信しました。ORD-1001 は all と filter の両方に届き、ORD-1002 は all だけに届きました。

all キューでは、1回目の receive-message で ORD-1002 だけが返り、2回目で ORD-1001 が返りました。1回の受信で全件が返らないときは、続けて受信し直します。

受信したイベント

filter キューで受け取った ORD-1001 の本文です。

{
  "Data": {
    "orderId": "ORD-1001",
    "status": "delivered",
    "carrier": "example-logistics"
  },
  "Metadata": {},
  "SystemMetadata": {
    "EventGroupId": "<UUID>",
    "DeduplicationId": "<UUID>",
    "ContentType": "application/json",
    "aws:IngestionTime": "2026-11-21T15:40:57.790Z",
    "aws:EventId": "<UUID>",
    "aws:SequenceNumber": "10000000000000003000",
    "aws:DeliveryType": "LIVE"
  }
}

今回送った JSON は、キーの順序も含めてそのまま Data に入りました。受信側では、送信元のペイロードを Data から読みます。

署名が合わないリクエスト

64桁すべてが 0 の署名を付けた POST と、署名ヘッダを付けない POST を送りました。

bash send-hmac.sh '{"orderId":"ORD-9001","status":"delivered","carrier":"example-logistics"}' 0000000000000000000000000000000000000000000000000000000000000000
bash send-hmac.sh '{"orderId":"ORD-9002","status":"delivered","carrier":"example-logistics"}' none

署名が違う POST には、次の応答が返りました。

HTTP/1.1 403 Forbidden
Content-Type: text/plain
Content-Length: 9

Forbidden

署名ヘッダを付けない POST も 403 でした。どちらのリクエストも、all キューと filter キューのいずれにも届きませんでした。

静的トークンと Basic 認証

認証方式は event source の作成後に変更できないため、HMAC のほかに、静的トークンと Basic 認証の event source を作りました。

source-token.json

{
  "WebhookEventsConfiguration": {
    "AuthConfiguration": {
      "StaticTokenAuthConfiguration": { "TokenHttpHeader": "X-Webhook-Token" }
    },
    "RoleArn": "arn:aws:iam::123456789012:role/ebwh-verify-webhook-role"
  }
}

source-basic.json

{
  "WebhookEventsConfiguration": {
    "AuthConfiguration": {
      "BasicHttpAuthConfiguration": {}
    },
    "RoleArn": "arn:aws:iam::123456789012:role/ebwh-verify-webhook-role"
  }
}

静的トークンも、Basic 認証のユーザー名とパスワードも、設定ファイルでは指定せず、EventBridge が生成した値を使いました。

aws eventsv2 create-event-source \
  --name ebwh-token \
  --event-bus-arn "$BUS_ARN" \
  --configuration file://source-token.json | tee src-token.json

aws eventsv2 create-event-source \
  --name ebwh-basic \
  --event-bus-arn "$BUS_ARN" \
  --configuration file://source-basic.json | tee src-basic.json

静的トークンの event source では、SecretString がトークンの値そのものでした。HMAC のときと同じ手順で取り出し、X-Webhook-Token ヘッダに入れて送りました。

send-token.sh

#!/usr/bin/env bash
# 静的トークンの webhook へ POST。必要: WEBHOOK_URL, SECRET(トークン値)
set -euo pipefail
curl -sS -i -X POST "$WEBHOOK_URL" -H 'Content-Type: application/json' -H "X-Webhook-Token: $SECRET" --data-binary "$1"
SECRET_ARN=$(jq -r .EventSourceDetails.WebhookDetails.SecretArn src-token.json)
export WEBHOOK_URL=$(jq -r .EventSourceDetails.WebhookDetails.WebhookUrl src-token.json)
export SECRET=$(aws secretsmanager get-secret-value --secret-id "$SECRET_ARN" --query SecretString --output text)
bash send-token.sh '{"orderId":"ORD-2001","status":"delivered"}'

Basic 認証の event source では、シークレットが username と password を持つ JSON でした。それぞれを取り出し、curl の -u で送りました。

send-basic.sh

#!/usr/bin/env bash
# Basic 認証の webhook へ POST。必要: WEBHOOK_URL, BASIC_USER, BASIC_PASS
set -euo pipefail
curl -sS -i -X POST "$WEBHOOK_URL" -u "$BASIC_USER:$BASIC_PASS" -H 'Content-Type: application/json' --data-binary "$1"
SECRET_ARN=$(jq -r .EventSourceDetails.WebhookDetails.SecretArn src-basic.json)
export WEBHOOK_URL=$(jq -r .EventSourceDetails.WebhookDetails.WebhookUrl src-basic.json)
BASIC_SECRET=$(aws secretsmanager get-secret-value --secret-id "$SECRET_ARN" --query SecretString --output text)
export BASIC_USER=$(echo "$BASIC_SECRET" | jq -r .username)
export BASIC_PASS=$(echo "$BASIC_SECRET" | jq -r .password)
bash send-basic.sh '{"orderId":"ORD-3001","status":"delivered"}'

どちらの方式でも、正しい資格情報を付けて1件ずつ送ったところ、HTTP 200 が返りました。ORD-2001(静的トークン)と ORD-3001(Basic 認証)は、status が delivered なので filter キューに届きました。

まとめ

Amazon EventBridge の Webhook Events で、curl から送ったリクエストを受け取り、イベントとして処理できることを確認できました。

リクエストの送信側は IAM 認証を使わず、HMAC 署名、静的トークン、Basic 認証のいずれかで送れるため、AWS 外部からの連携にも使いやすいと思います。

従来、API Gateway と Lambda などで同様の仕組みを用意していた場合は、今回のアップデートを試してみてください。

この記事をシェアする

AWSのお困り事はクラスメソッドへ

関連記事