HTTP ヘッダー
HTTP ヘッダーにより、クライアントやサーバーが HTTP リクエストやレスポンスで追加情報を渡すことができます。 HTTP ヘッダーは、大文字小文字を区別しないヘッダー名とそれに続くコロン (:)、 値で構成されます。値の前にあるホワイトスペースは無視されます。
独自のヘッダーは、以前は X- 接頭辞を使用していましたが、この慣習は 2012 年 6 月に非推奨になりました。これは、 RFC 6648 で非標準のフィールドが標準になったときに発生した不便さのためです。それ以外のヘッダーは IANA レジストリ に収録されており、その基になったものは RFC 4229 です。また IANA は 新たに提案された HTTP ヘッダーのレジストリ も管理しています。
ヘッダーは、そのコンテキストに応じて分類できます。
- 一般ヘッダー: リクエストとレスポンスの両方に適用されますが、本文で転送されるデータとは関係ないものです。
- リクエストヘッダー: 読み込むリソースやリソースをリクエストしているクライアントに関する詳細な情報を持ちます。
- レスポンスヘッダー: レスポンスに関する追加情報、例えば場所や提供しているサーバーに関するものを保持します。
- エンティティヘッダー: リソースの本体に関する情報、例えばコンテンツの長さや MIME タイプなどを持ちます。
またヘッダーは、プロキシサーバーがどのように処理するかに応じてグループ化されます。
ConnectionKeep-AliveProxy-AuthenticateProxy-Authorization- TE (en-US)
- Trailer (en-US)
Transfer-Encoding- Upgrade (en-US).
- エンドツーエンドヘッダー
- これらのヘッダーは、メッセージの最終的な宛先、すなわちリクエストならばサーバー、レスポンスならばクライアントに伝送しなければなりません。中間のプロキシはヘッダーを変更せずに再伝送しなければならず、またキャッシュには保存しなければなりません。
- ホップバイホップヘッダー
- これらのヘッダーは単一のトランスポート層の接続にのみ意味を持ち、プロキシが再転送したり、キャッシュを行ったりしてはいけません。なお、
Connection一般ヘッダーを用いて設定する場合があるのはホップバイホップヘッダーのみです。
認証
WWW-Authenticate- リソースへアクセスに使用すべき認証方法を定義します。
Authorization- サーバーでユーザーエージェントを認証するための資格情報を持ちます。
Proxy-Authenticate- プロキシサーバーの背後にあるリソースへアクセスできるようにするために使用すべき認証方法を定義します。
Proxy-Authorization- プロキシサーバーでユーザーエージェントを認証するための資格情報を持ちます。
キャッシュ
Age- オブジェクトがプロキシのキャッシュに存在する時間を秒数で表します。
Cache-Control- リクエストおよびレスポンスで、キャッシュ機能に関するディレクティブです。
Clear-Site-Data- リクエストしているウェブサイトに関連付けられたブラウズ用のデータ (クッキー、ストレージ、キャッシュ等) を消去します。
Expires- レスポンスが陳腐化すると考えられる日時を表します。
Pragma- リクエストからレスポンスへの流れの中でさまざまな影響がある、実装依存のヘッダーです。
Cache-Controlヘッダーが未実装である HTTP/1.0 キャッシュとの後方互換性のために使用します。 Warning- 起こりうる問題に関する一般警告情報です。
クライアントヒント
HTTP クライアントヒントは策定中です。実際の文書は HTTP 作業グループのウェブサイトにあります。
Accept-CH- サーバーはクライアントヒントに対応していることを、
Accept-CHヘッダーフィールドまたは同等のhttp-equiv属性が付いた HTML の<meta>要素を使用して広報することができます ([HTML5])。 Accept-CH-Lifetime- サーバーは、指定された期間サーバーがサポートする対応する一連のクライアントヒントを記憶するようクライアントに依頼し、そのサーバーのオリジンに対するその後のリクエストでクライアントヒントを配信できるようにすることができます ([RFC6454])。
Early-Data- リクエストが早期データを伝えていることを示します。
Content-DPR- 数値で、選択された画像レスポンスの CSS ピクセルに対する物理ピクセルの比を示します。
DPR- 数値で、現在のクライアントの端末ピクセル比 (DPR)、すなわち端末のレイアウトビューポート ([CSS2] のセクション9.1.1) における、 CSS ピクセルに対する物理ピクセルの比 ([CSSVAL] のセクション5.2) を示します。
Device-Memory- 技術的には Device Memory API の一部で、このヘッダーはクライアントが持つおよその RAM の量を表します。
- Save-Data (en-US)
- 論理型で、ユーザーエージェントのデータ利用の削減についての設定を示します。
Viewport-Width-
Viewport-Widthリクエストヘッダーフィールドは数値で、レイアウトビューポートの幅を CSS ピクセル数で示します。指定されたピクセル数は、それ以上の最小の整数に丸められます (つまり切り上げ)。Viewport-Widthがメッセージ内に二回以上現れた場合、最後の値がそれ以前のすべての値を上書きします。 Width-
Widthリクエストヘッダーフィールドは数値で、要求するリソースの幅 (つまり画像の固有の寸法) を物理ピクセル数で示します。指定されたピクセル数は、それ以上の最小の整数に丸められます (つまり切り上げ)。要求するリソースの幅がリクエストの時点で不明である場合や、リソースが表示幅を持たない場合は、
Widthヘッダーフィールドは省略できます。Widthがメッセージ内に二回以上現れた場合、最後の値がそれ以前のすべての値を上書きします。
条件付き
Last-Modified- リソースが最後に変更された日時であり、同じリソースの複数のバージョンを比較するために使用されます。
ETagより正確さは低いのですが、環境によっては計算が容易です。If-Modified-SinceやIf-Unmodified-Sinceを使用する条件付きリクエストでは、リクエストの動作を変更するためにこの値を使用します。 ETag- 一意な文字列であり、リソースのバージョンを識別します。
If-MatchやIf-None-Matchを使用する条件付きリクエストでは、リクエストの動作を変更するためにこの値を使用します。 If-Match- リクエストを条件付きにして、保存されたリソースが指定した ETag のいずれかに一致する場合に限りメソッドを適用します。
If-None-Match- リクエストを条件付きにして、保存されたリソースが指定した ETag のいずれかに一致しない場合に限りメソッドを適用します。これはキャッシュを更新する (安全なリクエスト向け)、あるいはすでにリソースが存在する場合に新しいリソースのアップロードを止めるために使用します。
If-Modified-Since- リクエストを条件付きにして、エンティティが指定した日時より後に変更されている場合に限り転送するようリクエストします。キャッシュが期限切れである場合に限りデータを転送するために使用します。
If-Unmodified-Since- リクエストを条件付きにして、エンティティが指定した日時より後に変更されていない場合に限り転送するようリクエストします。これは、特定の範囲の新しい断片と古い断片の一貫性を保証する、あるいは既存の文書を変更するときに楽観的な並行性制御システムを実装するために使用します。
Vary- 新しいものを元のサーバーにリクエストするのではなく、キャッシュされたレスポンスが使用できるよう決定するために、リクエストヘッダーを一致させる方法を定めます。/dd>
接続制御
Connection- 現在の転送が完了した後も、ネットワークコネクションを維持するかを制御します。
Keep-Alive- 持続的なコネクションをどれだけの期間維持するかを制御します。
コンテンツネゴシエーション
Accept- 送り返すことができるデータの種類をサーバーに通知します。
Accept-Charset- どの文字集合をクライアントが理解できるかです。
Accept-Encoding- 送り返すリソースで使用できるエンコードアルゴリズム (一般的には圧縮アルゴリズム) をサーバーに通知します。
Accept-Language- 送り返すリソースで期待する自然言語をサーバーに通知します。これはヒントであり、必ずしもユーザーの完全な制御下にあるものではありません。サーバーはユーザーの選択 (ドロップダウンリストで選ぶ言語など) を明示的に上書きしないように、常に注意を払うべきです。
制御
Expect- リクエストを適切に扱うためにサーバーが実行しなければならないと期待されていることを示します。
Max-Forwards
クッキー
Cookie- 過去に
Set-Cookieヘッダーでサーバーから送信されて保存している HTTP クッキーを持ちます。 Set-Cookie- サーバーからユーザーエージェントにクッキーを送信します。
Cookie2- 過去に
Set-Cookie2ヘッダーでサーバーから送信された HTTP クッキーを伝えるために使われていましたが、仕様書から廃止されました。代わりにCookieを使用してください。 Set-Cookie2- サーバーからユーザーエージェントに Cookie を送信するために使用されていましたが、仕様書から廃止されました。代わりに
Set-Cookieを使用してください。
オリジン間リソース共有 (CORS)
CORS についての詳細は、こちらを参照してください。
Access-Control-Allow-Origin- レスポンスが共有可能かを示します。
Access-Control-Allow-Credentials- credentials フラグが真であるときに、リクエストへのレスポンスを開示してよいかを示します。
Access-Control-Allow-Headers- プリフライトリクエストへのレスポンスで使用し、実際のリクエストを行うときに使用できる HTTP ヘッダーを指定します。
Access-Control-Allow-Methods- プリフライトリクエストへのレスポンスで、リソースへアクセスするときに使用できるメソッドを指定します。
Access-Control-Expose-Headers- ヘッダー名を羅列して、レスポンスの一部として開示できるヘッダーを示します。
Access-Control-Max-Age- プリフライトリクエストの結果をキャッシュしてよい期間を示します。
Access-Control-Request-Headers- 実際のリクエストを行う際に使用する HTTP ヘッダーをサーバーがわかるようにするため、プリフライトリクエストを発信する際に使用します。
Access-Control-Request-Method- 実際のリクエストを行う際に使用する HTTP メソッド をサーバーがわかるようにするため、プリフライトリクエストを発信する際に使用します。
Origin- どこから読み込みが発生したかを示します。
Timing-Allow-Origin- Resource Timing API の機能を通じて受け取った属性の値を見ることができるオリジンを指定します。そうでなければオリジン間の制約によってゼロとして報告されます。
Do Not Track
ダウンロード
Content-Disposition- 転送したリソースをインラインで表示すべきか (ヘッダーが存在しない場合の既定の動作)、またはダウンロードとして扱い、「名前を付けて保存」ウィンドウを表示すべきかを示します。
メッセージ本文の情報
Content-Length- リソースの大きさを、バイト単位の10進数で示します。
Content-Type- リソースのメディアタイプを示します。
Content-Encoding- 圧縮アルゴリズムを指定するために使用します。
Content-Language- 読者向けに言語を示すヘッダーであり、ユーザーが自身の好む言語に応じて区別することができます。
Content-Location- 返すデータの代替データの場所を示します。
プロキシ
Forwarded- リクエストのパスにプロキシが関与したときに変更または遺失した、プロキシサーバーのクライアント側の情報を持ちます。
X-Forwarded-For- HTTP プロキシやロードバランサーを経由してウェブサーバーに接続するクライアントの、接続元 IP アドレスを識別します。
X-Forwarded-Host- プロキシやロードバランサーに接続するクライアントがリクエストした、オリジナルのホストを示します。
X-Forwarded-Proto- クライアントがプロキシやロードバランサーに接続するために使用したプロトコル (HTTP または HTTPS) を識別します。
Via- フォワードプロキシとリバースプロキシの両方が追加するヘッダーであり、リクエストヘッダーとレスポンスヘッダーのどちらでも見られます。
リダイレクト
Location- ページのリダイレクト先の URL を示します。
リクエストコンテキスト
From- リクエストを行うユーザーエージェントを操作している人間の、インターネット電子メールアドレスを持ちます。
Host- サーバーのドメイン名 (バーチャルホスト向け) およびサーバーが待ち受けている TCP ポート番号 (省略可能) を指定します。
Referer- 現在リクエストしているページへリンクしていた、前のウェブページのアドレスです。
Referrer-PolicyRefererヘッダーで送信するどのリファラー情報をリクエストに含めるかを制御します。User-Agent- リクエストを行うユーザーエージェントソフトウェアのアプリケーションタイプ、オペレーティングシステム、ベンダー、バージョンを、ネットワークプロトコルのピアが識別できるようにする文字列を持ちます。 Firefox ユーザーエージェント文字列リファレンスもご覧ください。
レスポンスコンテキスト
範囲付きリクエスト
Accept-Ranges- サーバーが範囲付きリクエストに対応するかどうか、対応していれば対応する場合は、範囲を表すことができる単位を示します。
Range- サーバーが返すべきである文書の範囲を示します。
If-Range- 指定した ETag または日時がリモートのリソースにマッチする場合に限定した、条件付き range request を生成します。異なるバージョンのリソースから 2 つの範囲をダウンロードすることを防ぎます。
Content-Range- 部分的なメッセージが、メッセージ本文全体のどこに位置するかを示します。
セキュリティ
- Cross-Origin-Embedder-Policy (en-US) (COEP)
- サーバーが指定された文書の埋め込み方針を宣言するために使います。
- Cross-Origin-Opener-Policy (en-US) (COOP)
- 他のドメインがウィンドウを開いたり制御したりすることを防ぎます。
Cross-Origin-Resource-Policy(CORP)- このヘッダーが適用されたリソースのレスポンスが他のドメインから読み取られるのを防ぎます。
Content-Security-Policy(CSP)- ユーザーエージェントがページで読み込むことを許可するリソースを制御します。
Content-Security-Policy-Report-Only- ウェブの開発者がポリシーの効果を適用せずに監視することで、実験を行うことができます。これらの違反レポートは、 HTTP
POSTリクエストによって指定した URI へ送信される JSON 文書で構成されます。 Expect-CT- サイトが証明書の透明性要件の報告や実施を選択できるようにします。これにより、そのサイトで不正な証明書の使用に気づかないことを防ぎます。サイトが Expect-CT ヘッダーを有効にした場合、そのサイトの証明書が公開CTログに表示されることを Chrome が確認するようにリクエストしています。
Feature-Policy- 自身のフレームまたはその中の iframe で、ブラウザーの機能を使用することを許可または拒否する仕組みを提供します。
Strict-Transport-Security(HSTS)- HTTP の代わりに HTTPS による通信を強制します。
Upgrade-Insecure-Requests- 暗号化や認証されたレスポンスについて、クライアントの設定を表す信号をサーバーに送信して、
upgrade-insecure-requestsディレクティブを正しく扱うことができます。 X-Content-Type-Options- ブラウザーで MIME スニッフィングを無効化して、
Content-Typeで指定したタイプを強制的に使用させます。 X-Download-Options- HTTP の
X-Download-Optionsヘッダーは、ブラウザー (Internet Explorer) がアプリケーションからのダウンロードでファイルを「開く」の選択肢を表示しないようにし、アプリケーションのコンテキストで実行するアクセス権を得ることがないようにして、ファイルとすることでフィッシング詐欺を防止します。 (メモ: MS Edge bug に関連) X-Frame-Options(XFO)- ブラウザーがページを
<frame>,<iframe>,<embed>,<object>の内部に表示することを許可するかを示します。 X-Permitted-Cross-Domain-Policies- クロスドメインポリシーファイル (
crossdomain.xml) を許可するかどうかを指定します。このファイルは、 Adobe の Flash Player、Adobe Acrobat、Microsoft Silverlight、Apache Flex などのクライアントに、同一ドメインポリシーによって制限されているドメイン間のデータを処理する許可を与えるポリシーを定義することができます。詳細については、 Cross-domain Policy File Specification を参照してください。 X-Powered-By- ホスティング環境やその他のフレームワークによって設定される可能性があり、アプリケーションや訪問者に有益ではない情報を含みます。潜在的な脆弱性が発現することを防ぐために、このヘッダーは設定しないでください。
X-XSS-Protection- クロスサイトスクリプティングのフィルタリングを有効化します。
HTTP Public Key Pinning (HPKP)
HTTP Public Key Pinning は非推奨となり、削除されて Certificate Transparency と Expect-CT に置き換えられました。
- Public-Key-Pins (en-US)
- 偽造した証明書による MITM 攻撃の危険性を軽減するため、特定の暗号公開鍵とウェブサーバーを関連付けます。
- Public-Key-Pins-Report-Only (en-US)
- ピンニングに違反する場合でも、ヘッダーで指定した report-uri にレポートを送信して、クライアントからサーバーへの接続は許可します。
メタデータ読み取りリクエストヘッダー
- Sec-Fetch-Site (en-US)
- リクエスト開始元のオリジンと宛先のオリジンとの関係を示すリクエストヘッダーです。これは構造化ヘッダーで、値はトークンであり、取りうる値は
cross-site,same-origin,same-site,noneです。 - Sec-Fetch-Mode (en-US)
- サーバーへのリクエストモードを示すリクエストヘッダーです。これは構造化ヘッダーで、値はトークンであり、取りうる値は
cors,navigate,nested-navigate,no-cors,same-origin,websocketです。 - Sec-Fetch-User (en-US)
- ナビゲーションリクエストがユーザー操作によって起動されたかどうかを示すリクエストヘッダーです。これは構造化ヘッダーであり、論理値で、取りうる値は
?0ならば偽、?1ならば真です。 - Sec-Fetch-Dest (en-US)
- リクエストの宛先を示すリクエストヘッダーです。これは構造化ヘッダーで、値はトークンであり、取りうる値は
audio,audioworklet,document,embed,empty,font,image,manifest,object,paintworklet,report,script,serviceworker,sharedworker,style,track,video,worker,xslt,nested-documentです。
Server-sent event
Last-Event-ID- ...
NEL- 開発者がネットワークエラー報告ポリシーを宣言できるようにする仕組みを定義します。
Ping-From- ...
Ping-To- ...
Report-To- 警告やエラーを送信るためのブラウザーに対するサーバーのエンドポイントを指定するために使用します。
転送エンコーディング
Transfer-Encoding- エンティティをユーザーへ問題なく転送できるエンコード形式を指定します。
- TE (en-US)
- ユーザーエージェントが進んで受け入れる転送エンコーディングを指定します。
- Trailer (en-US)
- 送信者が chunk メッセージの終端に追加フィールドを含めることができます。
WebSocket
その他
Accept-Push-Policy- クライアントはリクエストに対して求めるプッシュポリシーを、リクエスト内で
Accept-Push-Policyヘッダーフィールドを送信することで表現することができます。 Accept-Signature- クライアントは
Accept-Signatureヘッダーフィールドを送信して、利用可能な署名を利用する意図を示したり、対応している署名の種類を示したりすることができます。 Alt-Svc- このサービスにたどり着く他の方法のリストに使用します。
Date- メッセージを生成した日時です。
- Large-Allocation (en-US)
- 読み込み中のページは大量の割り当てが必要であることをブラウザーに伝えます。
LinkLinkエンティティヘッダーフィールドは、 HTTP ヘッダー内の1つ以上のリンクを記述する方法を提供します。意味的には HTML の<link>要素と等価です。Push-PolicyPush-Policyはリクエストを処理するときのプッシュ通知に関するサーバーの動作を定義します。Retry-After- 後続のリクエストを行う前に、ユーザーエージェントがどれだけの期間待つべきかを示します。
SignatureSignatureヘッダーフィールドは、交換のための署名のリストを伝え、それぞれはその署名の権威を決定して、そして更新する方法についての情報を伴います。Signed-HeadersSigned-Headersヘッダーフィールドは、シグネチャに含めるためのレスポンスヘッダーフィールドの順序付きリストを識別します。Server-Timing- 指定されたリクエストとレスポンスのサイクルについて、１つ以上のメトリクス又は説明を通信します。
Service-Worker-Allowed- サービスワーカースクリプトのレスポンスにこのヘッダを含めることで、パス制限を解除するために使用します。
SourceMap- 生成されたコードと ソースマップ を関連付けます。
- Upgrade (en-US)
- Upgrade ヘッダーフィールドに関連する RFC 文書は RFC 7230, section 6.7 です。標準仕様では、現在のクライアント、サーバー、トランスポート層プロトコル接続で別のプロトコルへ更新または変更するための規則を定めています。例えば、このヘッダー標準ではサーバーが Upgrade ヘッダーフィールドを認めて実装すると決める前提で、クライアントが HTTP 1.1 から HTTP 2.0 へ変更することを可能にします。どちらの相手も、 Upgrade ヘッダーフィールドで指定された要件を受け入れる必要はありません。これはクライアントのヘッダーでもサーバーのヘッダーでも使用できます。Upgrade ヘッダーフィールドを指定した場合は、更新オプションを指ヘッダーonnection ヘッダーフィールドも送信者が送信しなければなりません。Connection ヘッダーフィールドについて、詳しくは 前述の RFC のセクション 6.1 をご覧ください。
X-DNS-Prefetch-Control- ユーザーがたどるであろうリンクや、ドキュメントが参照する画像、 CSS、 JavaScript などのリソースのドメイン名解決をブラウザーが事前に行う機能である、 DNS プリフェッチを制御します。
X-Firefox-Spdy- ...
X-Pingback- ...
X-Requested-With- ...
X-Robots-TagX-Robots-Tagヘッダーは、一般の検索エンジンの結果でウェブページをどのように索引付けをするかを示します。このヘッダーは<meta name="robots" content="...">と等価です。X-UA-Compatible- 使用する文書モードを示すために Internet Explorer で使用されています。
協力
新しい項目を書いたり (en-US)、既存のものを改善したりすることにご協力ください。