Udostępnij za pośrednictwem


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 obsługuje z częściami ścieżki wywołania (zobacz obraz). 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ą tutaj udokumentowane.

Z klienta do usługi Azure 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 żądania przychodzącego w przypadku wysłania, 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 na klienta.

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 klienta, po której następujePlatforma Azure jako wartość nagłówka Via. 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 krytycznego 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 mieć na niej zależności.
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 usługi 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
Ten X-Forwarded-Proto Pole 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 kondycji. Może służyć do ograniczania dostępu z usługi Front Door z określoną wartością dla pola nagłówka X-Forwarded-Host .

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.
X-Cache X-Cache: W tym nagłówku opisano stan buforowania żądania. Aby uzyskać więcej informacji, zobacz 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 zaplecze 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 dla usługi Azure Front Door/infrastruktury. 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 usługą Front Door i aplikacją zaplecza. 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.).

Następne kroki

  • Dowiedz się, jak utworzyć profil usługi Azure Front Door.
  • Dowiedz się, jak działa usługa Azure Front Door.