Topik ini menjelaskan kebijakan bawaan dan konfigurasi custom policy untuk keamanan Agentic API. Selain mekanisme deteksi bawaan, keamanan Agentic API mendukung custom detection policy yang dapat disesuaikan dengan kebutuhan bisnis Anda. Anda dapat mengonfigurasikan deteksi risiko, security event, sensitive data, authentication credential, tujuan bisnis, allowlist, lifecycle management, log subscription, dan target object untuk memastikan data API yang teridentifikasi mencerminkan bisnis Anda secara akurat. Hal ini meningkatkan akurasi dan recall deteksi, membantu Anda merespons secara efektif, serta mengurangi kerugian akibat serangan terhadap aset bisnis API Anda.
Console
-
Login ke konsol Web Application Firewall 3.0. Dari menu bar atas, pilih resource group dan region (Chinese Mainland atau Outside Chinese Mainland) untuk Instans WAF.
Di panel navigasi kiri, pilih .
Klik tab Policy Configurations.
Risk Detection Configurations
Risiko adalah ancaman keamanan atau kerentanan pada API yang disebabkan oleh kekurangan dalam pengembangan, pengelolaan, atau konfigurasi. Security risk merupakan potensi kerentanan, sedangkan security event mengonfirmasi bahwa serangan telah terjadi dan memicu alert.
WAF menyediakan kebijakan bawaan dan custom policy. Jika kebijakan bawaan tidak memenuhi kebutuhan bisnis Anda, Anda dapat mengonfigurasikan custom policy.
Built-in policy
Pada tab Policy Configurations > Risk Detection Configurations, Anda dapat melihat kebijakan risiko yang telah dikonfigurasi. Semua kebijakan bawaan diaktifkan secara default. Anda dapat mengubah statusnya dan menyesuaikan tingkat risikonya. Berdasarkan kebutuhan bisnis, Anda dapat mengatur tingkat risiko kebijakan bawaan menjadi "Low Risk", "Medium Risk", atau "High Risk".
Custom policy
Selain kebijakan bawaan, Anda dapat membuat hingga 20 custom policy.
Buka tab .
Di bagian Custom Policy di sebelah kiri, klik New. Di panel yang muncul, konfigurasikan pengaturan berikut.
Parameter
Deskripsi
Risk Name
Masukkan nama deskriptif untuk risiko kustom.
Suggestions
Masukkan tindakan yang disarankan untuk risiko ini.
Risk Level
Atur tingkat risiko ke rendah, menengah, atau tinggi.
Check Configurations
Atur kondisi deteksi untuk custom policy. Anda dapat menambahkan hingga 10 kondisi.
Tentukan Match Field, Logical Operator, dan Match Content. Anda dapat memasukkan hingga 50 nilai untuk match content. Tekan Enter setelah setiap nilai. Nilai Risk Detection Configurations bersifat case-sensitive.
Untuk detail mengenai konfigurasi yang didukung, lihat Deskripsi Kondisi Pencocokan (Deteksi Risiko dan Security Event).
Security Event Configurations
Security event adalah panggilan API yang tidak wajar atau serangan, seperti serangan brute-force pada API login atau serangan SMS bombing yang menyalahgunakan API SMS. WAF mendeteksi event ini berdasarkan alamat IP dan akun.
WAF menyediakan kebijakan bawaan dan custom policy. Jika kebijakan bawaan tidak memenuhi kebutuhan bisnis Anda, Anda dapat mengonfigurasikan custom policy.
Built-in policy
Ketika kebijakan bawaan untuk security event memicu alert, sistem tidak menghasilkan alert baru untuk serangan yang sedang berlangsung. Sebaliknya, sistem memperbarui waktu serangan dari alert asli, dan tingkat keparahan event dapat berubah berdasarkan faktor-faktor seperti volume serangan.
Pada tab Policy Configurations > Security Event Configurations, Anda dapat melihat kebijakan security event bawaan. Semua kebijakan bawaan diaktifkan secara default. Anda dapat mengubah statusnya dan menyesuaikan Event Level.
Custom policy
Selain kebijakan bawaan, Anda dapat membuat hingga 10 custom policy.
Buka tab Policy Configurations>Security Event Configurations.
Di bagian Custom Policy di sebelah kiri, klik New. Di panel yang muncul, konfigurasikan pengaturan berikut.
Parameter
Deskripsi
Event Name
Masukkan nama deskriptif untuk event kustom.
Suggestions
Berikan saran remediasi untuk security event kustom berdasarkan kebutuhan bisnis Anda.
Event Level
Atur tingkat keparahan event ke Low, Medium, atau High.
Match Condition
Konfigurasikan kondisi pencocokan yang memicu event keamanan kustom. Anda dapat menambahkan hingga 10 kondisi.
Untuk detail konfigurasi yang didukung, lihat Deskripsi Kondisi Pencocokan (Deteksi Risiko dan Peristiwa Keamanan).
Rate Limiting
Menentukan Statistical Object (alamat IP atau akun), Statistical Period (hingga 15 menit), dan Requests (harus berupa bilangan bulat positif).
Data Statistics
Konfigurasikan kondisi statistik untuk security event kustom. Anda dapat menambahkan hingga 10 kondisi.
Untuk detail mengenai konfigurasi yang didukung, lihat Deskripsi Data Statistics (Security Event).
Anda dapat memasukkan hingga 50 nilai match content. Tekan Enter setelah setiap nilai untuk mengonfirmasi.
Jika Anda menentukan beberapa kondisi, permintaan harus memenuhi semua kondisi untuk memicu aturan.
Match content untuk Security Event Configurations bersifat case-sensitive.
III. Sensitive Data-related Configurations
WAF mendeteksi tipe sensitive data bawaan maupun kustom. Tipe bawaan diaktifkan secara default dan hanya dapat diaktifkan atau dinonaktifkan. Jika tipe bawaan tidak memenuhi kebutuhan bisnis Anda, Anda dapat mengonfigurasikan hingga 20 tipe sensitive data kustom.
Built-in Sensitive Data Types
Buka tab Policy Configurations > Sensitive Data-related Configurations > Built-in Sensitive Data Types. Semua kebijakan bawaan diaktifkan secara default. Anda tidak dapat mengedit atau menghapusnya; Anda hanya dapat mengaktifkan atau menonaktifkannya.
Custom Sensitive Data Types
Buka tab Policy Configurations > Sensitive Data-related Configurations > Custom Sensitive Data Types, klik Create Policy, lalu konfigurasikan parameter berikut:
Parameter | Deskripsi |
Name | Masukkan nama untuk kebijakan. |
Mode | Mengatur mode deteksi untuk custom policy.
|
Sensitivity Level | Mengatur tingkat sensitivitas data yang terdeteksi. Opsinya adalah: S1, S2, S3, dan S4. Catatan Untuk informasi lebih lanjut tentang tipe sensitive data, lihat Tipe sensitive data apa saja yang didukung oleh Keamanan Agentic API? |
De-identification Display
Tab Sensitive Data-related Configurations mencakup sakelar De-identification Display. Sakelar ini dinonaktifkan secara default sehingga tidak ada data yang disamarkan. Saat diaktifkan, fitur ini menyamarkan informasi berikut:
Aturan penyamaran data
Risk Details dan API Details: Sensitive data dalam sampel permintaan dan respons diganti secara default dengan placeholder
{{Phone}}.Event Details: Sampel permintaan dan respons yang mengandung sensitive data disamarkan sebagai
{}.Menyembunyikan bidang tertentu:
Permintaan cookie disamarkan sebagai
{{Cookie}}.Header permintaan yang berisi token disamarkan sebagai
{{XXXToken}}.Header Set-Cookie respons disamarkan sebagai
{{SetCookie}}.
Cakupan
Risk Details dan API Details: Hanya berlaku untuk sampel permintaan dan respons baru.
Event Details: Berlaku untuk sampel permintaan dan respons baru maupun yang sudah ada.
IV. Disposal Policy Configuration
Tab Disposal Policy Configuration menyediakan fitur berikut.
Schema Validation: Memvalidasi permintaan dan respons langsung terhadap skema (
API contract) yang dikonfigurasi untukAPI asset. Pada waktu proses, WAF membandingkan traffic dengan definisi skema untuk mengidentifikasi permintaan yang tidak sesuai denganAPI contractdan menanganinya berdasarkandisposition actionyang dikonfigurasi dalam Templat. Fitur ini membantu Anda mendeteksi panggilan yang tidak wajar dan penyalahgunaan API.API Real-Time Data Masking: Didukung oleh
AI baseline engine, fitur ini secara otomatis mempelajari struktur API Anda untuk mengidentifikasisensitive datadan melakukandata maskingotomatis yang detail halus secara real-time. Karena tidak mengharuskan Anda menentukan field terlebih dahulu, fitur ini beradaptasi secara fleksibel dengan skenario bisnis yang kompleks, membantu Anda memenuhi persyaratan kepatuhan seperti transfer data lintas batas, dan memberikan perlindungan otomatis secara real-time.
Schema Validation
Sebelum mengonfigurasi Schema Validation, Anda harus terlebih dahulu mengonfigurasi skema untuk API asset pada tab Asset Management.
Pada tab Policy Configurations > Disposal Policy Configuration, klik Schema Validation di daftar sebelah kiri, lalu klik Create Template untuk membuat Templat validasi.
Template Name: Masukkan nama deskriptif untuk Templat.
Rule Configuration: Klik Create Rule untuk mengonfigurasi aturan validasi spesifik. Anda dapat mengonfigurasi beberapa aturan.
Rule Name: Masukkan nama deskriptif untuk aturan.
Validation Details: Pilih satu atau lebih item untuk divalidasi: Method, Path Parameter, Query Parameter, Header Parameter, dan Cookie Parameter. WAF tidak memvalidasi item yang tidak dipilih.
Method: Memvalidasi apakah method dari permintaan langsung sesuai dengan yang didefinisikan dalam skema.
Path Parameter, Query Parameter, Header Parameter, dan Cookie Parameter: Memvalidasi apakah parameter permintaan di lokasi yang sesuai mematuhi definisi skema (termasuk apakah parameter tersebut wajib, tipenya, formatnya, dan batasan nilainya).
Data Processing Method: Tindakan yang didukung adalah Monitor dan Block.
Monitor: Mengizinkan permintaan yang sesuai dengan aturan tetapi mencatat pencocokan tersebut. Saat menguji aturan, Anda dapat memulai dengan tindakan Log dan menganalisis log WAF untuk memeriksa false positive sebelum mengubah tindakannya.
Block: Memblokir permintaan yang sesuai dengan aturan dan mengembalikan halaman blokir ke client. Secara default, WAF menggunakan halaman blokir standar. Anda juga dapat membuat halaman kustom menggunakan fitur custom response.
Apply To: Tentukan
API assettempat Templat berlaku. SetiapAPI assethanya dapat dikaitkan dengan satu Templat validasi.
API Real-Time Data Masking
Pada tab Policy Configurations > Disposal Policy Configuration, klik API Real-Time Data Masking di daftar sebelah kiri, lalu klik Create Template untuk membuat Templat penyamaran data.
Template Name: Masukkan nama deskriptif untuk Templat.
Masking Rule Configuration: Klik Create Rule untuk mengonfigurasi aturan penyamaran data spesifik. Anda dapat mengonfigurasi beberapa aturan.
Rule Name: Masukkan nama deskriptif untuk aturan.
Sensitive Data Type: Pilih tipe data yang akan disamarkan. Hanya tipe sensitive data bawaan yang didukung.
Match Condition: Atur kondisi HTTP yang memicu aturan. Anda dapat mengonfigurasikan hingga lima kondisi. Jika Anda tidak mengonfigurasinya, aturan akan cocok dengan semua permintaan HTTP.
CatatanJika sebuah aturan mencakup beberapa kondisi, permintaan harus memenuhi semua kondisi (logika AND) agar sesuai dengan aturan. Untuk deskripsi rinci tentang match field dan Operator logika, lihat Detail match condition.
Data Processing Method: Dua tindakan berikut didukung:
Mask: Menyamarkan data. Anda juga harus mengonfigurasi Action spesifik. Tindakan yang didukung adalah Clear dan Masking.
Monitor: Tidak menyamarkan data tetapi mencatat ketika sensitive data terdeteksi.
Apply To: Tentukan
API assettempat Templat berlaku. SetiapAPI assethanya dapat dikaitkan dengan satu Templat penyamaran data.
Setelah Anda membuat Templat, aturan penyamaran datanya memerlukan waktu 10 hingga 20 menit untuk diterapkan pada API asset yang baru ditambahkan. Untuk melihat log penyamaran data API, buka halaman Security Reports.
Pemeliharaan: Anda dapat mengelola Templat dan aturan yang ada dengan cara berikut:
Mengaktifkan atau menonaktifkan Templat dan aturan.
Menambahkan aturan baru ke Templat.
Mengedit Templat dan aturan.
Menghapus Templat dan aturan.
V. Authentication Credential Configurations
WAF menyediakan identifikasi bawaan untuk authentication credential dan mendukung konfigurasi authentication credential kustom. Jika layanan Anda menggunakan field non-standar atau field dengan pola lemah (seperti nilai numerik saja) sebagai authentication credential, Anda dapat membuat custom policy untuk meningkatkan akurasi keamanan API dan identifikasi risiko tanpa autentikasi. Ikuti langkah-langkah berikut:
Buka tab Policy Configurations > Authentication Credential Configurations.
Klik Create Policy dan konfigurasikan pengaturan berikut.
Parameter
Deskripsi
Name
Masukkan nama deskriptif untuk kebijakan.
Match Condition
Setiap match condition terdiri dari Match Field, Logical Operator, dan Match Content. Anda dapat menambahkan hingga 10 kondisi. Anda harus menambahkan setidaknya satu match condition untuk header permintaan, cookie permintaan, query permintaan, atau badan permintaan. WAF menggabungkan beberapa kondisi dengan logika AND, yang berarti permintaan harus memenuhi semua kondisi agar sesuai dengan aturan.
Konfigurasi match content: Anda dapat memasukkan hingga 50 nilai. Tekan Enter untuk mengonfirmasi setiap nilai. Untuk Authentication Credential Configurations, match content bersifat case-sensitive. Untuk detail lebih lanjut, lihat Deskripsi match condition (konfigurasi authentication credential).
VI. Business Purpose
WAF menyediakan kebijakan bawaan dan custom policy. Jika kebijakan bawaan tidak memenuhi kebutuhan bisnis Anda, Anda dapat mengonfigurasikan custom policy untuk meningkatkan akurasi deteksi Agentic API untuk skenario bisnis tertentu.
Built-in Policy
Buka tab Policy Configurations > Business Purpose > Built-in Policy. Kebijakan ini mencakup pembaruan data, berbagi data, pengiriman SMS, dan pengiriman pesan. Secara default, semua kebijakan bawaan diaktifkan. Anda tidak dapat mengedit atau menghapusnya, tetapi Anda dapat mengaktifkan atau menonaktifkannya.
Custom Policy
Buka tab Policy Configurations>Business Purpose>Custom Policy.
Klik Create Policy dan konfigurasikan parameter berikut.
Parameter
Deskripsi
Name
Masukkan nama deskriptif untuk kebijakan.
Match Condition
Setiap kondisi terdiri dari Match Field, Logical Operator, dan Match Content. Anda dapat menambahkan hingga 10 kondisi.
Konfigurasi match content: Anda dapat memasukkan hingga 50 nilai, tekan Enter setelah setiap nilai. Match content dalam Business Purpose bersifat case-sensitive. Untuk detailnya, lihat Deskripsi match condition (konfigurasi business purpose).
Configure Whitelist
Keamanan Agentic API memungkinkan Anda mengonfigurasikan whitelist kustom untuk deteksi risiko dan security event guna memfilter alert yang tidak relevan berdasarkan kebutuhan bisnis Anda, seperti yang berasal dari alamat IP egress jaringan kantor Anda, serta meningkatkan efisiensi operasional.
Saat ini, Anda hanya dapat mengonfigurasikan whitelist untuk Risk Detection dan Security Events.
Buka tab Policy Configurations > Configure Whitelist.
Klik Create Policy dan konfigurasikan parameter berikut.
Parameter
Deskripsi
Name
Masukkan nama deskriptif untuk kebijakan.
Type
Pilih tipe whitelist: Risk Detection atau Security Events.
Match Condition
Setiap kondisi terdiri dari Match Field, Logical Operator, dan Match Content. Anda dapat menambahkan hingga 10 kondisi.
Konfigurasi matching content: Anda dapat memasukkan hingga 50 nilai. Tekan Enter setelah setiap nilai. Matching content dalam Configure Whitelist bersifat case-sensitive. Untuk informasi lebih lanjut, lihat Deskripsi matching conditions (konfigurasi whitelist).
Skipped Types
Dari kebijakan bawaan atau kustom, pilih satu atau lebih tipe deteksi risiko atau security event yang ingin dikecualikan.
Lifecycle management
Keamanan Agentic API memungkinkan Anda menyesuaikan kriteria untuk API yang tidak aktif dengan menetapkan ambang batas untuk kunjungan harian dan durasi. Hal ini menyelaraskan deteksi API tidak aktif dengan kebutuhan bisnis Anda. Lifecycle management API membantu Anda mengidentifikasi dan mengelola API yang memenuhi standar ini, mencegah penyerang mengeksploitasi API yang tidak aktif, serta mengurangi potensi kerugian bisnis.
Buka tab Policy Configurations > Lifecycle Management.
Atur kriteria untuk mengidentifikasi API yang tidak aktif, lalu klik OK.
Mode
Deskripsi
Built-in Model
Sistem menandai API sebagai tidak aktif jika tidak menerima traffic selama 8 hari atau volume traffic-nya turun secara signifikan.
Custom
Mode ini memungkinkan Anda menentukan ambang batas untuk kunjungan harian dan durasi hingga 31 hari. Jika kunjungan harian API turun di bawah ambang batas ini selama durasi yang ditentukan, sistem akan menandainya sebagai tidak aktif.
Jika Last Active Time Aset lebih dari 30 hari yang lalu, sistem secara otomatis menghapus Aset beserta data risiko dan catatan security event terkait.
IX. Log Subscription Configurations
WAF mendukung pengiriman informasi Aset, informasi risiko, dan informasi Peristiwa serangan dari keamanan Agentic API ke LogStore tertentu di Log Service (SLS) untuk manajemen dan analisis terpusat.
Batasan region: Instans WAF di Tiongkok daratan hanya dapat mengirimkan log ke LogStore di Tiongkok daratan. Instans WAF di luar Tiongkok daratan hanya dapat mengirimkan log ke LogStore di luar Tiongkok daratan. Pengiriman lintas wilayah tidak didukung.
Batasan Project dan LogStore: Anda tidak dapat memilih LogStore untuk log subscription jika dibuat secara otomatis oleh layanan log WAF atau jika Anda memberinya nama
waf-logstore,wafng-logstore, atauwafnew-logstore.
Prosedur
Login ke konsol Log Service dan buat Project serta LogStore untuk menerima log keamanan Agentic API. Jika Anda sudah membuatnya, lewati langkah ini. Untuk informasi lebih lanjut, lihat Mengelola Project.
Kembali ke konsol WAF, dan navigasikan ke tab Policy Configurations > Log Subscription Configurations.
Pilih tipe log yang ingin dilanggan dan klik Settings.
Pilih Wilayah tujuan, Project name, dan LogStore name, lalu klik OK.
Anda dikenakan biaya oleh Log Service untuk operasi di konsol Log Service, seperti membuat Project dan LogStore serta mengaktifkan pengindeksan. Untuk informasi lebih lanjut tentang item penagihan dan harga, lihat Ikhtisar penagihan Log Service.
Kondisi pemicu log subscription
Tipe log | Kondisi pemicu |
Log informasi aset | Log dikirimkan segera saat API asset baru ditambahkan. Jika tidak ada aset baru yang ditambahkan, log dikirimkan setiap jam secara default. |
Log informasi risiko | Ketika informasi risiko baru terdeteksi, log dikirimkan secara real-time. |
Log informasi peristiwa serangan | Ketika peristiwa serangan baru terdeteksi, log dikirimkan secara real-time. Jika serangan berlanjut, log dikirimkan setiap 10 menit. |
Field log: Untuk daftar field log yang dikirimkan, lihat Deskripsi field log subscription.
Applicable Object Configurations
Subscription WAF
Keamanan Agentic API menyediakan tiga sakelar pada level protected object atau grup protected object:
Sakelar Basic Detection: Diaktifkan secara default. Mengontrol semua mekanisme deteksi bawaan dan custom detection policy.
Sakelar Compliance Check: Dinonaktifkan secara default. Anda dapat mengaktifkan sakelar ini hanya setelah mengaktifkan Basic Detection. Mengontrol fitur Compliance Check.
Sakelar Traceability: Dinonaktifkan secara default. Anda dapat mengaktifkan sakelar ini hanya setelah mengaktifkan Basic Detection. Mengontrol fitur Traceability.
Pay-as-you-go WAF
Keamanan Agentic API menyediakan satu sakelar pada level protected object atau grup protected object:
Sakelar Basic Detection: Mengontrol semua mekanisme deteksi bawaan dan custom detection policy. Untuk menonaktifkan keamanan API, matikan sakelar Basic Detection untuk semua protected object dan grup protected object.
Lampiran
Match condition untuk risiko dan security event
Match field | Sub-condition | Operator logika | Deskripsi |
Domain Name | Tidak didukung | Contains One of Multiple Values, Does Not Contain Any Value, Equals One of Multiple Values, Does Not Equal Any Value | Anda dapat memasukkan hingga 50 nilai. Tekan Enter setelah setiap nilai. |
API | Tidak didukung | Contains One of Multiple Values, Does Not Contain Any Value, Equals One of Multiple Values, Does Not Equal Any Value | Anda dapat memasukkan hingga 50 nilai. Tekan Enter setelah setiap nilai. |
Request Method | Tidak didukung | Equals One of Multiple Values, Does Not Equal Any Value | Pilih satu atau lebih request method, seperti GET, POST, DELETE, dan PUT. |
User-Agent | Tidak didukung | Contains One of Multiple Values, Does Not Contain Any Value, Equals One of Multiple Values, Does Not Equal Any Value | Anda dapat memasukkan hingga 50 nilai. Tekan Enter setelah setiap nilai. |
Referer | Tidak didukung | Contains One of Multiple Values, Does Not Contain Any Value, Equals One of Multiple Values, Does Not Equal Any Value | Anda dapat memasukkan hingga 50 nilai. Tekan Enter setelah setiap nilai. |
Communication Protocol | Tidak didukung | Equals | Pilih HTTP atau HTTPS. |
Request Content-Type | Tidak didukung | Contains One of Multiple Values, Does Not Contain Any Value | Anda dapat memasukkan hingga 50 nilai. Tekan Enter setelah setiap nilai. |
Request Length | Tidak didukung | Equals, Value Less Than, Value Greater Than | Masukkan bilangan bulat dari 0 hingga 8.192. |
Response Content-Type | Tidak didukung | Contains One of Multiple Values, Does Not Contain Any Value | Anda dapat memasukkan hingga 50 nilai. Tekan Enter setelah setiap nilai. |
Response Length | Tidak didukung | Equals, Value Less Than, Value Greater Than | Masukkan bilangan bulat dari 0 hingga 8.192. |
HTTP Status Code | Tidak didukung | Equals One of Multiple Values, Does Not Equal Any Value | Anda dapat memasukkan hingga 50 nilai. Tekan Enter setelah setiap nilai. |
Request Header | header kustom | Exists, Does Not Exist, Length Equal To, Length Less Than, Length Greater Than, Contains One of Multiple Values, Does Not Contain Any Value | - |
Cookie Parameter | Cookie Kustom-Tepat | Exists, Does Not Exist, Length Equal To, Length Less Than, Length Greater Than, Contains One of Multiple Values, Does Not Contain Any Value | - |
GET Parameter | Parameter Kustom | Exists, Does Not Exist, Length Equal To, Length Less Than, Length Greater Than, Contains One of Multiple Values, Does Not Contain Any Value | - |
POST Parameter | Custom Post-Arg | Exists, Does Not Exist, Length Equal To, Length Less Than, Length Greater Than, Contains One of Multiple Values, Does Not Contain Any Value | - |
Response Header | header respons | Exists, Does Not Exist, Length Equal To, Length Less Than, Length Greater Than, Contains One of Multiple Values, Does Not Contain Any Value | - |
Response Parameter | parameter respons | Exists, Does Not Exist, Length Equal To, Length Less Than, Length Greater Than, Contains One of Multiple Values, Does Not Contain Any Value | - |
Purpose | Tidak didukung | Equals One of Multiple Values, Does Not Equal Any Value | Pilih satu atau lebih tujuan bisnis dari daftar. Untuk informasi lebih lanjut, lihat Bagaimana keamanan Agentic API mengklasifikasikan tujuan bisnis API? |
Service Object | Tidak didukung | Equals One of Multiple Values, Does Not Equal Any Value | Pilih satu atau lebih service object dari daftar. Untuk informasi lebih lanjut, lihat Bagaimana keamanan Agentic API membedakan service object API? |
Authentication | Tidak didukung | Equals | Ya/Tidak |
Request Sensitive Data Type | Tidak didukung | Equals One of Multiple Values, Does Not Equal Any Value, Category Count Greater Than | Pilih satu atau lebih tipe sensitive data dari daftar. Jika Anda menggunakan operator Number of Types Greater Than, masukkan bilangan bulat dari 0 hingga 8.192. |
Sensitivity Level of Request Sensitive Data | Tidak didukung | Equals One of Multiple Values, Does Not Equal Any Value | Pilih satu atau lebih level dari S1 hingga S4. |
Response Sensitive Data Type | Tidak didukung | Equals One of Multiple Values, Does Not Equal Any Value, Category Count Greater Than | Pilih satu atau lebih tipe sensitive data dari daftar. Jika Anda menggunakan operator Number of Types Greater Than, masukkan bilangan bulat dari 0 hingga 8.192. |
Sensitivity Level of Response Sensitive Data | Tidak didukung | Equals One of Multiple Values, Does Not Equal Any Value | Pilih satu atau lebih level dari S1 hingga S4. |
Source Location | Tidak didukung | Equals | Tiongkok Daratan/Luar Tiongkok Daratan |
Alamat IP | Tidak didukung | Belongs To, Does Not Belong To | Masukkan alamat IP atau Blok CIDR (misalnya, 1.1.X.X/24). Ekspresi reguler tidak didukung. Anda dapat memasukkan hingga 50 nilai, dipisahkan dengan koma atau baris baru. |
Account (security event saja) | Tidak didukung | Equals One of Multiple Values, Does Not Equal Any Value | Anda dapat memasukkan hingga 50 nilai. Tekan Enter setelah setiap nilai. |
Statistik security event
Bidang pencocokan | Sub-kondisi | Operator logika | Nilai |
Status Code Statistics | Status code (bilangan bulat dari 100 hingga 600) | Value Greater Than | Bilangan bulat dari 0 hingga 8.192. |
Request Header | custom header | Distinct Less Than, Distinct Equals, Distinct Greater Than | Bilangan bulat dari 0 hingga 8.192. |
Cookie Parameter | custom cookie-exact | Distinct Less Than, Distinct Equals, Distinct Greater Than | Bilangan bulat dari 0 hingga 8.192. |
GET Parameter | custom parameter | Distinct Less Than, Distinct Equals, Distinct Greater Than | Bilangan bulat dari 0 hingga 8.192. |
POST Parameter | custom POST parameter | Distinct Less Than, Distinct Equals, Distinct Greater Than | Bilangan bulat dari 0 hingga 8.192. |
Response Sensitive Data Type | Satu atau beberapa jenis data sensitif respons. | Distinct Greater Than | Bilangan bulat dari 0 hingga 8.192. |
Sensitivity Level of Response Sensitive Data | Satu atau beberapa tingkat data sensitif respons. | Distinct Greater Than | Bilangan bulat dari 0 hingga 8.192. |
Source IP Count | Ambang batas untuk jumlah IP sumber. | Value Greater Than | Bilangan bulat dari 0 hingga 8.192. |
Secara default, Keamanan Agentic API menganalisis sensitive data dalam respons menggunakan pengambilan sampel. Untuk mengonfigurasi deteksi Data Statistics untuk Response Sensitive Data Type dan Sensitivity Level of Response Sensitive Data dalam Custom Policy di bawah Security Event Configurations, aktifkan sakelar Traceability untuk protected object yang sesuai di Policy Configurations > Applicable Object Configurations. Hal ini memastikan bahwa semua sensitive data dalam respons dari protected object dicatat dan dianalisis sepenuhnya.
Match condition autentikasi
Match field | Sub-condition | Operator logika | Deskripsi |
Domain Name | Tidak didukung | Contains One of Multiple Values, Does Not Contain Any Value, Equals One of Multiple Values, Does Not Equal Any Value | Masukkan hingga 50 nilai. Tekan Enter setelah setiap nilai. |
API | Tidak didukung | Contains One of Multiple Values, Does Not Contain Any Value, Equals One of Multiple Values, Does Not Equal Any Value | Masukkan hingga 50 nilai. Tekan Enter setelah setiap nilai. |
Request Header | header kustom | Exists, Length Equal To, Length Less Than, Length Greater Than | |
Request Cookie | cookie kustom-tepat | Exists, Length Equal To, Length Less Than, Length Greater Than | |
Request Query | parameter kustom | Exists, Length Equal To, Length Less Than, Length Greater Than | |
Request Body | post-arg kustom | Exists, Length Equal To, Length Less Than, Length Greater Than |
Konfigurasi business purpose
Match field | Operator logika | Nilai |
Domain Name | Contains One of Multiple Values, Does Not Contain Any Value, Equals One of Multiple Values, Does Not Equal Any Value | Masukkan hingga 50 nilai, tekan Enter setelah setiap nilai. |
API | Contains One of Multiple Values, Does Not Contain Any Value, Equals One of Multiple Values, Does Not Equal Any Value | Masukkan hingga 50 nilai, tekan Enter setelah setiap nilai. |
Request Header Parameter Name | Contains One of Multiple Values, Equals One of Multiple Values | Masukkan hingga 50 nilai, tekan Enter setelah setiap nilai. |
Request Cookie Parameter Name | Contains One of Multiple Values, Equals One of Multiple Values | Masukkan hingga 50 nilai, tekan Enter setelah setiap nilai. |
Request Query Parameter Name | Contains One of Multiple Values, Equals One of Multiple Values | Masukkan hingga 50 nilai, tekan Enter setelah setiap nilai. |
Request Body Parameter Name | Contains One of Multiple Values, Equals One of Multiple Values | Masukkan hingga 50 nilai, tekan Enter setelah setiap nilai. |
Request Sensitive Data Type | Contains One of Multiple Values, Equals One of Multiple Values | Pilih satu atau lebih tipe sensitive data. |
Response Sensitive Data Type | Contains One of Multiple Values, Equals One of Multiple Values | Pilih satu atau lebih tipe sensitive data. |
Response Parameter Name | Contains One of Multiple Values, Equals One of Multiple Values | Masukkan hingga 50 nilai, tekan Enter setelah setiap nilai. |
Match condition (allow list)
Daftar Izin Deteksi Risiko
Match field | Operator logika | Nilai |
Domain Name | Contains One of Multiple Values, Does Not Contain Any Value, Equals One of Multiple Values, Does Not Equal Any Value | Masukkan hingga 50 nilai. Tekan Enter setelah setiap nilai. |
API | Contains One of Multiple Values, Does Not Contain Any Value, Equals One of Multiple Values, Does Not Equal Any Value | Masukkan hingga 50 nilai. Tekan Enter setelah setiap nilai. |
Daftar izin event keamanan
Bidang pencocokan | Operator logis | Nilai |
Domain Name | Contains One of Multiple Values, Does Not Contain Any Value, Equals One of Multiple Values, Does Not Equal Any Value | Masukkan hingga 50 nilai. Tekan Enter setelah setiap nilai. |
API | Contains One of Multiple Values, Does Not Contain Any Value, Equals One of Multiple Values, Does Not Equal Any Value | Masukkan hingga 50 nilai. Tekan Enter setelah setiap nilai. |
IP | Belongs To, Does Not Belong To | Masukkan alamat IP atau blok CIDR (misalnya, 1.1.X.X/24). Ekspresi reguler tidak didukung. Masukkan hingga 50 entri. Pisahkan dengan koma, atau tekan Enter setelah setiap entri. |
Account | Contains One of Multiple Values, Does Not Contain Any Value, Equals One of Multiple Values, Does Not Equal Any Value | Masukkan hingga 50 nilai. Tekan Enter setelah setiap nilai. |
Field pengiriman log subscription
Aset
Parameter | Deskripsi | Format | Contoh |
user_id |
| string | 123456 |
service_host |
| string | api.alibabacloud.com |
api_format |
| string | /api/v1/getuserbyid/${param} |
request_method |
| string | GET |
api_tag | Array yang menunjukkan | array | ['QueryInfo'] |
api_type | Array yang menunjukkan | array | ['PublicAPI'] |
auth_key | Array nama | array | ['id_token', 'access_token'] |
api_status | Status | string | NewbornInterface |
api_sensitive_level |
| string | L1 |
api_sensitive_req | Array ID untuk | array | ['1014', '1017', '1002'] |
api_sensitive_res | Array ID untuk | array | ['1009', '1013', '1003', '1014', '1002'] |
farthest_ts |
| long | 1713237135 |
latest_ts |
| long | 1716452318 |
abnormal_num | Total | integer | 1 |
event_num | Total | integer | 2 |
struct_baseline | Array string JSON, masing-masing mendeskripsikan | array | ['{"key":"Trace-Id","location":"request_header","format":"string","required":"true"}', '{"key":"pageNum","location":"request_query","format":"integer","required":"true"}', '{"key":"tlogTraceId","location":"response_header","format":"integer","required":"true"}', '{"key":"Strict-Transport-Security","location":"request_header","format":"string","required":"true"}', '{"key":"X-Forwarded-ClientSrcPort","location":"request_header","format":"integer","required":"true"}', '{"key":"Trace-State","location":"request_header","format":"string","required":"true"}', '{"key":"auth","location":"request_header","format":"string","required":"true"}', '{"key":"Access-Control-Max-Age","location":"response_header","format":"integer","required":"true"}', '{"key":"Enterprise-Hash","location":"request_header","format":"string","required":"true"}', '{"key":"X-Request-ID","location":"request_header","format":"string","required":"true"}', '{"key":"postName","location":"request_query","format":"string","required":"true"}', '{"key":"pageSize","location":"request_query","format":"integer","required":"true"}'] |
matched_hosts | Array pengidentifikasi | array | ['*.aliyun.com-waf'] |
hosts | Array | array | ['api.alibabacloud.com'] |
server_port | Array | array | ['443'] |
server_location | Array kode negara untuk | array | ['CN'] |
api_id |
| string | af418cb31036015fddea71b48d06aa4b |
log_type |
| string | asset |
request_header |
| JSON | {"Connection":"Keep-Alive","Host":"api.alibabacloud.com","eagleeye-rpcid":"0.1"} |
querystring |
| string | ?token=7464f593205896e23b1286ba7532dcff |
request_body |
| string | xxx=1 |
response_header |
| JSON | {"Accept-Ranges":["bytes","bytes"],"Cache-Control":"private, max-age=21600, no-transform"} |
response_body |
| string | xxxx |
example_timestamp |
| long | 1718546694 |
example_traceid |
| string | 784e2ca717213678365778292e58de |
Risiko
Parameter | Deskripsi | Format | Contoh |
user_id |
| string | 123456 |
service_host |
| string | api.alibabacloud.com |
api_format |
| string | /api/v1/login |
request_method |
| string | POST |
api_tag | Array yang menunjukkan | array | ['LoginAPI'] |
abnormal_tag |
| string | Risk_DefaultPasswd |
abnormal_type |
| string | default |
abnormal_level |
| string | medium |
abnormal_discover_ts |
| long | 1716343432 |
abnormal_info |
| object | {'default_passwd':'aliyun123'} |
api_id |
| string | 2c0f97e10b586208039e60671150bd9b |
abnormal_id |
| string | 8cfccc0e8c3d41aa1221e94a2fdeffe3 |
log_type |
| string | risk |
matched_hosts | Array pengidentifikasi | array | ['*.aliyun.com-waf'] |
request_header |
| JSON | {"Connection":"Keep-Alive","Host":"api.alibabacloud.com","eagleeye-rpcid":"0.1"} |
querystring |
| string | ?token=7464f593205896e23b1286ba7532dcff |
request_body |
| string | xxx=1 |
response_header |
| JSON | {"Accept-Ranges":["bytes","bytes"],"Cache-Control":"private, max-age=21600, no-transform"} |
response_body |
| string | xxxx |
example_timestamp |
| long | 1.718.546.694 |
example_traceid |
| string | 784e2ca71721367836577858de |
Peristiwa serangan
Parameter | Deskripsi | Format | Contoh |
user_id |
| string | 123456 |
service_host |
| string | api.alibabacloud.com |
matched_host |
| string | api.alibabacloud.com-waf |
host |
| string | api.alibabacloud.com |
api_format |
| string | /api/admin/login |
request_method |
| string | POST |
api_tag | Array yang menunjukkan | array | ['AdminService', 'LoginService'] |
event_tag |
| string | Event_LoginCollision |
event_origin |
| string | default |
event_level |
| string | high |
start_ts |
| long | 1713886210 |
end_ts |
| long | 1713887817 |
attack_cnt | Total | integer | 147 |
attack_ip_info | Array objek yang berisi | array | [{"ip": "103.44.XX.XXX", "country_id": "HK", "region_id": "-", "cnt": "147"}] |
api_id |
| string | 4dfc73b37d2d645fe2ca7f45c08f7398 |
event_id |
| string | f09f6802e9b57a58ebb9f1bea212027e |
log_type |
| string | event |
request_data |
| JSON | {"1002":["John Doe","Jane Smith","Sam Chen"],"1004":["13200000001","15200000002"]} |
response_data |
| JSON | {'postarg.userId':['lisi111','zhangsan123'],'postarg.corpId':['wx1111111'],'postarg.externalUserid':['wm7_KpDgOm6Bm-BGA']} |
Nilai field log subscription
Lifecycle
Lifecycle (api_status)
Nilai | Deskripsi |
| Baru. |
| Tidak aktif. |
| Normal. |
Tipe API
Tipe API (api_type)
Nilai | Deskripsi |
PublicAPI | API publik |
ThirdPartyAPI | API pihak ketiga |
InternalAPI | API internal |
Kasus penggunaan
Kasus penggunaan (api_tag)
Nilai | Deskripsi |
LoginByUserPasswd | Login username dan password |
LoginByPhoneCode | Login kode verifikasi ponsel |
LoginByMailCode | Login kode verifikasi email |
WeChatLogin | Login WeChat |
AliPayLogin | Login Alipay |
OAuthLogin | Otentikasi OAuth |
OIDCLogin | Otentikasi OIDC |
SAMLLogin | Otentikasi SAML |
SSOLogin | Otentikasi SSO |
LoginAPI | Layanan login |
LogoutAPI | Logout |
RegisterByUserPasswd | Registrasi username dan password |
RegisterByPhoneCode | Registrasi kode verifikasi ponsel |
RegisterByMailCode | Registrasi kode verifikasi email |
WeChatRegister | Registrasi WeChat |
AliPayRegister | Registrasi Alipay |
RegisterAPI | Layanan registrasi |
SendSMS | Mengirim SMS |
SendMail | Mengirim email |
ResetPasswd | Reset password |
CheckVerifyCode | Validasi kode verifikasi |
CheckStatus | Pemeriksaan status |
QueryOrder | Kueri pesanan |
ExportOrder | Ekspor pesanan |
UpdateOrder | Pembaruan pesanan |
PayOrder | Pembayaran pesanan |
QueryLog | Kueri log |
UploadLog | Pelaporan log |
DownloadLog | Ekspor log |
LogService | Log Service |
GraphQL | GraphQL |
SqlService | Layanan SQL |
FileUpload | Upload file |
FileDownload | Download file |
FileService | Layanan file |
AdminService | Manajemen backend |
DashBoard | Dasbor |
MonitorService | Layanan pemantauan |
SendInfo | Mengirim informasi |
CheckInfo | Pemeriksaan data |
QueryInfo | Kueri data |
UploadInfo | Upload data |
DownloadInfo | Download data |
AddInfo | Penambahan data |
EditInfo | Pengeditan data |
UpdateInfo | Pembaruan data |
ShareInfo | Berbagi data |
DeleteInfo | Penghapusan data |
SyncInfo | Sinkronisasi data |
SubmitInfo | Pengiriman data |
CopyInfo | Penyalinan data |
AuditInfo | Data Audit |
SaveInfo | Penyimpanan data |
CancelOp | Batal |
StartOp | Mulai |
BatchOp | Pemrosesan batch |
PauseOp | Jeda |
BindOp | Ikat |
DebugOp | Debug |
SetOp | Pengaturan |
ShutDown | Matikan |
Tipe sensitive data
Field ini menentukan tipe sensitive data permintaan (api_sensitive_req) dan tipe sensitive data respons (api_sensitive_res).
Nilai | Deskripsi |
1000 | Nomor KTP (Tiongkok daratan) |
1001 | Kartu debit |
1002 | Nama lengkap (Cina Sederhana) |
1003 | Alamat (Tiongkok daratan) |
1004 | Nomor ponsel (Tiongkok daratan) |
1005 | Alamat email |
1006 | Nomor paspor (Tiongkok daratan) |
1007 | Izin Perjalanan Daratan Utama untuk Penduduk Hong Kong dan Makau |
1008 | Nomor plat kendaraan (Tiongkok daratan) |
1009 | Nomor telepon (Tiongkok daratan) |
1010 | Kartu perwira militer |
1011 | Jenis kelamin |
1012 | Suku bangsa |
1013 | Provinsi (Tiongkok daratan) |
1014 | Kota (Tiongkok daratan) |
1015 | Nomor KTP (Hong Kong, Tiongkok) |
1016 | Nama lengkap (Cina Tradisional) |
1017 | Nama lengkap (Inggris) |
1018 | Nomor kartu identitas (Malaysia) |
1019 | Nomor kartu identitas (Singapura) |
1020 | Kartu kredit |
1022 | Kode SWIFT |
1023 | SSN |
1024 | Nomor telepon (Amerika Serikat) |
1025 | Keyakinan agama |
2000 | Alamat IP |
2001 | Alamat MAC |
2002 | String koneksi JDBC |
2003 | Sertifikat PEM |
2004 | Kunci privat |
2005 | ID AccessKey |
2006 | AccessKey Secret |
2007 | Alamat IPv6 |
2009 | Tanggal |
2010 | IMEI |
2011 | MEID |
2013 | File passwd Linux |
2014 | File shadow Linux |
2015 | URL |
4000 | Nomor izin usaha |
4001 | Nomor sertifikat pendaftaran pajak |
4002 | Kode organisasi |
4003 | Kode Kredit Sosial Terpadu |
4004 | Nomor identifikasi kendaraan (VIN) |
Tipe risiko
Tipe risiko
Nilai | Deskripsi |
RiskType_Specification | Spesifikasi keamanan |
Risk_UnsafeHttpMethod | HTTP method tidak aman |
Risk_WeakSignAlgorithm | Algoritma penandatanganan JWT lemah |
Risk_UrlParam | URL sebagai parameter |
RiskType_Account | Keamanan akun |
Risk_PasswdUnencrypt | Transmisi password teks biasa |
Risk_WeakPasswd | Password lemah diizinkan |
Risk_InternalWeakPasswd | Kredensial lemah dalam aplikasi internal |
Risk_DefaultPasswd | Password default ada |
Risk_PasswdResponse | Password teks biasa dikembalikan |
Risk_PasswdCookie | Password disimpan dalam cookie |
Risk_LoginRestrict | Kurangnya batasan upaya login |
Risk_LoginPrompt | prompt kegagalan login yang tidak seharusnya |
Risk_PasswdUrl | Kredensial ditransmisikan melalui URL |
RiskType_Control | Kontrol akses |
Risk_InternalAPI | Aplikasi internal dapat diakses dari jaringan publik |
Risk_SourceRestrict | Tidak ada pembatasan sumber pada API |
Risk_ClientRestrict | Tidak ada pembatasan tool client pada API |
Risk_SpeedRestrict | Tidak ada rate limiting pada API |
RiskType_Permission | Pengelolaan izin |
Risk_WeakToken | Kredensial autentikasi lemah |
Risk_UnauthSensitive | API sensitif tanpa autentikasi |
Risk_UnauthInternalAPI | API internal dapat diakses tanpa otorisasi |
Risk_TokenUrl | Kredensial ditransmisikan melalui URL |
Risk_AkLeak | Kebocoran Access Key |
RiskType_Sensitive | Perlindungan data |
Risk_SensitiveTypeExcessive | Jenis sensitive data yang dikembalikan berlebihan |
Risk_SensitiveNumExcessive | Jumlah sensitive data yang dikembalikan berlebihan |
Risk_InvalidDesensitize | Desensitisasi sensitive data tidak efektif |
Risk_ServerInfoLeak | Kebocoran informasi server sensitif |
Risk_InternalIPLeak | Kebocoran alamat IP internal |
Risk_SensitiveURL | Sensitive data ditransmisikan melalui URL |
RiskType_Design | Desain API |
Risk_ParamTraverse | Parameter permintaan yang dapat diiterasi |
Risk_PageSize | Ukuran halaman respons yang dapat diubah |
Risk_SqlAPI | API kueri database |
Risk_RceAPI | API eksekusi perintah |
Risk_SmsContent | Mengirim konten SMS sembarang |
Risk_MailContent | Mengirim konten email sembarang |
Risk_SmsVerifyCodeLeak | Kebocoran kode verifikasi SMS |
Risk_MailVerifyCodeLeak | Kebocoran kode verifikasi email |
Risk_FileDownload | Mengunduh file sembarang |
Risk_ExceptionLeak | Kebocoran informasi pengecualian aplikasi |
Risk_ExceptionSql | Kebocoran informasi pengecualian database |
Tipe event
Event
Nilai | Deskripsi |
Event_AbnormalFrequency | Akses frekuensi tinggi yang tidak wajar |
Event_ExceptionIPInvoke | Akses API internal dari alamat IP yang tidak wajar |
Event_ExceptionRegionInvoke | Akses API internal dari region yang tidak wajar |
Event_ExceptionClientInvoke | Akses dari client yang tidak wajar |
Event_ExceptionTimeInvoke | Akses selama periode waktu yang tidak biasa |
Event_AbnormalParamValue | Akses dengan nilai parameter yang tidak wajar |
Event_InternalLoginWeakPasswd | Login aplikasi internal dengan password lemah |
Event_LoginAccountBruteForce | Serangan brute-force username |
Event_LoginPasswdBruteForce | Serangan brute-force password |
Event_LoginCollision | Serangan credential stuffing |
Event_MobileVerifyBruteForce | Brute-force kode verifikasi SMS |
Event_MailVerifyBruteForce | Brute-force kode verifikasi email |
Event_AbnormalRegister | Registrasi massal |
Event_SMSInterfaceAbuse | Penyalahgunaan resource SMS |
Event_EmailInterfaceAbuse | Penyalahgunaan resource email |
Event_AbnormalExport | Download massal |
Event_DataTraverse | Pengambilan data melalui traversal API |
Event_WebAttackAPI | Serangan berbahaya pada API |
Event_ObtainSensitiveUnauthorized | Akses tidak sah ke sensitive data |
Event_ObtainSensitiveExcessive | Akses berlebihan ke sensitive data |
Event_CrossborderIPSensitiveExcessive | Akses berlebihan ke sensitive data dari alamat IP luar negeri |
Event_ExceptionResponse | Respons API dengan pesan pengecualian |
Event_ExceptionSql | Respons API dengan pesan kesalahan database |
Event_SystemInfoResponse | Respons API yang berisi informasi sistem sensitif |
Event_AbnormalStatus | Respons API dengan status tidak wajar |