Skip to content

Commit 1f89e7f

Browse files
[http](RFC9205) 諸々の編集
1 parent 037c4ec commit 1f89e7f

File tree

1 file changed

+71
-49
lines changed

1 file changed

+71
-49
lines changed

http-app-bcp-ja.html

+71-49
Original file line numberDiff line numberDiff line change
@@ -121,6 +121,7 @@
121121
HTTPcookieExt:http-cookie-ext-ja.html
122122
RFC6454:RFC6454-ja.html
123123
CAPABILITY-URLS:capability-urls-ja.html
124+
HTTPquery:http-query-method-ja.html
124125

125126
●●words_table
126127

@@ -167,6 +168,7 @@
167168
優先度:priority::~
168169
優先度をどう選ぶか:how chooses to prioritize
169170
早期:early::~
171+
~transport用の~port:transport port
170172

171173
●保安
172174
ambient:
@@ -244,7 +246,7 @@
244246
機能:function:~
245247
信頼性:reliability:~
246248
節約-:save:~
247-
解法:solution:~
249+
解決策:solution:~
248250
努める:striveする:~
249251
多岐:diverse:~
250252
~~多岐に渡る:vary widely
@@ -886,7 +888,7 @@ <h2 title="Is HTTP Being Used?">2. ~HTTPは利用されているか?</h2>
886888
</p>
887889
<ul>
888890
<li>
889-
~transport~portに[
891+
~transport用の~portに[
890892
80 / 443
891893
]【すなわち, `http$c / `https$c 用の既定の~port番号】を利用するもの。
892894
@@ -970,7 +972,7 @@ <h3 title="Non-HTTP Protocols">2.1. 非~HTTP~protocol</h3>
970972
そのような仕様は、
971973
~HTTPの[
972974
~URI~scheme/
973-
~transport~port/
975+
~transport用の~port/
974976
~ALPN~protocol~ID/
975977
~IANA~registry
976978
]を利用してはナラナイ
@@ -1394,7 +1396,7 @@ <h3 title="Specifying Server Behaviour">4.2. ~serverの挙動の指定-法</h3>
13941396
<p>
13951397
応用は、[
13961398
`~link関係$により識別され,指定された挙動を実装する`資源$
1397-
の集合を
1399+
たちが成す集合を
13981400
これらの~protocol要素で構成して定義する
13991401
]ことにより,自身の運用を定義できる
14001402
— 次に挙げるものを含め:
@@ -1596,20 +1598,31 @@ <h3 title="Specifying URLs">4.4. ~URLの指定-法</h3>
15961598
</p>
15971599

15981600
<p>
1599-
したがって,仕様の書き手は、[
1600-
`~client$が応用の~URLを発見する
1601-
]ことを許容するための何らかの仕組みが必要になる。
1602-
加えて、[
1601+
したがって,仕様の書き手は、
1602+
次を指定する必要がある:
1603+
1604+
Therefore, the specification writer needs\
1605+
</p>
1606+
<ul>
1607+
<li>
1608+
応用の~URLを発見することを`~client$に許容するための,何らかの仕組み
1609+
1610+
some mechanism to allow clients to discover an application's URLs.\
1611+
</li>
1612+
<li>
16031613
応用に利用されるべき~URL~scheme(たち)
1604-
]および[
1614+
1615+
Additionally, they need to specify which URL scheme(s) the application should be used with\
1616+
</li>
1617+
<li>
16051618
応用は[
16061619
専用な~port,
16071620
~HTTP用の既定の~port【!reuse HTTP's port(s)】
16081621
]どちらを利用するか
1609-
]も指定する必要がある。
16101622
1611-
Therefore, the specification writer needs some mechanism to allow clients to discover an application's URLs. Additionally, they need to specify which URL scheme(s) the application should be used with and whether to use a dedicated port or to reuse HTTP's port(s).
1612-
</p>
1623+
and whether to use a dedicated port or to reuse HTTP's port(s).
1624+
</li>
1625+
</ul>
16131626

16141627
<section id="discovering-an-applications-urls">
16151628
<h4 title="Discovering an Application's URLs">4.4.1. 応用の~URLの発見-法</h4>
@@ -1720,11 +1733,9 @@ <h4 title="Considering URI Schemes">4.4.2. ~URI~schemeを考慮するとき</h4>
17201733
]を使役することになる。
17211734
17221735
認証, 完全性, 機密性
1723-
]を供する, および
1724-
大規模な監視~攻撃を軽減するには、
1725-
"`https^c" が`推奨される^2119
1726-
`RFC7258$r
1727-
1736+
]を供するため, および
1737+
大規模な監視~攻撃 `RFC7258$r を軽減するためには、
1738+
"`https^c" が`推奨される^2119。
17281739
17291740
Applications that use HTTP will typically employ the "http" and/or "https" URI schemes. "https" is RECOMMENDED to provide authentication, integrity, and confidentiality, as well as to mitigate pervasive monitoring attacks [RFC7258].
17301741
</p>
@@ -1742,7 +1753,7 @@ <h4 title="Considering URI Schemes">4.4.2. ~URI~schemeを考慮するとき</h4>
17421753
~Web~browserは、
17431754
改変されない限り,新たな~schemeを~supportしない。
17441755
~Web~browserで新たな~URI~schemeを登録することはアリであるが
1745-
(例:`HTML$r における `registerProtocolHandler()^c,
1756+
(例:`HTML$r における `registerProtocolHandler()@~HTMLnavigator#custom-handlers$c,
17461757
あるいは いくつかの~proprietaryな~approachで)、
17471758
これらの仕組み用の~supportは、
17481759
すべての~browserから共有されるとは限らず,それらの能力は~browserごとに変わり得る。
@@ -1765,8 +1776,9 @@ <h4 title="Considering URI Schemes">4.4.2. ~URI~schemeを考慮するとき</h4>
17651776
<li>
17661777
~URLは、
17671778
~HTTPによる産物~内で共通的に生じることに加え,
1768-
自動的に(例: `Location$h 応答~header内で)`生成-$されることが多いので、
1769-
新たな~schemeが一貫して利用されることを確保するのは,困難にもなり得る。
1779+
自動的に(例: `Location$h 応答~header内で)`生成-$されることが多いので、[
1780+
新たな~schemeが一貫して利用される
1781+
]ことを確保することは,困難にもなり得る。
17701782
17711783
Because URLs commonly occur in HTTP artefacts and are often generated automatically (e.g., in the Location response header field), it can be difficult to ensure that the new scheme is used consistently.
17721784
</li>
@@ -1776,10 +1788,10 @@ <h4 title="Considering URI Schemes">4.4.2. ~URI~schemeを考慮するとき</h4>
17761788
]~URLを利用して可用になる。
17771789
それらの~URLは、[
17781790
~security/運用能
1779-
]の課題が在り得るような利用に “漏洩し得る”
1791+
]の課題が在り得るような利用に “漏洩-” し得る
17801792
例えば,新たな~schemeを利用しても、[
17811793
要請が “通常の” ~Web~siteへは送信されない
1782-
ことを確保するのは,失敗する見込みが高い。
1794+
ことを確保することは,失敗する見込みが高い。
17831795
17841796
The resources identified by the new scheme will still be available using "http" and/or "https" URLs. Those URLs can "leak" into use, which can present security and operability issues. For example, using a new scheme to ensure that requests don't get sent to a "normal" Web site is likely to fail.
17851797
</li>
@@ -1834,8 +1846,8 @@ <h4 title="Choosing Transport Ports">4.4.3. ~transport用の~portを選ぶとき
18341846
— あるいは、
18351847
他の~portにも配備できる。
18361848
この裁定は、
1837-
配備~時点に下されることもあれば,応用の仕様により奨励されることもあろう
1838-
(例:ある~portを,その応用~用として登録することにより)。
1849+
配備~時点に為されることもあれば,応用の仕様により奨励されることもあろう
1850+
(例:ある~portを,当の応用~用として登録することにより)。
18391851
18401852
Applications can use the applicable default port (80 for HTTP, 443 for HTTPS), or they can be deployed upon other ports. This decision can be made at deployment time or might be encouraged by the application's specification (e.g., by registering a port for that application).
18411853
</p>
@@ -1906,7 +1918,7 @@ <h3 title="Using HTTP Methods">4.5. ~HTTP~methodの利用-法</h3>
19061918
</p>
19071919

19081920
<p>
1909-
歴史的に,一部の応用(例: `RFC4791$r )は応用に特有な~methodを定義したが、
1921+
歴史的に,一部の応用(例: `RFC4791$r )は自身に特有な~methodを定義したが、
19101922
`HTTP$r は,今やこれを禁止する。
19111923
19121924
While historically some applications (e.g., [RFC4791]) have defined application-specific methods, [HTTP] now forbids this.
@@ -1930,9 +1942,7 @@ <h4 title="GET">4.5.1. `GET^m</h4>
19301942

19311943
<p>
19321944
`GET$m は、
1933-
最も[
1934-
共通的な, かつ有用な
1935-
]~HTTP~methodである。
1945+
最も共通的な, かつ最も有用な~HTTP~methodである。
19361946
その検索取得の意味論は、[
19371947
~caching, 副作用が無い~link法
19381948
]を許容する
@@ -1950,7 +1960,7 @@ <h4 title="GET">4.5.1. `GET^m</h4>
19501960
これは,~Web閲覧において馴染みな~patternであり、
19511961
その結果は~cacheできるので,高価になることが多い処理nの効率を改善する。
19521962
しかしながら,~URIの構文は制限されているので、
1953-
`GET$m で~queryを表出するのは手に余る事例もあるかもしれない
1963+
`GET$m で~queryを表出することは手に余る事例もあるかもしれない
19541964
— 特に、
19551965
~queryを成すある項が~binary~dataで形成される場合,
19561966
~URI構文に適合するよう符号化する必要がある。
@@ -1993,6 +2003,12 @@ <h4 title="GET">4.5.1. `GET^m</h4>
19932003
In these cases, an application using HTTP might consider using POST to express queries in the request's content; doing so avoids encoding overhead and URL length limits in implementations. However, in doing so, it should be noted that the benefits of GET such as caching and linking to query results are lost. Therefore, applications using HTTP that require support for POST queries ought to consider allowing both methods.
19942004
</p>
19952005

2006+
<p class="trans-note">
2007+
参考:
2008+
これらの課題に取組む~methodとして,
2009+
`QUERY@~HTTPquery#query$m が提案されている。
2010+
</p>
2011+
19962012
<p>
19972013
`GET$m 要請の処理により,当の応用の状態が変更される, その他の[
19982014
`~client$にとって有意になり得る副作用
@@ -2095,7 +2111,7 @@ <h4 title="OPTIONS">4.5.2. `OPTIONS^m</h4>
20952111
<li>
20962112
~server-wide~metadata用に、
20972113
`周知な~URI^cite【 "`/.well-known/^c" 】 `WELL-KNOWN-URI$r を作成するか,
2098-
適切になるなら既存のものを利用する(例: host-meta `RFC6415$r )。
2114+
適切になるなら既存のそれ(例: host-meta【 "`/.well-known/host-meta^c" 】 `RFC6415$r )を利用する
20992115
21002116
For server-wide metadata, create a well-known URI [WELL-KNOWN-URI] or use an already existing one if appropriate (e.g., host-meta [RFC6415]).
21012117
</li>
@@ -2123,12 +2139,13 @@ <h4 title="OPTIONS">4.5.2. `OPTIONS^m</h4>
21232139
<h3 title="Using HTTP Status Codes">4.6. ~HTTP状態s~codeの利用-法</h3>
21242140

21252141
<p>
2126-
`状態s~code$は、
2142+
`状態s~code$は、
21272143
汎用な~HTTP~component
21282144
— `~cache$, `媒介者$, `~client$など —
2129-
の便益, および応用~自身のために意味論を伝達する。
2145+
および,応用~自身
2146+
]の便益のために意味論を伝達する。
21302147
しかしながら、
2131-
それらの利用にあたって応用が遭遇し得る陥穽がいくつかある
2148+
それらの利用にあたっては,応用が遭遇し得る陥穽もいくつかある
21322149
21332150
HTTP status codes convey semantics both for the benefit of generic HTTP components -- such as caches, intermediaries, and clients -- and applications themselves. However, applications can encounter a number of pitfalls in their use.
21342151
</p>
@@ -2164,8 +2181,8 @@ <h3 title="Using HTTP Status Codes">4.6. ~HTTP状態s~codeの利用-法</h3>
21642181
適用-可能な状態s~codeの有限な空間が枯渇する状況に至ることが多い。
21652182
これは転じて,例えば次のような不良な実施へ導く
21662183
⇒#
2167-
新たな,応用に特有な状態s~codeを創出すること
2168-
既存の状態s~codeを,その意味論と当の応用の意味論との~~関連性が希薄でしかないのに利用すること
2184+
新たな,応用に特有な状態s~codeを創出する
2185+
既存の状態s~codeを,その意味論と当の応用の意味論との~~関連性が希薄でしかないのに利用する
21692186
21702187
Furthermore, mapping application errors to individual HTTP status codes one-to-one often leads to a situation where the finite space of applicable HTTP status codes is exhausted. This, in turn, leads to a number of bad practices -- including minting new, application-specific status codes or using existing status codes even though the link between their semantics and the application's is tenuous at best.
21712188
</p>
@@ -2289,7 +2306,7 @@ <h4 title="Redirection">4.6.1. ~redirection</h4>
22892306
Whether they are permanent or temporary. Permanent redirects can be used to update links stored in the client (e.g., bookmarks), whereas temporary ones cannot. Note that this has no effect on HTTP caching; it is completely separate.
22902307
</li>
22912308
<li>
2292-
~redirectされた要請の~methodを `POST$m から `GET$m に変更するのを許容するかどうか
2309+
~redirectされた要請の~methodを `POST$m から `GET$m に変更することを許容するかどうか
22932310
~Web~browserは、
22942311
一般に,[
22952312
`301$st0, `302$st0
@@ -2334,7 +2351,9 @@ <h4 title="Redirection">4.6.1. ~redirection</h4>
23342351
<p>
23352352
状態s~code `303$st は、[
23362353
演算の結果は、
2337-
異なる所在にて `GET$m を利用して可用である
2354+
異なる所在にて
2355+
— `GET$m を利用して —
2356+
可用である
23382357
]ことを~clientに伝えるために利用できる。
23392358
23402359
The 303 (See Other) status code can be used to inform the client that the result of an operation is available at a different location using GET.
@@ -2539,7 +2558,7 @@ <h3 title="Defining Message Content">4.8. ~message内容の定義-法</h3>
25392558
応用は、
25402559
自身が定義する各~形式ごとに,別個な`~MIME型$を登録するべきである。
25412560
そうすれば、
2542-
それらは一義的に識別され,それらを利用するために折衝するのもアリになる
2561+
それらは一義的に識別され,それらを利用するために折衝することもアリになる
25432562
更なる情報は、
25442563
`RFC6838$r を見よ。
25452564
@@ -2572,7 +2591,7 @@ <h3 title="Leveraging HTTP Caching">4.9. ~HTTP~cache法の活用-法</h3>
25722591

25732592
<p>
25742593
~HTTPを利用している応用は、
2575-
~cache法の利点を得ようと設計されていないときでも
2594+
~cache法の利点をとるよう設計されていないときでも
25762595
`~cache$が応答をどう取扱うかを考慮する必要はある
25772596
— (~network, `~server$, `~client$, 介在している基盤の)どこかに~cachingが差し挟まれても,正しい挙動を保全するため。
25782597
@@ -2588,7 +2607,8 @@ <h4 title="Freshness">4.9.1. 鮮度</h4>
25882607
複数の`~client$からの要請を満足するために応答を再利用すること/
25892608
単独の~clientが同じ要請を繰返に為すこと
25902609
]を許容する。
2591-
一般に,再利用しても安全な何かに対しては、
2610+
一般に、
2611+
再利用しても安全なものには,
25922612
鮮度~維持期間をアテガうことを考慮すること。
25932613
25942614
Assigning even a short freshness lifetime ([HTTP-CACHING], Section 4.2) -- e.g., 5 seconds -- allows a response to be reused to satisfy multiple clients and/or a single client making the same request repeatedly. In general, if it is safe to reuse something, consider assigning a freshness lifetime.
@@ -2609,10 +2629,11 @@ <h4 title="Freshness">4.9.1. 鮮度</h4>
26092629
<p>
26102630
ほとんどの応答に対しては、
26112631
それを~cacheするために `public$sdir 応答~指令を追加することは,必要yでない
2612-
— 必要yであるのは、[
2632+
— 必要yであるのは、
2633+
次に挙げるときに限られる
2634+
⇒#
26132635
認証された応答を格納するのが望ましいとき/
26142636
応答の`状態s~code$は~cacheにより解されない, かつ明示的な鮮度~情報は可用でないとき
2615-
]に限られる。
26162637
26172638
It is not necessary to add the public response directive ([HTTP-CACHING], Section 5.2.2.9) to cache most responses; it is only necessary when it's desirable to store an authenticated response, or when the status code isn't understood by the cache and there isn't explicit freshness information available.
26182639
</p>
@@ -3134,7 +3155,7 @@ <h3 title="Maintaining Application Boundaries">4.14. 応用~境界の保守-法<
31343155
</p>
31353156

31363157
<p>
3137-
これらの課題に対する解法の一つは
3158+
これらの課題に対する解決策の一つは
31383159
応用に対し専用な~hostnameを要求して,
31393160
応用が一意な生成元に属するようにすることである。
31403161
しかしながら,[
@@ -3150,15 +3171,16 @@ <h3 title="Maintaining Application Boundaries">4.14. 応用~境界の保守-法<
31503171

31513172
<p>
31523173
したがって,~HTTPを利用している応用は、
3153-
複数の応用が同じ生成元に属することを許容するよう,努めるべきである。
3154-
特定的には、[
3155-
`Cookie$h や~HTTP認証~realm `HTTP$r その他の,生成元~~全般な~HTTPの仕組み
3156-
]の利用を指定するときには,~HTTPを利用している応用は:
3174+
複数の応用が同じ生成元に属することを許容するよう,努めるべきである
3175+
— 特定的には
3176+
31573177
3178+
`Cookie$h や~HTTP認証~realm `HTTP$r その他の,生成元~~全般な~HTTPの仕組み
3179+
]の利用を指定するときには、[
31583180
特定0の名前の利用を義務付ける
31593181
]べきではなく[
31603182
代わりに,各~配備に応用を環境設定してもらうようにする
3161-
]べきであり
3183+
]べきであり
31623184
応用に指定された仕組みを利用して,応用の視野を当の生成元の一部に絞ること
31633185
]に関する考慮点を与えるべきである。
31643186
@@ -3169,7 +3191,7 @@ <h3 title="Maintaining Application Boundaries">4.14. 応用~境界の保守-法<
31693191
現代の~Web~browserは、
31703192
私用な情報が漏洩されるのを避けるため,
31713193
ある生成元に属する内容が別の生成元に属する`資源$へ~accessする能を拘束する。
3172-
したがって,非同一-生成元に属する~dataを~browserに公開するよう望む応用は、
3194+
したがって,非同一-生成元な~dataを~browserに公開するよう望む応用は、
31733195
`~CORS~protocol$ `FETCH$r を実装する必要がある。
31743196
31753197
Modern Web browsers constrain the ability of content from one origin to access resources from another to avoid leaking private information. As a result, applications that wish to expose cross-origin data to browsers will need to implement the CORS protocol; see [FETCH].

0 commit comments

Comments
 (0)