All Products
Search
Document Center

Edge Security Acceleration:Fungsi

Last Updated:Jul 24, 2026

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 true jika source String diakhiri oleh substring String. Jika tidak, mengembalikan false.

    • source String harus berupa field. Nilai ini tidak boleh berupa string literal. Misalnya, jangan menulis ends_with("foo.html",".html").

  • Contoh: Jika http.request.uri.path adalah "/welcome.html", maka ends_with(http.request.uri.path,".html") mengembalikan true.

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 true jika informasi tersebut ada, atau false jika tidak ada.

  • Contoh: Jika permintaan tidak menyertakan header bernama example, maka exists(http.request.headers["example"]) mengembalikan false.

len

Mengembalikan panjang sebuah string.

  • Format: len(String):Integer.

  • Logika: Mengembalikan jumlah karakter dalam nilai string suatu field.

  • Contoh:

    • Jika http.host adalah "example.com", maka len(http.host) mengembalikan 11.

    • len(http.request.uri) eq 11 mengembalikan true.

    • len(http.request.uri) gt 11 mengembalikan false.

    • len(http.request.uri) lt 11 mengembalikan false.

lower

Mengonversi string menjadi huruf kecil.

  • Format: lower(String):String

  • Logika: 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.host adalah "WWW.example.com", maka lower(http.host)=="www.example.com" mengembalikan true.

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, mengembalikan false.

  • 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.src

    • Nilai 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):Boolean

  • Logika:

    • Mengembalikan true jika source String diawali oleh substring String. Jika tidak, mengembalikan false.

    • source String harus berupa field. Nilai ini tidak boleh berupa string literal. Misalnya, jangan menulis starts_with("foo.html",".html").

  • Contoh: Jika http.request.uri.path adalah "/welcome.html", maka starts_with(http.request.uri.path,".html") mengembalikan true.

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 alamat IP.

  • Contoh:

    • Jika hasil dari ip.src.asnum adalah 15169, maka to_string(ip.src.asnum) mengembalikan "15169".

    • Jika hasil dari ssl adalah true, maka to_string(ssl) mengembalikan "true".

    • Jika hasil dari ip.src adalah 192.168.0.1, maka to_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.host adalah "www.example.com", maka upper(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):String

  • Logika:

    • 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 source harus berupa field, bukan string literal. Seluruh nilai source harus sesuai dengan parameter wildcard_pattern — kecocokan parsial tidak didukung.

    • Untuk memasukkan karakter literal * dalam parameter wildcard_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 parameter wildcard_pattern.

    • Untuk memasukkan karakter literal $ dalam parameter replacement, Anda harus meng-escape-nya dengan $$.

    • Untuk melakukan pencocokan wildcard yang case-sensitive, atur parameter flags ke s.

    • Fungsi ini menggunakan lazy matching — setiap * mencocokkan string terpendek yang mungkin.

  • Contoh:

    • Jika URI lengkap adalah https://apps.example.com/calendar/admin?expand=true, ekspresi wildcard_replace(http.request.full_uri,"https://*.example.com/*/*","https://example.com/${1}/${2}/${3}") mengembalikan https://example.com/apps/calendar/admin?expand=true.

    • Jika URI lengkap adalah https://example.com/applications/app1, ekspresi wildcard_replace(http.request.full_uri,"/applications/*","/apps/${1}") mengembalikan https://example.com/applications/app1 tanpa perubahan karena pola harus mencocokkan URI lengkap. Gunakan http.request.uri.path untuk pencocokan hanya pada path.

    • Jika path URI adalah /calendar, ekspresi wildcard_replace(http.request.uri.path,"/*","/apps/${1}") mengembalikan /apps/calendar.

    • Jika path URI adalah /Apps/calendar, ekspresi wildcard_replace(http.request.uri.path,"/apps/*","/${1}") mengembalikan /calendar. Pencocokan bersifat case-insensitive secara default.

    • Jika path URI adalah /Apps/calendar, ekspresi wildcard_replace(http.request.uri.path,"/apps/*","/${1}","s") mengembalikan /Apps/calendar. Parameter flags diatur ke s untuk mengaktifkan pencocokan case-sensitive. Karena pola tidak cocok dengan path URI asli, hasilnya tetap tidak berubah.

    • Jika path URI adalah /apps/calendar/login, ekspresi wildcard_replace(http.request.uri.path,"/apps/*/login","/${1}/login") mengembalikan /calendar/login.