466.txt

[16] [DFN[[CODE(HTTP)@en[[[Via:]]]]]] [[ヘッダー]]は、[[鯖]]と[[クライアント]]の間に[[中間器]]が存在することを示すものです。

[18] [CODE(HTTP)@en[[[Via:]]]] は、[[メッセージ]]の[[転送]]の追跡や、
[[要求]]のループの防止や、[[中間器]]の[[プロトコル]]能力のチェックに使うことができます
[SRC[>>17]]。

* 仕様書

[REFS[
- [17] '''[CITE@en[RFC 7230 - Hypertext Transfer Protocol (HTTP/1.1): Message Syntax and Routing]] ([TIME[2014-06-07 01:59:35 +09:00]] 版) <https://tools.ietf.org/html/rfc7230#section-5.7.1>'''
- [5] [CITE@en[RFC 7231 - Hypertext Transfer Protocol (HTTP/1.1): Semantics and Content]] ([TIME[2014-08-07 05:54:02 +09:00]] 版) <https://tools.ietf.org/html/rfc7231#section-9.6>
- [44] [CITE@en[RFC 2326 - Real Time Streaming Protocol (RTSP)]] ([TIME[2014-04-06 08:10:59 +09:00]] 版) <http://tools.ietf.org/html/rfc2326#section-12.43>
- [40] [CITE@en[RFC 3261 - SIP: Session Initiation Protocol]] ([TIME[2014-06-22 04:16:34 +09:00]] 版) <http://tools.ietf.org/html/rfc3261#section-8.1.1.7>
- [41] [CITE@en[RFC 3261 - SIP: Session Initiation Protocol]] ([TIME[2014-06-22 04:16:34 +09:00]] 版) <http://tools.ietf.org/html/rfc3261#page-232>
]REFS]

* 文脈

[25] [[串]]は、[[メッセージ]]を[[転送]]する際に [CODE(HTTP)@en[[[Via:]]]]
[[ヘッダー]]を送信しなければ[['''なりません''']]。 [SRC[>>17]]

[26] [[HTTP]] から [[HTTP]] への[[関門]]は、[[内向き]]の[[要求メッセージ]]を[[転送]]する際に
[CODE(HTTP)@en[[[Via:]]]] [[ヘッダー]]を送信しなければ[['''なりません''']]。
また、[[外向き]]の[[応答メッセージ]]を[[転送]]する際に
[CODE(HTTP)@en[[[Via:]]]] [[ヘッダー]]を送信して構いません。 [SRC[>>17]]

[19] 複数の [CODE(HTTP)@en[[[Via:]]]] [[ヘッダー]]を指定することができます。

* 構文

[20] [[欄値]]は、1つ以上の値の[[リスト]] ([CODE[#]]) です [SRC[>>17]]。

[24] 複数の値が記述されている場合、それぞれの値が[[メッセージ]]を[[転送]]したそれぞれの[[串]]や[[関門]]を表します。
[[中間器]]は自身の情報を末尾に追記していくため、
[[転送]]が行われた順に並ぶことになります。 [SRC[>>17]]

[FIG(railroad)[
= 値
= *
== [[OWS]]
== [CODE[[[,]]]]
== [[OWS]]
== 値
]FIG]

[21] それぞれの値は、[[プロトコル]]、[[RWS]]、[[受信者][プロキシの名前]]、[[RWS]]、
[[注釈]]を並べたものです。ただし末尾の [[RWS]] と[[注釈]]は省略できます。 [SRC[>>17]]

[FIG(railroad)[
= プロトコル
= [[RWS]]
= [[受信者][プロキシの名前]]
= ?
== [[RWS]]
== [[注釈]]
]FIG]

[22] [[プロトコル]]は、プロトコル名、[CODE[[[/]]]]、[[プロトコルの版]]を並べたものですが、
名前と [CODE[[[/]]]] は省略できます。省略された場合は [[HTTP]]
を表します。 [SRC[>>17]]

;; [43] [CODE(ABNF)@en[[[protocol]]]] 構文とは違って、[[プロトコルの版]]の側を省略することはできません。

;; [42] [[SIP]] ではどちらも省略できません [SRC[>>41]]。更に、
[CODE[[[/]]]] と[[トランスポート層プロトコル]]の名前も指定しないといけない [SRC[>>41]]
ことになっています。

[27] [[プロトコル]]は、[[メッセージ]]の[[上流]]の[[送信者]]が使ったものを示します。
[SRC[>>17]]

;; [39] [[[CODE(ABNF)@en[protocol]] (HTTP)]] や[[プロトコルの版]]も参照してください。

** 注釈

[28] [[注釈]]は、 [CODE(HTTP)@en[[[Server:]]]] や [CODE(HTTP)@en[[[User-Agent:]]]]
に相当するもので、[[受信者]]のソフトウェアを表します。 [SRC[>>17]]

[36] [[Guidelines for Web Content Transformation Proxies 1.0]] に従う[[串]]は、
[DFN[[CODE[[[http://www.w3.org/ns/ct]]]]]] という値の[[注釈]]を指定する[['''べきです''']]
[SRC[>>35]]。

[37] [[受信者]]は、[[注釈]]を削除してから[[転送]]して構いません [SRC[>>17]]。

;; [38] [[Guidelines for Web Content Transformation Proxies 1.0]] は、
現代の[[串]]でそのような処置は必要ないだろうと指摘し、
削除する[['''べきではない''']]としています [SRC[>>35]]。

* 処理モデル

[32] [[防火壁]]の出入口となっている[[中間器]]は、
明示的にそのように設定されている場合を除き、
[[防火壁]]内の[[ホスト]]や[[ポート]]を[[転送]]する[['''べきではありません''']]。
その場合には、[[防火壁]]内の[[ホスト]]は適当なペンネームに置き換える[['''べきです''']]。
[SRC[>>17]]

[33] [[中間器]]は、同じ[[プロトコル]]の値の列を結合しても構いません。
しかしそれは同じ組織の管理下にある場合で、既にペンネームに置き換えられている場合のみとする[['''べきです''']]。
異なる[[プロトコル]]のものを結合しては[['''なりません''']]。 [SRC[>>17]]

[EG[
[34] 例えば、
[PRE(HTTP example code)[
Via: 1.0 ricky, [MARK[1.1 ethel, 1.1 fred]], 1.0 lucy
]PRE]
... を
[PRE(HTTP example code)[
Via: 1.0 ricky, [MARK[1.1 mertz]], 1.0 lucy
]PRE]
... としても構いません [SRC[>>17]]。
]EG]

* 歴史

** [CODE(822)[Via:]] ヘッダー (電子メイル)

[2] [[電子メイル]]でも大昔に使われていたらしい。

*** 関連

[46] [CODE(822)@en[[[Received:]]]] も参照。

*** 例

[3] [SAMP(822)[Via:  IBM-SJ; 25 Apr 83 19:09-PDT]]

** HTTP への導入

[7] [CODE(HTTP)@en[[[Via:]]]] は初期の [[HTTP]] で提案されていた
[CODE(HTTP)@en[[[Forwarded:]]]] のかわりとして導入されました。

;; [8] 当時の経緯は [CODE(HTTP)@en[[[Forwarded:]]]] を参照。

;; [10] その後新たに [CODE(HTTP)@en[[[Forwarded:]]]] が追加されています。

[FIG(quote)[
[FIGCAPTION[
[35] RFC 2068 (HTTP/1.1) 14.44; RFC 2616 (HTTP/1.1) 14.45  Via
]FIGCAPTION]

> The Via general-header field MUST be used by gateways and proxies to
indicate the intermediate protocols and recipients between the user
agent and the server on requests, and between the origin server and
the client on responses. It is analogous to the "Received" field of
RFC 822 [INS[ [9] ]] and is intended to be used for tracking message forwards,
avoiding request loops, and identifying the protocol capabilities of
all senders along the request/response chain.

[1] [CODE(HTTP)[Via]] 一般頭欄は、関門や串が、
[[利用者エージェント]]と要求先サーバー間の、
および源サーバーと応答の顧客間の媒介プロトコル及び受信者を示すために、
使用し'''なければなりません'''。
これは RFC 822 の [CODE(822)[Received]] 欄に対応していて、
メッセージの転送の追跡や要求の循環の回避, 
要求・応答の鎖に居る全ての送信者のプロトコル能力の特定に使うことを目的としています。

>
- Via =  "Via" ":" 1#( received-protocol received-by [ comment ] )

>
- received-protocol = [ protocol-name "/" ] protocol-version
- protocol-name     = token
- protocol-version  = token
- received-by       = ( host [ ":" port ] ) | pseudonym
- pseudonym         = token

> The received-protocol indicates the protocol version of the message
received by the server or client along each segment of the
request/response chain. The received-protocol version is appended to
the Via field value when the message is forwarded so that information
about the protocol capabilities of upstream applications remains
visible to all recipients.

[11] [CODE(HTTP)[[VAR(ABNF)[received-protocol]]]]
は要求・応答の鎖の各部分のサーバー或いはクライアントが受信したメッセージのプロトコルの版を示します。
[CODE(HTTP)[[VAR(ABNF)[received-protocol]]]]
の版は、メッセージが転送された時に 
[CODE(HTTP)[Via]] 欄の値に追加されるので、
上流応用のプロトコル能力についての情報が全ての受信者に見えたままになります。

> The protocol-name is optional if and only if it would be "HTTP". The
received-by field is normally the host and optional port number of a
recipient server or client that subsequently forwarded the message.
However, if the real host is considered to be sensitive information,
it MAY be replaced by a pseudonym. If the port is not given, it MAY
be assumed to be the default port of the received-protocol.

[CODE(HTTP)[[VAR(ABNF)[protocol-name]]]] は、
[CODE(HTTP)[[CODE(ABNF)["HTTP"]]]]
である場合に限って省略可能です。
[CODE(HTTP)[[VAR(ABNF)[received-by]]]]
欄は、通常、続けてメッセージを転送する、
受信したサーバー或いは顧客のホストと省略可能で[RUBY[港] [ポート]]番号です。
しかし、本当のホストが繊細な情報であると考えられる時は、 [CODE(HTTP)[[VAR(ABNF)[pseudonym]]]]
(偽名)に置き換えても構いません。港が無い場合、 [CODE(HTTP)[[VAR(ABNF)[received-protocol]]]]
の既定値と仮定しても'''構いません'''。

> Multiple Via field values represent[INS[s]] each proxy or gateway that has
forwarded the message. Each recipient MUST append its information
such that the end result is ordered according to the sequence of
forwarding applications.

複数の [CODE(HTTP)[Via]] 欄値は、
メッセージを転送した各串・関門を表します。
各受信者はその情報を後置して、結果として転送した応用の順に並ぶように
し'''なければなりません'''。

> Comments MAY be used in the Via header field to identify the software
of the recipient proxy or gateway, analogous to the User-Agent and
Server header fields. However, all comments in the Via field are
optional and MAY be removed by any recipient prior to forwarding the message.

受信した[[串]]や[[関門]]のソフトウェアを識別するために、
[CODE(HTTP)[[[User-Agent]]]] 頭欄や [CODE(HTTP)[[[Server]]]]
頭欄と同様に、 [CODE(HTTP)[Via]] 頭欄で[[注釈]]を使って'''構いません'''。
しかし、 [CODE(HTTP)[Via]] 欄内のすべての注釈は省略可能であり、
どの受信者もメッセージの転送の前に削除して'''構いません'''。

> For example, a request message could be sent from an HTTP/1.0 user
agent to an internal proxy code-named "fred", which uses HTTP/1.1 to
forward the request to a public proxy at nowhere.com, which completes
the request by forwarding it to the origin server at www.ics.uci.edu.
The request received by www.ics.uci.edu would then have the following
Via header field:

例えば、要求メッセージが [[HTTP/1.0]] 利用者エージェントから
[SAMP[fred]] という符号名の内部串に送られて、こいつが HTTP/1.1
を使ってその要求を [SAMP[nowhere.com]] の公開串に転送して、
こいつはそれを [SAMP[www.ucs.uci.edu]] の[[起源鯖]]に転送することで要求を完了したとします。
[SAMP[www.ucs.uci.edu]] がj苦心した要求はこの時次の [CODE(HTTP)[Via]]
頭欄を持ちます:

>
- Via: 1.0 fred, 1.1 nowhere.com (Apache/1.1)

> Proxies and gateways used as a portal through a network firewall
SHOULD NOT, by default, forward the names and ports of hosts within
the firewall region. This information SHOULD only be propagated if
explicitly enabled. If not enabled, the received-by host of any host
behind the firewall SHOULD be replaced by an appropriate pseudonym for that host.

ネットワーク防火壁をくぐる玄関口として使われる串や関門は、
既定では、防火壁領域内のホストの名前と[[ポート]]を転送する'''べきではありません'''。
この情報は、陽に有効にしたときのみつける'''べきです'''。
有効にしていなければ、防火壁内のすべての [CODE(ABNF)[received-by]] ホストは、
そのホストの適切な [CODE(ABNF)[pseudonym]] で置換する'''べきです'''。

> For organizations that have strong privacy requirements for hiding
internal structures, a proxy MAY combine an ordered subsequence of
Via header field entries with identical received-protocol values into
a single such entry. For example,

内部構造を隠す強い個人情報保護要件を持つ組織では、
串は、同一の [CODE(ABNF)[received-protocol]] 値の
[CODE(HTTP)[Via]] 頭欄項目の順序付き並びを一つの項目に結合して'''構いません'''。
例えば、

>
- Via: 1.0 ricky, 1.1 ethel, 1.1 fred, 1.0 lucy

> could be collapsed to

は

>
- Via: 1.0 ricky, 1.1 mertz, 1.0 lucy

とまとめることができます。

> Applications SHOULD NOT combine multiple entries unless they are all
under the same organizational control and the hosts have already been
replaced by pseudonyms. Applications MUST NOT combine entries which
have different received-protocol values.

応用は、複数の項目がすべて同じ組織の統制の元にあり、
ホストが既に [CODE(ABNF)[pseudonyms]] に置換されているのでない限り、
複数の項目を結合する'''べきではありません'''。応用は、異なる
[CODE(ABNF)[received-protocol]] 値の項目を結合しては'''なりません'''。
]FIG]

[48] [CODE(HTTP)@en[[[X-Connfrom:]]]] は[[持続的接続]]その他の [[HTTP]]
追加機能に[[串]]が対応しているか明示させるために新たな[[ヘッダー]]を導入し、
[[ホスト名]]や機能を列挙させるという提案でした。

;; [49] [CODE(HTTP)@en[[[Via:]]]] [[ヘッダー]]と似ていますが、なぜか言及はありません。

[REFS[
- [15] [CITE@en[Guidelines for Web Content Transformation Proxies 1.0]]
( ([TIME[2010-10-22 17:20:31 +09:00]] 版))
<http://www.w3.org/TR/2010/NOTE-ct-guidelines-20101026/#sec-via-headers>
]REFS]

* 関連

[45] [CODE(HTTP)@en[[[X-Forwarded-*:]]]] や [CODE(HTTP)@en[[[Forwarded:]]]]
も参照。

* 例

[EG[
[29] 例えば [[HTTP/1.0]] [[利用者エージェント]]が「fred」
という内部[[串]]に[[要求メッセージ]]を送信し、 fred
が [[HTTP/1.1]] により公開[[串]]「p.example.net」に[[転送]]し、
そこから更に[[起源鯖]]に[[転送]]された場合、
[[起源鯖]]が見る [CODE(HTTP)@en[[[Via:]]]] [[ヘッダー]]は、
[PRE(HTTP example code)[
Via: 1.0 fred, 1.1 p.example.net
]PRE]
... となります [SRC[>>17]]。
]EG]

[4] ''Comments on AgentGripes'' <http://web.archive.org/web/20011019120517/http://www.dais.is.tohoku.ac.jp/logs/comment.html#via>

[12]
[SAMP(HTTP)[Via: 1.1 cachesv539 (NetCache NetApp/5.5R5D3)]]
([[名無しさん]] [WEAK[2004-07-12 12:39:09 +00:00]])

[13] [CITE@en[HTTP/1.1 Via header]] ([TIME[2009-07-19 12:11:49 +09:00]] 版) <http://www.http-stats.com/Via>

[14] >>13 ほとんどは protocol-name を省略していますが、
>
- Via: HTTP/1.1 10.86.124.17 (IBM-PROXY-WTE)
- Via: HTTP/1.1 ootemachi2-ci2 (Traffic-Server/5.2.1a-fj [c s f ])

のように省略していないものや

>
- Via: CN-5000, CN-5000

のようにプロトコル名が完全に省略されているもの (仕様違反) もありますね。


[47] [CITE@en[''''''[''''''MS-SIPRE'''''']'''''': Via Header Field Extensions]]
( ([TIME[2014-11-03 07:04:36 +09:00]] 版))
<http://msdn.microsoft.com/en-us/library/dd906564(v=office.12).aspx>

[50] [CITE[Session Initiation Protocol (SIP) Parameters]]
( ([TIME[2014-11-13 16:25:40 +09:00]] 版))
<http://www.iana.org/assignments/sip-parameters/sip-parameters.xhtml#sip-parameters-12>

[51] [CITE@en[RFC 8055 - Session Initiation Protocol (SIP) Via Header Field Parameter to Indicate Received Realm]]
([TIME[2017-02-03 01:02:37 +09:00]])
<https://tools.ietf.org/html/rfc8055>


[6] [TIME[2023-07-16T06:44:27.300Z]]

>
[PRE(HTTP code)[
Server: deno/gcp-asia-northeast2
Via: http/2 edgeproxy
]PRE]