ICS35.080CCSL773201DB3201/T1240-2025前言 12規(guī)范性引用文件 13術(shù)語(yǔ)和定義 14接入數(shù)據(jù) 15數(shù)據(jù)接入方式 36數(shù)據(jù)接口要求 7參考文獻(xiàn) 9ⅡDB3201/T1240-2025本文件按照GB/T1.1—2020《標(biāo)準(zhǔn)化工作導(dǎo)則第1部分：標(biāo)準(zhǔn)化文件的結(jié)構(gòu)和起草規(guī)則》的規(guī)定起草。請(qǐng)注意本文件的某些內(nèi)容可能涉及專(zhuān)利。本文件的發(fā)布機(jī)構(gòu)不承擔(dān)識(shí)別專(zhuān)利的責(zé)任。本文件由南京市應(yīng)急管理局提出并歸口。本文件起草單位：南京市應(yīng)急管理局、南京市產(chǎn)品質(zhì)量監(jiān)督檢驗(yàn)院（南京市質(zhì)量發(fā)展與先進(jìn)技術(shù)應(yīng)用研究院）、南京擎天科技有限公司、江蘇省電子信息產(chǎn)品質(zhì)量監(jiān)督檢驗(yàn)研究院（江蘇省信息安全測(cè)評(píng)中心）、御維網(wǎng)絡(luò)安全技術(shù)有限公司。本文件主要起草人：徐仁兒、張?jiān)讫垺埍绦?、王曉、戴軍、?yán)婷、張帥、儲(chǔ)鑫源、章文天。DB3201/T1240-20251城市安全風(fēng)險(xiǎn)綜合監(jiān)測(cè)預(yù)警平臺(tái)數(shù)據(jù)接入規(guī)范本文件規(guī)定了城市安全風(fēng)險(xiǎn)綜合監(jiān)測(cè)預(yù)警平臺(tái)（以下簡(jiǎn)稱(chēng)綜合平臺(tái)）的接入數(shù)據(jù)、數(shù)據(jù)接入方式及數(shù)據(jù)接口要求。本文件適用于綜合平臺(tái)接入城市安全風(fēng)險(xiǎn)監(jiān)測(cè)各類(lèi)數(shù)據(jù)的業(yè)務(wù)。2規(guī)范性引用文件本文件沒(méi)有規(guī)范性引用文件。3術(shù)語(yǔ)和定義下列術(shù)語(yǔ)和定義適用于本文件。3.1城市安全風(fēng)險(xiǎn)urbansafetyrisk發(fā)生危險(xiǎn)事件或有害暴露的可能性，與隨之引發(fā)的人身傷害、健康損害、財(cái)產(chǎn)損失、城市運(yùn)行破壞、生態(tài)環(huán)境危害和社會(huì)影響的嚴(yán)重性的組合。[來(lái)源：GB/T42768-2023，3.3，有修改]3.2數(shù)據(jù)元dataelement一種數(shù)據(jù)單位，在某個(gè)上下文中視為不可分，通過(guò)一組屬性描述其備注、標(biāo)識(shí)、表示和允許值。[來(lái)源：GB/T5271.4-2000，04.07.01，有修改]4接入數(shù)據(jù)4.1數(shù)據(jù)分類(lèi)綜合平臺(tái)所涉及的主要數(shù)據(jù)分類(lèi)見(jiàn)表1。表1數(shù)據(jù)分類(lèi)DB3201/T1240-20252表1數(shù)據(jù)分類(lèi)（續(xù)）4.2數(shù)據(jù)元屬性4.2.1標(biāo)識(shí)類(lèi)屬性為適用于本文件數(shù)據(jù)元標(biāo)識(shí)的屬性。主要內(nèi)容應(yīng)包含數(shù)據(jù)元名稱(chēng)、英文名稱(chēng)、表示符號(hào)、數(shù)據(jù)元標(biāo)識(shí)符、版本、注冊(cè)機(jī)構(gòu)、同義名稱(chēng)、語(yǔ)境等。4.2.2說(shuō)明類(lèi)屬性為描述數(shù)據(jù)元語(yǔ)義方面的屬性。主要內(nèi)容應(yīng)包含備注、對(duì)象類(lèi)詞、特性詞、應(yīng)用交換約束等。4.2.3關(guān)系類(lèi)屬性為描述數(shù)據(jù)元之間相互關(guān)聯(lián)和(或)數(shù)據(jù)元與模式、數(shù)據(jù)元概念、對(duì)象、實(shí)體之間關(guān)聯(lián)的屬性。主要內(nèi)容應(yīng)包含表示詞、分類(lèi)方案值、關(guān)系等。4.2.4表示類(lèi)屬性為描述數(shù)據(jù)元表示方面的屬性。主要內(nèi)容應(yīng)包含數(shù)據(jù)類(lèi)型、數(shù)據(jù)格式、值域等。4.2.5管理類(lèi)屬性為描述數(shù)據(jù)元管理與控制方面的屬性。主要內(nèi)容應(yīng)包含狀態(tài)、提交機(jī)構(gòu)、批準(zhǔn)日期4.2.6附加類(lèi)屬性為上述未能詳細(xì)描述的其他屬性。4.3數(shù)據(jù)元格式數(shù)據(jù)元格式應(yīng)主要包括字符串類(lèi)型、字母字符類(lèi)型、數(shù)值型字符類(lèi)型、字母和數(shù)字字符類(lèi)型、日期類(lèi)型、貨幣類(lèi)型、長(zhǎng)文本類(lèi)型和文件類(lèi)型，數(shù)據(jù)元表示格式的相關(guān)信息見(jiàn)表2。表2數(shù)據(jù)元表示格式CC..nDB3201/T1240-20253表2數(shù)據(jù)元表示格式（續(xù)）AA..nNN..nD12位定長(zhǎng)、全數(shù)字表示（YYYYMMDDhhmm）。年用4DECIMAL(10,2)：表示最多10位數(shù)—ff—5數(shù)據(jù)接入方式5.1數(shù)據(jù)接入DB3201/T1240-20254綜合平臺(tái)所需的城市安全風(fēng)險(xiǎn)數(shù)據(jù)主要來(lái)源于南京市應(yīng)急管理局?jǐn)?shù)據(jù)治理系統(tǒng)，數(shù)據(jù)治理系統(tǒng)按照本規(guī)范分別從上級(jí)應(yīng)急部門(mén)、政務(wù)數(shù)據(jù)共享平臺(tái)進(jìn)行數(shù)據(jù)接入。各行業(yè)領(lǐng)域城市安全風(fēng)險(xiǎn)監(jiān)測(cè)預(yù)警子平臺(tái)（以下簡(jiǎn)稱(chēng)子平臺(tái)）統(tǒng)一參照《南京市政務(wù)數(shù)據(jù)管理暫行辦法》將數(shù)據(jù)匯聚至政務(wù)數(shù)據(jù)共享平臺(tái)。綜合平臺(tái)需要接入的數(shù)據(jù)形態(tài)，主要應(yīng)包括庫(kù)表形態(tài)、文件形態(tài)、接口形態(tài)和消息形態(tài)。此外，對(duì)于在應(yīng)用系統(tǒng)中沒(méi)有的數(shù)據(jù)，應(yīng)采用人工填報(bào)的方式進(jìn)行數(shù)據(jù)采集。5.2接入方式5.2.1庫(kù)表、文件數(shù)據(jù)匯聚對(duì)于庫(kù)表和文件形態(tài)的數(shù)據(jù)應(yīng)采用數(shù)據(jù)匯聚的方式進(jìn)行數(shù)據(jù)接入，庫(kù)表形態(tài)數(shù)據(jù)源通過(guò)前置數(shù)據(jù)庫(kù)的方式提供數(shù)據(jù)；文件形態(tài)數(shù)據(jù)源端通過(guò)文件服務(wù)器的方式提供數(shù)據(jù)。主要特征及實(shí)現(xiàn)如下：——應(yīng)用場(chǎng)景：主要應(yīng)用于和數(shù)據(jù)源系統(tǒng)進(jìn)行監(jiān)測(cè)、預(yù)警、處置等數(shù)據(jù)的接入；——交互特點(diǎn)：對(duì)數(shù)據(jù)同步的實(shí)時(shí)性要求不高，增量數(shù)據(jù)大，一般按照T+1進(jìn)行數(shù)據(jù)同步；——實(shí)現(xiàn)方式：綜合平臺(tái)錄入數(shù)據(jù)匯聚標(biāo)準(zhǔn)，應(yīng)包括表結(jié)構(gòu)、字段名稱(chēng)、字段屬性等要求（對(duì)于沒(méi)有明確要求的庫(kù)表和文件數(shù)據(jù)，可不錄入?yún)R聚標(biāo)準(zhǔn)通過(guò)數(shù)據(jù)治理系統(tǒng)將任務(wù)下發(fā)給數(shù)據(jù)源系統(tǒng)，上級(jí)應(yīng)急部門(mén)、政務(wù)數(shù)據(jù)共享平臺(tái)通過(guò)數(shù)據(jù)源系統(tǒng)獲取任務(wù)，子平臺(tái)通過(guò)政務(wù)數(shù)據(jù)共享平臺(tái)獲取任務(wù)。采用數(shù)據(jù)匯聚方式實(shí)現(xiàn)數(shù)據(jù)接入過(guò)程的示意圖見(jiàn)圖1。2、下發(fā)數(shù)據(jù)匯聚任務(wù)1、錄入數(shù)據(jù)匯聚標(biāo)準(zhǔn)（如有）數(shù)據(jù)源系統(tǒng)數(shù)據(jù)治理系統(tǒng)數(shù)據(jù)源系統(tǒng)庫(kù)表庫(kù)表引擎庫(kù)表數(shù)據(jù)庫(kù)數(shù)據(jù)數(shù)據(jù)庫(kù)綜綜合平臺(tái)匯聚文件服務(wù)器文件文件引擎文件服務(wù)器政務(wù)數(shù)據(jù)子平臺(tái)共享平臺(tái)3、準(zhǔn)備數(shù)據(jù)并執(zhí)行任務(wù)4、完成數(shù)據(jù)匯聚數(shù)據(jù)流管理流圖1庫(kù)表、文件數(shù)據(jù)匯聚-數(shù)據(jù)接入過(guò)程DB3201/T1240-202555.2.2接口代理對(duì)于接口形態(tài)的數(shù)據(jù)，應(yīng)采用接口代理的方式進(jìn)行數(shù)據(jù)接入，接口形態(tài)數(shù)據(jù)源端通過(guò)API接口的方式提供數(shù)據(jù)。主要特征及實(shí)現(xiàn)如下：——應(yīng)用場(chǎng)景：主要應(yīng)用于和數(shù)據(jù)源系統(tǒng)進(jìn)行動(dòng)態(tài)查詢(xún)等接口的對(duì)接；——交互特點(diǎn)：對(duì)數(shù)據(jù)交換的實(shí)時(shí)性要求高，每次進(jìn)行數(shù)據(jù)交換的增量數(shù)據(jù)較小，由綜合平臺(tái)觸發(fā)接口調(diào)用；——實(shí)現(xiàn)方式：上級(jí)應(yīng)急部門(mén)、政務(wù)數(shù)據(jù)共享平臺(tái)將接口在數(shù)據(jù)源系統(tǒng)上進(jìn)行注冊(cè)和發(fā)布，子平臺(tái)通過(guò)政務(wù)數(shù)據(jù)共享平臺(tái)獲取任務(wù)，數(shù)據(jù)治理系統(tǒng)在數(shù)據(jù)源系統(tǒng)上獲取接口，綜合平臺(tái)在數(shù)據(jù)治理系統(tǒng)上調(diào)用接口。采用接口代理方式實(shí)現(xiàn)數(shù)據(jù)接入過(guò)程的示意圖見(jiàn)圖2。2、接口調(diào)用數(shù)據(jù)治理系統(tǒng)數(shù)據(jù)源系統(tǒng)數(shù)據(jù)治理系統(tǒng)接口代理接口綜合接口代理接口綜合平臺(tái)引擎政務(wù)數(shù)據(jù)子平臺(tái)4—u共享平臺(tái)1、接口注冊(cè)和發(fā)布數(shù)據(jù)流管理流---------b圖2接口代理-數(shù)據(jù)接入過(guò)程5.2.3發(fā)布訂閱對(duì)于消息形態(tài)的數(shù)據(jù)，應(yīng)采用發(fā)布訂閱的方式進(jìn)行數(shù)據(jù)接入，數(shù)據(jù)源端通過(guò)消息隊(duì)列的方式提供數(shù)據(jù)，主要特征及實(shí)現(xiàn)如下：——應(yīng)用場(chǎng)景：主要應(yīng)用于和數(shù)據(jù)源系統(tǒng)進(jìn)行物聯(lián)感知數(shù)據(jù)、監(jiān)測(cè)告警等數(shù)據(jù)的對(duì)接；——交互特點(diǎn)：對(duì)數(shù)據(jù)交換的實(shí)時(shí)性要求高，每次進(jìn)行數(shù)據(jù)交換的增量數(shù)據(jù)較小，由數(shù)據(jù)源端觸發(fā)數(shù)據(jù)的推送；——實(shí)現(xiàn)方式：上級(jí)應(yīng)急部門(mén)、政務(wù)數(shù)據(jù)共享平臺(tái)通過(guò)數(shù)據(jù)源系統(tǒng)推送實(shí)時(shí)產(chǎn)生的數(shù)據(jù),子平臺(tái)通過(guò)政務(wù)數(shù)據(jù)共享平臺(tái)獲取任務(wù)。綜合平臺(tái)在數(shù)據(jù)治理系統(tǒng)上調(diào)用發(fā)布訂閱服務(wù)，輸入監(jiān)測(cè)閾值、黑白名單等比對(duì)條件（如有并獲取滿(mǎn)足條件的數(shù)據(jù)。采用發(fā)布訂閱方式實(shí)現(xiàn)數(shù)據(jù)接入過(guò)程的示意圖見(jiàn)圖3。DB3201/T1240-20256數(shù)據(jù)治理系統(tǒng)3、輸入比對(duì)條件，消息數(shù)據(jù)治理系統(tǒng)數(shù)據(jù)源系統(tǒng)上級(jí)應(yīng)急部門(mén)消息隊(duì)列政務(wù)數(shù)據(jù)子平臺(tái)共享平臺(tái)消息引擎訂閱綜合平臺(tái)1、生產(chǎn)消息2、發(fā)布服務(wù)數(shù)據(jù)流管理流---------b圖3發(fā)布訂閱-數(shù)據(jù)接入過(guò)程5.2.4數(shù)據(jù)填報(bào)對(duì)于沒(méi)有業(yè)務(wù)系統(tǒng)支撐的數(shù)據(jù)，應(yīng)采用數(shù)據(jù)填報(bào)方式進(jìn)行數(shù)據(jù)采集，主要特征及實(shí)現(xiàn)如下：——應(yīng)用場(chǎng)景：主要應(yīng)用于采集各單位沒(méi)有應(yīng)用系統(tǒng)支撐的數(shù)據(jù)；——交互特點(diǎn)：沒(méi)有應(yīng)用系統(tǒng)支撐，對(duì)數(shù)據(jù)交換的實(shí)時(shí)性要求不高，一般針對(duì)臨時(shí)性少量數(shù)據(jù)的采集；——實(shí)現(xiàn)方式：綜合平臺(tái)設(shè)計(jì)自定義表單，并下發(fā)填報(bào)任務(wù)。個(gè)人領(lǐng)取填報(bào)任務(wù)，通過(guò)在線錄入或模板導(dǎo)入的方式填報(bào)數(shù)據(jù)。采用數(shù)據(jù)填報(bào)方式實(shí)現(xiàn)數(shù)據(jù)接入過(guò)程的示意圖見(jiàn)圖4。圖4數(shù)據(jù)填報(bào)-數(shù)據(jù)采集DB3201/T1240-202576數(shù)據(jù)接口要求6.1技術(shù)要求6.1.1傳輸協(xié)議綜合平臺(tái)數(shù)據(jù)接口宜采用HTTPS傳輸協(xié)議，宜使用基于國(guó)密算法的GMTLS協(xié)議。6.1.2接口類(lèi)型綜合平臺(tái)數(shù)據(jù)接口類(lèi)型可采用Restful接口、WebService接口等方式。6.1.3數(shù)據(jù)格式綜合平臺(tái)數(shù)據(jù)格式宜采用XML格式。6.2安全要求6.2.1安全認(rèn)證數(shù)字證書(shū)調(diào)用綜合平臺(tái)數(shù)據(jù)接口的使用方，應(yīng)使用具有國(guó)家密碼管理局電子認(rèn)證服務(wù)許可的機(jī)構(gòu)頒發(fā)的數(shù)字證書(shū)。數(shù)字令牌調(diào)用綜合平臺(tái)數(shù)據(jù)接口的參與方，應(yīng)使用電子認(rèn)證機(jī)構(gòu)簽發(fā)的唯一數(shù)字令牌。使用接口傳輸數(shù)據(jù)時(shí)附加數(shù)字令牌，實(shí)現(xiàn)身份鑒別。6.2.2傳輸安全簽名簽名過(guò)程如下：a)數(shù)據(jù)準(zhǔn)備：將簽名內(nèi)容包括客戶(hù)端id、客戶(hù)端密鑰、時(shí)間戳，以&字符串連接；b)哈希計(jì)算：使用國(guó)密算法對(duì)連接后的字符串進(jìn)行哈希計(jì)算，得到哈希值；c)簽名生成：使用發(fā)送方的私鑰對(duì)哈希值進(jìn)行加密，生成數(shù)字簽名。驗(yàn)簽過(guò)程如下：a)簽名解密：接收方使用發(fā)送方的公鑰對(duì)數(shù)字簽名進(jìn)行解密，得到哈希值；b)哈希驗(yàn)證：接收方使用國(guó)密算法對(duì)接收到的數(shù)據(jù)重新計(jì)算哈希值；c)比較驗(yàn)證：比較解密得到的哈希值和重新計(jì)算的哈希值，如果一致，則驗(yàn)證成功。加密使用國(guó)密算法進(jìn)行請(qǐng)求信息的加密，如果是GET請(qǐng)求，可以選擇對(duì)query參數(shù)的值進(jìn)行加密，如果是POST或PUT等請(qǐng)求，可對(duì)請(qǐng)求Body進(jìn)行加密。加密過(guò)程如下：a)明文轉(zhuǎn)換為字節(jié)數(shù)組：將要加密的明文數(shù)據(jù)轉(zhuǎn)換為字節(jié)數(shù)組；b)使用客戶(hù)端公鑰加密：使用客戶(hù)端的公鑰對(duì)字節(jié)數(shù)組進(jìn)行加密；c)轉(zhuǎn)換為16進(jìn)制格式：將加密后的字節(jié)數(shù)組轉(zhuǎn)換為16進(jìn)制字符串。使用clientSecret進(jìn)行響應(yīng)Body的解密。解密過(guò)程如下：DB3201/T1240-20258a)密文轉(zhuǎn)換為字節(jié)數(shù)組：將接收到的密文（16進(jìn)制格式）轉(zhuǎn)換為字節(jié)數(shù)組；b)使用客戶(hù)端私鑰解密：使用客戶(hù)端的私鑰對(duì)字節(jié)數(shù)組進(jìn)行解密；c)字節(jié)數(shù)組轉(zhuǎn)換為明文：將解密后的字節(jié)數(shù)組轉(zhuǎn)換為明文字符串。6.3調(diào)用方式6.3.1請(qǐng)求接口應(yīng)支持任何http/https的客戶(hù)端進(jìn)行調(diào)用，接口請(qǐng)求頭Header說(shuō)明的相關(guān)信息見(jiàn)表3。表