Mengumpulkan log AWS WAF

Versi Parser: 11.0

Didukung di:

Dokumen ini menjelaskan cara mengumpulkan log AWS Firewall Aplikasi Web (WAF) dengan menyiapkan feed Google Security Operations. Parser mengubah log mentah berformat JSON menjadi format terstruktur yang sesuai dengan UDM Google SecOps. Parser ini mengekstrak kolom seperti alamat IP, URL, agen pengguna, dan detail aturan keamanan, lalu memetakannya ke kolom UDM yang sesuai untuk representasi dan analisis yang konsisten.

Sebelum memulai

*Pastikan Anda memiliki prasyarat berikut:

  • Instance Google SecOps
  • Akses istimewa ke AWS

Mengonfigurasi bucket Amazon S3

  1. Buat bucket Amazon S3 dengan mengikuti panduan pengguna ini: Membuat bucket
  2. Simpan Name dan Region bucket untuk digunakan nanti.
  3. Buat pengguna dengan mengikuti panduan pengguna ini: Membuat pengguna IAM.
  4. Pilih User yang dibuat.
  5. Pilih tab kredensial keamanan.
  6. Klik Create Access Key di bagian Access Keys.
  7. Pilih Layanan pihak ketiga sebagai Kasus penggunaan.
  8. Klik Berikutnya.
  9. Opsional: tambahkan tag deskripsi.
  10. Klik Create access key.
  11. Klik Download CSV file untuk menyimpan Access Key dan Secret Access Key untuk digunakan nanti.
  12. Klik Done.
  13. Pilih tab Izin.
  14. Klik Tambahkan izin di bagian Kebijakan Izin.
  15. Pilih Add permissions.
  16. Pilih Attach policies directly.
  17. Telusuri dan pilih kebijakan AmazonS3FullAccess.
  18. Klik Berikutnya.
  19. Klik Add permissions.

Membuat ACL (Access Control List) web WAF

Jika belum menyiapkan AWS WAF, Anda harus membuat ACL (Access Control List) web WAF. Untuk penyiapan yang sudah ada, Anda dapat langsung melanjutkan ke prosedur berikutnya.

  1. Di AWS Console, telusuri dan pilih AWS WAF & Shield.
  2. Klik Create web ACL.
  3. Berikan setelan berikut:
    • Name: Beri nama ACL (misalnya, my-waf-web-acl).
    • Region: Pilih region tempat Anda ingin menerapkan WAF.
    • CloudWatch Metrics: Aktifkan pengumpulan metrik untuk melacak aktivitas dan aturan yang dipicu.
  4. Setelah dibuat, pilih ACL web yang ingin Anda aktifkan logging-nya.

Cara mengonfigurasi AWS WAF Logging

  1. Di AWS WAF Console, buka tab Logging di ACL web Anda.
  2. Klik Enable Logging.
  3. Pilih Amazon S3 sebagai tujuan log Anda.
  4. Pilih bucket S3 yang dibuat sebelumnya untuk menyimpan log.
  5. Opsional: konfigurasikan awalan log untuk mengatur log (misalnya, waf-logs/).
  6. Klik Simpan.

Memverifikasi Izin untuk Bucket S3

Pastikan bucket S3 memiliki izin yang tepat bagi AWS WAF untuk menulis log.

  1. Buka S3 Console.
  2. Pilih bucket tempat log akan disimpan.
  3. Di tab Permissions, tambahkan Bucket Policy berikut untuk mengizinkan AWS WAF menulis log:

    {
      "Version": "2012-10-17",
      "Statement": [
          {
            "Effect": "Allow",
            "Principal": {
                "Service": "wafv2.amazonaws.com"
            },
            "Action": "s3:PutObject",
            "Resource": "arn:aws:s3:::your-log-bucket-name/*"
          }
      ]
    }
    
  1. Klik Simpan.

Menyiapkan feed

Ada dua titik entri yang berbeda untuk menyiapkan feed di platform Google SecOps:

  • Settings > Data Management > Feeds > Add New Feed (Di platform khusus SIEM, Settings > Feeds > Add New Feed)
  • Content Hub > Paket Konten > Mulai

Cara menyiapkan feed AWS WAF

  1. Klik paket Amazon Cloud Platform.
  2. Temukan jenis log AWS WAF.
  3. Tentukan nilai di kolom berikut.

    • Source Type: Amazon SQS V2
    • Queue Name: Nama antrean SQS yang akan dibaca
    • S3 URI: URI bucket.
      • s3://your-log-bucket-name/
        • Ganti your-log-bucket-name dengan nama sebenarnya bucket S3 Anda.
    • Opsi penghapusan sumber: Pilih opsi penghapusan sesuai dengan preferensi penyerapan Anda.

    • Usia File Maksimum: Sertakan file yang diubah dalam jumlah hari terakhir. Defaultnya adalah 180 hari.

    • SQS Queue Access Key ID: Kunci akses akun yang merupakan string alfanumerik 20 karakter.

    • SQS Queue Secret Access Key: Kunci akses akun yang merupakan string alfanumerik 40 karakter.

    Opsi lanjutan

    • Nama Feed: Nilai yang diisi otomatis yang mengidentifikasi feed.
    • Namespace Aset: Namespace yang terkait dengan feed.
    • Label Penyerapan: Label yang diterapkan ke semua peristiwa dari feed ini.
  4. Klik Buat feed.

Untuk mengetahui informasi selengkapnya tentang cara mengonfigurasi beberapa feed untuk berbagai jenis log dalam kelompok produk ini, lihat Mengonfigurasi feed menurut produk.

Tabel Pemetaan UDM

Kolom log Pemetaan UDM Logika
tindakan security_result.action Jika tindakan adalah ALLOW, tetapkan security_result.action ke ALLOW dan security_result.severity ke INFORMATIONAL. Jika tindakan adalah BLOCK, tetapkan security_result.action ke BLOCK. Jika action adalah CAPTCHA dan captchaResponse.responseCode adalah 405, tetapkan security_result.action ke BLOCK dan security_result.action_details ke "CAPTCHA {captchaResponse.failureReason}".
captchaResponse.failureReason security_result.action_details Digunakan bersama dengan action dan captchaResponse.responseCode untuk menentukan security_result.action_details.
captchaResponse.responseCode security_result.action_details Digunakan bersama dengan action dan captchaResponse.failureReason untuk menentukan security_result.action_details.
httpRequest.clientIp principal.ip, principal.asset.ip Dipetakan langsung ke principal.ip dan principal.asset.ip.
httpRequest.headers target.hostname, target.asset.hostname, network.http.user_agent, network.http.parsed_user_agent, network.http.referral_url, target.location.country_or_region, target.resource.attribute.labels, target.user.userid Melakukan iterasi melalui setiap header di httpRequest.headers. Jika nama header adalah "host" atau "Host", nilainya akan dipetakan ke target.hostname dan target.asset.hostname. Jika nama header adalah "User-Agent" atau "user-agent", nilainya akan dipetakan ke network.http.user_agent dan diuraikan menjadi network.http.parsed_user_agent. Jika nama header adalah "Referer" atau "referer", nilainya akan dipetakan ke network.http.referral_url. Jika nama header adalah "(?i)time-zone", nilainya akan dipetakan ke target.location.country_or_region. Jika nama header adalah "authorization", nilainya akan didekode dan nama pengguna akan diekstrak dan dipetakan ke target.user.userid. Semua header lainnya ditambahkan sebagai key-value pair ke target.resource.attribute.labels.
httpRequest.httpMethod network.http.method Dipetakan langsung ke network.http.method.
httpRequest.requestId network.session_id Dipetakan langsung ke network.session_id.
httpRequest.uri target.url Dipetakan langsung ke target.url.
httpSourceId target.resource.name Dipetakan langsung ke target.resource.name.
httpSourceName metadata.product_event_type Dipetakan langsung ke metadata.product_event_type.
labels security_result.rule_labels Melakukan iterasi melalui setiap label dalam label. Jika nama label tidak kosong, nama tersebut akan ditambahkan sebagai pasangan nilai kunci ke security_result.rule_labels.
nonTerminatingMatchingRules security_result.action_details, security_result.rule_labels Melakukan iterasi melalui setiap aturan di nonTerminatingMatchingRules. Jika tindakan adalah ALLOW dan tindakan aturan adalah CAPTCHA, tetapkan security_result.action_details ke "CAPTCHA SUCCESSFUL" dan tambahkan ID aturan ke security_result.rule_labels dengan kunci "nonTerminatingCaptchaRuleName". Jika tindakan adalah BLOCK atau ALLOW dan tindakan aturan adalah COUNT, tetapkan security_result.action_details ke "COUNT RULE" dan tambahkan ID aturan ke security_result.rule_labels dengan kunci "nonTerminatingCountRuleName". Jika tindakan adalah BLOCK atau ALLOW dan tindakan aturan adalah CHALLENGE, tetapkan security_result.action_details ke "COUNT RULE" dan tambahkan ID aturan ke security_result.rule_labels dengan kunci "nonTerminatingChallengeRuleName".
rateBasedRuleList security_result.rule_id, security_result.rule_name, security_result.description Jika terminatingRuleType adalah "RATE_BASED", lakukan iterasi melalui setiap aturan di rateBasedRuleList. Jika terminatingRuleId cocok dengan nama aturan, ID aturan, nama aturan, dan deskripsi akan dipetakan ke security_result.rule_id, security_result.rule_name, dan security_result.description.
responseCodeSent network.http.response_code Dipetakan langsung ke network.http.response_code dan dikonversi menjadi bilangan bulat.
ruleGroupList intermediary.labels, security_result.rule_id, security_result.rule_name, security_result.description, security_result.detection_fields Melakukan iterasi melalui setiap grup aturan di ruleGroupList. ID grup aturan ditambahkan sebagai pasangan nilai kunci ke intermediary.labels. Jika terminatingRuleType adalah "MANAGED_RULE_GROUP" dan terminatingRuleId cocok dengan ID grup aturan, ID aturan, nama aturan, dan deskripsi akan dipetakan ke security_result.rule_id, security_result.rule_name, dan security_result.description. Jika terminatingRuleType adalah "GROUP", ID aturan penghentian akan diekstrak dan dipetakan ke security_result.rule_name dan security_result.description. ID grup aturan penghentian ditambahkan ke security_result.rule_labels dengan kunci "terminatingRuleGroupName". Jika terminatingRuleType adalah "REGULAR", tindakan aturan penghentian akan diekstrak dan ditambahkan ke kolom security_result.detectiondengan kunci "terminatingRuleAction{index}".
terminatingRuleId security_result.rule_id, security_result.rule_name, security_result.description Jika terminatingRuleType adalah "RATE_BASED", "MANAGED_RULE_GROUP", atau "REGULAR", terminatingRuleId dipetakan ke security_result.rule_id, security_result.rule_name, dan digunakan untuk membuat security_result.description.
terminatingRuleMatchDetails security_result.description, security_result.category_details, security_result.detection_fields Melakukan iterasi melalui setiap kecocokan di terminatingRuleMatchDetails. Menetapkan security_result.description ke "Terminating Rule". Jika jenis kondisi tidak kosong, jenis kondisi tersebut akan ditambahkan ke security_result.category_details. Jika lokasi tidak kosong, lokasi tersebut akan ditambahkan ke security_result.detection_fields dengan kunci "location". Setiap elemen data yang cocok akan ditambahkan ke security_result.detection_fields dengan kunci "matchedData".
terminatingRuleType security_result.rule_type Dipetakan langsung ke security_result.rule_type.
timestamp metadata.event_timestamp Dikonversi menjadi stempel waktu dan dipetakan ke metadata.event_timestamp.
webaclId intermediary.resource.name Dipetakan langsung ke intermediary.resource.name.
metadata.vendor_name Tetapkan ke "AMAZON".
metadata.product_name Tetapkan ke "AWS Firewall Aplikasi Web".
metadata.log_type Tetapkan ke "AWS_WAF".
network.application_protocol Tetapkan ke "HTTP".
metadata.event_type Tetapkan ke "NETWORK_HTTP" jika httpRequest.headers berisi header "host" atau "Host". Jika tidak, tetapkan ke "STATUS_UPDATE".

Log Perubahan

Melihat Log Perubahan untuk parser ini

Perlu bantuan lain? Dapatkan jawaban dari anggota Komunitas dan profesional Google SecOps.