Mengumpulkan log WAF Vercel

Didukung di:

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

  1. Buka Konsol Google Cloud.
  2. Pilih project Anda atau buat project baru.
  3. Di menu navigasi, buka Cloud Storage > Buckets.
  4. Klik Create bucket.
  5. 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
  6. 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.

Vercel Log Drains melakukan streaming log secara real-time ke endpoint eksternal.

  1. Login ke Dasbor Vercel.
  2. Buka setelan tim Anda: Settings > Log Drains.
  3. Klik Add Log Drain.
  4. 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).
  5. Klik Add Log Drain.
  6. Pastikan log dikirim ke endpoint Anda.

Opsi B: Mengekspor melalui REST API Vercel

  1. Buat token API Vercel di Settings > Tokens.
  2. 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

  1. Buka Setelan > Pengelolaan Data > Feed. Jika Anda menggunakan platform khusus SIEM, buka Settings > Feeds.
  2. Klik Tambahkan Feed Berita Baru.
  3. Klik Konfigurasi satu feed.
  4. Di kolom Nama feed, masukkan nama untuk feed (misalnya, Vercel WAF Logs).
  5. Pilih Google Cloud Storage V2 sebagai Source type.
  6. Pilih Vercel WAF sebagai Log type.
  7. Klik Get Service Account. Email akun layanan yang unik akan ditampilkan, misalnya:

    chronicle-12345678@chronicle-gcp-prod.iam.gserviceaccount.com
    
  8. Salin 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.

  1. Buka Cloud Storage > Buckets.
  2. Klik nama bucket Anda (misalnya, vercel-waf-logs).
  3. Buka tab Izin.
  4. Klik Grant access.
  5. 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.
  6. Klik Simpan.

Mengonfigurasi feed Google SecOps

  1. Buka Setelan > Pengelolaan Data > Feed. Jika Anda menggunakan platform khusus SIEM, buka Settings > Feeds.
  2. Klik Tambahkan Feed Berita Baru.
  3. Klik Konfigurasi satu feed.
  4. Di kolom Nama feed, masukkan nama untuk feed (misalnya, Vercel WAF Logs).
  5. Pilih Google Cloud Storage V2 sebagai Source type.
  6. Pilih Vercel WAF sebagai Log type.
  7. Klik Berikutnya.
  8. Tentukan nilai untuk parameter input berikut:

    • Storage bucket URL: Masukkan URI bucket GCS:

      gs://vercel-waf-logs/vercel-waf/
      
      • Ganti vercel-waf-logs dengan nama bucket GCS Anda.
      • Ganti vercel-waf dengan jalur awalan yang Anda konfigurasi.
    • 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.

  9. Klik Berikutnya.

  10. 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.