Edge Security Acceleration:Kode respons kustom

Kasus penggunaan

Beberapa permintaan sebaiknya tidak mencapai origin server Anda. Pemberitahuan blokir terpusat, halaman maintenance, atau redirect sementara dapat dilayani langsung dari edge. Meneruskan permintaan semacam itu ke origin menambah latensi dan meningkatkan beban origin. Aturan kode respons kustom memungkinkan ESA mengembalikan kode status HTTP dan halaman respons yang ditentukan di edge, sehingga menghilangkan round trip.

Skenario umum meliputi:

• Halaman error yang ramah pengguna: Ganti kode status seperti 404 atau 500 dengan halaman kustom yang menampilkan pesan error yang mudah dipahami pengguna.

• Jendela maintenance: Selama maintenance terjadwal, kembalikan kode status 503 beserta halaman maintenance untuk path tertentu.

• Blokir malicious request: Cocokkan signature serangan dan kembalikan kode status 403 beserta halaman pemberitahuan.

Kapan menggunakan aturan kode respons kustom

Aturan kode respons kustom berlaku ketika Anda ingin mengembalikan kode respons tetap dan halaman opsional langsung di edge. Jika kebutuhan Anda berbeda, gunakan fitur ESA yang sesuai:

Prasyarat

Sebelum memulai, pastikan Anda telah memiliki:

• Nama domain yang ditambahkan ke dan dilayani oleh ESA.

• (Opsional) Halaman respons kustom, jika Anda berencana mengembalikan konten halaman bersamaan dengan kode status. Buat halaman tersebut terlebih dahulu; Anda kemudian dapat mereferensikannya dari aturan mana pun.

Buat aturan kode respons kustom

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

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

3. Pada halaman Transform Rules, pilih tab Custom response code, lalu klik Add Rule.

4. Pada dialog Customize Response Code, konfigurasikan pengaturan berikut lalu klik OK:

   • Rule Name: Nama kustom untuk aturan, misalnya, my-rule.

   • Apply to: Tentukan matching conditions untuk permintaan. Contohnya, Hostname equals www.example.com.

     Atau, edit ekspresi secara langsung. Contohnya, (http.host eq "www.example.com").

   • Custom Response Code:

     • Response Code: Kode status HTTP yang akan dikembalikan. Nilai valid: 200 hingga 599.

     • Response Page: Pilih dari halaman kustom yang sudah ada. Nilai default adalah Unresponsive page, yang hanya mengembalikan kode status tanpa body halaman apa pun.

Verifikasi aturan

1. Kirim permintaan yang sesuai dengan aturan, menggunakan curl -I https://<your-domain>/<matching-path> atau browser.

2. Konfirmasi bahwa kode status HTTP yang dikembalikan sesuai dengan konfigurasi Anda. Jika Anda mengonfigurasi halaman respons, browser akan menampilkan konten halaman kustom yang sesuai.

Kelola aturan kode respons kustom

Dari daftar aturan, Anda dapat melakukan operasi berikut pada aturan yang sudah ada:

• Search: Masukkan nama aturan di kotak pencarian di bagian atas daftar untuk memfilter berdasarkan nama.

• Reorder: Seret aturan untuk mengubah posisinya. Aturan dicocokkan dari atas ke bawah dalam daftar.

• Enable or disable: Alihkan status aturan. Aturan yang dinonaktifkan tidak lagi berlaku, tetapi konfigurasinya tetap disimpan.

• Edit: Ubah nama aturan, matching conditions, kode respons, atau halaman respons.

• Delete: Hapus aturan yang tidak lagi diperlukan. Penghapusan tidak dapat dikembalikan, jadi lakukan dengan hati-hati.

Catatan penggunaan

• Aturan dievaluasi dari atas ke bawah dalam daftar. Aturan pertama yang cocok dengan permintaan akan mengembalikan respons, dan aturan berikutnya tidak dievaluasi. Urutkan aturan Anda dengan cermat.

• Nilai kode status yang valid berkisar antara 200 hingga 599, yang mencakup semua kode status HTTP yang sah. Pilih kode yang sesuai dengan kasus penggunaan Anda.

• Aturan kode respons kustom bersifat independen dari rewrite rules dan security rules, dan ketiga jenis aturan tersebut berlaku secara terpisah.

• Penambahan, pengeditan, dan penghapusan aturan berlaku secara real time di node edge. Tidak diperlukan refresh manual.