Dukungan protokol untuk header HTTP di Azure Front Door

Artikel
04/04/2024

Artikel ini menguraikan protokol yang didukung oleh Front Door dengan bagian-bagian dari jalur panggilan (lihat gambar). Di bagian berikut, Anda menemukan informasi tentang header HTTP yang didukung oleh Front Door.

Diagram memperlihatkan klien membuat permintaan ke Azure Front Door, yang diteruskan ke backend. Respons dikirim dari Azure Front Door ke klien.

Penting

Azure Front Door tidak mensertifikasi header HTTP apa pun yang tidak didokumenkan di sini.

Dari klien ke Azure Front Door

Azure Front Door menerima sebagian besar header untuk permintaan masuk tanpa memodifikasinya. Beberapa header yang dipesan dihapus dari permintaan masuk jika dikirim, termasuk header dengan awalan X-FD-* .

Header permintaan debug, X-Azure-DebugInfo, menyediakan informasi penelusuran kesalahan tambahan tentang Front Door. Anda perlu mengirim X-Azure-DebugInfo: 1 header permintaan dari klien ke Azure Front Door untuk menerima header respons opsional saat respons Azure Front Door ke klien.

Dari Front Door ke backend

Azure Front Door menyertakan header untuk permintaan masuk kecuali jika dihapus karena pembatasan. Azure Front Door juga menambahkan header berikut:

Header	Contoh dan deskripsi
Via	`Via: 1.1 Azure` Front Door menambahkan versi HTTP klien diikuti oleh Azure sebagai nilai untuk header Via. Header ini menunjukkan versi HTTP klien dan bahwa Front Door adalah penerima perantara untuk permintaan antara klien dan backend.
X-Azure-ClientIP	`X-Azure-ClientIP: 127.0.0.1` Mewakili alamat IP klien yang terkait dengan permintaan yang sedang diproses. Misalnya, permintaan yang datang dari proksi mungkin menambahkan header X-Forwarded-For untuk menunjukkan alamat IP pemanggil asli.
X-Azure-SocketIP	`X-Azure-SocketIP: 127.0.0.1` Mewakili alamat IP soket yang terkait dengan koneksi TCP asal permintaan saat ini. Alamat IP klien permintaan mungkin tidak sama dengan alamat IP soketnya karena IP klien dapat ditimpa semaunya oleh pengguna.
X-Azure-Ref	`X-Azure-Ref: 0zxV+XAAAAABKMMOjBv2NT4TY6SQVjC0zV1NURURHRTA2MTkANDM3YzgyY2QtMzYwYS00YTU0LTk0YzMtNWZmNzA3NjQ3Nzgz` String referensi unik yang mengidentifikasi permintaan yang dilayani oleh Azure Front Door. String ini digunakan untuk mencari log akses dan penting untuk pemecahan masalah.
X-Azure-RequestChain	`X-Azure-RequestChain: hops=1` Header yang digunakan Front Door untuk mendeteksi perulangan permintaan, dan pengguna tidak boleh mengambil dependensi padanya.
X-Azure-FDID	`X-Azure-FDID: 55ce4ed1-4b06-4bf1-b40e-4638452104da` String referensi yang mengidentifikasi permintaan berasal dari sumber daya Front Door tertentu. Nilai dapat dilihat di portal Microsoft Azure atau diambil menggunakan API manajemen. Anda dapat menggunakan header ini dalam kombinasi dengan daftar kontrol akses IP ACL untuk mengunci titik akhir Anda agar hanya menerima permintaan dari sumber daya Front Door tertentu. Lihat Tanya Jawab Umum untuk detail selengkapnya
X-Forwarded-For	`X-Forwarded-For: 127.0.0.1` Bidang header HTTP X-Forwarded-For (XFF) sering mengidentifikasi alamat IP asal klien yang terhubung ke server web melalui proksi HTTP atau load balancer. Jika sudah ada header XFF, maka Front Door akan menambahkan IP soket klien ke dalamnya atau menambahkan header XFF dengan IP soket klien.
X-Forwarded-Host	`X-Forwarded-Host: contoso.azurefd.net` Bidang header HTTP X-Forwarded-Host adalah metode umum yang digunakan untuk mengidentifikasi host asli yang diminta oleh klien di header permintaan HTTP Host. Ini karena nama host dari Azure Front Door mungkin berbeda untuk server backend yang menangani permintaan. Nilai sebelumnya ditimpa oleh Azure Front Door.
X-Forwarded-Proto	`X-Forwarded-Proto: http` Bidang `X-Forwarded-Proto` header HTTP sering digunakan untuk mengidentifikasi protokol asal permintaan HTTP. Front Door berdasarkan konfigurasi mungkin berkomunikasi dengan backend dengan menggunakan HTTPS. Ini benar bahkan jika permintaan ke proksi terbalik adalah HTTP. Setiap nilai sebelumnya akan ditimpa oleh Front Door.
X-FD-HealthProbe	`X-FD-HealthProbe` Bidang header HTTP digunakan untuk mengidentifikasi pemeriksaan kesehatan dari Front Door. Jika header ini diatur ke 1, permintaannya berasal dari pemeriksaan kesehatan. Ini dapat digunakan untuk membatasi akses dari Front Door dengan nilai tertentu untuk `X-Forwarded-Host` bidang header.

Dari Front Door ke klien

Setiap header yang dikirim ke Azure Front Door dari backend juga diteruskan ke klien. Front Door juga melampirkan header berikut ke semua respons ke klien:

Header	Contoh dan deskripsi
X-Azure-Ref	`X-Azure-Ref: 0zxV+XAAAAABKMMOjBv2NT4TY6SQVjC0zV1NURURHRTA2MTkANDM3YzgyY2QtMzYwYS00YTU0LTk0YzMtNWZmNzA3NjQ3Nzgz` Ini adalah string referensi unik yang mengidentifikasi permintaan yang dilayani oleh Front Door, yang sangat penting untuk pemecahan masalah seperti yang digunakan untuk mencari log akses.
X-Cache	`X-Cache:` Header ini menjelaskan status penembolokan permintaan. Untuk informasi selengkapnya, lihat Penembolokan dengan Azure Front Door.

Header respons debug opsional

Anda perlu mengirim X-Azure-DebugInfo: 1 header permintaan untuk mengaktifkan header respons opsional berikut.

Header	Contoh dan deskripsi
X-Azure-OriginStatusCode	`X-Azure-OriginStatusCode: 503` Header ini berisi kode status HTTP yang dikembalikan oleh backend. Dengan menggunakan header ini, Anda dapat mengidentifikasi kode status HTTP yang dikembalikan oleh aplikasi yang berjalan di backend Anda tanpa melalui log backend. Kode status ini mungkin berbeda dari kode status HTTP dalam respons yang dikirim ke klien oleh Front Door. Header ini memungkinkan Anda untuk menentukan apakah backend bermasalah atau apakah masalahnya ada pada layanan Front Door.
X-Azure-InternalError	Header ini berisi kode kesalahan yang muncul di Azure Front Door saat memproses permintaan. Kesalahan ini menunjukkan masalah bersifat internal untuk layanan/infrastruktur Azure Front Door. Laporkan masalah ke dukungan.
X-Azure-ExternalError	`X-Azure-ExternalError: 0x830c1011, The certificate authority is unfamiliar` Header ini menunjukkan kode kesalahan yang ditemui server Front Door saat membuat konektivitas ke server backend untuk memproses permintaan. Header ini membantu mengidentifikasi masalah dalam koneksi antara Front Door dan aplikasi backend. Header ini menyertakan pesan kesalahan terperinci untuk membantu Anda mengidentifikasi masalah konektivitas ke backend Anda (misalnya, resolusi DNS, sertifikasi yang tidak valid, dan sebagainya.).

Langkah berikutnya

Pelajari cara membuat profil Azure Front Door.
Pelajari tentang cara kerja Azure Front Door.