1M2M技術(shù)要求(第一階段)2017-01-19印發(fā)中國通信標(biāo)準(zhǔn)化協(xié)會(huì)發(fā)布2 31范圍 42規(guī)范性引用文件和參考文獻(xiàn) 42.1規(guī)范性引用文件 42.2參考文獻(xiàn) 4 55.1介紹 5 65.3狀態(tài)行 6 66.1介紹 66.2請(qǐng)求行的參數(shù)映射 7 6.5消息體 6.6消息路由 7安全考慮 7.1HTTP請(qǐng)求消息認(rèn)證 7.2傳輸層安全 附錄A(參考):流程舉例 附錄B(參考):Webet B.1采用WebSocket的通知 3本標(biāo)準(zhǔn)是oneM2M技術(shù)要求(第一階段)系列標(biāo)準(zhǔn)之一。該系列標(biāo)準(zhǔn)的名稱如下：M2M技術(shù)要求(第一階段)功能架構(gòu)M2M技術(shù)要求(第一階段)需求M2M技術(shù)要求(第一階段)安全解決方案M2M技術(shù)要求(第一階段)服務(wù)層核心協(xié)議M2M技術(shù)要求(第一階段)開放移動(dòng)聯(lián)盟(OMA)終端管理資源映射M2M技術(shù)要求(第一階段)寬帶論壇(BBF)終端管理實(shí)現(xiàn)M2M技術(shù)要求(第一階段)CoAP協(xié)議綁定M2M技術(shù)要求(第一階段)MQTT協(xié)議綁定M2M技術(shù)要求(第一階段)公共術(shù)語協(xié)會(huì)標(biāo)準(zhǔn)”,推薦有關(guān)方面參考采用。有關(guān)對(duì)本標(biāo)準(zhǔn)的建議和意見，向中國通信標(biāo)準(zhǔn)化協(xié)會(huì)反映。請(qǐng)注意本文件的某些內(nèi)容可能涉及專利。本文件的發(fā)布機(jī)構(gòu)不承擔(dān)識(shí)別這些本標(biāo)準(zhǔn)由中國通信標(biāo)準(zhǔn)化協(xié)會(huì)提出并了4本標(biāo)準(zhǔn)的范圍為(不僅限于以下部分):所有修訂)適用。[1]IETFRFC7230(June2014):"LIyertextTRouting".[3]oneM2MTS-0004.ServiceLayerCor[4]RFC7235:"HypertextTransferProtocol(,IETF,June2014."HTTP/1.1):Authentication",IETF,June2014.[5]RFC6750:Zh?OAuth2.0AuthorizationFramework:BearerTo[8]TETFRFC7232(June2014):"HypertextT5[i.1]oneM2MDrafting注：可從下述網(wǎng)址獲得/Static_pages/Others/Rules_Pages/oneM2M-Drafting-Rules[i.2]IETFRFC6455(December2011):"TheWebSocket3縮略語下列縮略語來自于TS-0011-通用術(shù)語[6],適用于本文檔。CSE-ID:通用服務(wù)實(shí)體標(biāo)識(shí)(CommonServiceEntityIdentifier)HTTP:超文本傳輸協(xié)議(HyperTextTransferProtocol)TLS:傳輸層安全協(xié)議(TransportLayerSecurity)URI:統(tǒng)一資源標(biāo)識(shí)(UniformResourceIdentifier)AE:應(yīng)用實(shí)體(ApplicationEntity)CSE:通用服務(wù)實(shí)體(CommonServicesEntity)MN-CSE:中間節(jié)點(diǎn)通用服務(wù)實(shí)體(MiddleNode-ComnoiSrviceEntity)IN-CSE:基礎(chǔ)節(jié)點(diǎn)通用服務(wù)實(shí)體(InfrastructureNode-CommonServiceEntity)XML:可擴(kuò)展標(biāo)記語言(eXtensib4約定5HTTP協(xié)議綁定概心5.1介紹圖5.1-1例舉了一個(gè)oneM2M系統(tǒng)配置及其相應(yīng)的基于HTTP的信息系統(tǒng)，如果本文檔定義的HTTP綁定一個(gè)MN-CSE(AE注冊(cè)方)處注冊(cè)。該請(qǐng)求原語對(duì)一個(gè)資源尋址，該資源由另一個(gè)MN-CSE(資源承載方)源承載方)針對(duì)此次特定請(qǐng)求消息作為HTTP服務(wù)器。6協(xié)議綁定對(duì)等系姣系統(tǒng)☆置牢例蜜流整方熄邪務(wù)→邪由服務(wù)器響應(yīng)由胳務(wù)器響應(yīng)執(zhí)行方圖5.1-1:oneM2M實(shí)八與HTTP客戶端和服務(wù)器的對(duì)應(yīng)關(guān)系息體[1]。本章節(jié)描述了如何將oneM2M的請(qǐng)求/響應(yīng)原語在上層映射為HTTP消息。相應(yīng)細(xì)節(jié)詳見第6章。5.2請(qǐng)求行查詢字符串。HTTP請(qǐng)求行牛的HTTP版本(HTTP-Version)詳見第6章。6HTTP消息映射2.請(qǐng)求接收方(HTTP服務(wù)器)的HTTP請(qǐng)求消息映射為請(qǐng)求原語；73.請(qǐng)求接收方(HTTP服務(wù)器)的響應(yīng)原語映射為HTTP響應(yīng)消息；4.請(qǐng)求發(fā)起方(HTTP客戶端)的HTTP響應(yīng)消息映射為響應(yīng)原語；所有四個(gè)用例也在中轉(zhuǎn)CSE中出現(xiàn)。6.2請(qǐng)求行的參數(shù)映射6.2.1方法(Method)HTTP“方法”必須由請(qǐng)求原語中的操作(Operation)請(qǐng)求原語參數(shù)中獲取。oneM2M操作在接收端，POST方法的HTTP請(qǐng)求消息必須被映射為Create或Notify操作(Operation)參數(shù)?？梢酝ㄟ^檢測(cè)內(nèi)容類型頭來區(qū)分Create和Notify。只有當(dāng)HTTPFOST請(qǐng)求代表一個(gè)創(chuàng)建(Create)請(qǐng)求時(shí)(參見6.4.3節(jié)),資源類型(ResourceType)參數(shù)才在內(nèi)容類型頭中出現(xiàn)。當(dāng)HTTPPOST請(qǐng)求代表一個(gè)通6.2.2請(qǐng)求目標(biāo)(Request-Targ路徑部件(Pathcomponent)To參數(shù)的資源標(biāo)識(shí)部分可以通過三種不同的形式表示(見6.2.3[3]和7.2[7]):每個(gè)上述的二種形式都可以包括如7.2[7]中定義的一個(gè)結(jié)構(gòu)化資源ID(用于分層尋址)或一個(gè)非結(jié)構(gòu)化資源ID(用于非分層尋址)。如下表格顯示了To請(qǐng)求原語參數(shù)和HTTP請(qǐng)求目標(biāo)路徑部件間的有效映射。在示例中，/myCSEID和CSEBase/ae12/cont27/contInst696表示一個(gè)結(jié)構(gòu)化的CSE相關(guān)的資源ID,cin00856表示一個(gè)非結(jié)構(gòu)化的表-1:參數(shù)和請(qǐng)求行路徑部件間的映射示例結(jié)構(gòu)化的CSE相關(guān)的CSEBase/ae12/cont27/cont/CSEBase/ae12/cont27/cont的結(jié)構(gòu)化的SP相關(guān)的/CSE178/CSEBase/ae12/cont27/conI/CSE178/CSEBase/ae128非結(jié)構(gòu)化的SP相關(guān)的結(jié)構(gòu)化的絕對(duì)路徑W//CSE178/CSEBa非結(jié)構(gòu)化的絕對(duì)路徑M//CSE178/cin00查詢部件(如查詢字符串)可以包含在表6.2.2-1列出的可選的原語參數(shù)，符合RFC7230[1]。每個(gè)可適用的請(qǐng)求原語參數(shù)和表6.2.2-1所示的FilterCriteria參數(shù)元素必須在查詢字符串中表示成域次?！?.….n”表示該參數(shù)可以以<查詢域名>=值的形式在查詢字符串中出現(xiàn)多次。例如，如果FilterCriteria參數(shù)的資源類型元素在列表中表示為234'(見TS-0C14廠3的節(jié)),它應(yīng)該在查詢字符串中被映射為rty=2+3+4。在接收側(cè)，該查詢字符串可以被反向表示到列表類型中。相同的表示必須適用于內(nèi)容類型和標(biāo)簽元素的多次出現(xiàn)的情況。示例中的出現(xiàn)次數(shù)為2(見TS-0004[3]的節(jié))。每個(gè)名稱(如aie1和attname2)必須表示資源類型的一個(gè)有效資源屬性名稱，該資源類型在查attname1=attvalue1&attname2=attvalue2。屬性名稱(即上述示例中的attname1和attname2)必須表示成TS-0004[3_3.2.3節(jié)中定義的短名稱的形式。注意，XML表示的<attribute>標(biāo)簽在HTTP綁定中被省示例!):'nonBlockingRequestSynch’的請(qǐng)求目標(biāo)原語參數(shù)；To:/CSE1234/RCSE78/container234(SP-Relative-Resource-ID)響應(yīng)類型：responseType=1(nonBlockingReResultPersistence:PIY2M3DT10H1MOS請(qǐng)求目標(biāo)(Request-Target):/CSE1234/RCSE78/container234?rt=1&rp=P1Y2M3DT10示例2):用于發(fā)現(xiàn)的請(qǐng)求目標(biāo)當(dāng)實(shí)體想要發(fā)現(xiàn)容器資源，該creator屬性的值為'Sam':(容器)(容器)9請(qǐng)求目標(biāo)(Request-Target);/CS在表8.2.3-1至8.2.3-5中列出的資源屬性短名稱可在查詢字符串中表示為attname=attvalue,除了必須被省略的那些(見[3]中的6.9).表6.2.2-1:oneM2M請(qǐng)求參數(shù)域名素(參見TS-0004[3]的9節(jié))0.j對(duì)于部分獲取(Retrieve)請(qǐng)求原語，To參數(shù)可以包括從資源D處被#’分隔的屬性名稱。如果多個(gè)資源屬性可以同部分獲取請(qǐng)求原語一起被獲取，這些屬性包括一個(gè)內(nèi)容(Content)參數(shù)的屬性列表 (attributeList)對(duì)象(詳見TS-0004[3]的,其有空值)。符串，這些字符串以#’字符分隔。如果多于一個(gè)的屬性名稱包含在片段部件內(nèi)，這些名稱必須通過+'字符分隔。例如，如果三個(gè)資源屬性都是長名稱資源ID,在內(nèi)容(Content)原語參數(shù)中指示了標(biāo)簽和請(qǐng)求可達(dá)性(requestReachability),片段部件#ri+1bl+rr附在了請(qǐng)求目標(biāo)中。在HTTP服務(wù)器側(cè)，當(dāng)從接收HTTP請(qǐng)求消息中構(gòu)建獲取請(qǐng)求原語時(shí)[3]所述，當(dāng)多個(gè)屬性必須被包含在內(nèi)容(Content)參數(shù)中時(shí)，在片段部件的屬性必須映射回To參數(shù)。6.2.3HTTP版本6.3狀態(tài)行6.3.1HTTP版本本文檔支持對(duì)HTTP1.1[1]的映射，所以版本域必須設(shè)為“HTTP/1.1”。6.3.2狀態(tài)碼StatusCode)可以被映射到一個(gè)相同表6.3.2-1:狀態(tài)碼映射4104(GROUP_REQUEST_IDENTIFIE5205(SUBSCRIPTION_HOST_HAS5206(NON_BLOCKING_REQUEST_6003(EXTERNAL_OBJECT_NOT6005(EXTERNAL_OBJEST6010(MAX_NUMBER_OF_MEMBE6011(MEMBER__個(gè)INCONSISTENT)6020(MANAGEMENT_SESSION_CANNOT_BE_E6021(MAN1GENENT_SESSION_ESTABLISHME6.3.3原因短語6.4頭字段域6.4.1Host字段Host頭字段必須被設(shè)為接收方pointOfAccess屬性值中的一個(gè)(即相應(yīng)<reroteCSE>資源中的發(fā)起方可以采用Accept頭字段來指示發(fā)起方支持哪種內(nèi)容類型。Accept頭字段必須映射到"application/xml",6.4.3Content-type字段任何包含消息體的HTTP請(qǐng)求或響應(yīng)必須包含Content-type頭字段集中的一種，包“application/vnd.onem2m-res+json”,“application/vnd.onem2m-ntfy+xml”“application/vnd.onem2m-ntfy+json”,“application/vnd.onem2m-attrs+xml”“application/vnd.onem2m-attrs+json”。的媒體類型之一(見6.7[31)。Content-Type:.p]lication/vnd.onem26.4.4Content八位組長度(8比特字節(jié))。6.4.7X-M2M-Origin字段X-M2M-Origin頭字段必須和請(qǐng)求/響應(yīng)原語的From參數(shù)相映射，反之亦然，如果X-M2M-Origin頭字段值必須由請(qǐng)求發(fā)起方(如AE或CSE)分配。6.4.8X-M2M-RI字段6.4.9X-M2M-NM字段6.4.10X-M2M-GID字段6.4.11X-M2M-RTU字段X-M2M-RTU頭字段必須映射到請(qǐng)求原語中Respo如果適用的話。如果元素中有多個(gè)值，則這些值間必須來用“L”字符連接。6.4.12X-M2M-OT字段X-M2M-OT頭字段必須映射到請(qǐng)求和響應(yīng)原語的OriginatingTimestamp參數(shù)，反之亦然，如果適用的話。6.4.13X-M2M-RST字段X-M2M-RST頭字段必須映射到請(qǐng)求和響應(yīng)原語的ResultExpirationTimestamp參數(shù)，反之亦如果適用的話。X-M2M-RET頭毛”必須映射到請(qǐng)求原語的RequestExpirationTimestamp參數(shù)，反之亦然，如果適用的話。6.4.15X-M2M-0EI字段X-M2M-OET頭字段必須映