2022工業(yè)互聯(lián)網(wǎng)標(biāo)識(shí)解析接入認(rèn)證系統(tǒng)接口技術(shù)要求

工業(yè)互聯(lián)網(wǎng)標(biāo)識(shí)解析接入認(rèn)證系統(tǒng)接口技術(shù)要求（2022年5月16日發(fā)布）目 次前 言 II范圍 3規(guī)范性引用文件 3術(shù)語(yǔ)和定義 3概述 3功能要求 3數(shù)據(jù)同步 3接入認(rèn)證 4接口要求 4數(shù)據(jù)同步接口 4新增節(jié)點(diǎn)數(shù)字證書(shū)接口 4更新節(jié)點(diǎn)數(shù)字證書(shū)接口 5刪除節(jié)點(diǎn)數(shù)字證書(shū)接口 5接入認(rèn)證接口 5接口異常返回值 6數(shù)據(jù)同步節(jié)點(diǎn)信息 6I工業(yè)互聯(lián)網(wǎng)標(biāo)識(shí)解析接入認(rèn)證系統(tǒng)接口技術(shù)要求范圍規(guī)范性引用文件（包括所有的修改單適用于本文件。GB/T33745-2017物聯(lián)網(wǎng)術(shù)語(yǔ)GB/T35285-2017信息安全技術(shù)公鑰基礎(chǔ)設(shè)施基于數(shù)字證書(shū)的可靠電子簽名生成及驗(yàn)證技術(shù)要求術(shù)語(yǔ)和定義下列術(shù)語(yǔ)和定義適用于本文件。3.1工業(yè)互聯(lián)網(wǎng)industrialinternet工業(yè)互聯(lián)網(wǎng)是互聯(lián)網(wǎng)和新一代信息技術(shù)與工業(yè)系統(tǒng)全方位深度融合所形成的產(chǎn)業(yè)和應(yīng)用生態(tài)，是工業(yè)智能化發(fā)展的關(guān)鍵綜合信息基礎(chǔ)設(shè)施。3.2標(biāo)識(shí)解析Identifierresolution將標(biāo)識(shí)符翻譯成與其相關(guān)聯(lián)的信息的過(guò)程。[來(lái)源：GB/T33745-2017，定義2.4.3]概述功能要求數(shù)據(jù)同步工業(yè)互聯(lián)網(wǎng)標(biāo)識(shí)解析接入認(rèn)證系統(tǒng)為各個(gè)節(jié)點(diǎn)提供認(rèn)證數(shù)據(jù)同步服務(wù)接口，根據(jù)指定同步請(qǐng)求條件，返回?cái)?shù)據(jù)同步接口結(jié)果信息。數(shù)據(jù)同步請(qǐng)求數(shù)據(jù)格式和數(shù)據(jù)同步結(jié)果返回?cái)?shù)據(jù)格式見(jiàn)第6.1節(jié)。詳細(xì)流程見(jiàn)《工業(yè)互聯(lián)網(wǎng)標(biāo)識(shí)解析接入認(rèn)證技術(shù)要求》第5節(jié)數(shù)字證書(shū)申請(qǐng)業(yè)務(wù)流程。如圖1所示。3同步節(jié)點(diǎn)信息同步節(jié)點(diǎn)信息接入認(rèn)證系統(tǒng)標(biāo)識(shí)解析系統(tǒng)同步結(jié)果圖1 數(shù)據(jù)同步接口同步結(jié)果接入認(rèn)證6.2認(rèn)證請(qǐng)求認(rèn)證請(qǐng)求接入認(rèn)證系統(tǒng)標(biāo)識(shí)解析系統(tǒng)認(rèn)證結(jié)果圖2 接入認(rèn)證接口認(rèn)證結(jié)果接口要求數(shù)據(jù)同步接口新增節(jié)點(diǎn)數(shù)字證書(shū)接口接口名稱：Createnode，同步新增節(jié)點(diǎn)的信息，根據(jù)節(jié)點(diǎn)信息制作節(jié)點(diǎn)數(shù)字證書(shū)。參數(shù)說(shuō)明：見(jiàn)表1表1新增節(jié)點(diǎn)數(shù)字證書(shū)方法參數(shù)說(shuō)明參數(shù)名稱參數(shù)類型描述nodeInfoParamNodeInfoParam節(jié)點(diǎn)信息，見(jiàn)第8節(jié)返回值說(shuō)明：字符串，當(dāng)status為0時(shí)表示新增成功，其他信息新增失敗；當(dāng)message為0時(shí)表示新cert為2000（base64格式）。4更新節(jié)點(diǎn)數(shù)字證書(shū)接口接口名稱：Updatenode，同步節(jié)點(diǎn)的更新信息，根據(jù)更新節(jié)點(diǎn)信息制作節(jié)點(diǎn)數(shù)字證書(shū)。參數(shù)說(shuō)明：見(jiàn)表2表2更新節(jié)點(diǎn)數(shù)字證書(shū)方法參數(shù)說(shuō)明參數(shù)名稱參數(shù)類型描述nodeInfoParamNodeInfoParam節(jié)點(diǎn)信息，見(jiàn)8節(jié)返回值說(shuō)明：字符串，當(dāng)status為0時(shí)表示更新成功，其他信息更新失??；當(dāng)message為0時(shí)表示修改成功，其他信息為錯(cuò)誤信息；當(dāng)cert為2000時(shí)String標(biāo)識(shí)數(shù)字證書(shū)更新失敗，其他為證書(shū)具體信息（base64格式）。刪除節(jié)點(diǎn)數(shù)字證書(shū)接口deletenode，同步節(jié)點(diǎn)的刪除消息，根據(jù)節(jié)點(diǎn)刪除消息吊銷(xiāo)節(jié)點(diǎn)數(shù)字證書(shū)的方法。參數(shù)說(shuō)明：見(jiàn)表3表3刪除節(jié)點(diǎn)數(shù)字證書(shū)方法參數(shù)說(shuō)明參數(shù)名稱參數(shù)類型描述openIdString唯一標(biāo)識(shí)，最長(zhǎng)32字符返回值說(shuō)明：字符串，當(dāng)status為0時(shí)表示刪除成功，其他信息刪除失敗；當(dāng)message為0時(shí)表示刪除成功，其他信息為錯(cuò)誤信息。接入認(rèn)證接口參數(shù)說(shuō)明：見(jiàn)表4表4登錄簽名方法參數(shù)說(shuō)明參數(shù)名稱參數(shù)類型描述userCertString公鑰證書(shū)(base64格式)signDatabyte[]待證書(shū)簽名數(shù)據(jù)原文randomString隨機(jī)數(shù)(10位)timeString時(shí)間戳返回值說(shuō)明：字節(jié)數(shù)組，為2000時(shí)表示登錄簽名失敗，其他為簽名值（返回pkcs1格式的簽名值的base64編碼）。參數(shù)說(shuō)明：見(jiàn)表5表5登錄驗(yàn)證方法參數(shù)說(shuō)明參數(shù)名稱參數(shù)類型描述userCertString簽名證書(shū)(base64格式)5signDatabyte[]待驗(yàn)證的數(shù)據(jù)原文signValuebyte[]簽名值返回值說(shuō)明：字符串，為2000時(shí)表示驗(yàn)證失敗，其他為認(rèn)證令牌token。接口名稱：getSignedNodeData，根據(jù)令牌獲取節(jié)點(diǎn)信息的方法。參數(shù)說(shuō)明：見(jiàn)表6表6獲取節(jié)點(diǎn)信息方法參數(shù)說(shuō)明參數(shù)名稱參數(shù)類型描述tokenString令牌返回值說(shuō)明：字符串，為2000時(shí)表示獲取失敗，其他為節(jié)點(diǎn)信息nodeInfoParam。接口異常返回值接口異常返回值說(shuō)明見(jiàn)表7。表7接口異常返回值錯(cuò)誤碼描述000000系統(tǒng)錯(cuò)誤000002請(qǐng)求中必須包含必要標(biāo)識(shí)000004無(wú)操作權(quán)限000005參數(shù)非法（具體非法參數(shù)信息）數(shù)據(jù)同步節(jié)點(diǎn)信息數(shù)據(jù)同步節(jié)點(diǎn)信息說(shuō)明見(jiàn)表8。表8數(shù)據(jù)同步節(jié)點(diǎn)nodeinfo信息參數(shù)名稱參數(shù)類型描述是否必項(xiàng)nodeTypeString節(jié)點(diǎn)類型：國(guó)家頂級(jí)節(jié)點(diǎn)二級(jí)節(jié)點(diǎn)企業(yè)節(jié)點(diǎn)公共節(jié)點(diǎn)是nodeNameString節(jié)點(diǎn)名稱是areaString組織/單位注冊(cè)所在地域是businesslicenseimage組織/單位營(yíng)業(yè)執(zhí)照是IpString節(jié)點(diǎn)ip地址是prefixString前綴是channelNameString渠道名稱是appSubordinateUnitsString應(yīng)用歸屬單位是appNameString應(yīng)用系統(tǒng)名稱是unitNameString單位名稱是unitPhoneString單位電話否6AddressString通信地址否authorizedRepresentString法定代表人是authorizedPhoneString法人手機(jī)號(hào)是certificateTypeString法人證件類型是certificateCodeString法人證件號(hào)是operatorNameString經(jīng)辦人姓名否operatorPhoneString經(jīng)辦人手機(jī)號(hào)否operatorEmailString經(jīng)辦人郵箱否operatorCertificateTypeString經(jīng)辦人證件類型否operato