Lista nagłówków HTTP

Z Wikipedii, wolnej encyklopedii
Skocz do: nawigacja, szukaj

Nagłówki HTTP to wszelkie komendy używane do komunikacji między przeglądarką WWW a serwerem.

Standardoweedytuj

Acceptedytuj

Accept: application/xhtml+xml, application/xml;q=0.9, text/xml;q=0.7, text/html;q=0.5, text/plain;q=0.3

Służy do określenia listy akceptowalnych przez przeglądarkę typów MIME dokumentu, oraz opcjonalnie hierarchii każdego typu. Liczby podane po ;q= powinny mieć wartości od 0 do 1, co 0.1. Jako separator miejsc dziesiętnych użyta musi być kropka. W przypadku braku zdefiniowanej wartości ;q= przyjmowana jest wartość: ;q=1 (równoznaczna z ;q=1.0).

Powyższy przykład ustala najwyższy priorytet typowi application/xhtml+xml. Jeżeli serwer nie posiada dokumentu w formacie application/xhtml+xml, to prześle plik w formacie application/xml – ogólnym dla podjęzyków XML, takich jak XHTML, SVG. Jeżeli na serwerze nie ma również dokumentu w tym formacie, dane zostaną przesłane jako text/xml – czyli ogólne dane w formacie XML, w ostateczności, jeżeli żadnego z tych typów nie posiada, serwer wyśle dane w formacie text/plain, czyli zwykłego tekstu.

Typy MIME mogą być określone za pomocą symboli wieloznacznych np.: text/*, */*.

Accept-Charsetedytuj

Accept-Charset: utf-8, iso-8859-13;q=0.8

Określa preferowane przez przeglądarkę formaty kodowania. Wartości ;q= interpretowane są na takich samych zasadach, jak w przypadku typów MIME z nagłówka Accept.

Accept-Encodingedytuj

Accept-Encoding: gzip;q=1.0, identity; q=0.5, *;q=0

Ten nagłówek określa kodowanie, za pomocą którego zostanie przesłana zawartość. Stosowane zwykle do kompresji treści.

Accept-Languageedytuj

Accept-Language: pl, en-us;q=0.7

Określa w jakim języku użytkownik przeglądarki życzy sobie czytać strony. Zobacz też: Language negotiation

Accept-Rangesedytuj

Accept-Ranges: bytes lub none

Ten nagłówek jest ustawiany przez przeglądarki i programy ułatwiające ściąganie plików. Określa czy klient potrafi (wartość bytes) lub nie (wartość none) odczytywać pliki przesyłane w częściach.

Zobacz też: Content-Range i Range

Allowedytuj

Allow: GET, POST, HEAD

Określa metody HTTP obsługiwane przez serwer.

Authorizationedytuj

Cache-Controledytuj

Cache-Control: no-cache

Określa regułę według której przeglądarka może (lub nie może) przechowywać stronę w pamięci podręcznej.

Dostępne wartości to:

  • no-store – strona nie może być przechowywana.
  • no-cache – strona może być przechowywana pod warunkiem każdorazowego sprawdzania jej aktualności.

Te dwa nagłówki mają szczególne znaczenie dla serwerów proxy. Pierwszy nakazuje przesyłać dokument bezwzględnie, natomiast drugi pozwala na skorzystanie z kopii w pamięci podręcznej, jeżeli dokument źródłowy się nie zmienił.

  • max-age=liczba_sekund – oznacza, że można skorzystać z cache pod warunkiem iż nie jest przechowywane dłużej jak liczba_sekund. Jeżeli jest starsze przeglądarka powinna ściągnąć nowszą wersję.
  • min-fresh=liczba_sekund – nakazuje przeglądarce ściągnąć dokument jeżeli jego wiek nie przekracza liczby_sekund + aktualna_data

Connectionedytuj

Connection: close

Połączenie zostanie zamknięte po obsłużeniu zapytania.

Connection: keep-alive

Połączenie będzie utrzymywane w oczekiwaniu na kolejne zapytania. Czas oczekiwania nie może przekroczyć wartości określonej w nagłówku wysłanym przez serwer.

Content-Encodingedytuj

Content-Encoding: gzip

Kodowanie dokumentu przesłanego przez serwer. Stosowane zwykle do kompresji treści.

Content-Languageedytuj

Content-Language: en, pl

Język dokumentu przesłanego przez serwer. Może być określony więcej niż jeden język. Wtedy język główny strony jest określony jako ostatni na tej liście.

Content-Lengthedytuj

Content-Length: 1

Długość w bajtach przesyłanej zawartości (wyłączając część nagłówkową). Nagłówek obowiązkowy dla danych wysyłanych z serwera, oraz przy korzystaniu z metody POST.

Content-Locationedytuj

Content-Rangeedytuj

Content-Range: bytes 123-456/5000

Informacja serwera jaki zakres pliku został przesłany (stosowany razem z kodem odpowiedzi 206).

Zakres jest podawany w formacie: pozycja_początkowa-pozycja_końcowa/wielkość_pliku (wszystkie wartości w bajtach)

Content-Typeedytuj

Content-Type: application/xhtml+xml; charset=utf-8

Tym nagłówkiem serwer informuje przeglądarkę, w jakim formacie i stronie kodowej wysyłany jest dokument.

Dateedytuj

Date: Tue, 15 Nov 1994 08:12:31 GMT

Data na serwerze.

Expiresedytuj

Expires: Thu, 01 Dec 1994 16:00:00 GMT

Data powyżej której dokument będzie nieaktualny.

Hostedytuj

Host: www.w3.org

Nagłówek określający dla jakiej domeny określony został URI (do serwera bowiem nie dociera nazwa domenowa, ale jedynie adres IP). Nagłówek wymagany w HTTP 1.1. Dzięki niemu można uruchomić kilka serwerów wirtualnych na jednym adresie IP.

If-Matchedytuj

If-Modified-Sinceedytuj

If-Modified-Since: Sat, 29 Oct 1994 19:43:31 GMT

Nagłówek nakazuje serwerowi przesłać dokument tylko jeżeli został zmodyfikowany od danej daty. Jeżeli dokument się nie zmienił serwer powinien wysłać przeglądarce kod odpowiedzi 304.

Last-Modifiededytuj

Last-Modified: Tue, 15 Nov 1994 12:45:26 GMT

Nagłówek serwera informujący o ostatniej aktualizacji dokumentu.

Locationedytuj

Location: http://serwer/

Wymusza przekierowanie na określony adres. Dla kodu odpowiedzi 201 adres oznacza miejsce nowo utworzonego zasobu. Dla kodów 3xx podany adres oznacza przekierowanie stałe. Od tej pory przeglądarka powinna korzystać z nowego adresu.

Pragmaedytuj

Proxy-Authenticateedytuj

Proxy-Authorizationedytuj

Rangeedytuj

Range: bytes=500-999

Określa jaką część pliku oczekuje przeglądarka. Podawany w formacie bytes=pozycja_początkowa-pozycja_końcowa

Refereredytuj

Referer[1]: http://serwer/katalog/plik.html

Podaje adres strony, z której nastąpiło przekierowanie. Pojawia się gdy użytkownik kliknie na link lub gdy przeglądarka ładuje elementy zagnieżdżone. Jeżeli użytkownik wpisał adres ręcznie ten nagłówek nie występuje.

Retry-Afteredytuj

Retry-After: Fri, 31 Dec 1999 23:59:59 GMT

Używany razem z kodem odpowiedzi 503 (Serwer zajęty). Określa czas po którym serwer będzie w stanie odpowiedzieć. Czas może być podany w formie konkretnej daty (jak w przykładzie) lub liczby sekund.

Serveredytuj

Server: Apache/2.0.50

Nagłówek identyfikujący serwer i użyte w nim oprogramowanie.

Transfer-Encodingedytuj

Transfer-Encoding: chunked

Określa w jaki sposób serwer przesłał zawartość dokumentu.

Dostępne metody to:

chunked
Oznacza przesyłanie zawartości kawałkami. Każdy z nich powinien mieć postać:
wielkość
treść
wielkość – jest to długość treści w bajtach, zapisane w formie szesnastkowej. Przykład:
1a
abcdefghijklmnopqrstuvwxyz
10
1234567890abcdef
0
Zero w ostatniej linijce określa zerowej długości kawałek i kończy transmisję.
identity
Oznacza tekst nieskompresowany
gzip
Oznacza dane skompresowane algorytmem DEFLATE
compress
Dane skompresowane algorytmem LZW

User-Agentedytuj

User-Agent: Mozilla/5.0 (X11; U; Linux i686; pl; rv:1.8.0.1) Gecko/20060124 Firefox/1.5.0.1

Identyfikuje przeglądarkę.

WWW-Authenticateedytuj

WWW-Authenticate: rodzaj_uwierzytelnienia

Przesyłany razem z kodem 401. Określa sposób w jaki ma zostać przeprowadzone uwierzytelnienie użytkownika.

Niestandardoweedytuj

Nagłówki podane poniżej nie znajdują się w specyfikacji HTTP 1.1, lecz są często używane.

Cookieedytuj

Cookie: ciastko1=wartosc1; ciastko2=wartosc2

W tym nagłówku przesyłane są wszystkie ciasteczka ustawione w przeglądarce.

Set-Cookieedytuj

Set-Cookie: ciastko1=wartosc1; ciastko2=wartosc2

Nagłówek wysłany od serwera nakazuje przeglądarce ustawienie określonych ciasteczek.

Refreshedytuj

Refresh: czas; url=adres

Ustawia automatyczne przekierowanie w przeglądarce na podany adres po określonym czasie

X-Frame-Optionsedytuj

X-Frame-Options: deny

Ogranicza zagnieżdżania strony w ramkach w celu ochrony przed atakami Clickjacking[1].

Dostępne wartości to:

deny 
zabrania osadzania strony w ramce
sameorigin 
pozwala na osadzenie strony tylko w obrębie tej samej domeny

Strict-Transport-Securityedytuj

Strict-Transport-Security: max-age=5184000[; includeSubDomains

Wymusza użycie bezpiecznego połączenia HTTPS podczas każdej następnej wizyty na odwiedzanej stronie do momentu upływu czasu max-age w sekundach od ostatniego skutecznego wczytania danej strony zawierającej ten nagłówek, jednak nie wcześniej, niż do końca najdłuższego okresu spośród napotkanych. Używany w celu zapobiegania atakom man in the middle oraz SSL strip. Opcjonalnie może obejmować poddomeny, przy ustawionym parametrze includeSubDomains. Dodatkowo przeglądarka użytkownika nie ma prawa zaproponować zignorowania lub ominięcia błędu, który powstanie w razie braku lub niezgodności certyfikatu serwera.

Przypisy

  1. a b Piotr Konieczny: Clickjacking i Framebusting (czyli ochrona przed clickjackingiem) (pol.). 2010-06-03. [dostęp 2013-06-30].

Zobacz teżedytuj