All Products
Search
Document Center

Edge Security Acceleration:Pengalihan permintaan

Last Updated:Oct 17, 2026

Jika jalur resource origin berubah namun URL permintaan tetap sama, konfigurasikan aturan pengalihan pada POP Edge Security Acceleration (ESA) untuk mengalihkan klien ke tujuan yang benar. Hal ini mengurangi permintaan balik ke origin dan meningkatkan kinerja akses.

Cara kerja

Proses pengalihan:

  1. Klien meminta resource.

  2. POP ESA mencocokkan permintaan dengan aturan pengalihan. Jika cocok, sistem mengembalikan kode status pengalihan (misalnya, 301 atau 302) beserta URL tujuan di dalam header respons Location.

  3. Klien mengikuti header Location dan meminta resource dari URL baru.

Kode status dan skenario

Kode status

Arti

Penanganan metode

Skenario umum

301

Moved Permanently

Permintaan GET tetap tidak berubah. Metode lain mungkin berubah menjadi GET.

Resource dipindahkan secara permanen ke URL baru. Mesin pencari memperbarui indeks mereka.

302

Found

Permintaan GET tetap tidak berubah. Metode lain mungkin berubah menjadi GET.

Resource berada sementara di URL yang berbeda. Mesin pencari mempertahankan tautan asli.

303

See Other

Permintaan GET tetap tidak berubah. Metode lain dipaksa menjadi GET, dan badan permintaan dibuang.

Pengalihan setelah PUT atau POST untuk mencegah pengiriman duplikat saat refresh.

307

Temporary Redirect

Metode dan badan permintaan tetap tidak berubah.

Pengalihan sementara. Lebih disarankan daripada 302 jika situs Anda menggunakan metode non-GET.

308

Permanent Redirect

Metode dan badan permintaan tetap tidak berubah.

Pengalihan permanen yang mempertahankan metode HTTP dan badan permintaan. Gunakan untuk migrasi API atau refaktorisasi situs yang memerlukan konsistensi metode.

Penting

Jika Anda perlu mengalihkan panggilan API atau permintaan non-GET (seperti POST atau PUT) sambil mempertahankan metode dan badan permintaan, gunakan kode status 307 (sementara) atau 308 (permanen). Kode status 301 dan 302 dapat mengubah permintaan non-GET menjadi GET, yang mengakibatkan hilangnya data.

Hindari mengonfigurasi pengalihan pada jalur unggahan dengan traffic tinggi (seperti /api/upload). Untuk jalur tersebut, pertimbangkan untuk memisahkannya ke domain khusus atau mencegat permintaan melalui WAF guna mencegah traffic kembali ke origin yang tidak normal akibat pengalihan.

Membuat aturan pengalihan

ESA mengevaluasi aturan berdasarkan urutan prioritas dan menerapkan kecocokan pertama.

  1. Di Konsol ESA, pilih Site Management. Di kolom Website, klik situs target.

  2. Di panel navigasi sebelah kiri, pilih Rules > Redirect Rules. Klik Create Rule.

  3. Pada halaman Add Redirect Rule, konfigurasikan pengaturan berikut, lalu klik OK:

    • Masukkan Rule Name.

    • Di bagian If requests match..., tentukan kondisi permintaan yang ingin dicocokkan. Untuk informasi selengkapnya, lihat Komponen ekspresi aturan.

    • URL Redirect:

      Parameter

      Tipe

      Deskripsi

      Redirect Type

      Static

      Mengalihkan ke URL tetap. Misalnya, atur URL ke https://test.example.com/image/1.jpg?test=123.

      Dynamic

      Membangun URL tujuan secara dinamis dengan ekspresi. Misalnya, untuk mengganti hostname dalam URL permintaan sambil mempertahankan jalur asli, atur Expression ke concat("https://www.example.com", http.request.uri.path). Gunakan ekspresi valid yang dibangun dengan fungsi yang didukung. Memasukkan string biasa yang berisi variabel secara langsung akan menyebabkan kegagalan penyimpanan.

      Pola ekspresi dinamis umum:

      • Mempertahankan jalur asli (non-www ke www, HTTP ke HTTPS) — Gunakan concat("https://target-domain.com", http.request.uri.path) untuk menggabungkan domain target dengan jalur permintaan asli. Gunakan pola ini jika Anda perlu mempertahankan jalur selama pengalihan.

      • Menghapus atau mengganti awalan jalur — Gunakan concat("https://img.example.com", regex_replace(http.request.uri.path, "^/data", "")) untuk menghapus awalan /data dari jalur asli dan mengalihkan ke domain baru. Gabungkan regex_replace dengan concat untuk mentransformasi jalur.

      Status Code

      Kode status HTTP yang dikembalikan untuk pengalihan. Nilai yang valid: 301 (default), 302, 303, 307, dan 308. Untuk detailnya, lihat Kode status dan skenario.

      Retain Query String

      Menentukan apakah query string dari permintaan asli akan dibawa ke URL tujuan. Dinonaktifkan secara default (query string asli dihapus).

      Saat Retain Query String diaktifkan:

      • Jika permintaan asli memiliki query string, maka akan menimpa query string URL pengalihan.

      • Jika permintaan asli tidak memiliki query string, maka query string URL pengalihan akan dipertahankan.

      Untuk contoh konfigurasi, lihat Contoh konfigurasi.

Contoh konfigurasi

Contoh pengalihan statis

Skenario 1: Permintaan tidak memiliki query string, URL pengalihan memiliki query string

  • Permintaan mengandung query string: Tidak

  • URL pengalihan yang dikonfigurasi mengandung query string: Ya

  • Mempertahankan query string: Diaktifkan atau dinonaktifkan

  • Contoh URL permintaan: http://test.example.com/1.jpg

  • URL pengalihan yang dikonfigurasi: http://test.example.com/image/1.jpg?test=123

  • Lokasi pengalihan aktual: http://test.example.com/image/1.jpg?test=123

  • Catatan: Karena tidak ada query string dalam permintaan asli, query string dari URL yang dikonfigurasi akan digunakan terlepas dari pengaturan Mempertahankan query string.

Skenario 2: Kedua URL memiliki query string, Mempertahankan query string diaktifkan

  • Permintaan mengandung query string: Ya

  • URL pengalihan yang dikonfigurasi mengandung query string: Ya

  • Mempertahankan query string: Diaktifkan

  • Contoh URL permintaan: http://test.example.com/1.jpg?test=321

  • URL pengalihan yang dikonfigurasi: http://test.example.com/image/1.jpg?test=123

  • Lokasi pengalihan aktual: http://test.example.com/image/1.jpg?test=321

  • Catatan: Jika Mempertahankan query string diaktifkan, hanya query string dari permintaan asli yang dipertahankan; parameter kueri dari URL yang dikonfigurasi akan dibuang.

Skenario 3: Kedua URL memiliki query string, Mempertahankan query string dinonaktifkan

  • Permintaan mengandung query string: Ya

  • URL pengalihan yang dikonfigurasi mengandung query string: Ya

  • Mempertahankan query string: Dinonaktifkan

  • Contoh URL permintaan: http://test.example.com/1.jpg?test=321

  • URL pengalihan yang dikonfigurasi: http://test.example.com/image/1.jpg?test=123

  • Lokasi pengalihan aktual: http://test.example.com/image/1.jpg?test=123

  • Catatan: Jika Mempertahankan query string dinonaktifkan, hanya query string dari URL yang dikonfigurasi yang dipertahankan; parameter kueri dari permintaan asli akan dibuang.

Skenario 4: Permintaan memiliki query string, URL pengalihan tidak, Mempertahankan query string diaktifkan

  • Permintaan mengandung query string: Ya

  • URL pengalihan yang dikonfigurasi mengandung query string: Tidak

  • Mempertahankan query string: Diaktifkan

  • Contoh URL permintaan: http://test.example.com/1.jpg?test=321

  • URL pengalihan yang dikonfigurasi: http://test.example.com/image/1.jpg

  • Lokasi pengalihan aktual: http://test.example.com/image/1.jpg?test=321

  • Catatan: Jika Mempertahankan query string diaktifkan, query string asli akan ditambahkan ke URL yang dikonfigurasi meskipun URL tersebut tidak memiliki parameter kueri.

Skenario 5: Permintaan memiliki query string, URL pengalihan tidak, Mempertahankan query string dinonaktifkan

  • Permintaan mengandung query string: Ya

  • URL pengalihan yang dikonfigurasi mengandung query string: Tidak

  • Mempertahankan query string: Dinonaktifkan

  • Contoh URL permintaan: http://test.example.com/1.jpg?test=321

  • URL pengalihan yang dikonfigurasi: http://test.example.com/image/1.jpg

  • Lokasi pengalihan aktual: http://test.example.com/image/1.jpg

  • Catatan: Jika Mempertahankan query string dinonaktifkan, query string asli akan dibuang dan hanya URL yang dikonfigurasi yang dikembalikan.

Contoh pengalihan dinamis

Skenario 1: Mempertahankan query string dinonaktifkan

  • Mempertahankan query string: Dinonaktifkan

  • Contoh URL permintaan: https://test.example.com/image/1.jpg?test=123

  • Ekspresi: concat("https://www.example.com", http.request.uri.path)

  • Lokasi pengalihan aktual: https://www.example.com/image/1.jpg

  • Catatan:

    • Jika Mempertahankan query string dinonaktifkan, jalur (/image/1.jpg) dipertahankan dan query string (?test=123) dihapus.

    • Ekspresi hanya menggabungkan hostname dan jalur; parameter kueri tidak diproses.

Skenario 2: Mempertahankan query string diaktifkan

  • Mempertahankan query string: Diaktifkan

  • Contoh URL permintaan: https://test.example.com/image/1.jpg?test=123

  • Ekspresi: concat("https://www.example.com", http.request.uri.path)

  • Lokasi pengalihan aktual: https://www.example.com/image/1.jpg?test=123

  • Catatan:

    • Jika Mempertahankan query string diaktifkan, query string asli akan ditambahkan ke URL yang dihasilkan meskipun ekspresi tidak menangani parameter kueri.

    • Ekspresi hanya menangani penggabungan jalur; sistem menambahkan query string sesuai konfigurasi.

Skenario 3: Fungsi wildcard_replace, Mempertahankan query string diaktifkan

  • Mempertahankan query string: Diaktifkan

  • Contoh URL permintaan: https://www.example.com/image-flower-20250816-1.html?src=cdn

  • Ekspresi: wildcard_replace(http.request.full_uri, "https://www.example.com/image-*", "https://www.example.com/${1}")

  • Lokasi pengalihan aktual: https://www.example.com/flower-20250816-1.html?src=cdn

  • Catatan:

    • Jika Mempertahankan query string diaktifkan, sistem menambahkan query string asli (misalnya, ?src=cdn) ke URL tujuan.

    • Ekspresi hanya menangani penulisan ulang jalur; sistem meneruskan query string sesuai konfigurasi.

Skenario 4: Fungsi wildcard_replace, Mempertahankan query string dinonaktifkan

  • Mempertahankan query string: Dinonaktifkan

  • Contoh URL permintaan: https://www.example.com/index.html?place=garden&date=20250816

  • Ekspresi: wildcard_replace(http.request.full_uri, "https://www.example.com/index.html?place=garden&date=*", "https://www.example.com/flower-${1}-1.html")

  • Lokasi pengalihan aktual: https://www.example.com/flower-20250816-1.html

  • Catatan:

    • Jika Mempertahankan query string dinonaktifkan, URL tujuan dibangun sepenuhnya dari ekspresi. Parameter asli (misalnya, place=garden) hanya digunakan untuk pencocokan; * menangkap nilai setelah date dan menggantinya sebagai ${1}.

    • URL akhir tidak menyertakan parameter kueri asli.

FAQ

Dukungan paket

Fitur

Entrance

Pro

Premium

Enterprise

Jumlah aturan

10

25

50

125

Dokumentasi terkait

Fitur terkait aturan bervariasi dalam prioritas efektif, reentransi, dan granularitas efektif. Untuk detailnya, lihat Karakteristik fitur berbasis aturan.