/
923.txt
248 lines (185 loc) · 12.4 KB
/
923.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
[504] [DFN[[RUBYB[[[転送符号化]]]@en[transfer coding]]]]は、
[[ネットワーク]]上の「[RUBYB[安全な輸送路]@en[safe transport]]」
を確保するために [[payload body]] に適用される、
されることがある、あるいは必要であるかもしれない[RUBYB[符号化変形]@en[encoding transformation]]です
[SRC[>>502]]。
;; [505] [[HTTP]] には[[転送符号化]]の他に[[内容符号化]]がありますが、
[[内容符号化]]が[[表現]]の特性であるのに対し、[[転送符号化]]は[[メッセージ]]の特性です
[SRC[>>502]]。
* 仕様書
[REFS[
- [502] '''[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-4>'''
- [520] [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#page-50>
- [524] [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-8.4>
- [1] [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-8.4>
- [523] [CITE[Hypertext Transfer Protocol (HTTP) Parameters]] ([TIME[2014-06-13 18:52:05 +09:00]] 版) <http://www.iana.org/assignments/http-parameters/http-parameters.xhtml#transfer-coding>
]REFS]
* 転送符号化の指定
[510] [[転送符号化]]は、名前で識別します。名前に加えて零個以上の[[引数]]を指定することができます。
[SRC[>>502]]
[511] この指定は、 [CODE(HTTP)@en[[[Transfer-Encoding:]]]] [[ヘッダー]]や、
[CODE(HTTP)@en[[[TE:]]]] [[ヘッダー]]で使われます。
[512] 名前は、[[字句]]です。[[大文字・小文字不区別]]です。
[[IANA登録簿]]に登録する[RUBYB[べき]@en[ought to]]です。 [SRC[>>502]]
[515] [[引数]]の前には、 [CODE(HTTP)[[[;]]]] が必要です [SRC[>>502]]。
[CODE(HTTP)[[[;]]]] の前後には、 [CODE(HTTP)[[[OWS]]]] を挿入できます [SRC[>>502]]。
[513] [[引数]]は、名前か名前と値の組とされています [SRC[>>502]] が、構文上値は必須となっています。名前と値の間には
[CODE(HTTP)[[[=]]]] が必要です [SRC[>>502]]。名前は[[字句]]、
値は[[字句]]または[[引用文字列]]です [SRC[>>502]]。
[514] [CODE[=]] の前後には [[BWS]] を挿入できます [SRC[>>502]]。
[516] [[引数]]の順序や重複、大文字と小文字、未対応の場合の対処などは言及がありません。
また [[HTTP]] 本体仕様および関連仕様や、実際の用例で、[[引数]]を用いた例はありません。
;; [519] [CODE(HTTP)@en[[[TE:]]]] [[ヘッダー]]には特別な [CODE(HTTP)[[[q]]]]
[[引数]]を指定することができますが、定義上は[[転送符号化]]の[[引数]]とはされていません。
また、他の[[引数]]より後に置かなければならない構文となっています。
[CODE(HTTP)[[[q]]]] [[引数]]では [[BWS]] や[[引用文字列]]は認められていません。
[FIG(railroad)[
= [[字句]]
= *
== [[OWS]]
== [CODE[[[;]]]]
== [[OWS]]
== [[字句]]
== [CODE[[[=]]]]
== |
=== [[字句]]
=== [[引用文字列]]
]FIG]
* 転送符号化名の一覧
[517] [[転送符号化]]の名前には、次のものがあります。
,名前,説明
,[CODE(HTTP)@en[[[chunked]]]],[[chunked]] [[符号化]]
,[CODE(HTTP)@en[[[compress]]]],[[UNIX]] [[compress]]
,[CODE(HTTP)@en[[[x-compress]]]],[[UNIX]] [[compress]]
,[CODE(HTTP)@en[[[deflate]]]],[[deflate]]
,[CODE(HTTP)@en[[[gzip]]]],[[gzip]]
,[CODE(HTTP)@en[[[x-gzip]]]],[[gzip]]
,[CODE(HTTP)@en[[[identity]]]],変形なし
,[CODE(HTTP)@en[[[trailers]]]],[[トレーラー部]]
[518] [CODE(HTTP)@en[[[chunked]]]] は特別な[[転送符号化]]で、 [[HTTP/1.1]]
で実装が義務付けられている他、他の[[転送符号化]]とは異なる要件が色々あります。
[[HTTP/2]] では利用が禁止されています。
[506] [CODE(HTTP)@en[[[trailers]]]] は[[転送符号化]]ではなく、
[CODE(HTTP)@en[[[chunked]]]] のオプションのようなものですが、
[CODE(HTTP)@en[[[TE:]]]] [[ヘッダー]]では[[転送符号化]]と共に指定できます。
([CODE(HTTP)@en[[[Transfer-Encoding:]]]] [[ヘッダー]]には指定できません。)
;; [528] [[IANAREG]] にはありません。
[507] [CODE(HTTP)@en[[[identity]]]] は [[RFC 2616]] にありましたが、
その[[正誤表]]で削除されています。
;; [529] [[内容符号化]]と一部名前が共通していますが、
[[内容符号化]]と[[転送符号化]]は別のものとされていますから、
片方で使えるからといって他方でも使えるとは限りません。
[533] [[転送符号化]]の名前の一覧が >>532 に [[JSON]] 形式で含まれています。
[REFS[
- [532] [CITE@en[data-web-defs/headers.txt at master · manakai/data-web-defs]] ([TIME[2014-09-01 16:23:55 +09:00]] 版) <https://github.com/manakai/data-web-defs/blob/master/doc/headers.txt>
]REFS]
* IANA 登録簿
[508] [[転送符号化]]の名前は [[IANA登録簿]] [SRC[>>523]] があります [SRC[>>524]]。
[509] 元は根拠不詳であり、登録手続きは
> Registration Procedures: First Come First Served with specification recommended
([[先来先給]]、仕様書推奨) とされていました。
[525] その後 [[RFC 7230]] が定義するようになり、登録手続きは [[IETF Review]]
に変更されています。
[526] [[内容符号化]]と同じ名前は、同じ[[符号化]]でないと使ってはいけないことになっています
[SRC[>>524, >>1]]。
* 処理
[521] [[串]]は、[[転送符号化]]を適用したり、除去したりしてから[[転送]]して構いません
[SRC[>>520]]。
;; [522] 特に [[HTTP/1.1]] から [[HTTP/1.0]] へと[[転送]]する時には、
すべての[[転送符号化]]を除去することになります。
* セキュリティー
[2] [[圧縮]]を用いると、 [[BREACH]] 攻撃に使われる危険性があります。
[[内容符号化]]とは違って[[転送符号化]]は送信者が完全に制御することはできませんから、
特に注意が必要かもしれません。実装は[[圧縮]]を使わないべきかもしれません。
[[利用者]]や[[著者]]は[[圧縮]]を使う可能性がある[[プロキシ]]に接続しないよう注意するべきかもしれません。
* 歴史
[FIG(quote)[
[FIGCAPTION[
[503] RFC 2068・2616 (HTTP/1.1) 3.6 Transfer Codings
]FIGCAPTION]
> Transfer[INS[-]]coding values are used to indicate an encoding
transformation that has been, can be, or may need to be applied to an
entity-body in order to ensure "safe transport" through the network.
This differs from a content coding in that the transfer[INS[-]]coding is a
property of the message, not of the original entity.
[CODE(ABNF)[transfer-coding]] 値は、ネットワークを通した「安全な輸送」
を確保するために [CODE(ABNF)[entity-body]] に適用している、
適用することができる、あるいは適用する必要がある符号化変形を示すのに使います。
転送符号化はメッセージの特性であってもとの実体の特性ではないという点において、
転送符号化は[[内容符号化]]と異なります。
>
- transfer-coding = "chunked" | transfer-extension
- transfer-extension = [INS[token *( ";" parameter )]]
[INS[
> Parameters are in the form of attribute/value pairs.
引数は属性・値の組の形です。
>
- parameter = attribute "=" value
- attribute = token
- value = token | quoted-string
]INS]
> All transfer-coding values are case-insensitive. HTTP/1.1 uses
transfer[INS[-]]coding values [INS[in the TE header field (section 14.39) and]]
in the Transfer-Encoding header field (section [DEL[14.40]] [INS[14.41]]).
すべての [CODE(ABNF)[transfer-coding]] 値は大文字・小文字を区別しません。
HTTP/1.1 は [INS[[CODE(HTTP)[[[TE]]]] 頭欄と]] [CODE(HTTP)[[[Transfer-Encoding]]]]
頭欄で [CODE(ABNF)[transfer-coding]] 値を使います。
[INS[
> Whenever a transfer-coding is applied to a message-body, the set of
transfer-codings MUST include "chunked", unless the message is
terminated by closing the connection. When the "chunked" transfer-coding is used, it MUST be the last transfer-coding applied to the
message-body. The "chunked" transfer-coding MUST NOT be applied more
than once to a message-body. These rules allow the recipient to
determine the transfer-length of the message (section 4.4).
[CODE(ABNF)[[[message-body]]]] が [CODE(ABNF)[transfer-coding]]
に適用する時は常に、 [CODE(ABNF)[transfer-coding]]
の集合はメッセージを[[接続]]を閉じることによって終端する場合を除き、
[CODE(HTTP)[[[chunked]]]] を含まなければ'''なりません'''。
[CODE(HTTP)[chunked]] を使うときは、 [CODE(ABNF)[message-body]]
に適用する最後の [CODE(ABNF)[transfer-coding]]
でなければ'''なりません'''。
[CODE(HJTTP)[chunked]] [CODE(ABNF)[transfer-coding]] は、一つの
[CODE(ABNF)[message-body]] に複数回適用しては'''なりません'''。
これらの規則は受信者がメッセージの [CODE(ABNF)[[[transfer-length]]]]
を決定することを可能とします。
]INS]
> Transfer[INS[-]]codings are analogous to the Content-Transfer-Encoding
values of MIME [INS[ [7] ]], which were designed to enable safe transport of
binary data over a 7-bit transport service. However, safe transport
has a different focus for an 8bit-clean transfer protocol. In HTTP,
the only unsafe characteristic of message-bodies is the difficulty in
determining the exact body length (section 7.2.2), or the desire to
encrypt data over a shared transport.
[CODE(ABNF)[transfer-coding]] は 7ビット輸送サービス上でバイナリ・データを安全に輸送することを可能とするために設計された
[[MIME]] の [CODE(MIME)[[[Content-Transfer-Encoding]]]] に相当するものです。
しかし、安全な輸送は8ビット安全転送プロトコルでは違った焦点があります。
HTTP では、 [CODE(ABNF)[message-body]] の唯一の非安全な性質は正確な本体の長さを決定することの困難性や共有輸送路上でデータを暗号化したいという希望です。
[INS[
> The Internet Assigned Numbers Authority (IANA) acts as a registry for
transfer-coding value tokens. Initially, the registry contains the
following tokens: "chunked" (section 3.6.1), [DEL[[INS[{2616; Errata で削除}]] "identity" (section 3.6.2),]] "gzip" (section 3.5), "compress" (section 3.5), and "deflate" (section 3.5).
IANA が [CODE(ABNF)[transfer-coding]] 値字句の登録簿として機能します。
最初に、登録簿は次の字句を含みます :
[CODE(HTTP)[chunked]], [DEL[[CODE(HTTP)[[[identity]],]]]]
[CODE(HTTP)[[[gzip]]]], [CODE(HTTP)[[[compress]]]],
[CODE(HTTP)[[[deflate]]]]。
> New transfer-coding value tokens SHOULD be registered in the same way
as new content-coding value tokens (section 3.5).
新しい [CODE(ABNF)[transfer-coding]] 値字句は新しい
[CODE(ABNF)[content-coding]] 値字句と同じ方法で登録する'''べきです'''。
> A server which receives an entity-body with a transfer-coding it does
not understand SHOULD return 501 (Unimplemented), and close the
connection. A server MUST NOT send transfer-codings to an HTTP/1.0 client.
理解しない [CODE(ABNF)[transfer-coding]] の [CODE(ABNF)[entity-body]]
を受信したサーバーは、 [CODE(HTTP)[[[501]] (mijissou)]]
を返し、接続を閉じる'''べきです'''。サーバーは HTTP/1.0
クライアントに [CODE(ABNF)[transfer-coding]] を送っては'''なりません'''。
]INS]
* 3.6.1 Chunked Transfer Coding
→[CODE(WikiPage)[[[chunked]]]]
]FIG]
* 実装
[531] [[転送符号化]]の名前の大文字と小文字を区別する実装もありました [SRC[>>530]]。
[REFS[
- [530] [CITE@en[HTTP Chunking peculiarities]] ([[Martin Holst Swende]] 著, [TIME[2014-04-03 17:07:05 +09:00]] 版) <http://martin.swende.se/blog/HTTPChunked.html>
]REFS]