Cocokkan & Ganti
Cocokkan & Ganti memodifikasi lalu lintas secara otomatis saat melewati proksi, tanpa menjeda atau memerlukan tindakan manual untuk setiap permintaan.
Cara Kerja Aturan
Setiap aturan menentukan apa yang dicari dan tindakan yang dilakukan terhadapnya. Ketika permintaan atau respons cocok dengan kondisi, aturan langsung menerapkan transformasinya.
Aturan diterapkan sesuai urutan dalam daftar. Jika dua aturan menargetkan header yang sama, aturan pertama yang cocok diterapkan terlebih dahulu, dan aturan berikutnya melihat hasil perubahan tersebut.
Kolom Aturan
| Kolom | Deskripsi |
|---|---|
| Nama | Label aturan. Gunakan nama deskriptif untuk menunjukkan tujuannya. |
| Arah | Apakah aturan berlaku pada permintaan, respons, atau keduanya |
| Operasi | Transformasi yang dilakukan (lihat tabel operasi di bawah) |
| Mode pencocokan | Literal, regex, atau seluruh konten, bergantung pada operasi |
| Nilai pencocokan | String atau pola yang dicari |
| Nilai pengganti | Nilai yang digunakan sebagai pengganti |
| Diaktifkan | Sakelar untuk mengaktifkan atau menonaktifkan aturan tanpa menghapusnya |
| Filter | Kondisi metode, host, path, dan HTTPQL opsional yang membatasi tempat aturan berlaku |
Operasi
| Operasi | Fungsi |
|---|---|
| Tambah header | Menambahkan header baru dengan nama dan nilai tetap |
| Hapus header | Menghapus header berdasarkan nama |
| Ganti header | Mengganti nilai header yang ada |
| Ganti isi | Mengganti bagian isi menggunakan nilai pencocokan |
| Path / kueri / parameter kueri | Mengubah path permintaan atau nilai kueri |
| Baris permintaan / respons | Mengubah komponen baris awal HTTP yang dipilih |
| Kode status | Mengubah status respons |
| Pesan dalam format transmisi | Mentransformasi baris awal HTTP, header, dan isi secara bersamaan |
| Payload WebSocket | Mengganti konten pesan klien/server yang cocok |
| Alur Kerja | Menjalankan alur kerja Konversi yang diaktifkan terhadap konten terpilih |
Mode Pencocokan
Literal mencocokkan string secara persis. Gunakan untuk token tetap, nama header, atau nilai tertentu.
Regex mencocokkan menggunakan ekspresi reguler. Gunakan ketika target bervariasi - misalnya, untuk mencocokkan token yang berubah pada setiap sesi, atau mengambil dan menggunakan kembali grup dalam penggantian.
Dalam penggantian regex, gunakan grup tangkapan dengan $1, $2, dan seterusnya untuk merujuk bagian yang cocok dalam nilai pengganti.
Seluruh konten meneruskan seluruh konten terpilih ke transformasi, alih-alih mencari substring. Beberapa operasi, seperti menambahkan/menghapus header bernama, menggunakan nama literal dan tidak menawarkan semua mode.
Mentransformasi Seluruh Isi Respons
- Buat dan aktifkan alur kerja Konversi, lalu validasi dengan masukan uji.
- Buat aturan Cocokkan & Ganti dengan arah Respons dan operasi Alur Kerja (Isi).
- Pilih mode pencocokan Seluruh konten dan pilih alur kerja.
- Persempit aturan dengan filter HTTPQL, misalnya:
text
req.host.eq:"cdn.example.com" AND (req.path.cont:".js" OR resp.headers["Content-Type"].value.cont:"javascript")Alur kerja menerima seluruh isi; keluarannya menggantikan isi tersebut. Alur Kerja (Header) mentransformasi header bernama, sedangkan Alur Kerja (Header Mentah) mentransformasi blok header. Masukan ini berbeda dari isi respons.
Filter HTTPQL diperiksa dalam konteks permintaan/respons yang tersedia. Aturan berarah permintaan tidak dapat bergantung pada respons yang belum tiba. Nonaktifkan pencatatan alur kerja ketika aturan menghasilkan banyak eksekusi; aktifkan sementara untuk mendiagnosis transformasi.
Mengubah Urutan Aturan
Seret baris aturan untuk mengubah posisinya dalam daftar. Urutan penting ketika aturan memodifikasi bagian yang tumpang tindih dari permintaan atau respons yang sama.
Bantuan AI
Jelaskan perubahan yang Anda inginkan dalam bahasa sehari-hari pada editor aturan, lalu klik Isi dengan AI. Ogma menghasilkan kolom aturan berdasarkan deskripsi Anda. Tinjau dan sesuaikan nilai yang dihasilkan sebelum mengaktifkan aturan.
Contoh prompt yang efektif:
- "Hapus header X-Frame-Options dari semua respons"
- "Ganti nilai header Authorization dengan token pengujian saya"
- "Tambahkan header bernama X-Debug dengan nilai true ke semua permintaan"
Menguji Aturan
Sebelum mengaktifkan aturan untuk lalu lintas langsung, uji dengan contoh permintaan:
- Buka editor aturan.
- Tempel permintaan HTTP dalam format transmisi ke panel Uji.
- Klik Terapkan aturan. Panel menampilkan hasil dan aturan yang diterapkan.
- Verifikasi bahwa keluarannya sesuai harapan.
- Aktifkan aturan.
Panel Uji juga memiliki target Respons dengan masukan status, header, dan isi. Periksa daftar aturan yang diterapkan: pengujian ini menguji aturan yang berlaku, bukan hanya satu kolom editor yang terisolasi.
Cocokkan & Ganti dan Intersepsi
Cocokkan & Ganti bersifat otomatis. Setelah aturan diaktifkan, aturan mentransformasi setiap permintaan atau respons yang cocok tanpa tindakan dari Anda.
Intersepsi menjeda lalu lintas dan menunggu keputusan manual. Gunakan Intersepsi ketika perubahan yang tepat bergantung pada konteks yang perlu Anda evaluasi per permintaan. Gunakan Cocokkan & Ganti ketika transformasi yang sama harus diterapkan setiap kali tanpa peninjauan.
Penggunaan Umum
- Mengganti cookie sesi di seluruh permintaan untuk menguji akun lain.
- Menambahkan header yang mengaktifkan mode debug atau admin.
- Menghapus header keamanan dari respons untuk mengevaluasi perilaku sisi klien.
- Mengganti host yang ditulis tetap dalam respons pengalihan.
- Menulis ulang awalan path permintaan.