Menulis ulang header permintaan dan respons HTTP dengan Azure Application Gateway - portal Microsoft Azure

Artikel ini menjelaskan cara menggunakan portal Microsoft Azure untuk mengonfigurasi instans SKU Azure Application Gateway v2 untuk menulis ulang header HTTP dalam permintaan dan respons.

Jika Anda tidak memiliki langganan Azure, buatlah akun gratis sebelum Anda memulai.

Sebelum Anda mulai

Anda harus memiliki instans SKU Application Gateway v2 untuk menyelesaikan langkah-langkah dalam artikel ini. Menulis ulang header tidak didukung di SKU v1. Jika Anda tidak memiliki SKU v2, buat instans SKU Application Gateway v2 sebelum Memulai.

Membuat objek yang diperlukan

Untuk mengonfigurasi penulisan ulang header HTTP, ikuti langkah-langkah ini.

  1. Buat objek yang diperlukan untuk penulisan ulang header HTTP:

    • Aksi penulisan ulang: Digunakan untuk menentukan bidang permintaan dan header permintaan yang ingin Anda tulis ulang dan nilai baru untuk header tersebut. Anda dapat mengaitkan satu atau beberapa kondisi penulisan ulang dengan tindakan penulisan ulang.

    • Kondisi penulisan ulang: Konfigurasi opsional. Kondisi penulisan ulang aturan mengevaluasi konten dari permintaan dan respons HTTP(S). Tindakan penulisan ulang terjadi jika permintaan atau respons HTTP cocok dengan kondisi penulisan ulang.

      Jika Anda mengaitkan lebih dari satu kondisi dengan tindakan, tindakan hanya terjadi ketika semua kondisi terpenuhi. Dengan kata lain, operasi ini adalah operasi logis AND .

    • Aturan penulisan ulang: Berisi beberapa kombinasi tindakan dan kondisi penulisan ulang.

    • Urutan aturan: Membantu menentukan urutan di mana aturan penulisan ulang dijalankan. Konfigurasi ini berguna ketika Anda memiliki beberapa aturan penulisan ulang dalam set penulisan ulang. Aturan penulisan ulang yang memiliki nilai urutan aturan yang lebih rendah berjalan terlebih dahulu. Jika Anda menetapkan nilai urutan aturan yang sama ke dua aturan penulisan ulang, urutan eksekusi bersifat nondeterministik.

    • Set penulisan ulang: Berisi beberapa aturan penulisan ulang yang akan dihubungkan dengan aturan perutean permintaan.

  2. Lampirkan set konfigurasi ulang ke aturan perutean. Konfigurasi penulisan ulang dilampirkan ke pendengar sumber melalui aturan perutean.

    • Saat Anda menggunakan aturan perutean dasar, konfigurasi penulisan ulang header dikaitkan dengan pendengar sumber dan merupakan penulisan ulang header global.
    • Saat Anda menggunakan aturan perutean berbasis jalur, konfigurasi penulisan ulang header ditentukan pada peta jalur URL. Dalam hal ini, ini hanya berlaku untuk area jalur tertentu dari situs.

Anda dapat membuat beberapa set penulisan ulang header HTTP dan menerapkan setiap set penulisan ulang ke beberapa pendengar. Tetapi Anda hanya dapat menerapkan satu set penulisan ulang ke pendengar tertentu.

Masuk ke Azure

Masuk ke portal Azure dengan akun Azure Anda.

Mengonfigurasi penulisan ulang header

Dalam contoh ini, kami memodifikasi URL pengalihan dengan menulis ulang header lokasi dalam respons HTTP yang dikirim oleh aplikasi backend.

  1. Pilih Semua sumber daya, lalu pilih gateway aplikasi Anda.

  2. Di panel layanan, pilih Tulis Ulang.

  3. Pilih Rewrite set.

    Cuplikan layar yang memperlihatkan penambahan set penulisan ulang.

  4. Berikan nama untuk set penulisan ulang dan kaitkan dengan aturan perutean:

    1. Dalam kotak Nama , masukkan nama untuk set penulisan ulang.
    2. Di daftar Aturan perutean terkait , pilih satu atau beberapa aturan. Pilih hanya aturan yang belum terkait dengan set penulisan ulang lainnya. Aturan yang sudah terkait dengan set penulisan ulang lainnya diredupkan.
    3. Pilih Selanjutnya.

    Cuplikan layar yang memperlihatkan penambahan nama dan asosiasi.

  5. Buat aturan penulisan ulang:

    1. Pilih Tambahkan aturan penulisan ulang.

      Cuplikan layar yang memperlihatkan penambahan aturan penulisan ulang.

    2. Dalam kotak Tulis ulang nama aturan , masukkan nama untuk aturan penulisan ulang. Dalam kotak Urutan aturan, masukkan angka.

      Cuplikan layar yang memperlihatkan penambahan nama aturan penulisan ulang.

  6. Dalam contoh ini, kami menulis ulang header lokasi hanya ketika berisi referensi ke azurewebsites.net. Untuk melakukan langkah ini, tambahkan kondisi untuk mengevaluasi apakah header lokasi dalam respons berisi azurewebsites.net:

    1. Pilih Tambahkan kondisi, lalu pilih kotak yang berisi instruksi Jika untuk memperluasnya.

      Cuplikan layar yang memperlihatkan penambahan kondisi.

    2. Di daftar Jenis variabel yang akan diperiksa , pilih header HTTP.

    3. Di daftar Jenis header , pilih Respons.

    4. Di bawah Nama header, pilih Header umum. Dalam contoh ini, kami mengevaluasi header lokasi, yang merupakan jenis header umum.

    5. Di daftar Header umum , pilih Lokasi.

    6. Di bawah Sensitif terhadap huruf besar/kecil, pilih Tidak.

    7. Di daftar Operator , pilih sama dengan (=).

    8. Masukkan pola ekspresi reguler. Dalam contoh ini, kita menggunakan pola (https?):\/\/.*azurewebsites.net(.*)$.

    9. Pilih OK.

    Cuplikan layar yang memperlihatkan konfigurasi kondisi If.

  7. Tambahkan tindakan untuk menulis ulang header lokasi:

    1. Di daftar Jenis tindakan , pilih Atur.
    2. Di daftar Jenis header , pilih Respons.
    3. Di bawah Nama header, pilih Header umum.
    4. Di daftar Header umum , pilih Lokasi.
    5. Masukkan nilai header. Dalam contoh ini, kita gunakan {http_resp_Location_1}://contoso.com{http_resp_Location_2} sebagai nilai header. Nilai ini menggantikan azurewebsites.net dengan contoso.com di header lokasi.
    6. Pilih OK.

    Cuplikan layar yang memperlihatkan penambahan tindakan.

  8. Pilih Buat untuk membuat set penulisan ulang.

    Cuplikan layar yang memperlihatkan memilih Buat.

  9. Panel Tulis Ulang terbuka. Verifikasi bahwa set penulisan ulang yang Anda buat ada dalam daftar set penulisan ulang.

    Cuplikan layar yang memperlihatkan penulisan ulang tampilan yang ditetapkan.

Untuk mempelajari selengkapnya tentang cara menyiapkan beberapa kasus penggunaan umum, lihat Skenario penulisan ulang header umum.