1. Home
2. Next-Gen WAF
3. 統合 (アラート)

汎用ウェブフック統合 (アラート) により、特定の Next-Gen WAF アクティビティタイプの通知を定期購読することができます。

ヒント : CDN または Compute サービスのアラートを設定する場合は、オブザーバビリティガイドをご覧ください。

ウェブフック統合 (アラート) の追加

ウェブフック統合 (アラート) を追加するには、次の手順を実行します。

通知形式

通知は以下の形式で送信されます。

{
  "created": "2024-02-09T21:08:21.31644377Z",
  "type": "flag",
  "payload": {
      "ID": "abcde123456789",
      "CorpID": "123456789abcde",
      "SiteID": "987654321fedcba",
      "Scope": "site",
      "Slug": "site.example",
      "Name": "example",
      "Description": "Webhook integration for Example site",
      "CreatedBy": "admin@example.com",
      "CreatedByID": "edcba987654321",
      "Created": "2024-02-09T21:08:21.31644377Z",
      "Updated": "2025-01-07T21:06:31.50725289Z",
      "ResourceID": "ASDFghjkl123456789"
  },
  "link":"dashboard link to event",
  "workspaceId": "www.mysite.com"
}

X-SigSci-Signature ヘッダー

汎用ウェブフック統合 (アラート) から送信されるすべてのリクエストには、X-SigSci-Signature というヘッダーが含まれています。その値は、汎用ウェブフックの作成時に生成された署名キーを使用してハッシュされた HMAC-SHA256 の16進数のダイジェストです。

署名キーをローテーションするには、次の手順を実行します。

検証は、署名キーを使用して汎用ウェブフックペイロードの HMAC-SHA256 の16進数のダイジェストを作成し、その結果を X-SigSci-Signature ヘッダーの値と比較することによって行います。

X-SigSci-Signature ヘッダー検証のコード例

例は X-SigSci-Signature のヘッダー検証コードを示しています。

package main

import (
    "crypto/hmac"
    "crypto/sha256"
    "encoding/hex"
    "fmt"
)

// CheckMAC reports whether messageMAC is a valid HMAC tag for message.
func CheckMAC(message, messageMAC, key []byte) bool {
    mac := hmac.New(sha256.New, key)
    mac.Write(message)
    expectedMAC := mac.Sum(nil)

    return hmac.Equal(messageMAC, expectedMAC)
}

func main() {
    key := []byte("[insert signing key here]")

    h := "[insert X-SigSci-Signature value here]"

    json := []byte(`[insert JSON payload here]`)

    hash, err := hex.DecodeString(h)
    if err != nil {
        log.Fatal("ERROR: ", err)
    }

    ok := CheckMAC(json, hash, key)

    fmt.Println(ok)
}

アクティビティタイプ

重要 : このセクションは、Next-Gen WAF コンソールにアクセスできる Next-Gen WAF のお客様のみが対象です。

Next-Gen WAF コンソールでウェブフック統合 (アラート) を設定するときは、以下のアクティビティタイプから選択できます。

関連コンテンツ

• Next-Gen WAF での API の使用