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 バケットを作成する
- Google Cloud コンソールに移動します。
- プロジェクトを選択するか、新しいプロジェクトを作成します。
- ナビゲーション メニューで、[Cloud Storage] > [バケット] に移動します。
- [バケットを作成] をクリックします。
次の構成情報を提供してください。
設定 値 バケットに名前を付ける グローバルに一意の名前( vercel-waf-logsなど)を入力します。ロケーション タイプ ニーズに応じて選択します(リージョン、デュアルリージョン、マルチリージョン)。 ロケーション Google SecOps インスタンスに最も近いロケーション( us-central1など)を選択します。ストレージ クラス Standard(頻繁にアクセスされるログに推奨) アクセス制御 均一(推奨) 保護ツール 省略可: オブジェクトのバージョニングまたは保持ポリシーを有効にする [作成] をクリックします。
Vercel WAF ログを GCS にエクスポートする
Vercel は、Log Drains と Vercel REST API を介して WAF ログを提供します。ログのエクスポートを構成してから、GCS にアップロードする。
オプション A: Vercel ログドレインを構成する(推奨)
Vercel Log Drains は、ログを外部エンドポイントにリアルタイムでストリーミングします。
- Vercel ダッシュボードにログインします。
- チームの設定([Settings] > [Log Drains])に移動します。
- [Add Log Drain] をクリックします。
- ログドレインを構成します。
- 配信形式: [JSON] を選択します。
- ソース: [ファイアウォール] を選択して、WAF イベントを含めます。
- 環境: モニタリングする環境(プロダクション、プレビュー、開発環境)を選択します。
- エンドポイント: 中間レシーバーの URL を入力します(例: GCS に書き込む Cloud Run functions のエンドポイント)。
- [Add Log Drain] をクリックします。
ログがエンドポイントに配信されていることを確認します。
オプション B: Vercel REST API を介してエクスポートする
- [Settings] > [Tokens] で Vercel API トークンを生成します。
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 サービス アカウントを取得する
- [設定] > [データ管理] > [フィード] に移動します。SIEM のみのプラットフォームを使用している場合は、[設定] > [フィード] に移動します。
- [Add New Feed] をクリックします。
- [単一フィードを設定] をクリックします。
- [フィード名] フィールドに、フィードの名前を入力します(例:
Vercel WAF Logs)。 - [Source type] として [Google Cloud Storage V2] を選択します。
- [ログタイプ] として [Vercel WAF] を選択します。
[サービス アカウントを取得する] をクリックします。一意のサービス アカウントのメールアドレスが表示されます。例:
chronicle-12345678@chronicle-gcp-prod.iam.gserviceaccount.comこのメールアドレスをコピーして、次のステップで使用します。
Google SecOps サービス アカウントに IAM 権限を付与する
Google SecOps サービス アカウントには、GCS バケットに対する Storage オブジェクト閲覧者のロールが必要です。
- [Cloud Storage] > [バケット] に移動します。
- バケット名(
vercel-waf-logsなど)をクリックします。 - [権限] タブに移動します。
- [アクセス権を付与] をクリックします。
- 次の構成情報を指定します。
- プリンシパルを追加: Google SecOps サービス アカウントのメールアドレス(例:
chronicle-12345678@chronicle-gcp-prod.iam.gserviceaccount.com)を貼り付けます。 - ロールを割り当てる: [Storage オブジェクト閲覧者] を選択します。
- プリンシパルを追加: Google SecOps サービス アカウントのメールアドレス(例:
[保存] をクリックします。
Google SecOps フィードを構成する
- [設定] > [データ管理] > [フィード] に移動します。SIEM のみのプラットフォームを使用している場合は、[設定] > [フィード] に移動します。
- [Add New Feed] をクリックします。
- [単一フィードを設定] をクリックします。
- [フィード名] フィールドに、フィードの名前を入力します(例:
Vercel WAF Logs)。 - [Source type] として [Google Cloud Storage V2] を選択します。
- [ログタイプ] として [Vercel WAF] を選択します。
- [次へ] をクリックします。
次の入力パラメータの値を指定します。
ストレージ バケットの URL: GCS バケットの URI を入力します。
gs://vercel-waf-logs/vercel-waf/vercel-waf-logsは、GCS バケット名に置き換えます。vercel-wafは、構成済みのプレフィックス パスに置き換えます。
Source deletion option: 必要に応じて削除オプションを選択します。
- なし: 転送後にファイルを削除しません(テストに推奨)。
転送されたファイルと空のディレクトリを削除する: 転送が成功した後にファイルと空のディレクトリを削除します。
ファイルの最長存続期間: 過去数日間に変更されたファイルを含めます(デフォルトは 180 日)。
Asset namespace: アセットの名前空間。
Ingestion labels: このフィードのイベントに適用されるラベル。
[次へ] をクリックします。
[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 のプロフェッショナルから回答を得ることができます。