ICPIP地址域名信息备案管理系统企业系统接口规范V3.1.doc_第1页
ICPIP地址域名信息备案管理系统企业系统接口规范V3.1.doc_第2页
ICPIP地址域名信息备案管理系统企业系统接口规范V3.1.doc_第3页
ICPIP地址域名信息备案管理系统企业系统接口规范V3.1.doc_第4页
ICPIP地址域名信息备案管理系统企业系统接口规范V3.1.doc_第5页
已阅读5页,还剩88页未读 继续免费阅读

下载本文档

版权说明:本文档由用户提供并上传,收益归属内容提供方,若内容存在侵权,请进行举报或认领

文档简介

。工业和信息化部ICP/IP地址/域名信息备案管理系统企业系统接口规范(3.1版)2015年12月精选资料,欢迎下载目 录1、 引言11-1、 目的11-2、 条件与限制11-3、 名词解释11-4、 规范性引用32、 接口功能52-1、 备案数据上报52-2、 备案数据下载62-3、 是否备案查询72-4、 备案密码校验72-5、 核验材料采集码获取接口83、 接口说明93-1、 接口概述93-2、 接口版本说明103-3、 接口说明103-3-1、 isp_upload方法103-3-1-1、 服务请求地址103-3-1-2、 方法原型103-3-1-3、 方法描述103-3-1-4、 参数描述123-3-1-5、 返回值123-3-2、 isp_download方法133-3-2-1、 服务请求地址133-3-2-2、 方法原型133-3-2-3、 方法描述133-3-2-4、 参数描述143-3-2-5、 返回值153-3-3、 isp_downloadack方法163-3-3-1、 服务请求地址163-3-3-2、 方法原型163-3-3-3、 方法描述163-3-3-4、 参数描述173-3-3-5、 返回值173-3-4、 isp_querypreviousupload方法173-3-4-1、 服务请求地址183-3-4-2、 方法原型183-3-4-3、 方法描述183-3-4-4、 参数描述183-3-4-5、 返回值193-3-5、 isp_querybeianstatus方法203-3-5-1、 服务请求地址203-3-5-2、 方法原型203-3-5-3、 方法描述203-3-5-4、 参数描述203-3-5-5、 返回值213-3-6、 isp_verifybamm方法223-3-6-1、 服务请求地址223-3-6-2、 方法原型233-3-6-3、 方法描述233-3-6-4、 参数描述233-3-6-5、 返回值243-3-7、 isp_getcollectcode方法243-3-7-1、 服务请求地址243-3-7-2、 方法原型243-3-7-3、 方法描述243-3-7-4、 参数描述253-3-7-5、 返回值263-4、 接口返回状态代码表273-5、 数据处理结果代码表284、 数据格式344-1、 上报备案数据格式344-1-1、 ICP上报数据格式344-1-1-1、 新增备案354-1-1-2、 新增网站374-1-1-3、 新增接入384-1-1-4、 变更备案394-1-1-5、 注销备案414-1-1-6、 上报真实性核验材料电子件424-1-1-7、 核验材料接入商核实结果424-1-1-8、 核实结果434-1-1-9、 未备案网站处理结果434-1-2、 IP上报数据格式434-1-2-1、 新增IP备案444-1-2-2、 修改IP备案464-1-2-3、 删除IP备案484-1-3、 域名上报数据格式494-1-3-1、 新增域名备案494-1-3-2、 修改域名备案504-1-3-3、 删除域名备案514-2、 下载备案数据格式514-2-1、 ICP下载数据格式514-2-1-1、 ICP备案数据524-2-1-2、 注销数据544-2-1-3、 黑名单列表544-2-1-4、 非法接入黑名单信息554-2-1-5、 未备案网站信息554-2-1-6、 备案结果554-2-1-7、 核实任务574-2-1-8、 核验材料584-2-1-9、 核查结果594-2-1-10、 相关通知信息604-2-2、 IP下载数据格式614-2-2-1、 IP来源备案结果数据614-2-2-2、 IP分配且使用备案结果数据624-2-2-3、 自带IP广播备案结果数据634-2-2-4、 自带IP备案结果数据644-2-2-5、 IP越界核查结果备案数据644-2-2-6、 IP冲突核查结果备案数据654-2-2-7、 IP未报核查结果备案数据654-2-3、 域名下载数据格式654-2-4、 基础代码下载数据格式664-2-4-1、 报备单位代码表664-2-4-2、 单位分类代码674-2-4-3、 单位性质代码674-2-4-4、 区域代码674-2-4-5、 意见反馈分类代码674-2-4-6、 管局信息674-2-4-7、 行业分类代码684-2-4-8、 行政级别代码684-2-4-9、 证件类型代码684-2-4-10、 网站经营类型代码694-2-4-11、 网站服务类型代码694-2-4-12、 网站接入方式代码694-2-4-13、 注销理由代码694-2-4-14、 域名类型代码704-2-4-15、 核实意见代码704-2-4-16、 未备案独立域名处理代码704-2-4-17、 真实性核验材料电子件附件文件格式代码704-2-4-18、 真实性核验材料电子件附件证件类型代码704-2-4-19、 语言类别代码714-2-5、 SJTB下载数据格式714-2-5-1、 同步ICP备案数据714-2-5-2、 同步IP备案数据744-2-5-3、 同步YM备案数据764-2-5-4、 同步基础代码数据774-2-5-5、 同步黑名单数据814-3、 企业获取备案信息核验材料采集码数据格式825、 附件:报备数据文件格式84精选资料,欢迎下载1、 引言1-1、 目的本企业报备接口是在工业和信息化部ICP/IP地址/域名信息备案管理系统企业系统接口规范(版本V3.0)的基础上,根据工信部备案数据核查评定子系统的需求,补充了ICP、IP地址及域名报备单位使用企业系统向部备案管理系统(以下简称“部级系统”)、省备案管理系统(以下简称“省局系统”)上报备案信息数据,及从部备案管理系统、省备案管理系统获取备案管理信息数据的编程接口。该接口作为开发单位设计、开发企业备案管理系统的依据。1-2、 条件与限制 接口使用的XML文件的编码方式均为GBK; 建议企业使用Java语言开发调用报备接口的程序; 建议对上报和下载的频率进行适度控制。1-3、 名词解释词汇名称词汇含义网站主办者互联网信息服务提供者的简称,主要指内容服务提供者(即ICP),它包括单位(企业法人、政府和事业单位及其分支机构、办事机构、代表机构等)和个人(自然人)两类(通过证件类型进行区分)。接入服务提供者包括因特网接入服务业务经营者(即ISP)、因特网数据中心业务经营者(即IDC)以及以其他方式为网站提供接入服务的单位。增值电信业务经营者的统称(可简称接入商)。域名注册管理机构是指承担顶级域名系统的运行、维护和管理工作的机构。域名注册服务机构是指受理域名注册申请,直接完成域名在国内顶级域名数据库中注册、直接或间接完成域名在国外顶级域名数据库中注册的机构。域名报备单位域名注册管理机构(如CNNIC中国互联网络信息中心)、境内域名注册服务机构和境外域名注册服务代理机构。IP报备单位是指直接从亚太互联网络信息中心等具有IP地址管理权的国际机构获得IP地址的单位和具有分配IP地址供其他单位或个人使用行为的单位,包括基础电信业务经营者、CNNIC、互联网接入服务提供者、公益性互联网络单位等。备案地省(直辖市、自治区)管局网站主体(即网站主办者)所在地省(直辖市、自治区)通信管理局。接入地省(直辖市、自治区)管局提供网站接入服务的接入服务提供者所在地所属省(直辖市、自治区)通信管理局。代为备案由互联网接入服务提供者受委托代网站主办者履行备案手续的行为。用户自行备案由网站主办者自己履行备案手续的行为。前置审批核验拟从事新闻、出版、教育、医疗保健、药品和医疗器械、文化、广播电影电视节目等互联网信息服务,根据法律、行政法规以及国家有关规定应经有关主管部门审核批准;在履行备案手续时,还应向其接入服务提供者提交审批文件原件,由接入服务提供者核验原件、并将批文批号、批文影印件通过系统提交给主办者所在地省通信管理局,由前置审批部门通过省局系统查验审核真伪。这个过程称为前置审批核验。备案号和电子证书是指备案系统为网站主办者发放的用来表明其已履行网站备案手续的序列号和证书文件。备案系统对外是以ICP为单位进行备案,对内是以主体为单位进行备案。一个主体多个网站备案时加网站序列号。备案号采取主体与网站结合编码的方式,由三部分组成:(省简写)ICP备+“主体序列号-网站序列号”;经营性网站:(省简写)ICP证+“主体序列号-网站序列号”。注销自行注销:由网站主办者在企业侧系统发起,一、可以选择注销网站接入,接入服务提供者去掉该备案信息中的本接入服务提供者的接入信息,断开网络接入;二、可以选择注销主体,系统通知其主体名下的所有接入服务提供者。备案号回收,备案库数据相应变更。接入服务提供者注销:由接入服务提供者发起,注销网站接入信息,效果是断开网络接入,并通过短信或邮件通知网站主办者。强制注销(也叫责令关闭网站):强制注销针对主体、网站或域名,由各省通信管理局发起,吊销备案。省局系统通知其下所有网站的所有接入服务提供者,效果是接入服务提供者切断其接入并发出回执,处理结果是备案号回收,网站主办者进黑名单,其关联的所有网站被关闭。Web网站指有独立域名的web站点(包括CN和通用顶级域名(gTLD)下的web站点),或没有域名只有IP地址的web站点。如果有多个独立域名或多个IP指向相同的页面集,视为同一网站(以下简称网站)。WAP WAP(Wireless Application Protocol)是无线应用协议的缩写,一种实现移动电话与互联网结合的应用协议标准。经营性网站提供经营性互联网信息服务的网站。非经营性网站提供非经营性互联网信息服务的网站。非经营性互联网信息服务,是指在中华人民共和国境内的组织或个人利用通过互联网域名访问的网站或者仅能通过互联网IP地址访问的网站,提供非经营性互联网信息服务。未备案网站是指将搜索到的网站的独立域名和系统中已报备的独立域名进行比对,未获得备案号的就是未备案网站。违法违规网站符合关于建立境内违法互联网站黑名单管理制度的通知中第一条描述的六种违规行为的一种或几种情形的境内互联网网站。单位网站互联网信息服务提供者为单位(企业法人、政府和事业单位及其分支机构、办事机构、代表机构等)的网站个人网站互联网信息服务提供者为个人(自然人)的网站黑名单由于网站涉及违法违规而被管理部门列为重点监管或处理对象的网站名单。独立域名是指用户在各顶级域(TLD)注册体系下直接注册的域名。具体说明如下:对部分国家顶级域,以.CN域名为例,即指用户在.CN下直接注册的二级域名,如SINA.CN;或者在信息产业部关于调整中国互联网络域名体系的公告(信部电200699号和信部电2008172号)中规定的CN二级“类别域名”和“行政区域名”下注册的三级域名,如SINA.COM.CN、SINA.NET.CN等;对其他国家顶级域及通用顶级域,以.COM域名为例,是指用户在.COM下直接注册的二级域名,如SOHU.COM,不包括NEWS.SOHU.COM;中文顶级域名是指暂设的“.中国”、“.公司”、“.网络”、“.政府”和“.公益”等。IP地址是一种在Internet上给主机编址的方式,也称网际协议地址,由32位二进制数组成。单位网站互联网信息服务提供者为单位用户(企业法人、政府和事业单位及其分支机构、办事机构、代表机构等)的网站个人网站互联网信息服务提供者为个人用户(自然人)的网站主体信息、网站信息、接入信息详见ICP备案数据格式。空壳网站在备案系统已获得备案号,但没有接入服务提供者的网站空壳主体在ICP库中无任何网站信息的备案主体。部级系统工业和信息化部开发的ICP/IP/域名信息备案管理系统的部级部分省局系统工业和信息化部开发的ICP/IP/域名信息备案管理系统的省局部分企业侧系统接入服务单位为落实接入责任而开发的企业部分的网站备案系统自带IP地址是指IP地址使用单位从为其提供互联网接入服务的单位以外的机构获得的IP地址。由为其提供互联网接入服务单位进行报备(标记自带IP地址)。境内分配此段IP地址的单位也应进行报备(标记为分配且使用、再分配)。自带IP地址广播基础运营企业集团公司将省分公司提交上来的申请入网的自带IP地址在运营商网络进行广播。IP地址自用IP地址报备单位将申请的IP地址自己使用。IP地址分配且使用IP地址报备单位将IP地址分配给终端使用用户。IP地址再分配IP地址报备单位将IP地址分配给具有将IP地址进行再次分配权限的单位。IP地址预留IP地址报备单位已申请获得的IP地址尚未分配。IP地址来源信息IP地址报备单位从上级分配单位所获得的IP地址信息。IP地址分配及使用信息IP地址报备单位从上级分配单位获得IP地址后,如何对这些IP地址进行分配或使用的信息。备案APP提供备案相关服务的移动终端应用程序备案信息核验材料采集码网站主办者用以上报备案信息核验材料的标识码,由省局系统根据接入企业的申请生成1-4、 规范性引用本规范引用以下文件中的条款。凡是注日期和版本的文件,其后续修改版本中的修改条款或新增条款均不适用于本规范,凡是不注日期或版本的文件,其最新内容可适用于本接口规范。1) ICP/IP地址/域名信息备案管理网站备案移动终端服务平台需求说明书(2015.12)2) 备案数据核查评定子系统需求说明书(2013.9.3)3) 工业和信息化部ICP/IP地址/域名信息备案管理系统新增业务需求说明书(2010.11.10)。4) 工业和信息化部ICP/IP地址/域名信息备案管理系统升级改造业务需求说明书V4.2(2009.9.15)。5) 互联网信息服务管理办法(中华人民共和国国务院令第292号)。6) 中国互联网络域名管理办法(信息产业部令第30号)。7) 非经营性互联网信息服务备案管理办法(信息产业部令第33号)。8) 互联网IP地址备案管理办法(信息产业部令第34号)。9) 互联网站管理工作细则(信部电2005501号)。10) 互联网站管理协调工作方案(信部联电2006121号)。11) 关于互联网站ICP备案信息、IP地址信息资源共享工作的意见(信电函200675号文件)。12) 电信网码号资源管理办法(信息产业部令第28号)。2、 接口功能本企业报备接口主要实现企业侧系统与部级系统、省局系统之间的备案数据交互。备案数据交互主要涉及以下三个功能:n 备案数据上报n 备案数据下载n 是否备案查询n 备案密码校验2-1、 备案数据上报企业侧系统将备案数据上报到省局系统或部级系统。企业侧系统通过调用isp_upload()方法,将备案数据作为参数进行上报。通过备案数据上报功能可以将以下备案申请数据提交给省局系统: n ICP备案管理1)新增备案:向省局系统提出新增ICP备案申请。2)新增网站:为已经完成备案的ICP主体增加新的网站。3)新增接入:为已经完成备案的ICP网站增加新的接入。4)变更备案:更新已完成备案的ICP主体、网站、域名或接入信息。5)注销备案:注销已经完成备案的ICP备案记录,包括主体或网站。6)上报真实性核验材料电子件。7)核实结果:上报ICP备案信息的核实结果。8)未备案网站处理结果:提交对未备案网站进行处理后的结果。9)核验材料接入商核实结果。10)变更接入:更新已完成备案网站的接入信息。n IP备案管理1)IP地址来源信息:IP来源信息的新增、修改与删除。2)IP地址分配与使用信息:IP分配与使用信息的新增、修改与删除。3)自带IP地址信息:自带IP信息的新增、修改与删除。4)IP地址广播信息:IP广播信息的新增、修改与删除。n 域名备案管理1)新增域名备案。2)修改域名备案。3)删除域名备案。2-2、 备案数据下载企业侧系统到省局系统或部级系统下载备案结果数据。企业侧系统通过调用isp_download()方法,将部级系统或省局系统下发给本企业的备案管理数据下载到企业侧系统。通过备案数据下载可以获取以下数据:n ICP备案数据1)ICP备案数据。2)注销数据。3)黑名单列表。4)非法接入黑名单信息。5)未备案网站信息。6)备案结果。7)核实任务。8)核验材料。9)核查结果。10)备案管理相关通知信息。n IP备案数据1)IP地址备案结果。2)IP地址备案信息核查结果。n 域名备案数据1)域名备案结果。n 基础代码数据1)报备单位列表。2)单位分类代码。3)单位性质代码。4)区域代码。5)意见反馈问题分类代码。6)管局信息。7)行业分类代码。8)行政级别代码。9)证件类型代码。10)网站经营类型代码。11)网站服务类型代码。12)网站接入方式代码。13)注销理由代码。14)域名类型代码。15)核实意见代码。16)未备案独立域名处理代码。17)真实性核验材料电子件附件文件格式代码。18)真实性核验材料电子件附件用途代码。n 同步数据1) ICP备案同步数据。2) IP备案同步数据。3) 域名备案同步数据。4) 基础代码同步数据。2-3、 是否备案查询企业侧系统到省局系统查询网站或主体是否已经备案。企业侧系统将网站域名或主体证件号码作为参数,通过调用isp_querybeianstatus()方法,查询网站或主体是否已经备案。2-4、 备案密码校验企业侧系统到省局系统校验备案密码是否正确。企业侧系统将备案号和备案密码作为参数,通过调用isp_verifybamm()方法,校验备案密码是否正确。2-5、 核验材料采集码获取接口企业侧系统到省局系统获取核验材料采集码提供给ICP用户。企业侧系统通过调用isp_getcollectcode()方法,从省局系统获取备案信息核验材料采集码。3、 接口说明3-1、 接口概述企业报备接口主要包含以下五个webservice方法:n isp_upload()方法:企业侧系统通过调用本方法实现ICP、IP地址或域名备案信息、未备案网站处理结果等信息的上报功能;n isp_download()方法:企业侧系统通过调用本方法实现到部级系统或省局系统下载ICP、IP地址或域名的备案结果、未备案网站、黑名单、基础代码等信息的下载功能;n isp_downloadack()方法:企业侧系统在调用isp_download()方法成功下载数据后,通过调用本方法通知部级系统或省局系统已经成功接收到isp_download()方法返回的数据文件;n isp_querypreviousupload()方法:企业侧系统通过本方法查询本企业最近一次上报的备案数据文件;n isp_querybeianstatus()方法:企业侧系统通过调用本方法到省局系统进行是否备案查询;n isp_verifybamm()方法:企业侧系统通过调用本方法到省局系统进行备案密码校验。n isp_getcollectcode()方法:企业侧系统通过调用本方法从省局系统获取备案信息核验材料采集码。下图描述了企业侧系统向部级系统或省局系统上报或下载备案数据文件的示例:3-2、 接口版本说明接口函数使用的XML格式数据含有接口版本信息,使用XML根节点元素“version”属性的值进行标识。本次发布版本为V.3.1,所有依据本版规范生成的XML文件须填写本版本号。部级系统和省局系统的企业系统接口服务将校验当前系统支持的接口版本,版本校验通过后方能进行下一步处理,否则返回版本错误提示信息。3-3、 接口说明3-3-1、 isp_upload方法3-3-1-1、 服务请求地址http:/服务器IP地址/ISPWebService/upDownLoad?wsdl3-3-1-2、 方法原型public String isp_upload (Long ispId, String userName, String randVal, String pwdHash, String beianInfo, String beianInfoHash, Long dataSequence, int encryptAlgorithm, int hashAlgorithm, int compressionFormat)3-3-1-3、 方法描述该方法实现将企业侧系统的备案申请等数据提交到部级系统、省局系统。企业侧系统在调用该接口方法之前,首先要产生长度为20个字节的随机字符串(数字和大、小写字母),并将口令与该随机字符串连接(例如,口令是字符串“1234567890”,生成的随机字符串是 “abcdefghij”,那么连接后的结果是字符串“1234567890abcdefghij”)。将连接后的结果转换为GBK编码的二进制数据,使用hashAlgorithm定义的哈希算法进行哈希计算,得到参数pwdHash的值作为认证信息。企业侧系统在调用该方法上报备案数据时,一次调用只能上报一个XML格式的数据文件,并且所上报的XML数据文件大小不能超过50MB,单个XML数据文件内的备案数据不能超过1000条。企业侧系统上报的数据文件必须满足本规范所附的XSD格式规范。企业侧系统上报的数据文件名必须使用英文字母或数字,文件名长度不超过128个字节。企业侧系统在上报完数据文件后,应保存该数据文件3个月以上,以保证系统处理文件出现错误时重新上传数据文件。企业侧系统要对需要上报的备案信息按照附件“企业上报数据格式.xsd”指定的格式编制XML文件,然后依序进行如下处理:1) 对XML文件使用参数compressionFormat指定的压缩格式进行压缩;2) 对压缩后的信息使用参数hashAlgorithm指定的哈希算法计算哈希值,并对哈希值进行base64编码运算形成beianInfoHash;3) 如需加密上传,则对压缩后的信息使用参数encryptAlgorithm指定的加密算法加密,并对加密结果进行base64编码运算形成beianInfo;如不加密上传,则直接对压缩后的信息进行base64编码运算形成beianInfo。注:1. 企业侧系统在上报备案信息数据文件时,需要对上报的数据进行编号,该编号为4个字节长度的长整型值,初始值为1,每上报成功一次数据,该编号值递增1。如果企业侧系统上报的数据编号跟上次数据上报的编号不连续(例如上次数据上报的编号为500,本次上报的数据编号为502),那么省局系统会返回状态“本次上载没有受理,请首先上载漏报的数据,然后再上载本次数据”,同时对该次上报数据不予接收处理,要求企业侧系统首先上报漏报的数据(例如上次数据上报的编号为500,本次上报的数据编号为502,那么省局系统返回状态提示,要求企业侧系统首先上报(或重新上报)编号为501的数据);2. 本方法中数据加解密、计算哈希值和压缩/解压缩是指对数据字节流的加解密、计算哈希值和压缩/解压缩;3. IP报备流程中,IP报备必须先报来源信息,再报分配信息;4. IP报备中,IP广播信息的报备是运营企业集团公司系统的报备功能,省级运营企业和其他接入商不报备此项信息;5. 域名报备只针对域名报备单位,其他报备单位不报备此项信息。3-3-1-4、 参数描述本方法共使用10个参数,各项参数的描述如下表所示:参数名称参数类型参数描述ispId长整型接入服务提供者的标识,可在部/省局系统的公共查询中查询得到userName字符串用户名,由企业所在省管局(或部管局)维护管理randVal字符串企业侧系统调用该方法时生成的随机字符串,长度是20字节pwdHash字符串使用指定的哈希算法对用户密码和随机字符串进行哈希运算,然后进行base64编码运算得到的结果,用户口令由企业所在省管局(或部管局)维护管理beianInfo字符串对备案信息(XML文件,格式参见“企业上报数据格式.xsd”)使用压缩算法进行压缩,再对压缩后的信息进行加密,然后进行Base64编码运算得到的结果beianInfoHash字符串对备案信息(XML文件,格式参见“企业上报数据格式.xsd”)压缩后进行哈希运算得到的哈希值dataSequence长整型本次数据上报的数据编号encryptAlgorithm整型对称加密算法hashAlgorithm整型哈希算法compressionFormat整型压缩格式encryptAlgorithm描述如下表所示:算法标识算法描述0不进行加密,明文传输1AES加密算法,加密模式使用CBC模式,补码方式采用PKCS5Padding,密钥偏移量由部级系统、省局系统生成的字符串,如“0102030405060708”。 hashAlgorithm描述如下表所示:算法标识算法描述0MD5哈希算法compressionFormat描述如下表所示:算法标识算法描述0Zip压缩格式3-3-1-5、 返回值该方法返回一个XML数据流(数据格式详见文件“企业上报数据方法调用返回数据格式.xsd”),其中描述了本次操作的结果代码、结果描述。如果操作成功,则返回以下信息:0操作成功如果操作错误,则返回以下信息:x错误描述(本标签当x=14时存在)漏报的数据文件序号msg_code参见第3-4节的接口返回状态msg_code代码表。3-3-2、 isp_download方法3-3-2-1、 服务请求地址http:/服务器IP地址/ISPWebService/upDownLoad?wsdl3-3-2-2、 方法原型public String isp_download (Long ispId, String userName, String randVal, String pwdHash , int hashAlgorithm)3-3-2-3、 方法描述通过该方法,企业侧系统可以下载部级系统或省管局系统下发的备案管理数据文件。企业侧系统在调用该接口方法之前,首先要产生长度为20个字节的随机字符串(数字和大、小写字母),并将口令与该随机字符串连接(例如,口令是字符串“1234567890”,生成的随机字符串是 “abcdefghij”,那么连接后的结果是字符串“1234567890abcdefghij”)。将连接后的结果转换为GBK编码的二进制数据,使用hashAlgorithm定义的哈希算法进行哈希计算,得到参数pwdHash的值作为认证信息。部级系统或省局系统接收到企业侧系统的下载请求后,将需要下发给该企业的备案管理数据文件(文件格式参见“企业下载数据格式.xsd”)依次进行如下处理:1) 对XML数据文件使用指定的压缩格式进行压缩;2) 对压缩后的信息使用哈希算法计算哈希值,然后对哈希值进行base64编码运算;3) 如需加密下载,则对压缩后的信息使用指定的加密算法加密,然后对加密结果进行base64编码运算;如不加密下载,则直接对压缩后的信息进行base64编码运算形成beianInfo。部级系统或省局系统将上述处理后的哈希值、编码运算后的加密(或者明文)结果、哈希算法、加密算法、压缩格式返回给企业系统(详见“企业下载数据格式.xsd”)。注:1. 返回值XML流中的标签“encryptAlgorithm”为0时,表示“beianInfo”标签的内容是不加密的;为1时,表示“beianInfo”标签的内容经过AES加密算法的加密,加密模式使用CBC模式,补码方式采用PKCS5Padding,密钥偏移量由部级系统、省局系统生成的字符串,如“0102030405060708”;2. 返回值XML流中的标签“hashAlgorithm”为0时,表示哈希算法是MD5;3. 返回值XML流中的标签“compressionFormat”为0时,表示使用Zip压缩格式进行压缩;4. 本方法中数据加解密、计算哈希值和压缩/解压缩是指对数据字节流的加解密、计算哈希值和压缩/解压缩。3-3-2-4、 参数描述本方法共使用5个参数,各项参数的描述如下表所示:参数名称参数类型参数描述ispId长整型接入服务提供者的标识,可在部/省局系统的公共查询中查询得到userName字符串用户名,由企业所在省管局(或部管局)维护管理randVal字符串企业侧系统调用该方法时生成的随机字符串,长度是20字节pwdHash字符串使用指定的哈希算法对用户密码和随机字符串进行哈希运算,然后进行base64编码运算得到的结果,用户口令由企业所在省管局(或部管局)维护管理hashAlgorithm整型哈希算法hashAlgorithm描述如下表所示:算法标识算法描述0MD5哈希算法3-3-2-5、 返回值该方法返回一个XML数据流(数据格式详见文件“企业下载数据方法调用返回数据格式.xsd”),其中描述了本次操作的结果代码、结果描述。如果成功,返回以下信息:0操作成功哈希算法压缩格式加密算法省局系统的备案数据文件名备案信息内容备案信息的哈希值企业侧系统收到上述数据后,首先对beianInfo信息进行base64解码,接着对解码后的信息使用encryptAlgorithm指定的加密算法解密,在得到备案信息的压缩信息后,再使用hashAlgorithm指定的哈希算法计算哈希值,然后与beianInfoHash信息base64解码后的信息进行比较。如果比较一致,那么备案信息的完整性得到保证;如果比较不一致,则哈希值验证未通过,备案数据不完整。最后,在通过完整性校验后,使用compressionFormat指定的压缩格式对压缩后的信息进行解压缩,得到备案数据信息。如果操作错误,返回以下信息:x错误描述企业侧系统收到备案信息文件后,如果数据文件可以通过完整性校验,并进行解压缩,则应该调用本接口规范中第3-3-3节的“isp_downloadack”方法,将已正确接收到该文件的信息回执发送给部级系统或省局系统。msg_code参见第3-4节的接口返回状态msg_code代码表。对于部级系统或省局系统处理企业上报的备案数据文件所产生的错误信息,均以数据文件下载形式返回给企业。数据中的错误信息详见3-5节数据处理结果代码表。3-3-3、 isp_downloadack方法3-3-3-1、 服务请求地址http:/服务器IP地址/ISPWebService/upDownLoad?wsdl3-3-3-2、 方法原型public String isp_downloadack (Long ispId, String userName, String randVal, String pwdHash , int hashAlgorithm, String fileName)3-3-3-3、 方法描述企业侧系统在调用isp_download方法,成功下载备案管理数据文件完毕后,需要调用本方法,将已成功接收到下载文件的信息回执发送给部级系统或省局系统。注:1. 如果企业侧系统在调用isp_download方法成功下载备案管理数据文件完毕后,不调用本方法将已成功接收到数据文件的信息回执发送给部级系统/省局系统,则部级系统/省局系统将在企业侧系统再次调用isp_download方法时,继续发送该数据文件。2. 本方法中计算哈希值是指对数据字节流的哈希值计算。企业侧系统在调用该接口方法之前,首先要产生长度为20个字节的随机字符串(数字和大、小写字母),并将口令与该随机字符串连接(例如,口令是字符串“1234567890”,生成的随机字符串是 “abcdefghij”,那么连接后的结果是字符串“1234567890abcdefghij”)。将连接后的结果转换为GBK编码的二进制数据,使用hashAlgorithm定义的哈希算法进行哈希计算,得到参数pwdHash的值作为认证信息。3-3-3-4、 参数描述本方法共使用6个参数,各项参数的描述如下表所示:参数名称参数类型参数描述ispId长整型接入服务提供者的标识,可在部/省局系统的公共查询中查询得到userName字符串用户名,由企业所在省管局(或部管局)维护管理randVal字符串企业侧系统调用该方法时生成的随机字符串,长度是20字节pwdHash字符串使用指定的哈希算法对用户密码和随机字符串进行哈希运算,然后进行base64编码运算得到的结果,用户口令由企业所在省管局(或部管局)维护管理hashAlgorithm整型哈希算法fileName字符串在isp_download方法中已成功接收到的备案信息文件名hashAlgorithm描述如下表所示:算法标识算法描述0MD5哈希算法3-3-3-5、 返回值该方法返回一个XML数据流(详见文件“企业数据下载确认方法调用返回数据格式.xsd”),参照以下信息:x返回信息描述msg_code参见第3-4节的返回状态msg_code代码表。3-3-4、 isp_querypreviousupload方法3-3-4-1、 服务请求地址http:/服务器IP地址/ISPWebService/upDownLoad?wsdl3-3-4-2、 方法原型public String isp_querypreviousupload(Long ispId, String userName, String randVal, String pwdHash, int hashAlgorithm)3-3-4-3、 方法描述企业侧系统调用isp_querypreviousupload方法,查询本企业最近一次上报的备案数据及其序号。注:1. 本方法在企业侧系统出现故障后,可以使用本方法与部级系统或省局系统进行通信参数的同步;企业侧系统在调用本方法得到数据文件序号后,在下次上报数据文件时,使用的文件序号应为本方法返回的数据文件序号加1;2. 企业侧系统在未进行数据上报操作时,调用本方法返回的数据文件为空,文件序号为0。企业侧系统在调用该接口方法之前,首先要产生长度为20个字节的随机字符串(数字和大、小写字母),并将口令与该随机字符串连接(例如,口令是字符串“1234567890”,生成的随机字符串是“abcdefghij”,那么连接后的结果是字符串“1234567890abcdefghij”)。将连接后的结果转换为GBK编码的二进制数据,使用hashAlgorithm定义的哈希算法进行哈希计算,得到参数pwdHash的值作为认证信息。3-3-4-4、 参数描述本方法共使用5个参数,各项参数的描述如下表所示:参数名称参数类型参数描述ispId长整型接入服务提供者的标识,可在部/省局系统的公共查询中查询得到userName字符串用户名,由企业所在省管局(或部管局)维护管理randVal字符串企业侧系统调用该方法时生成的随机字符串,长度是20字节pwdHash字符串使用指定的哈希算法对用户密码和随机字符串进行哈希运算,然后进行base64编码运算得到的结果,用户口令由企业所在省管局(或部管局)维护管理hashAlgorithm整型哈希算法hashAlgorithm描述如下表所示:算法标识算法描述0MD5哈希算法3-3-4-5、 返回值该方法返回一个XML数据流(详见文件“企业最近上载数据查询方法调用返回数据格式.xsd”),其中描述了本次操作的结果代码、结果描述。如果成功,返回以下信息:0代码描述哈希算法压缩格式加密算法数据文件序号上次上报的备案数据文件名上次上报备案信息内容备案信息的哈希值企业侧系统收到上述数据后,首先对beianInfo信息进行base64解码,接着对解码后的信息使用encryptAlgorithm指定的加密算法解密,在得到备案信息的压缩信息后,再使用hashAlgorithm指定的哈希算法计算哈希值,然后与beianInfoHash信息base64解码后的信息进行比较。如果比较一致,那么备案信息的完整性得到保证;如果比较不一致,则哈希值验证未通过,备案数据不完整。最后,在通过完整性校验后,使用compressionFormat指定的压缩格式对压缩后的信息进行解压缩,得到备案数据信息。如果操作错误,返回以下信息:x错误描述3-3-5、 isp_querybeianstatus方法3-3-5-1、 服务请求地址http:/服务器IP地址/BeianStatusWebService/queryBeianStatus?wsdl3-3-5-2、 方法原型public String isp_querybeianstatus(Long ispId, String userName, String randVal, String pwdHash , int hashAlgorithm, int queryConditionType , String queryCondition)3-3-5-3、 方法描述企业侧系统可以通过该方法查询网站或主体的备案状态(即:是否已经完成备案)。如果网站已经备案,则返回该网站的网站名称、主体备案号和网站备案号;如果主体已经备案,则返回该主体的主体备案号;注:本方法中计算哈希值是指对数据字节流的哈希值计算。企业侧系统在调用该接口方法之前,首

温馨提示

  • 1. 本站所有资源如无特殊说明,都需要本地电脑安装OFFICE2007和PDF阅读器。图纸软件为CAD,CAXA,PROE,UG,SolidWorks等.压缩文件请下载最新的WinRAR软件解压。
  • 2. 本站的文档不包含任何第三方提供的附件图纸等,如果需要附件,请联系上传者。文件的所有权益归上传用户所有。
  • 3. 本站RAR压缩包中若带图纸,网页内容里面会有图纸预览,若没有图纸预览就没有图纸。
  • 4. 未经权益所有人同意不得将文件中的内容挪作商业或盈利用途。
  • 5. 人人文库网仅提供信息存储空间,仅对用户上传内容的表现方式做保护处理,对用户上传分享的文档内容本身不做任何修改或编辑,并不能对任何下载内容负责。
  • 6. 下载文件中如有侵权或不适当内容,请与我们联系,我们立即纠正。
  • 7. 本站不保证下载资源的准确性、安全性和完整性, 同时也不承担用户因使用这些下载资源对自己和他人造成任何形式的伤害或损失。

评论

0/150

提交评论