AI Act Radar

aiactradar-examples

AI Act Radar 用の Webhook 受信側のリファレンス実装です。 各サブディレクトリには、プラットフォームごとの自己完結型で実行可能なサンプルが含まれています。

すべての受信側が行うこと

1. リクエストボディを生のまま読み取ります（署名対象は解析済み JSON ではなくバイト列です）。
2. X-AIAR-Timestamp が現在時刻から 300 秒以内であることを確認します。
3. X-AIAR-Signature（v1=<hex>）を、<timestamp>.<raw_body> に対する HMAC-SHA-256 を使用して一定時間で検証します。
4. 実際の処理を行う前に冪等性キー（event.id）を確認します。リトライは通常発生します。
5. 5 秒以内に 2xx を返します。そうでない場合、ディスパッチャーは指数バックオフで再試行します。

検証処理はどのプラットフォームでも同じです。異なるのはプラットフォーム固有の接続部分だけです。

サンプル

フォルダー	プラットフォーム	備考
cloudflare-workers/	Cloudflare Workers	Web Crypto API、冪等性には KV を使用
vercel-edge/	Vercel Edge Functions	Web Crypto API、冪等性には Vercel KV を使用
aws-lambda/	AWS Lambda + API Gateway	Node crypto モジュール、冪等性には DynamoDB を使用
express-node/	Node 上の通常の Express	Node crypto、プロセス内 LRU（本番環境では置き換えてください）
fastify-typescript/	Fastify + TS	型付きボディパーサー、生のボディを取得
deno-deploy/	Deno Deploy	冪等性には Deno KV を使用

サインアップせずに試す

各サンプルには、ローカルシークレットでサンプルイベントに署名し、実行中の受信側に POST する test.sh があります。ノートパソコンで一連の処理を 5 分以内に実行できます。

cd cloudflare-workers
cp .dev.vars.example .dev.vars   # set AIA_SECRET to anything
npm install && npm run dev       # starts http://localhost:8787
# in another terminal:
bash test.sh                     # posts a signed sample event

本番環境への移行

• AIA_SECRET はプラットフォームのシークレットマネージャーに保存してください。決してコミットしないでください。
• AI Act Radar のダッシュボードで、少なくとも 90 日ごとにシークレットをローテーションしてください。
• ディスパッチャーの Webhook ヘルスチャンネルを購読してください。配信の失敗は、顧客が気づく前にそこで確認できます。
• 冪等性ストアの TTL は 7 日以上にしてください。ディスパッチャーは最大 24 時間、再試行します。

ライセンス

MIT。

---

AI Act Radar は、カールスルーエの ligea GmbH が運営しています。情報提供のみを目的としており、法的助言ではありません。