Udostępnij przez

Obsługa protokołu dla nagłówków HTTP w usłudze Azure Front Door

W tym artykule opisano protokół, który usługa Front Door wspiera wraz z częściami ścieżki wywołania (patrz obrazek). W poniższych sekcjach znajdziesz informacje o nagłówkach HTTP obsługiwanych przez usługę Front Door.

Diagram przedstawiający żądanie klienta wysyłającego żądanie do usługi Azure Front Door, która jest przekazywana do zaplecza. Odpowiedź jest wysyłana z usługi Azure Front Door do klienta.

Ważne

Usługa Azure Front Door nie certyfikowa żadnych nagłówków HTTP, które nie są udokumentowane w tym artykule.

Od klienta do Front Door

Usługa Azure Front Door akceptuje większość nagłówków dla żądania przychodzącego bez ich modyfikowania. Niektóre zastrzeżone nagłówki są usuwane z przychodzącego żądania, jeśli są wysłane, w tym nagłówki z prefiksem X-FD-*.

Nagłówek żądania debugowania , X-Azure-DebugInfozawiera dodatkowe informacje o debugowaniu usługi Front Door. Należy wysłać X-Azure-DebugInfo: 1 nagłówek żądania od klienta do usługi Azure Front Door, aby otrzymywać opcjonalne nagłówki odpowiedzi , gdy usługa Azure Front Door odpowiada klientowi.

Z usługi Front Door do zaplecza

Usługa Azure Front Door zawiera nagłówki dla żądania przychodzącego, chyba że zostaną usunięte z powodu ograniczeń. Usługa Azure Front Door dołącza również następujące nagłówki:

Nagłówek Przykład i opis
Przez Via: 1.1 Azure
Usługa Front Door dodaje wersję HTTP używaną przez klienta, a następnie część wartości nagłówka Via jako Azure. Ten nagłówek wskazuje wersję HTTP klienta i że usługa Front Door była pośrednim adresatem żądania między klientem a zapleczem.
X-Azure-ClientIP X-Azure-ClientIP: 127.0.0.1
Reprezentuje adres IP klienta skojarzony z przetwarzanym żądaniem. Na przykład żądanie pochodzące z serwera proxy może dodać nagłówek X-Forwarded-For, aby wskazać adres IP oryginalnego obiektu wywołującego.
X-Azure-SocketIP X-Azure-SocketIP: 127.0.0.1
Reprezentuje adres IP gniazda skojarzony z połączeniem TCP, z którego pochodzi bieżące żądanie. Adres IP klienta żądania może nie być równy adresowi IP gniazda, ponieważ adres IP klienta może zostać arbitralnie zastąpiony przez użytkownika.
X-Azure-Ref X-Azure-Ref: 0zxV+XAAAAABKMMOjBv2NT4TY6SQVjC0zV1NURURHRTA2MTkANDM3YzgyY2QtMzYwYS00YTU0LTk0YzMtNWZmNzA3NjQ3Nzgz
Unikatowy ciąg odwołania identyfikujący żądanie obsługiwane przez usługę Azure Front Door. Ten ciąg służy do wyszukiwania dzienników dostępu i jest kluczowy do rozwiązywania problemów.
X-Azure-RequestChain X-Azure-RequestChain: hops=1
Nagłówek używany przez usługę Front Door do wykrywania pętli żądań, a użytkownicy nie powinni jej używać jako elementu swojej konfiguracji.
Identyfikator X-Azure-FDID X-Azure-FDID: a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1
Ciąg odwołania identyfikujący żądanie pochodzi z określonego zasobu usługi Front Door. Wartość można zobaczyć w witrynie Azure Portal lub pobrać przy użyciu interfejsu API zarządzania. Tego nagłówka można używać w połączeniu z listami ACL adresów IP, aby zablokować punkt końcowy w celu akceptowania żądań tylko z określonego zasobu usługi Front Door. Aby uzyskać więcej informacji, zobacz często zadawane pytania
X-Forwarded-For X-Forwarded-For: 127.0.0.1
Pole nagłówka HTTP X-Forwarded-For (XFF) często identyfikuje źródłowy adres IP klienta łączącego się z serwerem internetowym za pośrednictwem serwera proxy HTTP lub modułu równoważenia obciążenia. Jeśli istnieje nagłówek XFF, usługa Front Door dołącza do niego adres IP gniazda klienta lub dodaje do niego nagłówek XFF z adresem IP gniazda klienta.
Host przesłany dalej X X-Forwarded-Host: contoso.azurefd.net
Pole nagłówka HTTP X-Forwarded-Host jest typową metodą służącą do identyfikowania oryginalnego hosta żądanego przez klienta w nagłówku żądania HTTP hosta. Dzieje się tak, ponieważ nazwa hosta z usługi Azure Front Door może się różnić w przypadku serwera zaplecza obsługującego żądanie. Każda poprzednia wartość jest zastępowana przez usługę Azure Front Door.
X-Forwarded-Proto X-Forwarded-Proto: http
Pole X-Forwarded-Proto nagłówka HTTP jest często używane do identyfikowania protokołu źródłowego żądania HTTP. Usługa Front Door oparta na konfiguracji może komunikować się z zapleczem przy użyciu protokołu HTTPS. Jest to prawda, nawet jeśli żądanie do zwrotnego serwera proxy to HTTP. Każda poprzednia wartość zostanie zastąpiona przez usługę Front Door.
X-FD-HealthProbe X-FD-HealthProbe Pole nagłówka HTTP służy do identyfikowania sondy kondycji z usługi Front Door. Jeśli ten nagłówek ma wartość 1, żądanie pochodzi z sondy zdrowia. Może być używane do ograniczania dostępu z usługi Front Door, gdy pole nagłówka X-Forwarded-Host ma określoną wartość.
X-Azure —JA4-Fingerprint X-Azure-JA4-Fingerprint Pole nagłówka HTTP służy do unikatowego identyfikowania zachowania klienta na podstawie atrybutów powitania klienta TLS. Umożliwia lepsze wykrywanie botów, anomalii i złośliwego ruchu między sesjami.

Z usługi Front Door do klienta

Wszystkie nagłówki wysyłane do usługi Azure Front Door z zaplecza są również przekazywane do klienta. Usługa Front Door dołącza również następujące nagłówki do wszystkich odpowiedzi na klienta:

Nagłówek Przykład i opis
X-Azure-Ref X-Azure-Ref: 0zxV+XAAAAABKMMOjBv2NT4TY6SQVjC0zV1NURURHRTA2MTkANDM3YzgyY2QtMzYwYS00YTU0LTk0YzMtNWZmNzA3NjQ3Nzgz
Jest to unikatowy ciąg referencyjny, który identyfikuje żądanie obsługiwane przez usługę Front Door, co ma kluczowe znaczenie dla rozwiązywania problemów, ponieważ służy do wyszukiwania dzienników dostępu.
Pamięć podręczna X-Cache X-Cache: W tym nagłówku opisano stan buforowania żądania. Aby uzyskać więcej informacji, zapoznaj się z Buforowanie za pomocą usługi Azure Front Door.

Opcjonalne nagłówki odpowiedzi debugowania

Aby włączyć następujące opcjonalne nagłówki odpowiedzi, należy wysłać X-Azure-DebugInfo: 1 nagłówek żądania.

Nagłówek Przykład i opis
X-Azure-OriginStatusCode X-Azure-OriginStatusCode: 503
Ten nagłówek zawiera kod stanu HTTP zwrócony przez zaplecze. Za pomocą tego nagłówka można zidentyfikować kod stanu HTTP zwrócony przez aplikację działającą w zapleczu bez przechodzenia do dzienników zaplecza. Ten kod stanu może różnić się od kodu stanu HTTP w odpowiedzi wysyłanej do klienta przez usługę Front Door. Ten nagłówek umożliwia określenie, czy serwer zaplecza działa nieprawidłowo, czy problem dotyczy usługi Front Door.
X-Azure-InternalError Ten nagłówek zawiera kod błędu napotkany przez usługę Azure Front Door podczas przetwarzania żądania. Ten błąd wskazuje, że problem jest wewnętrzny w usłudze Azure Front Door i jej infrastrukturze. Zgłoś problem do pomocy technicznej.
X-Azure-ExternalError X-Azure-ExternalError: 0x830c1011, The certificate authority is unfamiliar
Ten nagłówek przedstawia kod błędu, na który wchodzą serwery usługi Front Door podczas nawiązywania łączności z serwerem zaplecza w celu przetworzenia żądania. Ten nagłówek pomaga zidentyfikować problemy w połączeniu między Front Door i aplikacją backendową. Ten nagłówek zawiera szczegółowy komunikat o błędzie, który pomaga zidentyfikować problemy z łącznością z zapleczem (na przykład rozpoznawanie nazw DNS, nieprawidłowy certyfikat itd.).

Treści powiązane

  • Last updated on