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:
Klien meminta resource.
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.
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. |
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.
Di Konsol ESA, pilih Site Management. Di kolom Website, klik situs target.
Di panel navigasi sebelah kiri, pilih . Klik Create Rule.
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/datadari jalur asli dan mengalihkan ke domain baru. Gabungkanregex_replacedenganconcatuntuk 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.jpgURL pengalihan yang dikonfigurasi:
http://test.example.com/image/1.jpg?test=123Lokasi pengalihan aktual:
http://test.example.com/image/1.jpg?test=123Catatan: 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=321URL pengalihan yang dikonfigurasi:
http://test.example.com/image/1.jpg?test=123Lokasi pengalihan aktual:
http://test.example.com/image/1.jpg?test=321Catatan: 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=321URL pengalihan yang dikonfigurasi:
http://test.example.com/image/1.jpg?test=123Lokasi pengalihan aktual:
http://test.example.com/image/1.jpg?test=123Catatan: 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=321URL pengalihan yang dikonfigurasi:
http://test.example.com/image/1.jpgLokasi pengalihan aktual:
http://test.example.com/image/1.jpg?test=321Catatan: 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=321URL pengalihan yang dikonfigurasi:
http://test.example.com/image/1.jpgLokasi pengalihan aktual:
http://test.example.com/image/1.jpgCatatan: 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=123Ekspresi:
concat("https://www.example.com", http.request.uri.path)Lokasi pengalihan aktual:
https://www.example.com/image/1.jpgCatatan:
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=123Ekspresi:
concat("https://www.example.com", http.request.uri.path)Lokasi pengalihan aktual:
https://www.example.com/image/1.jpg?test=123Catatan:
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=cdnEkspresi:
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=cdnCatatan:
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=20250816Ekspresi:
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.htmlCatatan:
Jika Mempertahankan query string dinonaktifkan, URL tujuan dibangun sepenuhnya dari ekspresi. Parameter asli (misalnya,
place=garden) hanya digunakan untuk pencocokan;*menangkap nilai setelahdatedan 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.