
EventBridge の Webhook Events がサポートされたので試してみた
はじめに
2026年11月20日に、Amazon EventBridge の enhanced Custom event bus で 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 などで同様の仕組みを用意していた場合は、今回のアップデートを試してみてください。








