SCFP外联平台对接技术说明书

SCFP外联平台技术对接指南

最新推荐文章于 2025-06-15 10:42:33 发布

原创

最新推荐文章于 2025-06-15 10:42:33 发布 · 577 阅读

4 ·

CC 4.0 BY-SA版权

文章标签：

#java

SCFP外联平台对接技术说明书

1. 文档说明

1.1 阅读对象

1.2 修订记录

版本号	修订时间	更改内容描述	修订人	审核人
V1.0	20220103	初稿	***

2. 接口规范

2.1 协议规则

传输方式：采用HTTPS传输
提交方式：采用POST方法提交
数据格式：提交和返回数据都为JSON格式
字符编码：统一采用UTF-8字符编码
签名算法：统一采用SM2摘要签名算法，具体为sm3withsm2
加密算法：统一采用SM4国密算法对报文加解密

2.2 环境地址

测试环境：https://scfp-mgr-di1.sit.cmft.com/ocs/
生产环境：http://ocs.cmscfp.com/ocs/

2.3 系统对接

在这里插入图片描述

2.4 HTTP请求头

序号	字段	是否必输	说明	备注
1	Content-Type	是	内容类型	application/json;charset=utf-8
2	x-app-id	是	对接方标识	由供应链金融平台提供
3	x-sign	是	签名	base64(sm3withsm2(报文明文))

2.5 请求样例

POST https://{环境地址}/{接口地址} HTTP/1.1
Content-Type: application/json;charset=utf-8
x-app-id: {请求方标识}
x-sign: {签名}

base64密文

2.6 响应样例

HTTP/1.1 200 OK
Content-Type: application/json;charset=utf-8

base64密文

3. 签名验签

3.1 密钥生成

对接方需生成一对sm2密钥对，并将公钥发送供应链金融平台。

3.1.1 Maven依赖

<dependency>
    <groupId>org.bouncycastle</groupId>
    <artifactId>bcprov-jdk15on</artifactId>
    <version>1.69</version>
</dependency>

3.1.2 静态代码

// 使用BouncyCastle密码库
private static final BouncyCastleProvider bc = new BouncyCastleProvider();

3.1.3 示例代码

// 使用BouncyCastle密码库
BouncyCastleProvider bc = new BouncyCastleProvider();
// 获取SM2椭圆曲线的参数
final ECGenParameterSpec sm2Spec = new ECGenParameterSpec("sm2p256v1");
// 获取一个椭圆曲线类型的密钥对生成器
final KeyPairGenerator kpg = KeyPairGenerator.getInstance("EC", bc);
// 使用SM2参数初始化生成器
kpg.initialize(sm2Spec);
// 使用SM2的算法区域初始化密钥生成器
kpg