isp_verifybamm方法

服务请求地址

http://服务器IP地址/BeianStatusWebService/verifyBamm?wsdl

方法原型

public String isp_verifybamm(Long ispId, String userName, String randVal, String pwdHash ,
int hashAlgorithm, String baxh , String bamm)

方法调用限制:一定时间内,系统限制同一备案密码校验的次数,具体限制次数根据业务需要设定


方法描述

企业侧系统可以通过该方法校验备案密码是否正确。

注:本方法中计算哈希值是指对数据字节流的哈希值计算。

企业侧系统在调用该接口方法之前,首先要产生长度为20个字节的随机字符串(数字和大、小写字母),并将口令与该随机字符串连接(例如,口令是字符串“1234567890”,生成的随机字符串是“abcdefghij”,那么连接后的结果是字符串“1234567890abcdefghij”)。将连接后的结果转换为GBK编码的二进制数据,使用hashAlgorithm定义的哈希算法进行哈希计算,得到参数pwdHash的值作为认证信息。

 

参数描述

本方法共使用7个参数,各项参数的描述如下表所示:

参数名称

参数类型

参数描述

ispId

长整型

接入服务提供者的标识,可在部/省局系统的公共查询中查询得到

userName

字符串

用户名,由企业所在省管局(或部管局)维护管理

randVal

字符串

企业侧系统调用该方法时生成的随机字符串,长度是20字节

pwdHash

字符串

使用指定的哈希算法对用户密码和随机字符串进行哈希运算,然后进行base64编码运算得到的结果,用户口令由企业所在省管局(或部管局)维护管理

hashAlgorithm

整型

哈希算法

baxh

字符串

备案号

bamm

字符串

备案密码

hashAlgorithm描述如下表所示:

算法标识

算法描述

0

MD5哈希算法

 

返回值

该方法返回一个XML数据流,其中描述了本次操作的结果代码、结果描述以及是否校验成功。

1) 校验操作成功的返回

<?xml version="1.0" encoding="utf-8"?>

<return> 
  <msg_code>0</msg_code>  
  <msg>操作成功</msg>  
  <VerifyRes>校验结果(0:表示校验成功1:表示校验失败)</VerifyRes> 
</return>


2) 校验操作错误,结果信息如下

<?xml version="1.0" encoding="utf-8"?>

<return> 
  <msg_code>x</msg_code>  
  <msg>错误描述</msg> 
</return>

msg_code参见第3-4节的返回状态msg_code代码表。