Mengumpulkan log WAF Vercel
Dokumen ini menjelaskan cara menyerap log WAF Vercel ke Google Security Operations menggunakan Google Cloud Storage V2.
Vercel WAF adalah firewall aplikasi web yang terintegrasi ke dalam jaringan edge Vercel untuk melindungi aplikasi serverless. Cloud Armor memeriksa permintaan HTTP yang masuk di edge dan menerapkan aturan keamanan untuk memblokir traffic berbahaya sebelum mencapai aplikasi Anda. Karena log WAF Vercel harus diekspor dari platform Vercel, Anda harus mengupload log tersebut ke bucket Google Cloud Storage (GCS), lalu mengonfigurasi feed Google SecOps untuk menyerapnya.
Sebelum memulai
Pastikan Anda memiliki prasyarat berikut:
- Instance Google SecOps
- Project Google Cloud yang mengaktifkan penagihan
- Akun Vercel dengan akses ke log WAF (paket Pro atau Enterprise)
- Token API Vercel atau Log Drain yang dikonfigurasi untuk mengekspor log WAF
Membuat bucket Google Cloud Storage
- Buka Konsol Google Cloud.
- Pilih project Anda atau buat project baru.
- Di menu navigasi, buka Cloud Storage > Buckets.
- Klik Create bucket.
Berikan detail konfigurasi berikut:
Setelan Nilai Memberi nama bucket Anda Masukkan nama yang unik secara global (misalnya, vercel-waf-logs)Location type Pilih sesuai kebutuhan Anda (Region, Dual-region, Multi-region) Location Pilih lokasi yang paling dekat dengan instance Google SecOps Anda (misalnya, us-central1)Storage class Standard (direkomendasikan untuk log yang sering diakses) Kontrol akses Seragam (direkomendasikan) Alat perlindungan Opsional: Mengaktifkan pembuatan versi objek atau kebijakan retensi Klik Create.
Mengekspor log WAF Vercel ke GCS
Vercel menyediakan log WAF melalui Log Drain dan REST API Vercel. Konfigurasikan ekspor log, lalu upload ke GCS.
Opsi A: Mengonfigurasi Vercel Log Drain (Direkomendasikan)
Vercel Log Drains melakukan streaming log secara real-time ke endpoint eksternal.
- Login ke Dasbor Vercel.
- Buka setelan tim Anda: Settings > Log Drains.
- Klik Add Log Drain.
- Konfigurasi pengosongan log:
- Format Pengiriman: Pilih JSON.
- Sources: Pilih Firewall untuk menyertakan peristiwa WAF.
- Environments: Pilih lingkungan yang akan dipantau (Production, Preview, Development).
- Endpoint: Masukkan URL penerima perantara Anda (misalnya, endpoint fungsi Cloud Run yang menulis ke GCS).
- Klik Add Log Drain.
Pastikan log dikirim ke endpoint Anda.
Opsi B: Mengekspor melalui REST API Vercel
- Buat token API Vercel di Settings > Tokens.
Gunakan REST API Vercel untuk mengambil peristiwa firewall:
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
Mengambil akun layanan Google SecOps
- Buka Setelan > Pengelolaan Data > Feed. Jika Anda menggunakan platform khusus SIEM, buka Settings > Feeds.
- Klik Tambahkan Feed Berita Baru.
- Klik Konfigurasi satu feed.
- Di kolom Nama feed, masukkan nama untuk feed (misalnya,
Vercel WAF Logs). - Pilih Google Cloud Storage V2 sebagai Source type.
- Pilih Vercel WAF sebagai Log type.
Klik Get Service Account. Email akun layanan yang unik akan ditampilkan, misalnya:
chronicle-12345678@chronicle-gcp-prod.iam.gserviceaccount.comSalin alamat email ini untuk digunakan di langkah berikutnya.
Memberikan izin IAM ke akun layanan Google SecOps
Akun layanan Google SecOps memerlukan peran Storage Object Viewer di bucket GCS Anda.
- Buka Cloud Storage > Buckets.
- Klik nama bucket Anda (misalnya,
vercel-waf-logs). - Buka tab Izin.
- Klik Grant access.
- Berikan detail konfigurasi berikut:
- Add principals: Tempel email akun layanan Google SecOps (misalnya,
chronicle-12345678@chronicle-gcp-prod.iam.gserviceaccount.com). - Assign roles: Pilih Storage Object Viewer.
- Add principals: Tempel email akun layanan Google SecOps (misalnya,
Klik Simpan.
Mengonfigurasi feed Google SecOps
- Buka Setelan > Pengelolaan Data > Feed. Jika Anda menggunakan platform khusus SIEM, buka Settings > Feeds.
- Klik Tambahkan Feed Berita Baru.
- Klik Konfigurasi satu feed.
- Di kolom Nama feed, masukkan nama untuk feed (misalnya,
Vercel WAF Logs). - Pilih Google Cloud Storage V2 sebagai Source type.
- Pilih Vercel WAF sebagai Log type.
- Klik Berikutnya.
Tentukan nilai untuk parameter input berikut:
Storage bucket URL: Masukkan URI bucket GCS:
gs://vercel-waf-logs/vercel-waf/- Ganti
vercel-waf-logsdengan nama bucket GCS Anda. - Ganti
vercel-wafdengan jalur awalan yang Anda konfigurasi.
- Ganti
Opsi penghapusan sumber: Pilih opsi penghapusan sesuai preferensi Anda:
- Never: Tidak pernah menghapus file apa pun setelah transfer (direkomendasikan untuk pengujian).
Delete transferred files and empty directories: Menghapus file dan direktori kosong setelah transfer berhasil.
Usia File Maksimum: Sertakan file yang diubah dalam jumlah hari terakhir (defaultnya adalah 180 hari).
Namespace aset: Namespace aset.
Label penyerapan: Label yang akan diterapkan ke peristiwa dari feed ini.
Klik Berikutnya.
Tinjau konfigurasi feed berita baru Anda di layar Finalize, lalu klik Submit.
Tabel pemetaan UDM
| Kolom Log | Pemetaan UDM | Logika |
|---|---|---|
| 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 peristiwa tambahan |
| metadata.event_type | Jenis peristiwa | |
| record.deploymentId | metadata.product_deployment_id | ID deployment khusus produk |
| record.id | metadata.product_log_id | ID log khusus produk |
| record.proxy.method | network.http.method | Metode HTTP |
| record.statusCode | network.http.response_code | Kode respons HTTP |
| record.source | principal.asset.hostname | Nama host aset yang terkait dengan akun utama |
| record.host | principal.hostname | Nama host principal |
| record.message | security_result.description | Deskripsi hasil keamanan |
| record.proxy.wafRule | security_result.rule_name | Nama aturan yang memicu hasil keamanan |
| record.level | security_result.severity | Tingkat keparahan hasil keamanan |
| record.proxy.wafRule | security_result.threat_name | Nama ancaman |
| record.proxy.clientIp | target.asset.ip | Alamat IP aset |
| record.projectId | target.cloud.project.id | ID project cloud |
| record.projectName | target.cloud.project.name | Nama project cloud |
| record.proxy.path | target.file.full_path | Jalur lengkap file |
| record.proxy.clientIp | target.ip | Alamat IP target |
| record.executionRegion | target.location.name | Nama lokasi |
| record.proxy.vercelId | target.user.userid | ID Pengguna dari pengguna target |
| metadata.product_name | Nama produk | |
| metadata.vendor_name | Nama vendor |
Perlu bantuan lain? Dapatkan jawaban dari anggota Komunitas dan profesional Google SecOps.