日本語

Webhooks

Slack および Microsoft Teams の通知に加えて、Zen のイベントに対して Webhook を設定することもできます。Webhook を作成または変更するには、Webhooks ページを開いてください。

リクエストが成功しなかった場合、Aikido は通知の再送信を 5 回試みます。200 以外の HTTP ステータスが返された場合、またはタイムアウトが発生した場合、そのリクエストは失敗とみなされます。Webhook イベントの検証方法については、こちらのページで説明しています。

Webhook イベント

現在、以下のイベントが送信されます。

攻撃の検出(サンプル)
{
   "event_type": "zen.attack",
   "created_at": 1760015974,
   "payload": {
      "url": "http://app.aikido.dev/runtime/services/X/events?groupId=X&eventId=X",
      "eventId": 123,
      "attack": {
         "blocked": false,
         "kind": "sql_injection"
      },
      "request": {
         "method": "POST",
         "route":"/add",
         "ip_address": "::ffff:127.0.0.1",
         "user_agent": "Mozilla/5.0 ..."
      },
      "service": {
         "id": 1,
         "name": "Test",
         "environment": "production"
      },
      "instance":{
         "id": 1,
         "ip_address": "172.17.0.123",
         "hostname": "hostname.local"
      },
      "user": {
         "id": "123abc",
         "blocked_at": 0
      },
      "message": "SQL injection detected in Test"
   },
   "dispatched_at": 1760016033,
   "workspace_id": 123
}
攻撃ウェーブの検出(サンプル)
{
   "event_type": "zen.attack_wave",
   "created_at": 1760015974,
   "payload": {
      "url": "http://app.aikido.dev/runtime/services/X/events?groupId=X&eventId=X",
      "eventId": 123,
      "attack": [],
      "request": {
         "ip_address": "::ffff:127.0.0.1",
         "user_agent": "Mozilla/5.0 ..."
      },
      "service": {
         "id": 1,
         "name": "Test",
         "environment": "production"
      },
      "instance":{
         "id": 1,
         "ip_address": "172.17.0.123",
         "hostname": "hostname.local"
      },
      "user": {
         "id": "123abc",
         "blocked_at": 0
      },
      "message": "Attack wave detected in Test"
   },
   "dispatched_at": 1760016033,
   "workspace_id": 123
}
新しいアウトバウンド接続(サンプル)
{
   "event_type": "zen.outbound.discovered",
   "created_at": 1760016813,
   "payload": {
      "hostname": "aikido.dev",
      "port": 443,
      "service": {
         "id": 123,
         "name": "Test",
         "environment": "production"
      },
      "message": "New outbound connection detected in Test"
   },
   "timestamp": 1757599746000
}