DB11_T 2290-2024 电子证照共享服务系统接入技术要求.docx

ICS35.240.01DB1.1.北京市地方标准DB11/T22902024电子证照共享服务系统接入技术要求Technica1.requirmentsforshareservicee1.ectroniccertificatesystemaccess2024-06-28发布三4MI1找北京市市场监督管理局发布前言IIII范围I2规范性引用文件13术语和定义I4tfTfi25电子证照共享服务系统接入25.1 接入内容25.2 接入流程：5.3 接入方式35.4 接入安全36电子证照共享服务系统接口要求46.1 接11内容46.2 安全会话接1146.3 电子证照目录查询接口56.4 电子证照制证接口66.5 电子证照操作发布接口76.6 电子证照持证主体授权服务接口96.7 电子证照依职能查验用证接口116.8 接口调用流程13附录A（资料性）电子证照共享职务系统接入巾清15A1.电子证照共享服务系统接入申请表15附录B（资料性）安全会话接口调用示例16B1.登录按口调用示例168.2 退出登录接11网用示例168.3 获取当前已登录用户信息接口调用示例16附录C（资料性）电子证照目录杳询接口调用示例18C1.电子证照目录查询接I1.调用示例18附录D（资料性）电子证照制证接口调用示例19D1.创建制证数据接口调用示例190.2修改制证数据接口调用示例20D.3删除制证数据按口调用示例21附录E（资料性）电子证照操作发布接口调用示例22E1.签发证照接口调用示例22E.2变更一张证照按1.1.调用示例23E.3废止一张证照接口调用示例24E.4批Ift制作i三照接1.I调用示例24附录F（资料性）电子证照持证主体用证服务接口调用示例28F1.统一身份认证用证接口调用示例28F.2用证码提取证照数据接口调用示例28F.3用证码换取访问令牌接口调用示例29F.4用证码归档电子文件接口调用示例30F.S克看电子证照移动端页面按口调用示例31附录G（资料性）电子证照用证服务接口冏用示例32G.I依职能杳整用证接口调用示例32G.2获取证照访问令犍接口调用示例33G.3提取证照数据接口调用示例34G.4者看电子证照页面接口调用示例34参考文献35电子证照共享服务系统接入技术要求1本文件规定了电子证照共享服务系统的接入内容、接入流程、接入方式、接入安全以及接口要求，本文件适用于政务部门存在用证需求的业务系统（以下简称业务系统）3电子证照共享服务系统的对接工作.2般我性引用文件下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款.其中，注日期的引用文件.仅该日期对应的版本适用于本文件：不注口期的引用文件，其也新版本（包括所有的修改以）适用于本文件.GBT36901电子证照总体技术架构GBZT36906电子证照共次服务接D规越DBI1.fT1901政务眼务小项娘码及要索规范3术管和定义GB.T36901,GBJT36906.DB1.1.fT1901界定的以及下列术语和定义适用于本文件.3.1certificate由机关、团体、企事业单位颁发的.他修证明资格或权利等的凭证类文件.来源：GBT36901-2018.3.13.2证照目录certificatecata1.og依据元数据Mt范对证照提取特征,并按照定的分类方法进行推序和编码形成的祖信息.来源GBfT369OI-2OI8,3.233电子U丽e1.ectrmiccertificate按规范形式表达或承就证照信息的电子文件，包含证IW模板，证照数据和签章/签名信息，来源：GBT36901-2018.3.33.4电子EXR共享服务JKIte1.ectroniccertificatesysteaforshareservice为政务部门提供电子证照共享账务的系统，35Idiitacode给政务儒门存在用证需求的事项赋广的代码.3.6事项名葬itenaae对政务部门存在用证需求的事项进行焜范统一的命名.*Ea4批证照接口用示的续）-ackcode*/SUCCESS*.-errors*:.“sign':nu1.1.,"signmethod*:nu1.I1*Iiftustaiip*:nu1.1.orrc1.11tion,id*2b7bcfde-f621-49-15-b282-f49873311436*,返回示例*responsed*:*be9<kt1.>S7-I22c-1.ce-a911-8e9t,f063<f*,*datn*:*1icense_c<×!es*:F(XWO202。(XKXXIS2P"uI1000020200000HU1.N«f.2用证礴取Mga口调用示例谢求小例I1OSThttps:/IAPIROOT)/IicenseZget1icense.qf?nccess_token-ACCESSTWI?*Content-Typojapp1.icationZJSON:(%uthCO加”:FuTHCOM*service_itenname":*办事项",*Mrvicritencode*:*121567S90*bi2nun*:*1002!8000006939799113071OOOO.*operator*:*accownt*bjzj*.*na11r":“张XX0.'idniitynuiT:"1.】O1.o5*h*iwf*",*e1.:'mXK/XX处空科员二"servic«.or«*:*市XXM”»'dNision":"北京市二*division,c<x1.e*:*10105*源回示例(*;«:kcdr*z,SIJCSS*"errors*:,*data*:data.fie1.ds*:(*1icense_code*:*01011.*M32342S12“na11o':'身份证二*ixxu<rgna11c*:*ItIXXW*issue_dave*:*2020-12-12*expirydate*/2020-12-12*version:I,*crcatar*:*tcx1.*."creation-tine”:2020T27二"1.as(x×iificator*est*.*1.axtx×iificatinti11x*:m2O2O12-2w)F3用证码排取访问令接口用示例用证码换取访问令牌接口谓用示例,以JSON格式描述举例,详见表F.3.M用谢换取访问令例如U1.ff1.示例请求示例IjOSThttps:/'APIR(X/1icense/ettokenqr?accessIoken=ACCESSIOKEXContmt-Typciapp1.ication.SON：(“mith/mk”：“1235815”.*serviceitencode*z*,KWiS<>*"servicejtennane":"本项名称，uopcrntor*:()1)送I可示例*errcode*:0.*err11s*:*",-date-J,expiresJn*:*2020-12-1200:00:00*,1.icensoaccesstoken":"dFVzVNBNi1.三n*6ArZ/R4用证码归档电子文件接口调用示例用证码归档电子文件接口调用示例，以JSoN格式描述举例，详见抑.4。«F.4用证码归档电子文件接口售用示创请求示例POSThttps:/<API_ROOT)/1.icense/archivcqr?access_tokcnACCESSTOKEContenc-Tye:app1ication/JSON-data*:FuthCOdeIFUTHCODE*.*service_itwina«。"："申办小项二*fervicciIeI1.Cadj12MS67890."biz11m':"100218000006939799113071.OOOO1，*operator*:(*account*:*bj11zj*,*11arw*iKXX*1.*identitynure":"1IO1.05*余余余-O1.cZ,市KX局XX处室科处二*scnice.org*:*市XXEi*,"division":"北京市:*division_codc*:*1.101.05c*termina1.info,192,168.0.,tit1.estamp*<2020-10-1010:10:10*,*requestid*:*b2629b80-n96f-469b-87f7-0496bc(Mf958*返回示例("ack_cade”S1.CCESS，“errors":,"data":"fi1.ena11w':*1100001.6IXXXX)20.ofdFIedata":"BDAAUDBQEZ”,F.5H电子证II移动页面接口辑用示例查看电子证照移动端页而接1.1.调用示例,以JS0格式描述举例,详见表R5。*F.5查看电子证照移动端页面按调用示例iff求示例https:/1.>1.B.ROOTI/1icense/viwJwbi。？IiCgn翻JKCmOken:IJC曰SE_ACCESSJa(EN返M示例显示电了证照的详情页面S1.用量G电召HR用证务按口调用示例G.1依职能理用证捱口辑用示例依职能钱验用证按U调用示例,以JSoN格式描述举例,详见表GJ,«G.1.侬职充用证接口用示例请求示制POSThttp:/PIJJOOT)/1icns*uth7a<XM-okeo>ACCSS.T0KENContrat-Type:app1.ic«tion/JSQNMrvSdcod:KWTicjit-M三:项名称，sbw,8itiv,t:*W*三.,biuu:业务海水号"，operatar'Mccmt,门1.ebCM.m三t.11,“ro1.e":.加局。处室科员，"sendCjorI”:“市XXJI",“division朝阳区，*diiion.cod*110105,identityju三ber:1IoIO5*,«G.1.依职能会用证接口用示例（续）返I可示例*ack_ccde*:*SUOCESS*errors*,"to1.a】count*:!*auth_codes*:-,aaa*.*bbb*1."dau;(*data_fie1.ds*:(*1icESJed<:"OIQng1.32M22'"m11m':“身份证”*issue_org_nta>e*:*rXX*.*isseDrRcdde":"1.1-杆«1«1*4&50二“取fi为18位"ixxucdnt<*2O2O-12-1.2-.*expiry.date*r2020-12-12*.rversion:J,*creator*:*text*creation_ti«e*:*2020-1.2-1.*,*1.axtncdificator*i*tcNt*,*1.astodification.ti*2020-12-2*G.2嵌取证H访问令H接口断示例获取证照访问令牌按口调用示例,以JSON格式描述举例，详见表G.2,我（口丧取证IM访问令H接口AJf1.示例GET请求示例httx:/(APIR<X>?Jiccn!?c/gct_1.iccnsc?!icr11raccesstIikcn-ACChSSTOXENAnuthcode=MTHeODE«G.2获取IEJi访问令It接口调用示例（续）"SUCCESS",“errors":。,*data":*data.fie1.d.s*:(CIicmxr_codcA:"DIO1.1.9132勿2：142二飞内："身份证"*ixxurCrgniInXItIXXi¾”.*issue<>rg_code*:*Hw*w*w*w*455O*.'/取值为18位返回示例*issuedate*:*2O2(h1.2-12*oxpirydato*2020-12-12*.version:I*<:rrator*:“t<st*creaiion_1.i(ix?*:*2020-12-r.*1.astwdif1.caior*test*.“1.astnodification_tie-:>2020-12-2*G.3IuHHRRt口用示例提取证照数枇接口调用示例,以JSON格式描述举例,详见非G.3,*；.3IMHEMuHH«口调用示例请求示例GCThttps:/APIROOT)/1.icense/token?access_1.oken=ACCESSTOKEXAauth.code=A1.iTHCODE返回示例(,cxpircs.in202312-1200:00:00.000,*1iCCnSC-access.token":"dFYzVNBi*iHMAn6ArZ1.*G.4H电子访页接口辑用示例杳看电子证照页面接口调用示例,以JSOX格式描述举例,详见表G.4。«G.4充电子证原页IV接口用示例请求示例https:/(II1.BKt)OT!icr11xevic*Iicense?HrcnxcMC:(?S1.Qkrn=1.1.CEXSEACO:SSTOKE返回示例枝示的个电干证照的详情页面，考文献GB,'T205182018信息安全技术公钥基础设施数字证书格式GBT329052016信息安全技术SM3桧码杂凑算法网GBT329182016信息安全技术SM2椭版曲跋公铜密码算法4C0124-2018国家政务服务平台电门正照踏区域共享服务接入要求