Sdílet prostřednictvím


Podpora protokolů pro hlavičky HTTP ve službě Azure Front Door

Tento článek popisuje protokol, který služba Front Door podporuje s částmi cesty volání (viz obrázek). V následujících částech najdete informace o hlavičkách HTTP podporovaných službou Front Door.

Diagram znázorňující požadavek klienta na službu Azure Front Door, která se předává do back-endu Odpověď se odešle ze služby Azure Front Door klientovi.

Důležité

Azure Front Door necertifikuje žádné hlavičky HTTP, které tady nejsou zdokumentované.

Z klienta do služby Azure Front Door

Azure Front Door přijímá většinu hlaviček příchozího požadavku, aniž by je upravoval. Některé rezervované hlavičky se při odeslání odeberou z příchozího požadavku, včetně hlaviček s předponou X-FD-* .

Hlavička X-Azure-DebugInfopožadavku ladění poskytuje další informace o ladění služby Front Door. Pokud chcete, aby odpověď azure Front Door na klienta přijímala volitelná hlavička odpovědi, musíte odeslat X-Azure-DebugInfo: 1 hlavičku požadavku z klienta.

Ze služby Front Door do back-endu

Azure Front Door obsahuje hlavičky příchozího požadavku, pokud se neodeberou kvůli omezením. Azure Front Door také připojí následující hlavičky:

Hlavička Příklad a popis
Přes Via: 1.1 Azure
Front Door přidá verzi HTTP klienta, za kterou následujeAzure jako hodnota hlavičky Via. Tato hlavička označuje verzi PROTOKOLU HTTP klienta a že front Door byl zprostředkujícím příjemcem požadavku mezi klientem a back-endem.
X-Azure-ClientIP X-Azure-ClientIP: 127.0.0.1
Představuje IP adresu klienta přidruženou ke zpracování požadavku. Například požadavek přicházející z proxy serveru může přidat hlavičku X-Forwarded-For, která označuje IP adresu původního volajícího.
X-Azure-SocketIP X-Azure-SocketIP: 127.0.0.1
Představuje IP adresu soketu přidruženou k připojení TCP, ze kterého pochází aktuální požadavek. IP adresa klienta požadavku nemusí být rovna IP adrese soketu, protože IP adresu klienta může libovolně přepsat uživatel.
X-Azure-Ref X-Azure-Ref: 0zxV+XAAAAABKMMOjBv2NT4TY6SQVjC0zV1NURURHRTA2MTkANDM3YzgyY2QtMzYwYS00YTU0LTk0YzMtNWZmNzA3NjQ3Nzgz
Jedinečný referenční řetězec, který identifikuje požadavek obsluhované službou Azure Front Door. Tento řetězec slouží k prohledávání protokolů přístupu a kritických pro řešení potíží.
X-Azure-RequestChain X-Azure-RequestChain: hops=1
Hlavička, kterou služba Front Door používá k detekci smyček požadavků, a uživatelé by na ní neměli záviset.
X-Azure-FDID X-Azure-FDID: a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1
Referenční řetězec, který identifikuje požadavek, pochází z konkrétního prostředku služby Front Door. Hodnotu můžete zobrazit na webu Azure Portal nebo načíst pomocí rozhraní API pro správu. Tuto hlavičku můžete použít v kombinaci s seznamy ACL PROTOKOLU IP a uzamknout koncový bod tak, aby přijímal pouze požadavky z konkrétního prostředku služby Front Door. Další podrobnosti najdete v nejčastějších dotazech.
X-forwarded-for X-Forwarded-For: 127.0.0.1
Pole hlavičky HTTP X-Forwarded-For (XFF) často identifikuje původní IP adresu klienta, který se připojuje k webovému serveru prostřednictvím proxy serveru HTTP nebo nástroje pro vyrovnávání zatížení. Pokud existuje existující hlavička XFF, služba Front Door k němu připojí IP adresu klientského soketu nebo přidá hlavičku XFF s IP adresou klientského soketu.
X-forwarded-host X-Forwarded-Host: contoso.azurefd.net
Pole hlavičky HTTP pro předávání X-Forwarded-Host je běžnou metodou, která slouží k identifikaci původního hostitele požadovaného klientem v hlavičce požadavku HTTP hostitele. Důvodem je to, že se název hostitele z Azure Front Dooru může u back-endového serveru, který zpracovává požadavek, lišit. Každá předchozí hodnota je přepsána službou Azure Front Door.
X-forwarded-Proto X-Forwarded-Proto: http
Ten X-Forwarded-Proto Pole hlavičky HTTP se často používá k identifikaci původního protokolu požadavku HTTP. Služba Front Door založená na konfiguraci může komunikovat s back-endem pomocí protokolu HTTPS. To platí i v případě, že požadavek na reverzní proxy server je HTTP. Služba Front Door přepíše jakoukoli předchozí hodnotu.
X-FD-HealthProbe X-FD-HealthProbe Pole hlavičky HTTP slouží k identifikaci sondy stavu ze služby Front Door. Pokud je tato hlavička nastavená na hodnotu 1, požadavek pochází z sondy stavu. Dá se použít k omezení přístupu ze služby Front Door s konkrétní hodnotou pro X-Forwarded-Host pole záhlaví.

Ze služby Front Door do klienta

Všechny hlavičky odeslané do služby Azure Front Door z back-endu se také předávají klientovi. Služba Front Door také připojí následující hlavičky ke všem odpovědím na klienta:

Hlavička Příklad a popis
X-Azure-Ref X-Azure-Ref: 0zxV+XAAAAABKMMOjBv2NT4TY6SQVjC0zV1NURURHRTA2MTkANDM3YzgyY2QtMzYwYS00YTU0LTk0YzMtNWZmNzA3NjQ3Nzgz
Jedná se o jedinečný referenční řetězec, který identifikuje požadavek obsluhované službou Front Door, což je důležité pro řešení potíží, protože se používá k prohledávání protokolů přístupu.
X-Cache X-Cache: Tato hlavička popisuje stav ukládání do mezipaměti požadavku. Další informace najdete v tématu Ukládání do mezipaměti se službou Azure Front Door.

Volitelné hlavičky odpovědi ladění

Pokud chcete povolit následující volitelná hlavička odpovědi, musíte odeslat X-Azure-DebugInfo: 1 hlavičku požadavku.

Hlavička Příklad a popis
X-Azure-OriginStatusCode X-Azure-OriginStatusCode: 503
Tato hlavička obsahuje stavový kód HTTP vrácený back-endem. Pomocí této hlavičky můžete identifikovat stavový kód HTTP vrácený aplikací spuštěnou v back-endu, aniž byste museli procházet protokoly back-endu. Tento stavový kód se může lišit od stavového kódu HTTP v odpovědi odeslané klientovi službou Front Door. Tato hlavička umožňuje určit, jestli se back-end nechová špatně nebo jestli se jedná o problém se službou Front Door.
X-Azure-InternalError Tato hlavička obsahuje kód chyby, který azure Front Door při zpracování požadavku narazí. Tato chyba značí, že problém je interní pro službu nebo infrastrukturu služby Azure Front Door. Nahlaste problém s podporou.
X-Azure-ExternalError X-Azure-ExternalError: 0x830c1011, The certificate authority is unfamiliar
Tato hlavička ukazuje kód chyby, na který servery Front Door narazí při navazování připojení k back-endovému serveru pro zpracování požadavku. Tato hlavička pomáhá identifikovat problémy v připojení mezi službou Front Door a back-endovou aplikací. Tato hlavička obsahuje podrobnou chybovou zprávu, která vám pomůže identifikovat problémy s připojením k back-endu (například překlad DNS, neplatný certifikát atd.).

Další kroky