Protokollstöd för HTTP-huvuden i Azure Front Door

  • Artikel

Den här artikeln beskriver det protokoll som Front Door stöder med delar av samtalssökvägen (se bild). I följande avsnitt hittar du information om HTTP-huvuden som stöds av Front Door.

Diagram som visar klientbegäran till Azure Front Door, som vidarebefordras till serverdelen. Svaret skickas från Azure Front Door till klienten.

Viktigt!

Azure Front Door certifierar inga HTTP-huvuden som inte dokumenteras här.

Från klient till Azure Front Door

Azure Front Door accepterar de flesta huvuden för inkommande begäran utan att ändra dem. Vissa reserverade rubriker tas bort från den inkommande begäran om de skickas, inklusive rubriker med X-FD-* prefixet.

Rubriken för felsökningsbegäran, X-Azure-DebugInfo, ger extra felsökningsinformation om Front Door. Du måste skicka X-Azure-DebugInfo: 1 begärandehuvudet från klienten till Azure Front Door för att ta emot valfria svarshuvuden när Azure Front Door svarar klienten.

Från Front Door till serverdelen

Azure Front Door innehåller rubriker för en inkommande begäran om de inte tas bort på grund av begränsningar. Azure Front Door lägger också till följande rubriker:

Header Exempel och beskrivning
Via Via: 1.1 Azure
Front Door lägger till klientens HTTP-version följt av Azure som värde för Via-huvudet. Det här huvudet anger klientens HTTP-version och att Front Door var en mellanliggande mottagare för begäran mellan klienten och serverdelen.
X-Azure-ClientIP X-Azure-ClientIP: 127.0.0.1
Representerar klientens IP-adress som är associerad med den begäran som bearbetas. En begäran som kommer från en proxy kan till exempel lägga till rubriken X-Forwarded-For för att ange IP-adressen för den ursprungliga anroparen.
X-Azure-SocketIP X-Azure-SocketIP: 127.0.0.1
Representerar socket-IP-adressen som är associerad med den TCP-anslutning som den aktuella begäran kommer från. En begärans klient-IP-adress kanske inte är lika med dess socket-IP-adress eftersom klientens IP-adress kan skrivas över godtyckligt av en användare.
X-Azure-Ref X-Azure-Ref: 0zxV+XAAAAABKMMOjBv2NT4TY6SQVjC0zV1NURURHRTA2MTkANDM3YzgyY2QtMzYwYS00YTU0LTk0YzMtNWZmNzA3NjQ3Nzgz
En unik referenssträng som identifierar en begäran som hanteras av Azure Front Door. Den här strängen används för att söka i åtkomstloggar och är viktig för felsökning.
X-Azure-RequestChain X-Azure-RequestChain: hops=1
En rubrik som Front Door använder för att identifiera begärandeloopar, och användarna bör inte vara beroende av den.
X-Azure-FDID X-Azure-FDID: 55ce4ed1-4b06-4bf1-b40e-4638452104da
En referenssträng som identifierar begäran kom från en specifik Front Door-resurs. Värdet kan visas i Azure-portalen eller hämtas med hjälp av hanterings-API:et. Du kan använda det här huvudet i kombination med IP-ACL:er för att låsa slutpunkten för att endast acceptera begäranden från en specifik Front Door-resurs. Mer information finns i Vanliga frågor och svar
X-Forwarded-For X-Forwarded-For: 127.0.0.1
HTTP-huvudfältet X-Forwarded-For (XFF) identifierar ofta den ursprungliga IP-adressen för en klient som ansluter till en webbserver via en HTTP-proxy eller lastbalanserare. Om det finns ett befintligt XFF-huvud lägger Front Door till klient socket-IP-adressen till den eller lägger till XFF-huvudet med klient socket-IP-adressen.
X-vidarebefordrad värd X-Forwarded-Host: contoso.azurefd.net
HTTP-huvudfältet X-Forwarded-Host är en vanlig metod som används för att identifiera den ursprungliga värden som begärdes av klienten i värd-HTTP-begärandehuvudet. Det beror på att värdnamnet från Azure Front Door kan skilja sig åt för serverdelsservern som hanterar begäran. Alla tidigare värden åsidosättas av Azure Front Door.
X-Forwarded-Proto X-Forwarded-Proto: http
FÄLTET X-Forwarded-Proto HTTP-huvud används ofta för att identifiera det ursprungliga protokollet för en HTTP-begäran. Front Door baserat på konfigurationen kan kommunicera med serverdelen med hjälp av HTTPS. Detta gäller även om begäran till den omvända proxyn är HTTP. Alla tidigare värden kommer att åsidosättas av Front Door.
X-FD-HealthProbe X-FD-HealthProbe FÄLTET HTTP-huvud används för att identifiera hälsoavsökningen från Front Door. Om det här huvudet är inställt på 1 kommer begäran från hälsoavsökningen. Den kan användas för att begränsa åtkomsten från Front Door med ett visst värde för X-Forwarded-Host rubrikfältet.

Från Front Door till klienten

Alla huvuden som skickas till Azure Front Door från serverdelen skickas också till klienten. Front Door bifogar också följande huvuden till alla svar på klienten:

Header Exempel och beskrivning
X-Azure-Ref X-Azure-Ref: 0zxV+XAAAAABKMMOjBv2NT4TY6SQVjC0zV1NURURHRTA2MTkANDM3YzgyY2QtMzYwYS00YTU0LTk0YzMtNWZmNzA3NjQ3Nzgz
Det här är en unik referenssträng som identifierar en begäran som hanteras av Front Door, vilket är viktigt för felsökning eftersom den används för att söka i åtkomstloggar.
X-Cache X-Cache: Det här huvudet beskriver cachelagringsstatusen för begäran. Mer information finns i Cachelagring med Azure Front Door.

Valfria svarshuvuden för felsökning

Du måste skicka X-Azure-DebugInfo: 1 begärandehuvudet för att aktivera följande valfria svarshuvuden.

Header Exempel och beskrivning
X-Azure-OriginStatusCode X-Azure-OriginStatusCode: 503
Det här huvudet innehåller HTTP-statuskoden som returneras av serverdelen. Med det här huvudet kan du identifiera HTTP-statuskoden som returneras av programmet som körs i serverdelen utan att gå igenom serverdelsloggarna. Den här statuskoden kan skilja sig från HTTP-statuskoden i svaret som skickas till klienten av Front Door. Med den här rubriken kan du avgöra om serverdelen fungerar felaktigt eller om problemet gäller Front Door-tjänsten.
X-Azure-InternalError Den här rubriken innehåller felkoden som Azure Front Door stöter på när begäran bearbetas. Det här felet anger att problemet är internt för Azure Front Door-tjänsten/infrastrukturen. Rapportera problem som ska stödjas.
X-Azure-ExternalError X-Azure-ExternalError: 0x830c1011, The certificate authority is unfamiliar
Den här rubriken visar felkoden som Front Door-servrar stöter på när anslutningen till serverdelsservern upprättas för att bearbeta en begäran. Den här rubriken hjälper dig att identifiera problem i anslutningen mellan Front Door och serverdelsprogrammet. Det här huvudet innehåller ett detaljerat felmeddelande som hjälper dig att identifiera anslutningsproblem till serverdelen (till exempel DNS-matchning, ogiltigt certifikat och så vidare.).

Nästa steg