DB3502∕T 056.3-2020 政務(wù)信息共享協(xié)同平臺(tái) 第3部分：接入要求VIP

3502/TThesharingandcollaborativeplatformofgovernmentinformation—Part3：InterfacerequireI 2 2 3 3 4 46.4接入數(shù)據(jù)流資源 5 6 6 7 77.4使用數(shù)據(jù)流資源 8 8 8 8 98.4公共參數(shù)說明 參考文獻(xiàn)..............................................................................39本文件按照GB/T1.1—2020《標(biāo)準(zhǔn)化工作導(dǎo)則第1部分：標(biāo)準(zhǔn)化文件的結(jié)構(gòu)和起草規(guī)則》的規(guī)定本文件為DB3502/T056《政務(wù)信息共享協(xié)同平臺(tái)技術(shù)規(guī)范》的第3部分。DB3502/T056已發(fā)布了以d)增加接入日志記錄要求，建立調(diào)用方與平臺(tái)的對）；）；本文件起草單位：廈門暢享信息技術(shù)有限公司、廈門市標(biāo)準(zhǔn)化研究院、廈門市信息中入要求、二次開發(fā)的技術(shù)標(biāo)準(zhǔn)，擬由四個(gè)部分——第1部分：總體設(shè)計(jì)。目的在于確立平臺(tái)關(guān)鍵技體架構(gòu)滿足國家對政務(wù)信息交換與共享的要求，明確平臺(tái)內(nèi)主要功能模塊和模塊間的邏輯關(guān)——第2部分：資源管理。目的在于規(guī)范平臺(tái)所支持的多平臺(tái)對外服務(wù)的兼容性提供保障；明確平臺(tái)不同類型資源的屬性，統(tǒng)一屬性分類，為平臺(tái)對外服務(wù)的通用性提供保障；針對資源生產(chǎn)、資源注冊、源目錄、資源檢索、資源版本、資源安全等操作提出全生命周期管理要求，為平臺(tái)對外服務(wù)——第3部分：接入要求。目的在于將平臺(tái)對外接口標(biāo)準(zhǔn)化，明確接口在安全性、易用性、穩(wěn)定性方面要求，進(jìn)一步提升平臺(tái)對外提供服務(wù)的能力和質(zhì)量，并入、平臺(tái)資源生產(chǎn)方、平臺(tái)資源消費(fèi)方、區(qū)級平臺(tái)接入等方面，明確接入的實(shí)現(xiàn)方式，為?！?部分：二次開發(fā)。目的在于規(guī)范平臺(tái)提供二次開發(fā)的工作方為后續(xù)平臺(tái)業(yè)務(wù)流程及插件的完善提供統(tǒng)一標(biāo)準(zhǔn)，既避免了平允許不同部門結(jié)合特定業(yè)務(wù)需要，在授權(quán)范圍內(nèi)擴(kuò)展1政務(wù)信息共享協(xié)同平臺(tái)第3部分：接入要求本文件規(guī)定了生產(chǎn)方、消費(fèi)方、區(qū)級平臺(tái)接入政務(wù)信息共享協(xié)同平臺(tái)的技術(shù)DB3502/T056.1—2020政務(wù)信息共享協(xié)同平臺(tái)第1部分：總體DB3502/T056.2—2020政務(wù)信息共享協(xié)同平臺(tái)第2部分：資源管理DB3502/T056.1—2020、DB3502/T056.2—2020界定的以及下列術(shù)語和定義適用于本文件。3.13.23.3基于服務(wù)流程引擎，融合多個(gè)原子服務(wù)，實(shí)現(xiàn)將多個(gè)細(xì)顆3.43.53.623.73.84縮略語API：應(yīng)用程序編程接口（ApplicationPrograAPP：應(yīng)用程序（APPlication）GB：計(jì)算機(jī)存儲(chǔ)單位，吉字節(jié)（GigaBytHTTP：超文本傳輸協(xié)議（HyperTextTrJSON：基于“JavaScript”語言形式的數(shù)據(jù)對象表達(dá)方式（JavaScriptRTSP：實(shí)時(shí)流傳輸協(xié)議（RealTimeStreamingProREST：表述性狀態(tài)轉(zhuǎn)移（REpresentatiSDK：軟件開發(fā)工具包（SoftwareDevelopmeSFTP：SSH文件傳輸協(xié)議（SSHFileTransferSOAP：簡單對象訪問協(xié)議（SimpleObjSSL：安全套接層（SecureSocketsTCP：傳輸控制協(xié)議（TransmissiTLS：傳輸層安全協(xié)議（TransportLayerSecuriUDP：用戶數(shù)據(jù)報(bào)協(xié)議（UserDatagramProtocoUTF-8：8位的針對Unicode的可變長度字符編碼（8-bitUnicodeTransURL：統(tǒng)一資源定位系統(tǒng)（UniformResourceLocaWSDL：Web服務(wù)器描述語言（WebServiceDescriXML：擴(kuò)展性標(biāo)識(shí)語言（eXtensibleMarkupLaXSD：XML結(jié)構(gòu)定義（XMLSchemaDefini3c)部署接入前置機(jī)應(yīng)由部門端和總控中心雙方共同管理。前置機(jī)上主要部署分控中心所需的軟含義參照DB3502/T056.2—2020中5.MessageFormatandProtoc.2接入本平臺(tái)的服務(wù)方默認(rèn)只支持基本數(shù)據(jù)類型，以消除由于使用不同語言、不同框架實(shí)現(xiàn)式接入。服務(wù)的報(bào)文格式及交換形式滿足HTTP1.0或HTTP1.1傳輸協(xié)議，采用GET或POST方法提起請求，采用JSON格式、XML或自定義純文本作為請求或回應(yīng)報(bào)文的載4a)不做身份認(rèn)證僅加密報(bào)文。b)加密報(bào)文且實(shí)現(xiàn)請求方通過證書驗(yàn)證服務(wù)方，服務(wù)方不驗(yàn)證請求方。c)加密報(bào)文且請求與服務(wù)方相互驗(yàn)證對方身份三種安全交換方式。6.2接入數(shù)據(jù)文件資源數(shù)據(jù)文件資源接入涉及到兩類用戶，分控管理員和總數(shù)據(jù)文件資源應(yīng)符合以下要求，以提供穩(wěn)定的數(shù)據(jù)資6.3接入數(shù)據(jù)庫表資源數(shù)據(jù)庫表資源接入涉及到兩類用戶，分控管理員和總資源描述、資源文檔。字段含義參照DB3502/T056.2—2020中5d)數(shù)據(jù)庫表的字段類型應(yīng)在可共享字段類型范圍內(nèi)，暫不支MySQL字段NUMBERMEDIUMINTMEDIUMTEXTMEDIUMBLOB6.4接入數(shù)據(jù)流資源期、共享類型、共享范圍、協(xié)議類型、服務(wù)IP地址、服務(wù)端口、資源描述、資源文檔。字段含義參照DB3502/T056.2—2020中5.1的6消費(fèi)方使用服務(wù)接口接入流程包括兩步：第一步是分控管理員填寫申請使用服務(wù)的信息，總c)聯(lián)系人：指定請求申請目標(biāo)服務(wù)的聯(lián)系人信息；d)聯(lián)系人電話：指定請求申請目標(biāo)服務(wù)的聯(lián)系人電話；e)授權(quán)業(yè)務(wù)：指定請求申請目標(biāo)服務(wù)所用的授權(quán)業(yè)f)授權(quán)應(yīng)用系統(tǒng)：指定請求申請目標(biāo)服務(wù)所用的授權(quán)應(yīng)用系統(tǒng)；g)使用頻率：指定請求申請目標(biāo)服務(wù)所用的最高頻率；h)使用并發(fā)量：指定請求申請目標(biāo)服務(wù)所用的最高并發(fā)量；i)其他技術(shù)請求：指定請求申請目標(biāo)服.2協(xié)同平臺(tái)服務(wù)資源訪.3協(xié)同平臺(tái)服務(wù)資源短碼通過在協(xié)同平臺(tái)申請的資源詳情下載使用手冊來查閱。授權(quán)短碼代表應(yīng)用與共享服務(wù)資源的對應(yīng)關(guān)系，不同應(yīng)用對同個(gè)可.5協(xié)同平臺(tái)記錄被調(diào)用日志時(shí)，需記錄辦件編碼信息；調(diào)用方記錄調(diào)用日志時(shí)，需記錄辦件77.2使用數(shù)據(jù)文件資源b)第二步：消費(fèi)方或消費(fèi)方的應(yīng)用系統(tǒng)通過SFTP協(xié)議或指7.3使用數(shù)據(jù)庫表資源b)第二步：總控管理員配置數(shù)據(jù)庫交換方案，將數(shù)據(jù)同步到前置庫或推送到業(yè)務(wù)庫；8h)接收方式：指定請求申請數(shù)據(jù)庫表資源的接收方式，包按照申請信息中的相關(guān)要求，初始化對應(yīng)的數(shù)據(jù)庫用戶及庫7,4使用數(shù)據(jù)流資源消費(fèi)方使用數(shù)據(jù)流資源流程b)第二步：消費(fèi)方的應(yīng)用系統(tǒng)構(gòu)建請求d)聯(lián)系人電話：指定請求申請目標(biāo)數(shù)據(jù)流資源的聯(lián)系人電話；e)授權(quán)業(yè)務(wù)：指定請求申請目標(biāo)數(shù)據(jù)流資源所用的授權(quán)業(yè)務(wù)；f)授權(quán)應(yīng)用系統(tǒng)：指定請求申請目標(biāo)數(shù)據(jù)流資源所用的授權(quán)應(yīng)用系統(tǒng)；按照目標(biāo)數(shù)據(jù)流資源指定的數(shù)據(jù)訪問協(xié)議，訪問協(xié)同平臺(tái)開放的數(shù)據(jù)流資源放的資源。協(xié)同平臺(tái)提供基于WebService形式的開發(fā)接口。接入報(bào)文示例見附8.2區(qū)級平臺(tái)接入申請8.2.1區(qū)級平臺(tái)接入之前，應(yīng)在市政務(wù)信息共享協(xié)同平臺(tái)管理系統(tǒng)發(fā)起接入申請。其中需要選擇所需9c)發(fā)布服務(wù)接口：調(diào)用該接口，可向市級平臺(tái)開放區(qū)級平臺(tái)上的服務(wù)資源；f)調(diào)用服務(wù)接口：調(diào)用已通過“申請服務(wù)接口”，并完成并通過申請的市級平臺(tái)服務(wù)。8.2.2審核通過后，指定應(yīng)用即可上線調(diào)用指定的市級平臺(tái)接口。a)AppID：由系統(tǒng)生成，作為應(yīng)用的唯一標(biāo)識(shí)；b)SecretKey：由系統(tǒng)生成，用來驗(yàn)證應(yīng)用合法性的加密串。a)在管理頁面填寫基本信息，應(yīng)包括：應(yīng)用8.3調(diào)用平臺(tái)服務(wù)接口流程8.3.1擁有平臺(tái)用戶帳號和應(yīng)用AppID和SecretKey8.4公共參數(shù)說明是是否是msg在使用HTTP協(xié)議請求接口時(shí)，為了確保應(yīng)用與API服務(wù)器之間的安全通信，防止SecretKey盜用，待簽名的源串包括3部分內(nèi)容并用“&”字符拼接：HTTP請求方式&urlencode(uri)&urlencode(a=x&b=y&...下面以/user/get_ia)第一步：原始請求信息：）：3)請求參數(shù)：appid=123456&format=json&name=jack&access_token=eb)第二步：構(gòu)造源串：3)將2）中排序后的參數(shù)(key=value)用&拼接：access_token=e1&format=json&name=jack；編碼結(jié)果為：access_token%3De123456%26appid%3D123456%26format%5)將HTTP請求方式、1）以及3）中的到的字符串用&拼接起來，得到源串：GET&%2Fuser%2Fget_info&access_token%3De123456%26appid%3D123456%26formaGET&%2Fuser%2Fget_info&access_token%3De123456%26appid%3D123456%26formaon%26name%3Djack&12注：除非接口文檔中特別標(biāo)注了某參數(shù)不參與簽名，功能說明：獲取需要授權(quán)的Res請求地址：/auth/tok公共參數(shù)：發(fā)送請求時(shí)應(yīng)傳入公共參是是返回參數(shù)說明：包含公共返回參數(shù)和業(yè)務(wù)返回參數(shù)。登錄驗(yàn)功能說明：退出登錄的操作，注銷a請求地址：/auth/e公共參數(shù)：發(fā)送請求時(shí)應(yīng)傳入公共參功能說明：獲取指定表碼表的請求地址：/system/get_table_c公共參數(shù)：發(fā)送請求時(shí)應(yīng)傳入公共參是返回參數(shù)說明：包含公共返回參數(shù)和業(yè)務(wù)返回參數(shù)。表碼功能說明：獲取本單位發(fā)布的服務(wù)列表。第三方應(yīng)用應(yīng)根據(jù)服務(wù)狀態(tài)和審核狀態(tài)請求地址：/service/get_my_serv公共參數(shù)：發(fā)送請求時(shí)應(yīng)傳入公共參否否否否返回參數(shù)說明：包含公共返回參數(shù)和wsdl請求地址：/service/save_serv否作是最終存儲(chǔ)在平臺(tái)為：XM.GOV.YZ.D是否是是是是是是否否是否wsdl是是是是是是是是否是否否是是是是是參數(shù)輸入順序的排序值，用兩位的數(shù)字字符串表示，如：功能說明：獲取服務(wù)的詳細(xì)信請求地址：/service/get_service_i是否否是是返回參數(shù)說明：包含公共返回參數(shù)和wsdl是是是是參數(shù)輸入順序的排序值，請用兩位的數(shù)字字符串表示，如：是是是是是是是是是是請求地址：/service/submit_servi公共參數(shù)：發(fā)送請求時(shí)必須傳入公共參數(shù)。是是參數(shù)值組成的json串，組成規(guī)則為參數(shù)名為key，參數(shù)值為是返回參數(shù)說明：包含公共返回參數(shù)和8.5.10獲取可申請的外部服務(wù)列表功能說明：獲取其他部門單位的服務(wù)列表。請求地址：/service/get_external_servic公共參數(shù)：發(fā)送請求時(shí)必須傳入公共參數(shù)。否否否否否，（wsdlWSDL地址8.5.11獲取申請過的外部服務(wù)列表功能說明：獲取其他部門單位的服務(wù)列表。請求地址：/service/get_apply_service業(yè)務(wù)參數(shù)：獲取申請過的外部服務(wù)否否否否否）；wsdl請求地址：/service/apply_servi業(yè)務(wù)參數(shù)：申請外部是是是是是是否返回參數(shù)：包含公共返回參數(shù)和業(yè)務(wù)返回參數(shù)，申請外部服務(wù)接a)通過協(xié)同平臺(tái)的授權(quán)地址獲取資源動(dòng)態(tài)憑證令牌；b)通過協(xié)同平臺(tái)的服務(wù)調(diào)用地址訪問相應(yīng)的服務(wù)，importcom.alibaba.importjava.security.Keimportjava.security.NoSucimportjava.security.certimportjava.security.import.ssl**privatestaticfinalStringXSH"https://6:20184/core/request/token?appIprivatestaticfinalStr"ff8080816e399e4e01privatestaticfinalStringXSHAR"https://6/core/Ynqqqq?acStringqueryTokenUrl=MessageFormat.format(XSHARXSHARE_APP_ID,XSHARE_JSONObjectaccessTokenInfo=queryAccessToken(quStringcallServiceUrl=MessageFormat.format(XSHARE_accessTokenInfo.getString("accesByteArrayOutputStreamresult=post(callServiceUrl,jSystem.out.println(result.toString("UTFSystem.out.println(e.getSystem.out.println(e.getSystem.out.println(e.getMSystem.out.println(e.geSystem.out.println(e.getSystem.out.println(e.ge}}**@throwsPoseidonEprivatestaticJSONObjectqueryAccessthrowsIOException,PoByteArrayOutputStreamresult=get(url,timJSONObjectaccessToken}*@throwsPoseidonEpublicstaticByteAthrowsIOException,PoByteArrayOutputStreamresult=request(url,"GET",null,t}*@throwsNoSuchAlgorithmE*@throwsKeyManagementEpublicstaticByteArrayOutputStreampost(StringtimeOut)throwsIOException,PoByteArrayOutputStreamresult=request(url,"POST",param,}privatestaticByteArrayOutputStreamrequest(Stringurl,Striconnection.setConnectTimeout(connection.setReadTimeout(tconnection.setRequestMconnection.setRequestProperty("POSEOutputStreamoutputStream=connection.getOutpoutputStream.write(requestParam.getBytes("UT}ByteArrayOutputStreamresult=copyStreamToByteArrayOutputStream(connection.getthrownewPoseidonException(connection.geresult.toString("UTF}ByteArrayOutputStreamresult=copyStreamToByteArrayOutputStream(connection.getIn}privatestaticByteArrayOutpreturnnewByteArrayOutputSByteArrayOutputStreamout=newByteArrayOutputStrebyte[]buffer=newbyteout.write(buffer,0,}}**@throwsKeyManagementE*@throwsNoSuchAlgorithprivatestaticvoidallowAllHostKeyManagementException,NoSuchAlgorithmETrustManager[]trustAllCerts=newTrustManagepublicvoidcheckClientTrusted(X509Certificate[]x509CerStrings)throwsCerti}publicvoidcheckServerTrusted(X509Certificate[]x509CerStrings)throwsCertific}returnnewX509Certif}SSLContextsslContext=SSLContext.getInstance(sslContext.init(null,trHttpsURLConnection.setDefaultSSLSocketFactory(sslContext.getSocketFaHostnameVerifierhostnameVerifier=newHostnameVerHttpsURLConnection.setDefaultHostnameVerifier(hostnameV}*平臺(tái)異常信息，如果項(xiàng)目有全局處理異常宜將該內(nèi)部類移到}}}POST/auth/tokenHTTContent-Type:application/x-www-form-urlen&login_name=admin&pwd=9iaaaabbdsss&sig=75897972f153d6509988227fa8bba9ab{"data":{"access_token":"10000f771b200}<?xmlversion="1.0"encoding=POST/auth/exitHTTContent-Type:application/x-www-form-urlenappid=123456&format=json&access_token=e123456&sig=bc529866f252b086db2b40f22f{}<?xmlversion="1.0"encoding=POST/service/get_table_codeHTTContent-Type:application/x-www-form-urlenappid=123456&format=json&access_token=e123456&table_id=1&sig=e473e175162b14bf52e321c{{{}<?xmlversion="1.0"encoding=POST/service/get_my_service_listHTContent-Type:application/x-www-form-urlen&access_token=e123456&review_status=0&service_status=0&sig=e473e175162b14bf52e321cff4c5e52d{{"id":"ff8080813c195804013"service_id":"XM.GOV."expiration_date":"2"wsdl":"HTTP://42:8082/ws/services/hel}<?xmlversion="1.0"encoding={{}<?xmlversion="1.0"encoding=POST/service/get_my_service_listHTContent-Type:application/x-www-form-urlen&access_token=e123456&id=1234567890&sig=e473e175162b14bf52e321cff4c5e52d{"wsdl":"HTTP://42:8082/ws001/services/"service_type":"1","service_na"id":"ff8080813d47949101"authorize_dept_cn":""instruction":"","review_status":"1","se"keyword":"","doc_type":"","output"xsd_name":"","is_enabled":"0","review_date":{"input_type":"int","input_name":"a","input_directions":"a","in{"input_type":"int","input_name":"b","input_directions":"b","develop_language":"Java","expiration_date":"20230308235959","is_private":"0"rk":"Spring","method":"Addservices","output_type":"","call_directions":"","service_}<?xmlversion="1.0"encoding=<itemname="service_id">XM.GOV.YZ.D<itemname="departm<itemname="wsdl">HTTP://42:8082/ws001/services/Addservi<itemname="departm<itemname="review_op<itemname="service<itemname="service_name">人口家<itemname="concurrent_l<itemname="id">ff8080813d479491013d4947<itemname="develop_framework_<itemname="authorize_dept">RS,G<itemname="output_err<itemname="create_date">2013030<itemname="authorize_dept_cn">人社,公安,<itemname="review_<itemname="se