YD∕T 3846.5-2021 互联网基础资源支撑系统信息交换接口规范 第5部分:ICP网站(通信).pdf

上传人:曲**** 文档编号:67530681 上传时间:2022-12-25 格式:PDF 页数:73 大小:1.03MB
返回 下载 相关 举报
YD∕T 3846.5-2021 互联网基础资源支撑系统信息交换接口规范 第5部分:ICP网站(通信).pdf_第1页
第1页 / 共73页
YD∕T 3846.5-2021 互联网基础资源支撑系统信息交换接口规范 第5部分:ICP网站(通信).pdf_第2页
第2页 / 共73页
点击查看更多>>
资源描述

《YD∕T 3846.5-2021 互联网基础资源支撑系统信息交换接口规范 第5部分:ICP网站(通信).pdf》由会员分享,可在线阅读,更多相关《YD∕T 3846.5-2021 互联网基础资源支撑系统信息交换接口规范 第5部分:ICP网站(通信).pdf(73页珍藏版)》请在taowenge.com淘文阁网|工程机械CAD图纸|机械工程制图|CAD装配图下载|SolidWorks_CaTia_CAD_UG_PROE_设计图分享下载上搜索。

1、YD/T XXXXXXXXI ICS 33.040M 21YD/TYD/T 2018中 华 人 民 共 和 国 通 信 行 业 标 准互联网基础资源支撑系统信息交换接口规范 第 5 部分:ICP 网站检测规范Technical specifications for information exchange interface of Internet basic resource monitor management system-Part 5:ICP website(报批稿)-发布-实施中 华 人 民 共 和 国 工 业 和 信 息 化 部 发 布YD/T XXXXXXXXI目 次 前言.II

2、 1 范围.1 2 术语和定义.1 3 缩略语.2 4 系统概述.2 5 接口功能.3 5.1 备案数据上报.3 5.2 备案数据下载.4 5.3 企业最近一次上报备案数据及其序号查询.5 5.4 是否备案查询.5 5.5 备案密码校验.5 5.6 接入数据报备.5 6 接口流程.6 6.1 数据上报流程.6 6.2 数据下载流程.6 6.3 企业最近一次上报备案数据及其序号查询流程.7 6.4 是否备案查询流程.7 6.5 备案密码校验流程.7 6.6 接入数据报备流程.8 7 接口方法.9 8 交换接口使用要求.16 8.1 省局系统的数据交换接口服务建设要求.16 8.2 企业侧系统的建

3、设要求.16 9 数据格式定义.16 9.1 上报备案数据格式.16 9.2 下载备案数据格式.50 10 接口返回代码.64 10.1 接口返回状态代码表.65 10.2 数据处理结果代码表.66 10.2.1ICP 数据处理类错误.66 10.2.2 通用类错误.68 II前言 “互联网基础资源支撑系统”系列标准包括 互联网基础资源支撑系统信息交换接口规范、互联网基础资源支撑系统监管信息交换接口规范和互联网基础资源支撑系统接口测试规范,本部分是互联网基础资源支撑系统信息交换接口规范的第5部分,该标准的预计结构和名称如下:第1部分:域名注册服务 第2部分:域名管理服务 第3部分:域名权威解析

4、服务 第4部分:域名递归解析服务 第5部分:ICP网站 第6部分:IP地址 第7部分:内容分发网络(CDN)本部分按照GB/T 1.1-2009给出的规则起草。请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别这些专利的责任。本部分由中国通信标准化协会提出并归口。本部分起草单位:国家计算机网络应急技术处理协调中心、天津市国瑞数码安全系统股份有限公司。本部分主要起草人:卢卫、李湘宁、云晓春、王文磊、舒敏、刘博元、陈悦、王云荣、陆希玉、杨云龙、夏光升、张牙、郝振江。YD/T XXXXX20171互联网基础资源支撑系统信息交换接口规范 第 5 部分:ICP网站 1范围 本部分规定了互联网

5、基础资源支撑系统与互联网接入服务商之间的数据交换接口。本部分适用于通信行业主管部门、互联网接入服务提供单位建设ICP基础资源管理系统的技术参考。2术语和定义 下列术语和定义适用于本文件。2.1 互联网信息服务提供者 Internet content provider 互联网信息服务提供者,又称网站主办者,主要指内容服务提供者(即ICP),包括法人、自然人和其他非法人实体(如分支机构、办事机构、代表机构等)。2.2 互联网接入服务提供者 Internet service provider 为法人、自然人和其他非法人实体(如分支机构、办事机构、代表机构等)提供互联网接入服务的单位(即ISP)。2.

6、3 未备案网站 unregistered website 未获得备案号的网站。2.4 备案号 registration number 备案系统为网站主办者发放的用来表明其已履行网站备案手续的序列号。2.5 注销备案 cancellation of registration 将已完成备案的ICP网站从已备案网站列表中删除,回收备案号的操作。2.6 黑名单 blacklist of websites 被管理部门列为重点监管或处理对象的网站名单。YD/T XXXXX201722.7 空壳网站 website without ISP 在备案系统已获得备案号,但没有接入服务提供者的网站。2.8 空壳主体

7、 ICP without website 在备案系统已获得备案号,但无任何网站信息的备案主体。2.9 部级系统 management system of MIIT 工业和信息化部建设的互联网基础资源支撑系统的部级部分。2.10 省局系统 management system of CA 工业和信息化部建设的互联网基础资源支撑系统的省局部分。2.11 企业侧系统 Management system of Enterprises 接入服务单位建设的的互联网基础资源支撑系统的企业部分。2.12 网站语言类别 Languages of Website 网站页面内容里的语种信息。可以为一种语言类别,也可为

8、多个语言类别。3缩略语 下列缩略语适用于本文件。ICP 网络内容服务提供者 Internet Content Provider ISP 互联网接入服务提供者 Internet Services Provider WSDL XML 网络服务描述语言 可扩展标识语言 Web Services Description Language eXtensible Markup Language 4系统概述 互联网基础资源管理支撑系统主要实现对互联网基础资源数据信息的采集汇聚、管理支撑以及协同联动,建成集中、完整、准确、可信、权威、开放的支撑平台系统。互联网基础资源支撑系统采用三级体系结构:部级系统、省局系

9、统(以下简称为部省系统)和企业侧系统。其关系如图 1 所示。YD/T XXXXX20173图 1 系统体系结构图 第一级为部级系统,主要存储全国省局系统上报的 ICP 信息备案数据;对全国 ICP 信息备案数据进行核查;并对全国的备案数据进行管理、查询、统计等操作。第二级是省局系统。省局系统存储本省相关的 ICP 信息备案数据(注:本省相关的 ICP信息备案数据包括本省主体、本省接入和服务器放置在本省的 ICP 信息备案数据,并负责对 ICP 信息备案请求进行审核,同时实现本省的 ICP 备案数据的统计、查询等功能。第三级是企业侧系统,由企业根据工业和信息化部发布的相关标准规范自行建设。企业侧

10、系统主要实现 ICP 备案信息的采集,并由 ISP 的备案管理人员进行核实;以及本单位 IP地址分配信息、域名注册信息的上报。同时,企业侧系统要接收省局系统下发的 ICP 黑名单数据,以及未备案网站等信息并进行处理。企业侧系统必须实现与企业注册地的省局系统的通信,主要实现 ICP 信息备案上报、数据下载功能。本部分定义了企业侧系统与省局系统的数据交换接口。5接口功能 5.1备案数据上报 5.1.1 ICP 备案管理 完成企业侧系统向省局系统上报 ICP 备案数据的功能。ICP 报备单位的企业侧系统与其所在省的省局系统进行对接,并将 ICP 备案数据上报到其对接的省局系统。部级系统不接受企业侧系

11、统的 ICP 备案数据请求。企业侧系统上报的 ICP 备案数据主要包括以下几种类型:1)新增备案:向省局系统提出新增 ICP 备案申请;2)新增网站:为已经完成备案的 ICP 主体增加新的网站;3)新增接入:为已经完成备案的 ICP 网站增加新的接入;部级系统省局系统省局系统企业侧系统企业侧系统企业侧系统信息交换接口YD/T XXXXX201744)变更接入:更新已经完成备案的 ICP 网站的接入信息;5)变更网站:更新已经完成备案的 ICP 网站的网站信息;6)变更主体:更新已经完成备案的 ICP 网站的主体信息;7)变更备案:更新已完成备案的 ICP 主体、网站、域名或接入信息;8)备案域

12、名迁移:迁移已备案域名信息到新备案或已备案主体下,备案域名迁移业务需要双流程支撑,即每一个域名迁移流程,需要对应的剔除域名(注销/变更)流程支撑完成;9)备案网站迁移:将已备案网站信息(含接入信息),迁移到新备案或已备案主体下;10)上报真实性核验电子件:为已完成备案的 ICP 备案记录增加真实性核验材料的电子扫描件;11)注销备案:注销已经完成备案的 ICP 备案记录,包括注销主体、注销网站和取消接入;12)未备案网站处理结果:提交对未备案网站进行处理后的结果。5.2备案数据下载 5.2.1 ICP 备案数据 省局系统以文件的形式将需要下发给企业的数据保存在省局系统,企业侧系统可以连接省局系

13、统下载已下发给本单位的 ICP 备案数据文件,包括:1)ICP 备案数据;2)注销数据;3)黑名单列表;4)非法接入黑名单;5)未备案网站列表;6)ICP 备案结果数据;7)ICP 核查结果。5.2.2 数据同步 企业侧系统上的备案数据与省局系统备案数据不一致时,可以人工请求省局系统管理人员对异常数据进行同步。企业侧系统可以连接其所在省的省局系统,下载已下发给本单位的备案数据,包括:1)ICP 备案数据;2)基础代码数据;3)黑名单数据。5.2.3 基础代码数据 企业侧系统可以连接其所在省的省局系统下载已下发给本单位的基础代码数据,包括:1)报备单位列表;2)单位分类代码信息;3)单位性质代码

14、信息;4)区域代码信息;5)意见反馈问题分类代码信息;6)管局信息;7)行业分类代码信息;8)行政级别代码信息;YD/T XXXXX201759)证件类型代码信息;10)网站经营类型代码信息;11)网站服务类型代码信息;12)网站接入方式代码;13)注销理由代码;14)域名类型代码;15)核实意见代码;16)未备案网站处理状态代码;17)附件文件格式代码;18)附件用途类型代码;19)网站语言类别代码;20)即时通讯基础代码;21)应用服务类型代码;22)资源记录类型代码。5.3企业最近一次上报备案数据及其序号查询 企业侧系统通过其所在省的省局系统查询本企业最近一次上报的备案数据及其序号。5.

15、4是否备案查询 企业侧系统通过其所在省的省局系统查询网站或主体是否已经完成ICP备案。5.5备案密码校验 企业侧系统通过其所在省的省局系统验证ICP备案密码是否正确。5.6接入资源报备 企业侧系统要与企业所在省份的部/省系统进行对接,并将接入资源上报到部/省系统。具体要求如下:1)企业侧系统需要提供接入资源数据下载的SFTP服务器,部省系统使用企业提供的SFTP服务端下载数据文件;2)企业侧系统在约定周期内,封装新增和删除的接入资源数据为文件,上传到SFTP服务器,数据格式和上报文件命名规范,详见(9.1.2),每周一上报全量数据,周二至周日每天上报增量数据。具体约定如表1接入资源上报周期表:

16、表1 接入资源上报周期表 时间时间 全量全量/增量增量 数据时间要求数据时间要求 周一 全量 每周一的12点之前将截止至上周日23:59:59之前的接入资源全量数据文件放到 SFTP 服务端的下载目录中。周二 增量 12 点之前将前一天(即周一的 0:00-23:59:59)的增量接入资源数据文件放到 SFTP 服务端的下载目录中。周三 增量 12 点之前将前一天(即周二的 0:00-23:59:59)的增量接入资源数据文件放到 SFTP 服务端的下载目录中。周四 增量 12 点之前将前一天(即周三的 0:00-23:59:59)的增量接入资源数据文件放到 SFTP 服务端的下载目录中。周五

17、增量 12 点之前将前一天(即周四的 0:00-23:59:59)的增量YD/T XXXXX20176接入资源数据文件放到 SFTP 服务端的下载目录中。周六 增量 12 点之前将前一天(即周五的 0:00-23:59:59)的增量接入资源数据文件放到 SFTP 服务端的下载目录中。周日 增量 12 点之前将前一天(即周六的 0:00-23:59:59)的增量接入资源数据文件放到 SFTP 服务端的下载目录中。6接口流程 6.1数据上报流程 流程如图2所示,具体为:图2 数据上报流程 1)企业侧系统调用isp_upload(),将备案数据上报至所在省的省局系统;2)省局系统接收企业侧上报的备案

18、数据,完成信息校验后进行保存;3)省局系统将接收结果返回企业侧系统。6.2数据下载流程 流程如图 3 所示,具体为:图3 数据下载流程 1)企业侧系统调用isp_download(),访问其所在省的省局系统;企业侧系统省局系统校验并保存数据结果信息isp_upload企业侧系统省局系统isp_download()isp_downloadack()有数据下载?返回数据文件返回结果信息YN返回结果信息文件已发布查询数据YD/T XXXXX201772)省局系统查询是否有需要该企业下载的数据,若有则压缩文件下发;否则,告知企业侧系统没有数据需要下载;3)企业侧系统接收省局系统下发的数据,校验通过后,

19、调用isp_downloadack()向省局系统进行回馈;4)省局系统根据企业侧系统的回馈信息确定是否需要将刚才下发文件状态更新为已发布,并返回企业侧更新结果,以及是否还有数据需要下载;5)如果还有数据需要下载,企业侧系统重复以上步骤,直到没有数据文件需要下载。6.3企业最近一次上报备案数据及其序号查询流程 流程如图4所示,具体为:图4 最近上报序号查询流程 1)企业侧系统调用isp_querypreviousupload(),将查询请求上报至所在省的省局系统;2)省局系统查询企业侧系统最近一次上报的备案数据信息;3)省局系统将查询结果返回企业侧系统。6.4是否备案查询流程 流程如图5所示,具

20、体为:图5 是否备案查询流程 1)企业侧系统调用isp_querybeianstatus(),将查询请求上报至所在省的省局系统;2)省局系统接收企业侧上报的查询条件,查询对应的网站或主体是否完成ICP备案,若已经备案,查询备案信息;3)省局系统将查询结果返回企业侧系统。6.5备案密码校验流程 企业侧系统省局系统查询企业最近一次上报数据信息结果信息isp_querypreviousupload企业侧系统省局系统查询主体或网站备案信息结果信息isp_querybeianstatusYD/T XXXXX20178流程如图6所示,具体为:图6备案密码校验流程 1)企业侧系统调用isp_verifyba

21、mm(),将校验请求上报至所在省的省局系统;2)省局系统接收企业侧上报的校验条件,校验对应的ICP备案密码是否正确;3)省局系统将校验结果返回企业侧系统。6.6接入资源报备流程 流程如图7所示,具体为:图7接入数据文件上报流程 1)企业将上报的接入数据文件(文件格式见9.1.2)进行打包、压缩;企业侧系统isp_verifybamm省局系统ICP备案密码校验校验结果企业侧企业侧部省系统部省系统2.对压缩文件加密,加密后文件名不变,如需分卷则对压缩文件分卷1.准备接入数据文件并压缩3.对压缩文件进行哈希计算,生成校验文件5.下载接入数据文件解压、解析4.将加密文件和校验文件放到SFTP下载目录如

22、果解压失败,则向企业发送短信和邮件通知YD/T XXXXX201792)上报文件压缩后,文件大小需控制在1GB以内,如果超过1GB,需要拆分为多个文件来上报。(文件命名规则见 9.1.2.3);3)对压缩文件进行加密;4)对加密后的文件进行哈希(md5,可使用Linux系统的md5sum命令计算哈希值)计算,并生成校验文件;5)企业将加密后的压缩文件和校验文件放到SFTP服务端下载目录;6)省局系统通过SFTP下载企业服务器上的接入资源数据文件;7)省局系统对下载的接入数据文件进行(如果文件为分割文件则合并)校验、解压和解析;8)如果校验、解压或解析失败,则向企业相关负责人发送短信和邮件通知。

23、7接口方法 7.1版本说明 接口方法使用的XML格式数据含有接口版本信息,使用XML根节点元素“version”属性的值进行标识。版本号格式为V.1.0,所有依据本部分生成的XML文件须填写本版本号。省局系统要校验当前系统支持的接口版本,版本校验通过后方能进行下一步处理,否则返回版本错误提示信息。7.2方法说明 7.2.1 isp_upload 方法 7.2.1.1 服务请求地址 http:/服务器 IP 地址/ISPWebService/upDownLoad?wsdl 7.2.1.2 方法原型 public String isp_upload(Long ispId,String userNa

24、me,String randVal,String pwdHash,String beianInfo,String beianInfoHash,Long dataSequence,int encryptAlgorithm,int hashAlgorithm,int compressionFormat)7.2.1.3 方法描述 企业侧系统通过调用本方法实现 ICP、IP 地址或域名备案信息、未备案网站处理结果等备案数据的上报。企业侧系统在调用该接口方法时,需要生成长度为 20 个字节的随机字符串(数字和大、小写字母),并将省局系统分配的口令与该随机字符串连接(例如,口令是字符串“123456789

25、0”,生成的随机字符串是“iPVFOyQsIOZJtYJFv4ig”,那么连接后的结果是字符串“1234567890iPVFOyQsIOZJtYJFv4ig”)。将连接后的结果转换为 UTF-8 编码的二进制数据,使用 hashAlgorithm 定义的哈希算法进行哈希计算,得到参数 pwdHash 的值作为认证信息。YD/T XXXXX201710企业侧系统在调用该方法上报备案数据时,一次调用只能上报一个 XML 格式的数据文件,并且所上报的 XML 数据文件大小不能超过 50MB,单个 XML 数据文件内的备案数据不能超过 1000 条。企业侧系统上报的数据文件名必须使用英文字母或数字,文

26、件名长度不超过128个字节。企业侧系统在上报完数据文件后,建议保存该数据文件 3 个月以上,以保证系统处理文件出现错误时重新上传数据文件。企业侧系统要对需要上报的备案信息编制 XML 文件,然后依序进行如下处理:1)对 XML 文件使用参数 compressionFormat 指定的压缩格式进行压缩;2)对压缩后的信息使用参数 hashAlgorithm 指定的哈希算法计算哈希值,并对哈希值进行 base64 编码运算形成 beianInfoHash;3)如需加密上传,则对压缩后的信息使用参数encryptAlgorithm指定的加密算法加密,并对加密结果进行 base64 编码运算形成 be

27、ianInfo;如不加密上传,则直接对压缩后的信息进行 base64 编码运算形成 beianInfo。7.2.1.4 参数描述 本方法共使用 10 个参数,各项参数的描述见表 2。表 2 isp_upload 接口参数表 参数名称参数名称 参数类型参数类型 参数描述参数描述 ispId 长整型 接入服务提供者的标识,由局省局系统产生 userName 字符串 用户名,由局省局系统产生 randVal 字符串 企业侧系统调用该方法时生成的随机字符串,长度是20 字节 pwdHash 字符串 使用指定的哈希算法对用户密码和随机字符串进行哈希运算,然后进行 base64 编码运算得到的结果,用户口

28、令由局省局系统产生 beianInfo 字符串 对备案信息使用压缩算法进行压缩,再对压缩后的信息进行加密,然后进行 Base64 编码运算得到的结果 beianInfoHash 字符串 对备案信息压缩后进行哈希运算得到的哈希值 dataSequence 长整型 本次数据上报的数据编号 encryptAlgorithm 整型 对称加密算法 0:不进行加密,明文传输 1:AES 加密算法,加密密钥由局省局系统产生 hashAlgorithm 整型 哈希算法 0:MD5 哈希算法 compressionFormat 整型 压缩格式 0:Zip 压缩格式 7.2.1.5 返回值 该方法返回一个 XML

29、 数据流,描述了本次操作的结果代码、结果描述(见第 10 章接口返回代码)。7.2.2 isp_download 方法 YD/T XXXXX2017117.2.2.1 服务请求地址 http:/服务器 IP 地址/ISPWebService/upDownLoad?wsdl 7.2.2.2 方法原型 public String isp_download(Long ispId,String userName,String randVal,String pwdHash,int hashAlgorithm)7.2.2.3 方法描述 通过该方法,企业侧系统可以下载省管局系统下发的备案管理数据文件。企业侧

30、系统在调用该接口方法时,需要生成长度为 20 个字节的随机字符串(数字和大、小写字母),并将省局系统分配的口令与该随机字符串连接(例如,口令是字符串“1234567890”,生成的随机字符串是“iPVFOyQsIOZJtYJFv4ig”,那么连接后的结果是字符串“1234567890iPVFOyQsIOZJtYJFv4ig”)。将连接后的结果转换为 UTF-8 编码的二进制数据,使用 hashAlgorithm 定义的哈希算法进行哈希计算,得到参数 pwdHash 的值作为认证信息。省局系统接收到企业侧系统的下载请求后,将需要下发给该企业的备案管理数据文件依次进行如下处理:1)对 XML 数据

31、文件使用指定的压缩格式进行压缩;2)对压缩后的信息使用哈希算法计算哈希值,然后对哈希值进行 base64 编码运算;3)如需加密下载,则对压缩后的信息使用指定的加密算法加密,然后对加密结果进行base64 编码运算;如不加密下载,则直接对压缩后的信息进行 base64 编码运算形成 beianInfo。省局系统将上述处理后的哈希值、编码运算后的加密(或者明文)结果、哈希算法、加密算法、压缩格式返回给企业系统。7.2.2.4 服务请求地址 本方法共使用 5 个参数,各项参数的描述见表 3。表 3 isp_download 接口参数表 参数名称参数名称 参数类型参数类型 参数描述参数描述 ispI

32、d 长整型 接入服务提供者的标识,由局省局系统产生 userName 字符串 用户名,由局省局系统产生 randVal 字符串 企业侧系统调用该方法时生成的随机字符串,长度是 20 字节 pwdHash 字符串 使用指定的哈希算法对用户密码和随机字符串进行哈希运算,然后进行 base64 编码运算得到的结果,用户口令由局省局系统产生 hashAlgorithm 整型 哈希算法 0:MD5 哈希算法 7.2.2.5 返回值 该方法返回一个 XML 数据流,其中描述了本次操作的结果代码、结果描述(见第 10章接口返回代码)。如果成功下载数据文件,企业侧系统需要对数据文件进行解密,并验证数据文件的完

33、整YD/T XXXXX201712性。若验证成功,则应调用本部分中的 7.2.3 的“isp_downloadack”方法,将已正确接收到该文件的信息回执发送给省局系统。7.2.3 isp_downloadack 方法 7.2.3.1 服务请求地址 http:/服务器 IP 地址/ISPWebService/upDownLoad?wsdl 7.2.3.2 方法原型 public String isp_downloadack(Long ispId,String userName,String randVal,String pwdHash,int hashAlgorithm,String file

34、Name)7.2.3.3 方法描述 企业侧系统在调用 isp_download 方法,成功下载备案管理数据文件完毕后,需要调用本方法,将已成功接收到下载文件的信息回执发送给省局系统。企业侧系统在调用该接口方法时,需要生成长度为 20 个字节的随机字符串(数字和大、小写字母),并将省局系统分配的口令与该随机字符串连接(例如,口令是字符串“1234567890”,生成的随机字符串是“iPVFOyQsIOZJtYJFv4ig”,那么连接后的结果是字符串“1234567890iPVFOyQsIOZJtYJFv4ig”)。将连接后的结果转换为 UTF-8 编码的二进制数据,使用 hashAlgorith

35、m 定义的哈希算法进行哈希计算,得到参数 pwdHash 的值作为认证信息。7.2.3.4 参数描述 本方法共使用 6 个参数,各项参数的描述见表 4。表 4 isp_downloadack 接口参数表 参数名称参数名称 参数类型参数类型 参数描述参数描述 ispId 长整型 接入服务提供者的标识,由局省局系统产生 userName 字符串 用户名,由局省局系统产生 randVal 字符串 企业侧系统调用该方法时生成的随机字符串,长度是 20 字节 pwdHash 字符串 使用指定的哈希算法对用户密码和随机字符串进行哈希运算,然后进行 base64 编码运算得到的结果,用户口令由局省局系统产生

36、 hashAlgorithm 整型 哈希算法 0:MD5 哈希算法 fileName 字符串 在 isp_download 方法中已成功接收到的备案信息文件名 7.2.3.5 返回值 该方法返回一个 XML 数据流,其中描述了本次操作的结果代码、结果描述(见第 10章接口返回代码)。7.2.4 isp_querypreviousupload 方法 7.2.4.1 服务请求地址 https:/服务器IP地址/ISPWebService/upDownLoad?wsdl YD/T XXXXX2017137.2.4.2 方法原型 public String isp_querypreviousuploa

37、d(Long ispId,String userName,String randVal,String pwdHash,int hashAlgorithm)7.2.4.3 方法描述 企业侧系统调用isp_querypreviousupload方法,查询本企业最近一次上报的备案数据及其序号。说明:说明:1)本方法在企业侧系统出现故障后,可以使用本方法与部级系统或省局系统进行通信参数的同步;企业侧系统在调用本方法得到数据文件序号后,在下次上报数据文件时,使用的文件序号应为本方法返回的数据文件序号加 1;2)企业侧系统在未进行数据上报操作时,调用本方法返回的数据文件为空,文件序号为 0。企业侧系统在调

38、用该接口方法之前,首先要产生长度为20个字节的随机字符串(数字和大、小写字母),并将口令与该随机字符串连接(例如,口令是字符串“1234567890”,生成 的 随 机 字 符 串 是“abcdefghij”,那 么 连 接 后 的 结 果 是 字 符 串“1234567890abcdefghij”)。将连接后的结果转换为UTF-8编码的二进制数据,使用hashAlgorithm定义的哈希算法进行哈希计算,得到参数pwdHash的值作为认证信息。7.2.4.4 参数描述 本方法共使用 5 个参数,各项参数的描述如表 5 所示:表 5 isp_querypreviousupload 接口参数表

39、参数名称参数名称 参数类型参数类型 参数描述参数描述 ispId 长整型 接入服务提供者的标识,可在部/省局系统的公共查询中查询得到 userName 字符串 用户名,由企业所在省管局(或部管局)维护管理 randVal 字符串 企业侧系统调用该方法时生成的随机字符串,长度是20 字节 pwdHash 字符串 使用指定的哈希算法对用户密码和随机字符串进行哈希运算,然后进行 base64 编码运算得到的结果,用户口令由企业所在省管局(或部管局)维护管理 hashAlgorithm 整型 哈希算法 0:MD5 哈希算法 7.2.4.5 返回值 该方法返回一个 XML 数据流,其中描述了本次操作的结

40、果代码、结果描述。如果成功,返回以下信息:0 代码描述 哈希算法 压缩格式 YD/T XXXXX201714加密算法 数据文件序号 上次上报的备案数据文件名 上次上报备案信息内容 备案信息的哈希值 企业侧系统收到上述数据后,首先对 beianInfo 信息进行 base64 解码,接着对解码后的信息使用 encryptAlgorithm 指定的加密算法解密,在得到备案信息的压缩信息后,再使用 hashAlgorithm 指定的哈希算法计算哈希值,然后与 beianInfoHash 信息 base64 解码后的信息进行比较。如果比较一致,那么备案信息的完整性得到保证;如果比较不一致,则哈希值验证

41、未通过,备案数据不完整。最后,在通过完整性校验后,使用 compressionFormat指定的压缩格式对压缩后的信息进行解压缩,得到备案数据信息。如果操作错误,返回以下信息:x 错误描述 7.2.5 isp_querybeianstatus 方法 7.2.5.1 服务器请求地址 http:/服务器 IP 地址/BeianStatusWebService/queryBeianStatus?wsdl 7.2.5.2 方法原型 public String isp_querybeianstatus(Long ispId,String userName,String randVal,String pw

42、dHash,int hashAlgorithm,int queryConditionType,String queryCondition)7.2.5.3 方法描述 企业侧系统可以通过该方法查询网站或主体的备案状态(即:是否已经完成备案)。如果网站已经备案,则返回该网站的网站名称、主体备案号和网站备案号;如果主体已经备案,则返回该主体的主体备案号。企业侧系统在调用该接口方法时,需要生成长度为 20 个字节的随机字符串(数字和大、小写字母),并将省局系统分配的口令与该随机字符串连接(例如,口令是字符串“1234567890”,生成的随机字符串是“iPVFOyQsIOZJtYJFv4ig”,那么连接

43、后的结果是字符串“1234567890iPVFOyQsIOZJtYJFv4ig”)。将连接后的结果转换为 UTF-8 编码的二进制数据,使用 hashAlgorithm 定义的哈希算法进行哈希计算,得到参数 pwdHash 的值作为认证信息。7.2.5.4 参数描述 本方法共使用 7 个参数,各项参数的描述见表 6。表 6 isp_querybeianstatus 接口参数表 参数名称参数名称 参数类型参数类型 参数描述参数描述 ispId 长整型 接入服务提供者的标识,由局省局系统产生 YD/T XXXXX201715userName 字符串 用户名,由局省局系统产生 randVal 字符串

44、 企业侧系统调用该方法时生成的随机字符串,长度是 20 字节 pwdHash 字符串 使用指定的哈希算法对用户密码和随机字符串进行哈希运算,然后进行 base64 编码运算得到的结果,用户口令由局省局系统产生 hashAlgorithm 整型 哈希算法 0:MD5 哈希算法 queryConditionType 整型 查询条件类型:0-表示通过网站域名查询网站是否已备案;X-表示通过证件类型查询单位主体是否备案,X 是指证件类型基础代码的编码序号;queryCondition 字符串 与 queryConditionType 对应的域名或证件号码 7.2.5.5 返回值 该方法返回一个 XML

45、 数据流,其中描述了本次操作的结果代码、结果描述以及是否备案信息(见第 10 章接口返回代码)。7.2.6 isp_verifybamm 方法 7.2.6.1 服务器请求地址 http:/服务器 IP 地址/BeianStatusWebService/isp_verifybamm?wsd 7.2.6.2 方法原型 public String isp_verifybamm(Long ispId,String userName,String randVal,String pwdHash,int hashAlgorithm,String baxh,String bamm)7.2.6.3 方法描述 企

46、业侧系统可以通过该方法验证 ICP 备案密码是否正确。如果 ICP 备案密码正确,则返回校验成功;否则返回校验失败。企业侧系统在调用该接口方法时,需要生成长度为 20 个字节的随机字符串(数字和大、小写字母),并将省局系统分配的口令与该随机字符串连接(例如,口令是字符串“1234567890”,生成的随机字符串是“iPVFOyQsIOZJtYJFv4ig”,那么连接后的结果是字符串“1234567890iPVFOyQsIOZJtYJFv4ig”)。将连接后的结果转换为 UTF-8 编码的二进制数据,使用 hashAlgorithm 定义的哈希算法进行哈希计算,得到参数 pwdHash 的值作为

47、认证信息。7.2.6.4 参数描述 本方法共使用 7 个参数,各项参数的描述见表 7。表 7 isp_verifybamm 接口参数表 参数名称参数名称 参数类型参数类型 参数描述参数描述 ispId 长整型 接入服务提供者的标识,可在部/省局系统的公共查询中查询得到 userName 字符串 用户名,由企业所在省管局(或部管局)维护管理 randVal 字符串 企业侧系统调用该方法时生成的随机字符串,长度是 20 字节 YD/T XXXXX201716pwdHash 字符串 使用指定的哈希算法对用户密码和随机字符串进行哈希运算,然后进行 base64 编码运算得到的结果,用户口令由企业所在省

48、管局(或部管局)维护管理 hashAlgorithm 整型 哈希算法 baxh 字符串 备案号 bamm 字符串 备案密码 7.2.6.5 返回值 该方法返回一个 XML 数据流,其中描述了本次操作的结果代码、结果描述以及是否校验成功。(见第 10 章接口返回代码)。8交换接口使用要求 8.1省局系统的数据交换接口服务建设要求 按照本部分要求,省局系统要建设数据交换接口服务,为企业侧系统提供ICP备案信息的上报及备案数据的下载功能。省局系统的数据交换接口服务建设,应保证对企业侧系统提供正常的 ICP 备案管理数据上报和下载服务。由于企业侧系统对数据交换接口服务的访问是不可控的,在访问高峰时段,

49、容易形成数据交换接口服务的访问瓶颈,影响到系统的访问性能。为避免出现无法访问、访问速度慢的情况,应充分考虑系统建设的网络访问量、网络带宽需求,并充分考虑系统的自我防护能力。8.2企业侧系统的建设要求 企业侧系统通过对省局系统的数据交换接口访问,实现 ICP 备案信息的备案数据上报和备案相关数据的下载功能。企业侧系统需按照标准要求进行建设,并在运行过程中主动降低对数据交换接口服务的访问频率。企业侧系统需要为部省系统提供接入资源数据下载的 SFTP 服务器,并且须保证下载服务器的可用性。9数据格式定义 9.1上报备案数据格式 9.1.1 ICP 上报数据格式 9.1.1.1 新增备案 企业请求流水

50、号,由企业端系统生成的报备唯一标识,见表 8。表 8 企业请求流水号表 新增备案数据项中的主体信息见表 9。编号编号 节点节点 节点名称节点名称 填写情况填写情况 数据类型数据类型 长度(位长度(位/字符字符)描述描述 1、IspLsh 企业请求流水号 必填 长整型/企业请求流水号,由企业端系统生成的报备唯一标识 YD/T XXXXX201717表 9 新增备案主体表 编号编号 节点节点 节点名称节点名称 填写情况填写情况 数据类型数据类型 长度(位长度(位/字符字符)描述描述 1、IspLsh 企业请求流水号 必填 长整型/企业请求流水号,由企业端系统生成的报备唯一标识 2、IspZtid

展开阅读全文
相关资源
相关搜索

当前位置:首页 > 技术资料 > 技术规范

本站为文档C TO C交易模式,本站只提供存储空间、用户上传的文档直接被用户下载,本站只是中间服务平台,本站所有文档下载所得的收益归上传人(含作者)所有。本站仅对用户上传内容的表现方式做保护处理,对上载内容本身不做任何修改或编辑。若文档所含内容侵犯了您的版权或隐私,请立即通知淘文阁网,我们立即给予删除!客服QQ:136780468 微信:18945177775 电话:18904686070

工信部备案号:黑ICP备15003705号© 2020-2023 www.taowenge.com 淘文阁