2.2、中间件提供给第三方业务系统的加解密接口.docxVIP

电子文档安全管理系统中间件接口文档

北京亿赛通科技发展有限责任公司

2016年6月22日

文档说明

本文档所涉及到的文字、图表等，仅限于北京亿赛通科技发展有限责任公司和DOCPROPERTYuserfullname被呈送方内部使用，未经双方书面许可，请勿扩散到第三方。

文档属性

软件名称[中文]：

电子文档安全管理系统中间件接口文档

软件名称[英文]：

产品编号：

产品型号：

文档主题：

电子文档安全管理系统中间件接口文档

文档编号：

文档作者：

李杰

编制日期：

2020-07-28

审批人：

审批日期：

批准人：

批准日期：

扩散范围：

文档历史

文档版本

修订状态

修订日期

修订人

描述

V1.0

初稿

2022-4-1

詹传昉

第一部分：文档概述

1.1、概述

1.1.1.方案概述

1.1.2.术语和缩写

序号

术语

描述

1

中间件

亿赛通公司与第三方业务系统的交互接口程序。

2

第三方业务系统

代指所有亿赛通客户的系统，如OA、业务系统等

1.2、支持的规格

1.1.1.支持的操作系统

支持windows系统。

1.1.2.中间件提供的接口形式

基于通用标准的rest接口进行与综合管理系统的交互。

第二部分：中间件提供给第三方业务系统的接口服务

2.1、中间件提供给第三方业务系统的接口服务地址

接口的访问路径http://服务器ip地址:端口/sec-server/s/rs/uni

如：

:8081/sec-server/s/rs/uni

:8443/sec-server/s/rs/uni

2.2、中间件提供给第三方业务系统的加解密接口

判断文件是否是密文的接口（文件流形式）

描述

在httpheader里传递方法名表示要调用此接口，在httpbody传二进制的文件流。然

后中间件将在返回的http响应的header里返回状态（data~returnFlag）

功能

接口类型

判断文件是否是密文的接口

RS接口

接口定义

请求参数说明

参数名

参数说明

备注

method-name

checkFileIsEncryptionRest

方法参数必填此值

放在httpbody中

把文件转换成二进制文件流byte[]放入httpbody

响应返回值

参数名

参数说明

备注

data~returnFlag

状态标识。

0：明文

1：密文

data~returnTip

如果接口返回状态不是0成功，可以可选地在此参数里随意写入一小段提示错误的信息返回给调用者

非必填。

文件加密接口（文件流形式）

描述

在httpheader里传递方法名表示要调用此接口，在httpbody传二进制的文件

流。然后中间件将在返回的http响应的header里返回状态（data~returnFlag）、在httpbody里返回加密后的二进制文件流。

注：接口里在文件加密之前会对文件进行判断，如果是明文才对文件进行加密。

功能

接口类型

明文加密接口

RS接口

接口定义

请求参数说明

参数名

参数说明

备注

method-name

fileEncryptionRest

方法参数必填此值

data-counSize

当前文件传输的文件流的大小

文件块的大小，实际必须为字符串形式的整型数字(必须与实际大小相同，使用程序获取即可)

data-fileOffset

文件截取的大小起始值

如果文件不分块传输的话fileffet为0，如果分块的话该值为当前块的起始值在文件流中的位置（比如文件大小为3072分三块，每块大小为1024；第一块的fileoffet值为0，第二块的fileoffet值为1024，第三块的fileoffet值为2048），不低于512字节，fileOffset大于0的分块加密后调用判断密文接口也会被识别为明文

放在httpbody中

把明文转换成二进制文件流byte[]放入httpbody

data-secLevel

密级等级

默认给10

data-mastkey

主秘钥

data-cryptKey

认证秘钥

响应返回值

参数名

参数说明

备注

data~returnFlag

状态标识。

必填。请参考2.5节RS接口返回值说明

data~returnTip

如果接口返回状态不是0成功，可以可选地在此参数里随意写入一小段提示错误的信息返回给调用者

非必填。

放在httpbody中

中间件把加密后的明文转换成二进制文件流byte[]放入httpbody

文件解密接口（文件流形式）

描述

在httpheader里传递方法名表示要调用此接口，在httpbody传二进制的文件流。然后中间件将在返回的http响应的header里返回状态（data~returnFlag）、