摘要：概述本文為協(xié)議的第十一章，本文翻譯的主要內(nèi)容為的相關(guān)注意事項(xiàng)。應(yīng)用協(xié)議使用這個(gè)協(xié)議規(guī)范互操作性注意事項(xiàng)使用時(shí)需要使用或者更高版本的協(xié)議。安全性注意事項(xiàng)見安全性注意事項(xiàng)一節(jié)。

本文為 WebSocket 協(xié)議的第十一章，本文翻譯的主要內(nèi)容為 WebSocket 的 IANA 相關(guān)注意事項(xiàng)。

ws URI 定義了 WebSocket 服務(wù)器和資源名稱。

URI 協(xié)議名稱

ws

狀態(tài)

永久

URI 協(xié)議語法

使用 ABNF （RFC5234）語法和來自 URI 規(guī)范 RFC3986 的 ABNF 終端：

"ws:" "http://" authority path-abempty [ "?" query ]

path-abempty 和 query RFC3986 部分組成了發(fā)送給服務(wù)端的資源名稱，來標(biāo)記需要的服務(wù)類型。其他的部分在 RFC3986 中定義了含義。

URI 協(xié)議含義

這個(gè)方案的唯一操作就是使用 WebSocket 協(xié)議打開一個(gè)連接。

編碼注意事項(xiàng)

按照上面定義的語法排除的主機(jī)部分中的字符必須按照 RFC3987 中的規(guī)定從 Unicode 轉(zhuǎn)換為 ASCII 或其替換字符。為了實(shí)現(xiàn)基于方案的規(guī)范化，國際化網(wǎng)域名稱（IDN）主機(jī)組件的形式與 punycode 碼之間的相互轉(zhuǎn)化認(rèn)為是等價(jià)的（見 RFC3987 第 5.3.3 節(jié)）。

除了由上面語法排除的字符外，其他組件的字符在第一次轉(zhuǎn)換為 UTF-8 字符時(shí)，必須從 Unicode 碼轉(zhuǎn)化到 ASCII 碼，然后使用百分比編碼格式替換對(duì)應(yīng)的定義在 URI RFC3896 字符和國際化資源標(biāo)識(shí)符（IRI） RFC3987 規(guī)范。

應(yīng)用/協(xié)議使用這個(gè) URI 協(xié)議規(guī)范

WebSocket Protocol

互操作性注意事項(xiàng)

使用 WebSocket 時(shí)需要使用 1.1 或者更高版本的 HTTP 協(xié)議。

安全性注意事項(xiàng)

見”安全性注意事項(xiàng)”一節(jié)。

聯(lián)系

HYBI WG

作者/更改控制者

IETF

關(guān)聯(lián)

RFC 6455

一個(gè) wss 的 URI 定義了一個(gè) WebSocket 服務(wù)器和資源名稱，表明通過這個(gè)鏈接的傳輸需要通過 TLS（包含標(biāo)準(zhǔn)的 TLS 能力例如數(shù)據(jù)保密性和完整性以及終端認(rèn)證）來進(jìn)行保護(hù)。

URI 協(xié)議名稱

wss

狀態(tài)

永久

URI 協(xié)議語法

使用 ABNF （RFC5234）語法和來自 URI 規(guī)范 RFC3986 的 ABNF 終端：

"wss:" "http://" authority path-abempty [ "?" query ]

path-abempty 和 query RFC3986 部分組成了發(fā)送給服務(wù)端的資源名稱，來標(biāo)記需要的服務(wù)類型。其他的部分在 RFC3986 中定義了含義。

URI 協(xié)議含義

這個(gè)方案的唯一操作就是使用 WebSocket 協(xié)議打開一個(gè)連接，通過 TLS 加密。

編碼注意事項(xiàng)

按照上面定義的語法排除的主機(jī)部分中的字符必須按照 RFC3987 中的規(guī)定從 Unicode 轉(zhuǎn)換為 ASCII 或其替換字符。為了實(shí)現(xiàn)基于方案的規(guī)范化，國際化網(wǎng)域名稱（IDN）主機(jī)組件的形式與 punycode 碼之間的相互轉(zhuǎn)化認(rèn)為是等價(jià)的（見 RFC3987 第 5.3.3 節(jié)）。

除了由上面語法排除的字符外，其他組件的字符在第一次轉(zhuǎn)換為 UTF-8 字符時(shí)，必須從 Unicode 碼轉(zhuǎn)化到 ASCII 碼，然后使用百分比編碼格式替換對(duì)應(yīng)的定義在 URI RFC3896 字符和國際化資源標(biāo)識(shí)符（IRI） RFC3987 規(guī)范。

應(yīng)用/協(xié)議使用這個(gè) URI 協(xié)議規(guī)范

WebSocket Protocol

互操作性注意事項(xiàng)

使用 WebSocket 時(shí)需要使用 1.1 或者更高版本的 HTTP 協(xié)議。

安全性注意事項(xiàng)

見”安全性注意事項(xiàng)”一節(jié)。

聯(lián)系

HYBI WG

作者/更改控制者

IETF

關(guān)聯(lián)

RFC 6455

這一節(jié)描述一個(gè)在 HTTP 升級(jí)憑證注冊的關(guān)鍵值，在 RFC2817 定義。

憑證名稱

WebSocket

作者/更改控制者

IETF

關(guān)聯(lián)

RFC 6455

這一節(jié)描述一個(gè)注冊在永久消息頭字段名稱中的頭字段，在 RFC3864 定義。

頭字段名稱

Sec-WebSocket-Key

應(yīng)用協(xié)議

http

狀態(tài)

標(biāo)準(zhǔn)

作者/更改控制者

IETF

說明文檔

RFC 6455

關(guān)聯(lián)信息

這個(gè)頭字段只用于 WebSocket 開始握手。

Sec-WebSocket-Key 頭字段是用在 WebSocket 開始握手階段。它是通過客戶端發(fā)送給服務(wù)端，這部分信息用于服務(wù)端證明收到一個(gè)有效的 WebSocket 握手操作的認(rèn)證。這可以幫助確認(rèn)服務(wù)端不會(huì)接收可能被用來向 WebSocket 服務(wù)任意發(fā)送數(shù)據(jù)的非 WebSocket 客戶端的連接（例如 HTTP 客戶端）。

Sec-WebSocket-Key 頭字段禁止在一個(gè) HTTP 請(qǐng)求中出現(xiàn)多次。

這一節(jié)描述一個(gè)注冊在永久消息頭字段名稱中的頭字段，在 RFC3864 定義。

頭字段名稱

Sec-WebSocket-Extensions

應(yīng)用協(xié)議

http

狀態(tài)

標(biāo)準(zhǔn)

作者/更改控制者

IETF

說明文檔

RFC 6455

關(guān)聯(lián)信息

這個(gè)頭字段只用于 WebSocket 開始握手。

Sec-WebSocket-Extensions 頭字段是用于 WebSocket 開始握手階段。它最開始是通過客戶端發(fā)送給服務(wù)端，然后通過服務(wù)端發(fā)送給客戶端，來對(duì)一個(gè)在連接中的協(xié)議級(jí)的擴(kuò)展進(jìn)行協(xié)商。

Sec-WebSocket-Extensions 頭字段可能會(huì)在一個(gè) HTTP 請(qǐng)求中出現(xiàn)多次（這個(gè)邏輯是等價(jià)于一個(gè)多帶帶的 Sec-WebSocket-Extensions 頭字段包含所有值）。然而，Sec-WebSocket-Extensions 頭字段在 HTTP 響應(yīng)中不能出現(xiàn)超過1次。

這一節(jié)描述一個(gè)注冊在永久消息頭字段名稱中的頭字段，在 RFC3864 定義。

頭字段名稱

Sec-WebSocket-Accept

應(yīng)用協(xié)議

http

狀態(tài)

標(biāo)準(zhǔn)

作者/更改控制者

IETF

說明文檔

RFC 6455

關(guān)聯(lián)信息

這個(gè)頭字段只用于 WebSocket 開始握手。

Sec-WebSocket-Accpet 頭字段是用于 WebSocket 開始握手階段。它是通過服務(wù)端發(fā)送給客戶端，用來確認(rèn)服務(wù)端會(huì)初始化一個(gè) WebSocket 連接。

Sec-WebSocket-Accpet 頭在一個(gè) HTTP 響應(yīng)中不允許出現(xiàn)超過1次。

這一節(jié)描述一個(gè)注冊在永久消息頭字段名稱中的頭字段，在 RFC3864 定義。

頭字段名稱

Sec-WebSocket-Protocol

應(yīng)用協(xié)議

http

狀態(tài)

標(biāo)準(zhǔn)

作者/更改控制者

IETF

說明文檔

RFC 6455

關(guān)聯(lián)信息

這個(gè)頭字段只用于 WebSocket 開始握手。

Sec-WebSocket-Protocol 頭字段是用于 WebSocket 開始握手階段。它是從客戶端發(fā)送給服務(wù)端，然后從服務(wù)端返回給服務(wù)端來確認(rèn)連接的子協(xié)議。這個(gè)機(jī)制能夠讓雙方選擇一個(gè)子協(xié)議，同時(shí)向服務(wù)端確認(rèn)可以支持這個(gè)子協(xié)議。

Sec-WebSocket-Protocol 頭字段可以在一個(gè) HTTP 請(qǐng)求中出現(xiàn)多次（這個(gè)邏輯是等價(jià)于一個(gè)多帶帶的 Sec-WebSocket-Protocol 頭字段包含所有值）。然而，? Sec-WebSocket-Protocol 頭字段在 HTTP 響應(yīng)中不能出現(xiàn)超過1次。

這一節(jié)描述一個(gè)注冊在永久消息頭字段名稱中的頭字段，在 RFC3864 定義。

頭字段名稱

Sec-WebSocket-Version

應(yīng)用協(xié)議

http

狀態(tài)

標(biāo)準(zhǔn)

作者/更改控制者

IETF

說明文檔

RFC 6455

關(guān)聯(lián)信息

這個(gè)頭字段只用于 WebSocket 開始握手。

Sec-WebSocket-Version 頭字段是用于 WebSocket 開始握手階段。它是從客戶端發(fā)送給服務(wù)端來表示這個(gè)連接使用的協(xié)議版本。它能夠讓服務(wù)端正確的進(jìn)行開始握手和接下來的數(shù)據(jù)發(fā)送，以及在服務(wù)端不能夠在一個(gè)安全方式下正確解析數(shù)據(jù)時(shí)關(guān)閉連接。Sec-WebSocket-Version 頭字段在服務(wù)端理解的版本不匹配從客戶端收到的版本導(dǎo)致的 WebSocket 握手失敗時(shí)，也從服務(wù)端發(fā)送給客戶端。在這種情況下，這個(gè)頭字段包含服務(wù)端支持的協(xié)議版本。

注意這里不期望更高的版本號(hào)需要向前兼容低版本號(hào)。

Sec-WebSocket-Version 頭字段可以在一個(gè) HTTP 響應(yīng)中出現(xiàn)多次（這個(gè)邏輯等價(jià)于一個(gè)多帶帶的Sec-WebSocket-Version包含所有的值）。然而，Sec-WebSocket-Version 頭字段不能在 HTTP 請(qǐng)求中出現(xiàn)超過1次。

這個(gè)規(guī)范根據(jù)RFC5526中規(guī)定的原則為 WebSocket 協(xié)議創(chuàng)建了一個(gè)新的 IANA 注冊表，用于 WebSocket 擴(kuò)展名稱。

作為此注冊表的一部分，IANA 包含了一下信息：

擴(kuò)展定義

這個(gè)擴(kuò)展的定義，將在 Sec-WebSocket-Extensions 頭字段中使用，在此規(guī)范的第 11.3.2 節(jié)注冊。這個(gè)值必須滿足在此規(guī)范第 9.1 節(jié)中定義的擴(kuò)展憑證要求。

擴(kuò)展通用名

擴(kuò)展名稱，一般稱為擴(kuò)展名。

擴(kuò)展定義

對(duì)定義與 WebSocket 協(xié)議一起使用的擴(kuò)展的文檔的引用。

已知不兼容擴(kuò)展

已知的不兼容的擴(kuò)展定義列表。

WebSocket 擴(kuò)展名是受到“先到先得” IANA 注冊政策 RFC5226 限制的。

這個(gè)注冊表里沒有初始值。

這個(gè)規(guī)范根據(jù)RFC5526中規(guī)定的原則為 WebSocket 協(xié)議創(chuàng)建了一個(gè)新的 IANA 注冊表，用于 WebSocket 擴(kuò)展名稱。

作為此注冊表的一部分，IANA 包含了一下信息：

子協(xié)議定義

子協(xié)議的標(biāo)識(shí)符將在 Sec-WebSocket-Protocol 頭字段中使用，在此規(guī)范的第 11.3.4 節(jié)中注冊。這個(gè)之必須符合此規(guī)范第 4.1 節(jié)中的第 10 項(xiàng)要求—換句話說，這個(gè)之必須是 RFC2616 中定義的憑證。

子協(xié)議通用名

子協(xié)議名稱，通常被稱為子協(xié)議。

子協(xié)議定義

對(duì)定義與 WebSocket 協(xié)議一起使用的子協(xié)議的文檔的引用。

WebSocket 子協(xié)議名是受到“先到先得” IANA 注冊政策 RFC5226 限制的。

該規(guī)范根據(jù) RFC5226 中規(guī)定的原則為 WebSocket 協(xié)議創(chuàng)建了一個(gè)新的 IANA 注冊表，用于 WebSocket 版本號(hào)。

作為此注冊表的一部分，IANA 包含了一下信息：

版本號(hào)

版本號(hào)是用于在此規(guī)范第 4.1 節(jié)中制定的 Sec-WebSocket-Version 字段。這個(gè)值必須是一個(gè)范圍在 0 到 255（含）之間的非負(fù)整數(shù)。

參考

RFC 請(qǐng)求新版本號(hào)或者帶有版本號(hào)的草稿名稱（見下文）。

狀態(tài)

臨時(shí)或者標(biāo)準(zhǔn)。見下面描述。

版本號(hào)被指定為“臨時(shí)”或者“標(biāo)準(zhǔn)”。

“標(biāo)準(zhǔn)”的版本號(hào)被記錄在 RFC 文檔中，被認(rèn)為是一個(gè)重大、穩(wěn)定的 WebSocket 協(xié)議版本，例如定義在這個(gè) RFC 中的版本。“標(biāo)準(zhǔn)”版本號(hào)是受到 “IETF 評(píng)論” IANA 注冊政策 RFC5526 限制的。

“臨時(shí)”版本是記錄在網(wǎng)絡(luò)草案和用于幫助實(shí)現(xiàn)者識(shí)別 WebSocket 協(xié)議的已部署版本并與之互操作，例如開發(fā)后但是發(fā)布前的 RFC 版本?！芭R時(shí)”版本號(hào)是受到 “專家評(píng)論” IANA 注冊政策 RFC5526 、 最初的指定專家如HYBI 工作組主席（或者，如果工作組關(guān)閉，那么是 IETF 應(yīng)用領(lǐng)域的領(lǐng)域主任）限制的。

IANA 已經(jīng)向注冊表中添加了如下的初始值。

該規(guī)范根據(jù) RFC5226 中規(guī)定的原則為 WebSocket 協(xié)議創(chuàng)建了一個(gè)新的 IANA 注冊表，用于 WebSocket 關(guān)閉碼。

作為此注冊表的一部分，IANA 包含了一下信息：

狀態(tài)碼

狀態(tài)碼表示定義在此文檔第 7.4 節(jié)中 WebSocket 連接關(guān)閉的原因。這個(gè)狀態(tài)碼是一個(gè)在 1000 到 4999（含）之間的整數(shù)。

含義

狀態(tài)碼含義。每一個(gè)狀態(tài)碼有一個(gè)特定的含義。

聯(lián)系

保留狀態(tài)代碼的實(shí)體的聯(lián)系人。

關(guān)聯(lián)

請(qǐng)求狀態(tài)碼的固定文檔和含義定義。對(duì)于 1000-2999 的狀態(tài)碼來說是必須的，推薦使用 3000-3999 范圍的狀態(tài)碼。

WebSocket 關(guān)閉狀態(tài)碼根據(jù)它的范圍有不同的注冊要求。使用在這個(gè)協(xié)議和它的后續(xù)的版本或者擴(kuò)展的請(qǐng)求版本號(hào)是受到“標(biāo)準(zhǔn)行為”、“規(guī)范要求”（這意味著“指定專家”）或者“IESG 評(píng)論” IANA注冊表政策限制的，應(yīng)該在 1000-2999 范圍內(nèi)授權(quán)。被類庫、框架和應(yīng)用使用的狀態(tài)碼是受限制于“先到先得”IANA 注冊表政策，應(yīng)該在 3000-3999 范圍內(nèi)授權(quán)。4000-4999 范圍的狀態(tài)碼是私用的。請(qǐng)求應(yīng)指明它們是否正在通過擴(kuò)展、類庫、框架或者應(yīng)用使用請(qǐng)求WebSocket協(xié)議的狀態(tài)代碼（或者將來的協(xié)議的版本）。

IANA已經(jīng)向注冊表中添加了如下初始值。

該規(guī)范根據(jù) RFC5226 中規(guī)定的原則為 WebSocket 協(xié)議創(chuàng)建了一個(gè)新的 IANA 注冊表，用于 WebSocket 操作碼。

作為此注冊表的一部分，IANA 包含了一下信息：

操作碼

操作碼表示定義在第 5.2 節(jié)中的 WebSocket 幀的幀類型。操作碼是一個(gè)范圍在 0 到 15（含）的數(shù)字。

含義

操作碼的含義。

關(guān)聯(lián)

請(qǐng)求操作碼的規(guī)范。

WebSocket 操作碼是受到“標(biāo)準(zhǔn)行為”IANA 注冊表政策 RFC5266 限制的。

IANA 已經(jīng)向注冊表中注冊了一下初始值。

該規(guī)范根據(jù) RFC5226 中規(guī)定的原則為 WebSocket 協(xié)議創(chuàng)建了一個(gè)新的 IANA 注冊表，用于 WebSocket 幀頭 bit 字段。這個(gè)注冊表控制分配的 bit 位為第 5.2 節(jié)中的 RSV1、RSV2 和 RSV3。

這些 bit 位是保留給將來的版本或者文檔中的擴(kuò)展。

WebSocket 幀頭 bit 字段是受到“標(biāo)準(zhǔn)行為”IANA 注冊表政策 RFC5266 限制的。