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.
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-DebugInfo
pož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
- Zjistěte, jak vytvořit profil služby Azure Front Door.
- Přečtěte si, jak Azure Front Door funguje.