supOS 2.8 集成指南

「SaaS APP」：ISV已有的或新开发的支持SaaS模式的应用。

supOS版本：V2.8 及以上

集成过程 #

开发者可以使用自己习惯的IDE来改造原型SaaS APP，支持本地测试，测试完成后在蓝卓开放平台进行上架发布。SaaS APP分发流程图如下：

租户开通改造 #

租户开通 #

ISV在原来支持SaaS的基础上进行改造，需要实现开通如下接口：

 

（1）开通APP租户；

 

（2）开通租户结果查询；

 

（3）续费APP租户；

 

（4）停止APP租户；

 

由BOSS平台向SaaS APP请求，这接口交互需要实现「RSA加密解密」，蓝卓云平台实施加密操作，SaaS APP实施解密操作；

SaaS APP 租户开通相关时序图如下：

RSA加密解密 #

（1）接口安全体系采用 **`签名验签`** 的模式进行保障，请接入APP服务商保存cloud的公钥：

（2）根据报文结构，双方实时通信报文中的签名域值采用 **`SHA1withRSA`** 进行签名验签；

（3）在通讯过程中，对于发起报文，需要使用自己的私钥进行签名；

（4）对于响应报文，需要使用对方提供的公钥进行验签;

 改造示例 #

示例下载地址：【下载saas-app-api.yml接口demo】

 

（1）开通租户接口

（2）开通租户查询接口

蓝卓云平台登录鉴权 #

蓝卓云平台将提供SSO，完成统一认证，SaaS APP需支持OAuth2.0认证标准。

OAuth2.0 授权码模式认证流程 #

改造示例 #

示例文件下载：【下载saas-oauth2-api.yaml接口demo】

 

该示例为原有SaaS多租户模式的管理系统，其特点：

 

（1）前后端分离架构；

 

（2）代码注释丰富，极其简洁风格，上手快易理解；

 

（3）采用Restfull API 规范开发；

 

（4）统一异常拦截，友好的错误提示；

 

（5）基于注解 + Aop切面实现全方位日记记录系统；

 

（6）基于Mybatis拦截器 + 策略模式实现数据权限控制；

 

（7）Jwt Token 鉴权机制；

 

（8）Spring Social集成Security实现第三方社交登录；

 

（9）基于Mybatis-Plus实现SaaS多租户功能；

 

（10）基于注解实现数据脱敏,防隐私；

 

前端Vue代码改造 #

后端Java代码改造 #

集成效果展示 #