11 IANA考慮 · WebSocket協議翻譯

# IANA考慮 ## 11.1.注冊新的URI模式 ### 11.1.1.注冊“ws“模式一個|ws| URI標識一個WebSocket服務器和資源名稱。 URI模式名稱 ????ws 狀態 ????永久的 URI模式語法 ????使用ABNF[[RFC5234](http://tools.ietf.org/html/rfc5234)]語法和URI規范[[RFC3986](http://tools.ietf.org/html/rfc3986)]的ABNF終結符： ????????"ws:" "//" authority path-abempty [ "?" query ] ????和 [[RFC3986](http://tools.ietf.org/html/rfc3986)]組件形成的資源名發生給服務器來確定服務期望的類型。其他組件的含義描述在[[RFC3986](http://tools.ietf.org/html/rfc3986)]。模式語義 ????這個模式的作用僅是使用WebSocket協議打開一個連接。編碼考慮 ????上邊定義的語法不包括host組件中的字符，必須按照[[RFC3987](http://tools.ietf.org/html/rfc3987)]從Unicode轉換為ASCII或其替換。為了模式標準化的目的，國際化域名（IDN）形式的host組件和它們轉換的域名代碼（Punycode）被認為是等價的（參考[[RFC3987](http://tools.ietf.org/html/rfc3987)] 5.3.3節）。 ????上邊定義的語法不包括其他組件中的字符，必須按照定義在URI[[RFC3986](http://tools.ietf.org/html/rfc3986)] 和國際化資源標識符（IRI）[[RFC3987](http://tools.ietf.org/html/rfc3987)]規范從Unicode編碼轉換為ASCII，通過首先編碼字符為UTF-8，接著使用它們百分數編碼的形式替換相應的字節。應用/協議使用這個URI模式命名 ????WebSokcet協議互操作性考慮 ????使用WebSocket需要使用HTTP版本1.1或更高。 ????安全考慮 ????參考“安全考慮”章節。 ????聯系方式 ????HYBI WG?[hybi@ietf.org](mailto:hybi@ietf.org) ????作者/變更管理員 ????IETF?[iesg@ietf.org](mailto:iesg@ietf.org) ????參考資源 ????[RFC 6455](http://tools.ietf.org/html/rfc6455) ### 11.1.2.注冊”wss“模式一個|wss| URI標識一個WebSocket服務器和資源名稱，并表明在受TLS保護的連接之上通信（包括標準的TLS的好處，比如數據保密性和完整性和端點認證）。 URI模式名稱 ????wss 狀態 ????永久的 URI模式語法 ????使用ABNF[[RFC5234](http://tools.ietf.org/html/rfc5234)]語法和URI規范[[RFC3986](http://tools.ietf.org/html/rfc3986)]的ABNF終結符： ???????? "wss:" "//" authority path-abempty [ "?" query ] ????和 [[RFC3986](http://tools.ietf.org/html/rfc3986)]組件形成的資源名發生給服務器來確定服務期望的類型。其他組件的含義描述在[[RFC3986](http://tools.ietf.org/html/rfc3986)]。 URI模式語義 ????這個模式的作用僅是使用WebSocket協議打開一個使用TLS的連接。編碼考慮 ????上邊定義的語法不包括host組件中的字符，必須按照[[RFC3987](http://tools.ietf.org/html/rfc3987)]從Unicode轉換為ASCII或其替換。為了模式標準化的目的，國際化域名（IDN）形式的host組件和它們轉換的域名代碼（Punycode）被認為是等價的（參考[[RFC3987](http://tools.ietf.org/html/rfc3987)] 5.3.3節）。 ????上邊定義的語法不包括其他組件中的字符，必須按照定義在URI[[RFC3986](http://tools.ietf.org/html/rfc3986)] 和國際化資源標識符（IRI）[[RFC3987](http://tools.ietf.org/html/rfc3987)]規范從Unicode編碼轉換為ASCII，通過首先編碼字符為UTF-8，接著使用它們百分數編碼的形式替換相應的字節。應用/協議使用這個URI模式命名 ????TLS之上的WebSokcet協議互操作性考慮 ????使用WebSocket需要使用HTTP版本1.1或更高。安全考慮 ????參考“安全考慮”章節。聯系方式 ????HYBI WG?[hybi@ietf.org](mailto:hybi@ietf.org) 作者/變更管理員 ????IETF?[iesg@ietf.org](mailto:iesg@ietf.org) 參考資源 ????[RFC 6455](http://tools.ietf.org/html/rfc6455) ## 11.2.注冊”WebSocket“ HTTP Upgrade關鍵字本節按照[RFC2817](http://tools.ietf.org/html/rfc2817)[[RFC2817](http://tools.ietf.org/html/rfc2817)]定義了在HTTP Upgrade符號注冊中心中注冊一個關鍵字。符號名稱 ????WebSocket 作者/變更管理員 ????IETF?[iesg@ietf.org](mailto:iesg@ietf.org) 參考資源 ????[RFC 6455](http://tools.ietf.org/html/rfc6455) ## 11.3.注冊新的HTTP頭字段 ### 11.3.1\. Sec-WebSocket-Key 本節描述了在永久消息頭字段命名注冊中心[[RFC3864](http://tools.ietf.org/html/rfc3864)]中注冊一個頭字段。頭字段名 ????Sec-WebSocket-Key 適用協議 ????http 狀態 ????標準的作者/變更管理員 ????IETF 參考資源 ????[RFC 6455](http://tools.ietf.org/html/rfc6455) 相關信息 ????該頭字段僅用于WebSocket打開階段握手。 |Sec-WebSocket-Key| 頭字段用于WebSocket打開階段握手。它從客戶端發送到服務器，提供部分信息用于服務器檢驗它收到了一個有效的WebSocket握手。這有助于確保服務器不接收正被濫用來發送數據給毫不知情的WebSocket服務器的非WebSocket客戶端的連接（例如HTTP客戶端）。 |Sec-WebSocket-Key| 頭字段在一個HTTP請求中不能出現多于一個。 ### 11.3.2\. Sec-WebSocket-Extensions 本節描述了在永久消息頭字段命名注冊中心[[RFC3864](http://tools.ietf.org/html/rfc3864)]中注冊一個頭字段。頭字段名 ????Sec-WebSocket-Extensions 適用協議 ????http 狀態 ????標準的作者/變更管理員 ????IETF 參考資源 ????[RFC 6455](http://tools.ietf.org/html/rfc6455) 相關信息 ????該頭字段僅用于WebSocket打開階段握手。 |Sec-WebSocket-Extensions|頭字段用于WebSocket打開階段握手。它最初是從客戶端發送到服務器，隨后從服務器端發送到客戶端，用來達成在整個連接階段的一組協議級擴展。 |Sec-WebSocket-Extensions|頭字段在HTTP請求中可以出現多次（邏輯上等價于單個|Sec-WebSocket-Extensions|頭字段包含所有值）。但是，|Sec-WebSocket-Extensions|頭字段在一個HTTP響應中必須不出現多于一次。 ### 11.3.3\. Sec-WebSocket-Accept 本節描述了在永久消息頭字段命名注冊中心[[RFC3864](http://tools.ietf.org/html/rfc3864)]中注冊一個頭字段。頭字段名 ????Sec-WebSocket-Accept 適用協議 ????http 狀態 ????標準的作者/變更管理員 ????IETF 參考資源 ????[RFC 6455](http://tools.ietf.org/html/rfc6455) 規范文檔 ????[RFC 6455](http://tools.ietf.org/html/rfc6455) 相關信息 ????該頭字段僅用于WebSocket打開階段握手。 | Sec-WebSocket-Accept|頭字段用于WebSocket打開階段握手。它從服務器發送到客戶端來確定服務器愿意啟動WebSocket連接。 |Sec-WebSocket-Accept| 頭在一個HTTP響應中必須不出現多于一次。 ### 11.3.4\. Sec-WebSocket-Protocol 本節描述了在永久消息頭字段命名注冊中心[[RFC3864](http://tools.ietf.org/html/rfc3864)]中注冊一個頭字段。頭字段名 ????Sec-WebSocket-Protocol 適用協議 ????http 狀態 ????標準的作者/變更管理員 ????IETF 參考資源 ????[RFC 6455](http://tools.ietf.org/html/rfc6455) 規范文檔 ????[RFC 6455](http://tools.ietf.org/html/rfc6455) 相關信息 ????該頭字段僅用于WebSocket打開階段握手。 |Sec-WebSocket-Protocol|頭字段用于WebSocket打開階段握手。它從客戶端發送到服務器端，并從服務器端發回到客戶端來確定連接的子協議。這使腳本可以選擇一個子協議和確定服務器同意服務子協議。 |Sec-WebSocket-Protocol|頭字段在一個HTTP請求中可以出現多次（邏輯上等價于單個|Sec-WebSocket-Protocol|頭字段包含所有值）。但是，|Sec-WebSocket-Protocol|頭字段在一個HTTP響應中必須不出現多于一次。 ### 11.3.5.Sec-WebSocket-Version 本節描述了在永久消息頭字段命名注冊中心[[RFC3864](http://tools.ietf.org/html/rfc3864)]中注冊一個頭字段。頭字段名 ????Sec-WebSocket-Version 適用協議 ????http 狀態 ????標準的作者/變更管理員 ????IETF 參考資源 ????[RFC 6455](http://tools.ietf.org/html/rfc6455) 規范文檔 ????[RFC 6455](http://tools.ietf.org/html/rfc6455) 相關信息 ????該頭字段僅用于WebSocket打開階段握手。 |Sec-WebSocket- Version |頭字段用于WebSocket打開階段握手。它從客戶端發送到服務器端來指定連接的協議版本。這能使服務器正確解釋打開階段握手和發送數據的隨后數據，如果服務器不能以安全的方式解釋數據則關閉連接。當從客戶端接收到不匹配服務器端理解的版本時，WebSocket握手錯誤，|Sec-WebSocket-Version|頭字段也從服務器端發送到客戶端。在這種情況下，頭字段包括服務器端支持的協議版本。注意，如果沒有期望更高版本號，必然是向下兼容低版本號。 |Sec-WebSocket-Version|頭字段在一個HTTP響應中可以出現多次（邏輯上等價于單個|Sec-WebSocket-Version|透過自動包含所有值）。但是，|Sec-WebSocket-Version|頭字段在HTTP請求中必須不出現多于一次。 ## 11.4.WebSocket擴展名注冊本規范依據[RFC5226](http://tools.ietf.org/html/rfc5226)[[RFC5226](http://tools.ietf.org/html/rfc5226)]陳述的原則，創建了一個新的IANA注冊用于與WebSocket協議一起使用的WebSocket擴展名。作為本注冊的一部分，IANA維護以下信息：擴展標識符 ????擴展標識符，將被用在注冊到本規范[11.3.2節](http://tools.ietf.org/html/rfc6455#section-11.3.4)的| Sec-WebSocket-Extensions|頭字段。其值必須符合定義在本規范[9.1節](http://tools.ietf.org/html/rfc6455#section-4.1)的擴展-符號要求。擴展通用名稱 ????擴展名稱，通常稱為擴展。擴展定義 ????在擴展用于的WebSocket協議中定義了文檔參考。已知的不兼容擴展 ????與此擴展是不兼容的一個擴展標識符列表。 WebSocket擴展名受制于“先來先服務”的IANA注冊策略 [[RFC5226](http://tools.ietf.org/html/rfc5226)]。在此注冊中心沒有初始值。 ## 11.5.WebSocket子協議名注冊本規范依據RFC5226[RFC5226]陳述的原則，創建了一個新的IANA注冊用于與WebSocket協議一起使用的WebSocket子協議名。作為本注冊的一部分，IANA維護以下信息：子協議標識符 ????子協議標識符，將被用在注冊到本規范[11.3.4節](http://tools.ietf.org/html/rfc6455#section-11.3.4)的|Sec-WebSocket-Protocol|頭字段。其值必須符合定義在本規范[4.1節](http://tools.ietf.org/html/rfc6455#section-4.1)給出的第10條的符號要求——也就是，其值必須是[RFC5226](http://tools.ietf.org/html/rfc5226)?[[RFC5226](http://tools.ietf.org/html/rfc5226)].定義的一個符號。子協議通用名稱 ????子協議名稱，通常成為子協議。子協議定義 ????在子協議用于的WebSocket協議中定義了文檔參考。 WebSocket子協議名受制于“先來先服務”的IANA注冊策略 [[RFC5226](http://tools.ietf.org/html/rfc5226)]。 ## 11.6.WebSocket版本號注冊本規范依據[RFC5226](http://tools.ietf.org/html/rfc5226)[[RFC5226](http://tools.ietf.org/html/rfc5226)]陳述的原則，創建了一個新的IANA注冊用于與WebSocket協議一起使用的WebSocket版本號。作為本注冊的一部分，IANA維護以下信息：版本號 ????用于|Sec-WebSocket-Version|的版本號指定在本規范[4.1節](http://tools.ietf.org/html/rfc6455#section-4.1)。其值必須是一個在0到255（包括）之間的非負整數。參考 ????RFC請求一個新的版本號或帶版本號的草案名稱（見下文）。狀態 ????“臨時的”或“標準的”。參考下面的說明。一個版本號被指定為“臨時的”或“標準的”。 “標準的”版本號是記錄在一個RFC中并用來識別一個主要的、穩定的WebSocket協議版本，例如本RFC定義的版本。“標準的”版本號受制于“IETF評審”IANA注冊策略 [[RFC5226](http://tools.ietf.org/html/rfc5226)]。 “Interim”的版本號記錄在一個Internet草案中用并用于幫助實現者識別和與部署的WebSocket版本互操作，例如在公布這個RFC之前指定的版本。“臨時的”版本號受制于“專家評審”IANA注冊策略 [[RFC5226](http://tools.ietf.org/html/rfc5226)]，HYBI工作組主席（或，如果工作組關閉了，IETF應用區域的區域董事）將是初始的指定專家。 IANA 已經添加如下初始值到注冊中心： ~~~ +--------+-----------------------------------------+----------+ |Version | Reference | Status | | Number | | | +--------+-----------------------------------------+----------+ | 0 + draft-ietf-hybi-thewebsocketprotocol-00 | Interim | +--------+-----------------------------------------+----------+ | 1 + draft-ietf-hybi-thewebsocketprotocol-01 | Interim | +--------+-----------------------------------------+----------+ | 2 + draft-ietf-hybi-thewebsocketprotocol-02 | Interim | +--------+-----------------------------------------+----------+ | 3 + draft-ietf-hybi-thewebsocketprotocol-03 | Interim | +--------+-----------------------------------------+----------+ | 4 + draft-ietf-hybi-thewebsocketprotocol-04 | Interim | +--------+-----------------------------------------+----------+ | 5 + draft-ietf-hybi-thewebsocketprotocol-05 | Interim | +--------+-----------------------------------------+----------+ | 6 + draft-ietf-hybi-thewebsocketprotocol-06 | Interim | +--------+-----------------------------------------+----------+ | 7 + draft-ietf-hybi-thewebsocketprotocol-07 | Interim | +--------+-----------------------------------------+----------+ | 8 + draft-ietf-hybi-thewebsocketprotocol-08 | Interim | +--------+-----------------------------------------+----------+ | 9 + Reserved | | +--------+-----------------------------------------+----------+ | 10 + Reserved | | +--------+-----------------------------------------+----------+ | 11 + Reserved | | +--------+-----------------------------------------+----------+ | 12 + Reserved | | +--------+-----------------------------------------+----------+ | 13 + RFC 6455 | Standard | +--------+-----------------------------------------+----------+ ~~~ ## 11.7.WebSocket關閉代碼注冊本規范依據[RFC5226](http://tools.ietf.org/html/rfc5226)[[RFC5226](http://tools.ietf.org/html/rfc5226)]陳述的原則，創建了一個新的IANA注冊用于WebSocket關閉代碼。作為本注冊的一部分，IANA維護以下信息：狀態碼 ????狀態碼表示一個按照本文檔[7.4節](http://tools.ietf.org/html/rfc6455#section-7.4)的WebSocket連接關閉的原因。狀態是一個在1000到4999（包括）之間的一個整數數字。含義 ????狀態碼的含義。每一個狀態碼都必須有唯一的含義。聯系方式 ????保留狀態代碼實體的聯系方式。參考 ????穩定的文檔要求狀態碼并定義它們的含義。在1000-2999范圍內的狀態碼是必須的且推薦的狀態碼在3000-3999范圍內。 WebSocket關閉代碼根據它們的范圍受不同的注冊要求。本協議請求使用的狀態碼和其后續版本或擴展受制于“標準功能”、“規定要求”（這意味著“指定專家”）或“IESG審查”IANA注冊策略中的任何一個，且應該允許在1000-2999范圍內。庫、框架和應用請求使用的狀態碼受制于“先來先服務”IANA注冊策略且應該允許在3000-3999范圍內。4000-4999范圍的狀態碼被指定用于私有使用。請求應該指出他們要求的狀態碼是用于WebSocket協議（或未來版本的協議）、擴展，或庫/框架/應用。 IANA 已經添加如下初始值到注冊中心： ~~~ |Status Code | Meaning | Contact | Reference | -+------------+-----------------+---------------+-----------| | 1000 | Normal Closure | hybi@ietf.org | RFC 6455 | -+------------+-----------------+---------------+-----------| | 1001 | Going Away | hybi@ietf.org | RFC 6455 | -+------------+-----------------+---------------+-----------| | 1002 | Protocol error | hybi@ietf.org | RFC 6455 | -+------------+-----------------+---------------+-----------| | 1003 | Unsupported Data| hybi@ietf.org | RFC 6455 | -+------------+-----------------+---------------+-----------| | 1004 | ---Reserved---- | hybi@ietf.org | RFC 6455 | -+------------+-----------------+---------------+-----------| | 1005 | No Status Rcvd | hybi@ietf.org | RFC 6455 | -+------------+-----------------+---------------+-----------| | 1006 | Abnormal Closure| hybi@ietf.org | RFC 6455 | -+------------+-----------------+---------------+-----------| | 1007 | Invalid frame | hybi@ietf.org | RFC 6455 | | | payload data | | | -+------------+-----------------+---------------+-----------| | 1008 | Policy Violation| hybi@ietf.org | RFC 6455 | -+------------+-----------------+---------------+-----------| | 1009 | Message Too Big | hybi@ietf.org | RFC 6455 | -+------------+-----------------+---------------+-----------| | 1010 | Mandatory Ext. | hybi@ietf.org | RFC 6455 | -+------------+-----------------+---------------+-----------| | 1011 | Internal Server | hybi@ietf.org | RFC 6455 | | | Error | | | -+------------+-----------------+---------------+-----------| | 1015 | TLS handshake | hybi@ietf.org | RFC 6455 | -+------------+-----------------+---------------+-----------| ~~~ ## 11.8.WebSocket操作碼注冊本規范依據[RFC5226](http://tools.ietf.org/html/rfc5226)[[RFC5226](http://tools.ietf.org/html/rfc5226)]陳述的原則，創建一個新的IANA注冊用于WebSocket操作碼。作為本注冊的一部分，IANA維護以下信息：操作碼 ????操作碼表示WebSocket幀的幀類型，定義在[5.2節](http://tools.ietf.org/html/rfc6455#section-5.2)。操作碼是一個在0到15（包括）之間的整數數字。含義 ????狀態碼值的含義。參考 ????規范要求的操作碼。 WebSocket狀態碼受制于“標準功能”IANA注冊策略[[RFC5226](http://tools.ietf.org/html/rfc5226)]。 IANA 已經添加如下初始值到注冊中心： ~~~ |Opcode | Meaning | Reference | -+--------+-------------------------------------+-----------| | 0 | Continuation Frame | RFC 6455 | -+--------+-------------------------------------+-----------| | 1 | Text Frame | RFC 6455 | -+--------+-------------------------------------+-----------| | 2 | Binary Frame | RFC 6455 | -+--------+-------------------------------------+-----------| | 8 | Connection Close Frame | RFC 6455 | -+--------+-------------------------------------+-----------| | 9 | Ping Frame | RFC 6455 | -+--------+-------------------------------------+-----------| | 10 | Pong Frame | RFC 6455 | -+--------+-------------------------------------+-----------| ~~~ ## 11.9.WebSocket幀頭位注冊本規范依據[RFC5226](http://tools.ietf.org/html/rfc5226)[[RFC5226](http://tools.ietf.org/html/rfc5226)]陳述的原則，創建了一個新的IANA注冊用于WebSocket幀頭位（Framing Header Bits）。此注冊控制的位分配標記為[5.2節](http://tools.ietf.org/html/rfc6455#section-5.2)的RSV1、RSV2和RSV3。這些位被保留用于未來版本或本規范的擴展。 WebSocket幀頭位分配受制于“標準功能”IANA注冊測策略[[RFC5226](http://tools.ietf.org/html/rfc5226)]。