对接达实授权平台

注意

在对接开放平台之前，您需要先了解一些前置知识，这些内容是对接开放平台的基础

1. 场景

客户有自己统一的认证中心，在认证中心登录后就可以直接进入达实系统；认证中心退出的同时达实也会退出。

2. 适用版本

AIOT V6

3. 功能介绍

3.1单点登录介绍

单点登录（single sign on），简称SSO，用户只需登录一次统一认证系统，就可访问同一帐号平台下的多个应用系统。

3.1.1. 实现机制

1、当用户第一次访问应用系统（达实）的时候，因为还没有登录，会被引导到认证系统中进行登录；根据用户提供的登录信息，认证系统进行身份校验，如果通过校验，返回给用户一个认证的凭据。

2、用户从认证系统跳转到应用系统的时候，就会将这个认证的凭据带上，应用系统接受到请求之后会把认证的凭据通过接口传输给认证系统进行校验，检查认证的凭据的合法性。如果通过校验，用户就可以开始访问应用系统。

如图：

3.1.1. 实现条件

实现SSO，需要以下主要的功能：

认证系统：用户进行登录认证；认证成功后，认证系统生成统一的认证凭据，返还给用户；认证系统对认证凭据进行校验，判断其有效性。

应用系统：通过与认证系统的对接，将用户的认证凭据传输到认证系统进行认证，从而实现对认证凭据进行识别和获取用户信息，返回认证结果从而完成单点登录的功能。

SSO插件：现场二开编写插件实现上述应用系统对接认证系统的功能，开发文档参考单点登录插件开发说明。

3.2 单点登录插件开发说明

3.2.1 方式一：采用依赖SDK的方式

依赖达实SDK

可以提供Jar包，该工具包实现对接达实授权平台
application.yml需要增加配置：

com.das.aiot.portal.login.extend.ExtendSource -- oauth2协议配置自定义资源类
com.das.aiot.portal.login.extend.ExtendDASRequest -- 达实接口配置类
推荐接口：
com.das.aiot.portal.login.controller.LoginController#login(String,HttpServletResponse) -- 获取授权码
com.das.aiot.portal.login.controller.LoginController#login(String,AuthCallback) -- 使用授权码获取token
com.das.aiot.portal.login.controller.LoginController#refresh -- 刷新token

3.2.2 方式二：自定义对接

3.2.2.1 POM依赖

3.2.2.2 声明达实接口配置

达实登录相关接口

接口	接口描述
/api/justauth/oauth-server/v1/visitor/oauth/authorize	获取授权码
/api/justauth/oauth-server/v1/visitor/oauth/token	依据授权码获取令牌
/api/justauth/oauth-server/v1/visitor/oauth/token	刷新令牌
/api/justauth/oauth-server/v1/visitor/logout	用户注销

3.2.2.3 达实接口扩展处理类

作用：达实接口对接时的扩展处理。可增加自定义参数、自定义返回值

3.2.2.4 接口demo Service

可参考该service自定义controller。或者额外的逻辑处理

3.2.2.5 JWT内容含义

字段	含义
name	用户登录名
sub	用户id
tenant	租户id
client_id	密钥key
server	是否服务
exp	过期时间(时间戳)
scope	授权范围
flag	用户类型(管理员=1,员工=2,客户=4)
iat	颁发时间

对接达实授权平台

对接达实授权平台#

1. 场景#

2. 适用版本#

3. 功能介绍#

3.1单点登录介绍#

3.1.1. 实现机制#

3.1.1. 实现条件#

3.2 单点登录插件开发说明#

3.2.1 方式一：采用依赖SDK的方式#

3.2.2 方式二：自定义对接#

3.2.2.1 POM依赖#

3.2.2.2 声明达实接口配置#

3.2.2.3 达实接口扩展处理类#

3.2.2.4 接口demo Service#

3.2.2.5 JWT内容含义#

对接达实授权平台

1. 场景

2. 适用版本

3. 功能介绍

3.1单点登录介绍

3.1.1. 实现机制

3.1.1. 实现条件

3.2 单点登录插件开发说明

3.2.1 方式一：采用依赖SDK的方式

3.2.2 方式二：自定义对接

3.2.2.1 POM依赖

3.2.2.2 声明达实接口配置

3.2.2.3 达实接口扩展处理类

3.2.2.4 接口demo Service

3.2.2.5 JWT内容含义