Bahasa aturan ESA menyediakan fungsi transformasi untuk memanipulasi dan memvalidasi nilai yang diekstraksi dari permintaan HTTP.
Fungsi transformasi yang didukung
concat
Menggabungkan string.
Format:
concat(String | Integer | Bytes | elemen Array):String.Logika: Menggabungkan daftar nilai yang dipisahkan koma menjadi satu string.
Contoh:
concat("String1"," ","String",2)mengembalikan"String1 String2".concat("/archive",http.request.uri.path)menambahkan segmen path"/archive"di awal path URI.concat("userid=123&",http.request.uri.query)menambahkan pasangan kunci-nilai"userid=123"di awal string kueri URI.concat("https://www.example.com",http.request.uri.path)menggabungkan hostname baru dengan path permintaan asli untuk menghasilkan URL baru.
ends_with
Memeriksa apakah sebuah string diakhiri oleh substring tertentu.
Format:
ends_with(source String,substring String):Boolean.Logika:
Mengembalikan
truejikasource Stringdiakhiri olehsubstring String. Jika tidak, mengembalikanfalse.source Stringharus berupa field. Nilai ini tidak boleh berupa string literal. Misalnya, jangan menulisends_with("foo.html",".html").
Contoh: Jika
http.request.uri.pathadalah"/welcome.html", makaends_with(http.request.uri.path,".html")mengembalikantrue.
exists
Memeriksa apakah informasi tertentu ada dalam permintaan.
Format:
exists(String):Boolean.Logika: Beberapa field permintaan bersifat opsional (seperti header, Referer, User-Agent, dan cookie). Fungsi ini memeriksa apakah informasi opsional yang ditentukan ada dalam permintaan klien. Mengembalikan
truejika informasi tersebut ada, ataufalsejika tidak ada.Contoh: Jika permintaan tidak menyertakan header bernama
example, makaexists(http.request.headers["example"])mengembalikanfalse.
len
Mengembalikan panjang sebuah string.
Format:
len(String):Integer.Logika: Mengembalikan jumlah karakter dalam nilai string suatu field.
Contoh:
Jika
http.hostadalah"example.com", makalen(http.host)mengembalikan11.len(http.request.uri) eq 11mengembalikantrue.len(http.request.uri) gt 11mengembalikanfalse.len(http.request.uri) lt 11mengembalikanfalse.
lower
Mengonversi string menjadi huruf kecil.
Format:
lower(String):StringLogika: Mengonversi nilai string dari suatu field menjadi huruf kecil. Hanya byte ASCII huruf besar yang dikonversi; semua byte lain tetap tidak berubah.
Contoh: Jika
http.hostadalah"WWW.example.com", makalower(http.host)=="www.example.com"mengembalikantrue.
percent
Menyaring permintaan berdasarkan nilai field tertentu dan ambang batas persentase.
Format:
percent(String | alamat IP, Integer):Boolean.Logika: Melakukan perhitungan MD5 terhadap nilai field yang ditentukan dalam permintaan klien, lalu menerapkan operasi modulo untuk memetakan hasilnya ke bilangan bulat antara 1 hingga 100. Jika nilai yang dipetakan (A) kurang dari atau sama dengan bilangan bulat yang ditentukan (B), fungsi ini mengembalikan
true. Jika tidak, mengembalikanfalse.Catatan:
Jika nilai field kosong (misalnya, permintaan tidak membawa header yang ditentukan), aturan tidak diterapkan dan fungsi mengembalikan
false.Parameter kedua harus berupa bilangan bulat antara 1 hingga 100.
Field yang didukung:
Header:
http.request.headers["example"]Alamat IP klien:
ip.srcNilai cookie:
http.request.cookies["example"]Parameter kueri URI:
http.request.uri.args["example"]Timestamp permintaan:
http.request.timestamp.sec
Contoh:
percent(http.request.headers["example"], 80)percent(ip.src, 80)percent(http.request.cookies["example"], 80)percent(http.request.uri.args["example"], 80)percent(http.request.timestamp.sec, 80)
regex_replace
Mengganti substring yang sesuai dengan pola ekspresi reguler.
Format:
regex_replace(source String,regular_expression String,replacement String):String.Logika:
Mengganti substring pertama yang sesuai dengan ekspresi reguler menggunakan string pengganti.
Secara default, pencocokan bersifat case-sensitive.
Hanya kecocokan pertama yang diganti, meskipun terdapat beberapa kecocokan dalam string sumber.
Anda dapat meng-escape karakter
$dalam string pengganti dengan menambahkan karakter$lain di depannya.String pengganti dapat berisi referensi ke capturing group ekspresi reguler menggunakan format
${<NUMBER>}, di mana<NUMBER>adalah nomor capturing group tersebut. Maksimal delapan referensi semacam ini didukung, seperti${1}dan${2}.
Contoh:
Pencocokan dan penggantian karakter statis:
Kecocokan string berhasil:
regex_replace("/animal/cat","/cat$","/dog")=="/animal/dog".Jika tidak ditemukan kecocokan, string sumber tetap tidak berubah:
String berbeda:
regex_replace("/x","^/y$","/z")=="/x".String case-sensitive:
regex_replace("/cat","^/CAT$","/dog")=="/cat".
Saat terdapat beberapa kecocokan, hanya yang pertama yang diganti:
regex_replace("/a/a","/a","/b")=="/b/a".Meng-escape karakter
$dalam string pengganti:regex_replace("/b","^/b$","/b$$")=="/b$".Menggunakan capturing group dalam string pengganti:
regex_replace("/foo/a/path","^/foo/([^/]*)/(.*)$","/bar/${2}/${1}")=="/bar/path/a".
Pencocokan dan penggantian field dinamis:
String sumber menggunakan field dinamis untuk mengambil informasi path dari permintaan klien. Contoh ini mengganti
/cat/dalam path dengan/dog/:regex_replace(http.request.uri.path,"/cat/(.*)$","/dog/${1}").Contoh penggantian kompleks: Mengganti setiap karakter
+dalam path permintaan asli dengan string%2B:regex_replace(http.request.uri.path, "^([^+]*)\\+([^+]*)\\+(.*)$", "${1}%2B${2}%2B${3}").
starts_with
Memeriksa apakah sebuah string diawali oleh substring tertentu.
Format:
starts_with(source String,substring String):BooleanLogika:
Mengembalikan
truejikasource Stringdiawali olehsubstring String. Jika tidak, mengembalikanfalse.source Stringharus berupa field. Nilai ini tidak boleh berupa string literal. Misalnya, jangan menulisstarts_with("foo.html",".html").
Contoh: Jika
http.request.uri.pathadalah"/welcome.html", makastarts_with(http.request.uri.path,".html")mengembalikantrue.
to_string
Mengonversi nilai menjadi representasi string-nya.
Format:
to_string(Integer | Boolean | alamat IP):String.Logika: Mengembalikan representasi string dari nilai
Integer,Boolean, atau alamatIP.Contoh:
Jika hasil dari
ip.src.asnumadalah15169, makato_string(ip.src.asnum)mengembalikan"15169".Jika hasil dari
ssladalahtrue, makato_string(ssl)mengembalikan"true".Jika hasil dari
ip.srcadalah192.168.0.1, makato_string(ip.src)mengembalikan"192.168.0.1".
upper
Mengonversi string menjadi huruf besar.
Format:
upper(String):String.Logika: Mengonversi nilai string dari suatu field menjadi huruf besar. Hanya byte ASCII huruf kecil yang dikonversi; semua byte lain tetap tidak berubah.
Contoh: Jika
http.hostadalah"www.example.com", makaupper(http.host)mengembalikan"WWW.EXAMPLE.COM".
wildcard_replace
Mengganti substring yang sesuai dengan pola wildcard.
Format:
wildcard_replace(source Bytes,wildcard_pattern Bytes,replacement Bytes,flags Bytes optional):StringLogika:
Mencocokkan string sumber terhadap pola yang berisi nol atau lebih wildcard
*, mengganti bagian yang cocok dengan string pengganti, lalu mengembalikan hasilnya. String pengganti dapat berisi referensi ke capturing group wildcard, seperti${1}dan${2}. Maksimal delapan referensi pengganti didukung.Jika tidak ada kecocokan, fungsi mengembalikan string sumber asli.
Parameter
sourceharus berupa field, bukan string literal. Seluruh nilaisourceharus sesuai dengan parameterwildcard_pattern— kecocokan parsial tidak didukung.Untuk memasukkan karakter literal
*dalam parameterwildcard_pattern, Anda harus meng-escape-nya dengan\*. Anda juga harus meng-escape karakter\dengan\\. Dua karakter*yang tidak di-escape secara berurutan, seperti**, tidak valid dan tidak dapat digunakan. Untuk melakukan escaping karakter, gunakan sintaks raw string untuk parameterwildcard_pattern.Untuk memasukkan karakter literal
$dalam parameterreplacement, Anda harus meng-escape-nya dengan$$.Untuk melakukan pencocokan wildcard yang case-sensitive, atur parameter
flagskes.Fungsi ini menggunakan lazy matching — setiap
*mencocokkan string terpendek yang mungkin.
Contoh:
Jika URI lengkap adalah
https://apps.example.com/calendar/admin?expand=true, ekspresiwildcard_replace(http.request.full_uri,"https://*.example.com/*/*","https://example.com/${1}/${2}/${3}")mengembalikanhttps://example.com/apps/calendar/admin?expand=true.Jika URI lengkap adalah
https://example.com/applications/app1, ekspresiwildcard_replace(http.request.full_uri,"/applications/*","/apps/${1}")mengembalikanhttps://example.com/applications/app1tanpa perubahan karena pola harus mencocokkan URI lengkap. Gunakanhttp.request.uri.pathuntuk pencocokan hanya pada path.Jika path URI adalah
/calendar, ekspresiwildcard_replace(http.request.uri.path,"/*","/apps/${1}")mengembalikan/apps/calendar.Jika path URI adalah
/Apps/calendar, ekspresiwildcard_replace(http.request.uri.path,"/apps/*","/${1}")mengembalikan/calendar. Pencocokan bersifat case-insensitive secara default.Jika path URI adalah
/Apps/calendar, ekspresiwildcard_replace(http.request.uri.path,"/apps/*","/${1}","s")mengembalikan/Apps/calendar. Parameterflagsdiatur kesuntuk mengaktifkan pencocokan case-sensitive. Karena pola tidak cocok dengan path URI asli, hasilnya tetap tidak berubah.Jika path URI adalah
/apps/calendar/login, ekspresiwildcard_replace(http.request.uri.path,"/apps/*/login","/${1}/login")mengembalikan/calendar/login.