YD_T 2431-2012ICP/IP地址/域名信息备案系统信息交换接口技术要求.pdf

ICS 33.040M 16YD中华人民共和国通信行业标准YD/T 2431-2012ICP/IP地址/域名信息备案系统信息交换接口技术要求Technical specificationforinformation exchange interfaceof iCP/IPaddress/domain name informationregistration system2012-12-28发布2013-03-01实施中华人民共和国工业和信息化部发布 YD/T次范围2，术语和定义3缩略语.4系统概述.5接口功能.-5:1备案数据上报3.2备案数据下载5.3企业最近—次上报备案数据及其序号查询5.4是否备案查询接口流程6.1数据上报流程6.2数据下载流程6.3企业最近一次上报备案数据及其序号查询流程6.4是否备案查询流程接口方法·7.1版本说明7.2方法说明8交换接口使用要求.·8.1部级系统和省局系统的数据交换接口服务建设要求8.2企业侧系统的建设要求+*+12附录A（规范性附录）数据格式定义附录B（规范性附录）接口返回代码 YD/T 243120方法原型public String isp_upload (Long ispld, String userName, String randVal, String pwdHash, String beianInfo,String beianlnfoHash, Long dataSequence, int encryptAlgorithm, int hashAlgorithm, int compressionFormat)方法描述企业侧系统通过调用本方法实现ICP、IP地址或域名备案信息、未备案网站处理结果等备案数据的上报.企业侧系统在调用该接口方法时，需要产生长度为20个字节的随机字符串（数字和大、小写字母），并将部级系统或省局系统分配的口令与该随机字符串连接（例如，口令是字符串“1234567890”，生成的换为GBK编码的二进制数据，采用hashAlgorithm定义的哈希算法进行哈希计算，得到参数pwdHash的值作为认证信息。企业侧系统在调用该方法上报备案数据时，一次调用只能上报一个XML格式的数据文件，并且所上报的XML数据文件大小不能超过50MB，单个XML数据文件内的备案数据不能超过1000条。企业侧系统上报的数据文件名必须使用英文字母或数字，文件名长度不超过128个字节，企业侧系统在上报完数据文件后，建议保存该数据文件3个月以上，以保证系统处理文件出现错误时重新上传数据文件。企业侧系统要对需要上报的备案信息编制XML文件，然后依序进行如下处理：a）对XML文件采用参数compressionFomat指定的压缩格式进行压缩：b）对压缩后的信息采用参数hashAlgorithm指定的哈希算法计算哈希值，并对哈希值进行base64编码运算形成beianinfoHashe）如需加密上传，则对压缩后的信息采用参数encryptAlgorithm指定的加密算法加密，并对加密结果进行base64编码运算形成beianlnfo；如不加密上传，则直接对压缩后的信息进行base64编码运算形成beianlnfo.参数描述本方法共使用10个参数，各项参数的描述见表1。表1isp_upload接口参数参数名称参数类型参数描速ispld长整型接入服务提供者的标识，由部级系统或局省局系统产生userName学符中用户名，由部级系统或局省局系统产生randVal字符中企业侧系统调用该方法时生成的随机字特串，长度是20字节pwdHash字符审使用指定的哈希算法对用户密码和随机字符串进行哈希运算，然后选行basc64编码运算得到的结果，用户口令由邮级系统或局否系统产生beianlnfo字符审对备案信息使用压缩算法进行压缩，再对压缩后的信息进行加密，然后进行Base64编码运算得到的结果beianlnfoHash字特申对备案信息压综后进行哈希送算得到的哈希值dataSequence长格型本次数据上报的数据编号encryptAlgorithm整型对称加密算法0：不进行加密，明文传输1：AES加密算法，加密密钥由部级系统或局省局系统产生 YD/T1(续)参数名称参数类型参数措述hashAlgorithm整型哈希算法0：MD5哈希算法compressionFomat整型压缩格式0Zip压维格式5返回值该方法返回一个XML数据流，推述了本次操作的结果代码、结果描述（见表B，1)。7.2.2isp_download方法服务请求地址http:/服务器IP地址/ISPWebService/upDownLoad?wsdl方法原型public String isp_downloa