Vercel WAF のログを収集する

以下でサポートされています。

このドキュメントでは、Google Cloud Storage V2 を使用して Vercel WAF ログを Google Security Operations に取り込む方法について説明します。

Vercel WAF は、サーバーレス アプリケーションを保護するために Vercel エッジ ネットワークに統合されたウェブ アプリケーション ファイアウォールです。エッジで受信 HTTP リクエストを検査し、セキュリティ ルールを適用して、悪意のあるトラフィックがアプリケーションに到達する前にブロックします。Vercel WAF ログは Vercel プラットフォームからエクスポートする必要があるため、これらのログを Google Cloud Storage(GCS)バケットにアップロードしてから、それらを取り込むように Google SecOps フィードを構成する必要があります。

始める前に

次の前提条件を満たしていることを確認してください。

  • Google SecOps インスタンス
  • 課金を有効にした Google Cloud プロジェクト
  • WAF ログにアクセスできる Vercel アカウント(Pro プランまたは Enterprise プラン)
  • WAF ログをエクスポートするように構成された Vercel API トークンまたはログドレイン

Google Cloud Storage バケットを作成する

  1. Google Cloud コンソールに移動します。
  2. プロジェクトを選択するか、新しいプロジェクトを作成します。
  3. ナビゲーション メニューで、[Cloud Storage] > [バケット] に移動します。
  4. [バケットを作成] をクリックします。
  5. 次の構成情報を提供してください。

    設定 値
    バケットに名前を付ける グローバルに一意の名前(vercel-waf-logs など)を入力します。
    ロケーション タイプ ニーズに応じて選択します(リージョン、デュアルリージョン、マルチリージョン)。
    ロケーション Google SecOps インスタンスに最も近いロケーション(us-central1 など)を選択します。
    ストレージ クラス Standard(頻繁にアクセスされるログに推奨)
    アクセス制御 均一(推奨)
    保護ツール 省略可: オブジェクトのバージョニングまたは保持ポリシーを有効にする
  6. [作成] をクリックします。

Vercel WAF ログを GCS にエクスポートする

Vercel は、Log Drains と Vercel REST API を介して WAF ログを提供します。ログのエクスポートを構成してから、GCS にアップロードする。

Vercel Log Drains は、ログを外部エンドポイントにリアルタイムでストリーミングします。

  1. Vercel ダッシュボードにログインします。
  2. チームの設定([Settings] > [Log Drains])に移動します。
  3. [Add Log Drain] をクリックします。
  4. ログドレインを構成します。
    • 配信形式: [JSON] を選択します。
    • ソース: [ファイアウォール] を選択して、WAF イベントを含めます。
    • 環境: モニタリングする環境(プロダクション、プレビュー、開発環境)を選択します。
    • エンドポイント: 中間レシーバーの URL を入力します(例: GCS に書き込む Cloud Run functions のエンドポイント)。
  5. [Add Log Drain] をクリックします。
  6. ログがエンドポイントに配信されていることを確認します。

オプション B: Vercel REST API を介してエクスポートする

  1. [Settings] > [Tokens] で Vercel API トークンを生成します。
  2. Vercel REST API を使用してファイアウォール イベントを取得します。

    curl -H "Authorization: Bearer YOUR_VERCEL_TOKEN" \
      "https://api.vercel.com/v1/security/firewall/events?teamId=YOUR_TEAM_ID&projectId=YOUR_PROJECT_ID&limit=100" \
      -o vercel-waf-events.json
    

Google SecOps サービス アカウントを取得する

  1. [設定] > [データ管理] > [フィード] に移動します。SIEM のみのプラットフォームを使用している場合は、[設定] > [フィード] に移動します。
  2. [Add New Feed] をクリックします。
  3. [単一フィードを設定] をクリックします。
  4. [フィード名] フィールドに、フィードの名前を入力します(例: Vercel WAF Logs)。
  5. [Source type] として [Google Cloud Storage V2] を選択します。
  6. [ログタイプ] として [Vercel WAF] を選択します。
  7. [サービス アカウントを取得する] をクリックします。一意のサービス アカウントのメールアドレスが表示されます。例:

    chronicle-12345678@chronicle-gcp-prod.iam.gserviceaccount.com
    
  8. このメールアドレスをコピーして、次のステップで使用します。

Google SecOps サービス アカウントに IAM 権限を付与する

Google SecOps サービス アカウントには、GCS バケットに対する Storage オブジェクト閲覧者のロールが必要です。

  1. [Cloud Storage] > [バケット] に移動します。
  2. バケット名(vercel-waf-logs など)をクリックします。
  3. [権限] タブに移動します。
  4. [アクセス権を付与] をクリックします。
  5. 次の構成情報を指定します。
    • プリンシパルを追加: Google SecOps サービス アカウントのメールアドレス(例: chronicle-12345678@chronicle-gcp-prod.iam.gserviceaccount.com)を貼り付けます。
    • ロールを割り当てる: [Storage オブジェクト閲覧者] を選択します。
  6. [保存] をクリックします。

Google SecOps フィードを構成する

  1. [設定] > [データ管理] > [フィード] に移動します。SIEM のみのプラットフォームを使用している場合は、[設定] > [フィード] に移動します。
  2. [Add New Feed] をクリックします。
  3. [単一フィードを設定] をクリックします。
  4. [フィード名] フィールドに、フィードの名前を入力します(例: Vercel WAF Logs)。
  5. [Source type] として [Google Cloud Storage V2] を選択します。
  6. [ログタイプ] として [Vercel WAF] を選択します。
  7. [次へ] をクリックします。
  8. 次の入力パラメータの値を指定します。

    • ストレージ バケットの URL: GCS バケットの URI を入力します。

      gs://vercel-waf-logs/vercel-waf/
      
      • vercel-waf-logs は、GCS バケット名に置き換えます。
      • vercel-waf は、構成済みのプレフィックス パスに置き換えます。
    • Source deletion option: 必要に応じて削除オプションを選択します。

      • なし: 転送後にファイルを削除しません(テストに推奨)。
      • 転送されたファイルと空のディレクトリを削除する: 転送が成功した後にファイルと空のディレクトリを削除します。

    • ファイルの最長存続期間: 過去数日間に変更されたファイルを含めます(デフォルトは 180 日)。

    • Asset namespace: アセットの名前空間。

    • Ingestion labels: このフィードのイベントに適用されるラベル。

  9. [次へ] をクリックします。

  10. [Finalize] 画面で新しいフィードの設定を確認し、[送信] をクリックします。

UDM マッピング テーブル

ログフィールド UDM マッピング ロジック
record.requestId, record.proxy.timestamp, record.proxy.region, record.proxy.errorCode, record.proxy.vercelCache, record.proxy.pathType, record.proxy.referer, record.proxy.cacheId, record.proxy.wafAction, record.proxy.scheme, record.proxy.userAgent, record.environment additional.fields 追加のイベント メタデータ
metadata.event_type イベントのタイプ
record.deploymentId metadata.product_deployment_id プロダクト固有のデプロイ ID
record.id metadata.product_log_id プロダクト固有のログ ID
record.proxy.method network.http.method HTTP メソッド
record.statusCode network.http.response_code HTTP レスポンス コード
record.source principal.asset.hostname プリンシパルに関連付けられたアセットのホスト名
record.host principal.hostname プリンシパルのホスト名
record.message security_result.description セキュリティ結果の説明
record.proxy.wafRule security_result.rule_name セキュリティ結果をトリガーしたルールの名前
record.level security_result.severity セキュリティ結果の重大度
record.proxy.wafRule security_result.threat_name 脅威の名前
record.proxy.clientIp target.asset.ip アセットの IP アドレス
record.projectId target.cloud.project.id クラウド プロジェクトの ID
record.projectName target.cloud.project.name クラウド プロジェクトの名前
record.proxy.path target.file.full_path ファイルのフルパス
record.proxy.clientIp target.ip ターゲットの IP アドレス
record.executionRegion target.location.name 場所の名前
record.proxy.vercelId target.user.userid 対象ユーザーのユーザー ID
metadata.product_name 製品名
metadata.vendor_name ベンダー名

さらにサポートが必要な場合 コミュニティ メンバーや Google SecOps のプロフェッショナルから回答を得ることができます。