天天看点

开源协同OA办公平台教程:O2OA服务管理中,接口的调用权限

 本文介绍O2OA服务管理中,接口的权限设定和调用方式。

适用版本:5.4及以上版本

具有服务管理设计权限的用户(具有ServiceManager角色或Manager角色)打开“服务管理平台”,进入接口配置视图,点击左上角的新建按钮,可创建一个新的接口。

开源协同OA办公平台教程:O2OA服务管理中,接口的调用权限
开源协同OA办公平台教程:O2OA服务管理中,接口的调用权限

新建接口后,在右侧属性栏中有两个配置和调用权限有关,一个是“允许访问的地址表达式”,一个收是“启用鉴权”。

开源协同OA办公平台教程:O2OA服务管理中,接口的调用权限
开源协同OA办公平台教程:O2OA服务管理中,接口的调用权限

此处允许输入一个正则表达式,用来匹配调用接口的客户端的Remote_Addr,只有匹配通过,接口才允许执行。例如只允许172.16.1.50到172.16.1.56地址调用接口,可以在此处输入:

此处选择“是”的话,就需要在调用接口时传入client名称和一个加密后的token。所以我们先需要一组鉴权配置。

具有管理员权限的用户(具有Manager角色),打开“系统设置”-“系统SSO配置”,找到“鉴权配置”。

开源协同OA办公平台教程:O2OA服务管理中,接口的调用权限
开源协同OA办公平台教程:O2OA服务管理中,接口的调用权限

点击“添加鉴权配置”:

开源协同OA办公平台教程:O2OA服务管理中,接口的调用权限
开源协同OA办公平台教程:O2OA服务管理中,接口的调用权限

此处需要配置一个名称和密钥。

名称:可随意填写,就是我们在调用接口或进行SSO时要传入的client参数。

密钥:可随意填写,用于后续加密,最少8位。

此处我们假设名称填写:oa;密钥填写:platform

填写完成后确定。

开源协同OA办公平台教程:O2OA服务管理中,接口的调用权限

然后我们就可以使用此鉴权配置来调用接口了。

接口调用的的地址在接口属性栏中有显示:

开源协同OA办公平台教程:O2OA服务管理中,接口的调用权限
开源协同OA办公平台教程:O2OA服务管理中,接口的调用权限

当启用鉴权后的接口调用地址为:

http://develop.o2oa.net:20030/x_program_center/jaxrs/invoke/{name}/client/{client}/token/{token}/execute

请求方法为:POST

地址中的{name}为接口的名称或别名;

地址中的{client}为鉴权的名称;

地址中的{token}为:用户名#1970年毫秒数 使用鉴权密钥经过3DES加密后的值。

我们使用CryptoJS进行DES加密。(GitHub: https://github.com/brix/crypto-js)

开源协同OA办公平台教程:O2OA服务管理中,接口的调用权限
开源协同OA办公平台教程:O2OA服务管理中,接口的调用权限
开源协同OA办公平台教程:O2OA服务管理中,接口的调用权限