All Products
Search

This Product

    Edge Security Acceleration:Ubah header permintaan masuk

    Document Center

    Edge Security Acceleration:Ubah header permintaan masuk

    Last Updated:Jun 06, 2026

    Dengan mengonfigurasi aturan untuk menambah, mengubah, atau menghapus header permintaan tertentu dari klien atau layanan upstream, Anda dapat mengontrol konten permintaan secara fleksibel sesuai kebutuhan backend—misalnya, menambahkan header seperti Accept-Encoding atau Accept-Language—untuk menyesuaikan pengalaman pengunjung dan memperoleh wawasan lebih mendalam mengenai perilaku pengguna.

    Ikhtisar

    Dengan fitur ubah header permintaan masuk ESA, Anda dapat memproses permintaan masuk di node edge dengan menambah, mengubah, atau menghapus header permintaan tertentu secara fleksibel. Fitur ini memungkinkan Anda:

    • Mengontrol routing kembali ke origin — Tambah atau ubah header untuk mengarahkan server origin dalam menangani permintaan.

    • Memperkaya log backend — Teruskan informasi klien (seperti alamat IP asal) melalui header kustom untuk pencatatan log dan analitik.

    • Menghapus header yang tidak relevan — Hapus header yang tidak diperlukan dari permintaan asli guna mengurangi beban dan meningkatkan keamanan.

    Konfigurasi header permintaan masuk

    Prasyarat

    Sebelum memulai, pastikan Anda telah:

    • Membuat situs di Konsol ESA. Untuk informasi selengkapnya, lihat Rule Precedence.

    • Mengaktifkan fitur Rules untuk situs Anda.

    Langkah-langkah

    1. Di Konsol ESA, pilih Websites, lalu pada kolom Website, klik situs target.

    2. Di panel navigasi kiri, pilih Rules > Transform Rules.

    3. Klik Modify request header > Client to ESA > Create Rule.

      Add rule

    4. Pada area Add Request Header Modification Rule, konfigurasikan bidang-bidang berikut:

      • Rule Name: Masukkan nama kustom untuk aturan tersebut.

      • If requests match...: Pilih kondisi yang menentukan permintaan mana yang dikenai aturan ini.

        • All Requests: Aturan ini berlaku untuk semua permintaan pada situs saat ini.

        • Filtered Requests: Aturan ini hanya berlaku untuk traffic yang sesuai dengan ekspresi kustom. Konfigurasikan ekspresi untuk menyaring traffic.

      • Modify Request Header: Tentukan aksi yang akan dilakukan terhadap permintaan yang sesuai. Gunakan tabel berikut untuk memilih jenis operasi dan mode.

        Operation

        Mode

        Description

        Example

        Add

        Static

        Memastikan header permintaan yang ditentukan ada dalam permintaan asal. Membuat header baru jika belum ada, atau menimpa header yang sudah ada dengan nama yang sama.

        Untuk menambahkan header permintaan bernama x-code dengan nilai key1, masukkan:
        - Header Name: x-code
        - Header Value: key1

        Dynamic

        Nilai header dapat diatur ke suatu expression.

        Untuk menambahkan header permintaan bernama True-Client-IP dengan nilai ip.src guna mencatat alamat IP asal klien, masukkan:
        - Header Name: True-Client-IP
        - Header Value: ip.src

        Modify

        Static

        Mengubah nilai header permintaan tertentu dalam permintaan asal. Operasi ini hanya berlaku jika header dengan nama yang ditentukan sudah ada dalam permintaan asli; jika tidak, operasi ini tidak berpengaruh.

        Untuk mengubah nilai header permintaan bernama x-code menjadi key2 dalam permintaan asal, masukkan:
        - Header Name: x-code
        - Header Value: key2

        Dynamic

        Nilai header dapat diatur ke suatu expression.

        Untuk mengubah header permintaan bernama True-Client-IP menjadi nilai ip.src dalam permintaan asal, sehingga nilainya disetel ke alamat IP asal klien, masukkan:
        - Header Name: True-Client-IP
        - Header Value: ip.src

        Delete

        Menghapus semua header dari permintaan asal yang cocok dengan Header Name yang ditentukan, terlepas dari apakah terdapat parameter header duplikat.

        Untuk menghapus header permintaan bernama x-code, masukkan Header Name: x-code.

    Catatan

    • Nama header permintaan yang diawali dengan ali-swift, ali-esa-inner, x-swift, atau x-site tidak dapat dikonfigurasi (tidak membedakan huruf besar/kecil).

    • Untuk mengonfigurasi beberapa nilai pada Header Value, pisahkan dengan koma (,).

    • Operasi Delete berlaku baik untuk mode Static maupun Dynamic. Operasi Modify hanya berlaku jika permintaan asli berisi header dengan nama yang ditentukan; jika tidak, operasi tersebut tidak berpengaruh.

    • Dalam satu aturan, beberapa operasi dieksekusi secara berurutan. Jika operasi berbeda menargetkan nama header yang sama, operasi terakhir akan menimpa operasi sebelumnya.

    Contoh konfigurasi ekspresi dinamis

    Contoh ini menunjukkan cara menambahkan ekspresi dinamis yang meneruskan alamat IP asal klien dalam header permintaan kustom.

    Tambahkan ekspresi dinamis untuk True-Client-IP-IN

    Prosedur

    1. Di Konsol ESA, pilih Websites, lalu pada kolom Website, klik situs target.

    2. Di panel navigasi kiri, pilih Rules > Transform Rules.

    3. Klik Modify request header > Client to ESA > Create Rule.

      Add rule

    4. Pada area Add Incoming Request Header, konfigurasikan bidang-bidang berikut:

      • Rule Name: Masukkan add-client-ip-in.

      • Match Condition: Pilih All Requests agar aturan ini berlaku untuk semua permintaan pada situs saat ini.

      • Header Operation:

        • Type: Dynamic

        • Operation: Add

        • Header Name: True-Client-IP-IN

        • Header Value: ip.src

      Expression configuration

    Verifikasi hasil

    Setelah dikonfigurasi, header true-client-ip-in berisi alamat IP asal klien.

    Result verification