ws交互接口说明.doc

支付宝和天威诚信webservices交互接口说明
public interface AlipayUKeyServices {
public WsPacket services(WsPacket param);
}
1. 服务接口

2. 参数定义
WsPacket
WS服务传输的包
String uid; // 一个会话标识
String status; // 状态
String message; // 包信息
String opName; // 操作名称
String signData; // 签名结果
List nvList;// 业务传输的数据,需要签名的所有字段
List attributes;// 以后扩展使用

说明
参数名称
类型
说明
建议
uid
String
Ws通讯唯一标示
建议使用32位的16进制字符串，比如MD5摘要的结果
status
String
Ws通讯状态，非业务处理状态

message
String
ws通讯消息

opName
String
操作类型

signData
String
对业务数据的签名结果

nvList
ListValue>
业务数据

attributes
List
其他扩展信息

NameValue

String name;//　键
String value;//　值

3. 数据签名
数据签名的过程

使用签名者私钥，进行签名运算，结果放入WsPacket的signData字段
依次连接name和value，构成字符串
对WsPacket的nvList按照name和value升序排序

数据验证签名的过程

依次连接name和value，构成字符串orgStr
对WsPacket的nvList按照name和value升序排序

比较消息的签名者是否是系统配置的签名者
取出WsPacket的signData字段，并和上一步的orgStr字符串一起传入“验证签名”函数，验证得到签名者的数字证书

4. 运行环境依赖
Spring2.0
Xfire1.2.6

bcmail-jdk14-137.jar
bcprov-jdk14-137.jar
iTrusJavaCertAPI.2.5.8.jar
xalan.jar

Auth
章建军 zhang_jianjun@天威诚信