sa-token-doc/sso/sso-type3.md
如果既无法做到前端同域，也无法做到后端同Redis，那么可以使用模式三完成单点登录
[!WARNING| label:小提示] 阅读本篇之前请务必先熟读SSO模式二！因为模式三仅仅属于模式二的一个特殊场景，熟读模式二有助于您快速理解本章内容
我们先来分析一下，当后端不使用共享 Redis 时，会对架构产生哪些影响：
所以模式三的主要目标：也就是在 模式二的基础上 解决上述 三个难题
[!TIP| label:demo | style:callout] 模式三的 Demo 示例地址：
/sa-token-demo/sa-token-demo-sso/sa-token-demo-sso3-client/源码链接，如遇难点可参考示例
如果想要更直观的感受模式二与模式三的差距，可以把前面章节创建的模式二 demo 代码复制一份，在新复制的项目上继续更改来测试模式三。
模式三要求 sso-client 与 sso-server 连接不同的 redis，所以此处没有必要再引入 sa-token-alone-redis 机制，可以去除相关依赖：
<!---------------------------- tabs:start ----------------------------> <!-------- tab:Maven 方式 --------><!-- Sa-Token插件：权限缓存与业务缓存分离 -->
<dependency>
<groupId>cn.dev33</groupId>
<artifactId>sa-token-alone-redis</artifactId>
<version>${sa.top.version}</version>
</dependency>
// Sa-Token插件：权限缓存与业务缓存分离
implementation 'cn.dev33:sa-token-alone-redis:${sa.top.version}'
更改 application.yml ：
# 端口
server:
port: 9003
# sa-token配置
sa-token:
# 打印操作日志
is-log: true
# sso-client 相关配置
sso-client:
# 应用标识
client: sso-client3
# sso-server 端主机地址
server-url: http://sa-sso-server.com:9000
# 使用 Http 请求校验 ticket (模式三)
is-http: true
# API 接口调用秘钥
secret-key: SSO-C3-kQwIOrYvnXmSDkwEiFngrKidMcdrgKor
spring:
# 配置 Redis 连接 （此处与 SSO-Server 端连接不同的 Redis）
redis:
# Redis数据库索引
database: 3
# Redis服务器地址
host: 127.0.0.1
# Redis服务器连接端口
port: 6379
# Redis服务器连接密码（默认为空）
password:
# 连接超时时间
timeout: 10s
# 端口
server.port=9003
# sa-token配置
# 打印操作日志
sa-token.is-log=true
# sso-client 相关配置
# 应用标识
sa-token.sso-client.client=sso-client3
# sso-server 端主机地址
sa-token.sso-client.server-url=http://sa-sso-server.com:9000
# 使用 Http 请求校验 ticket (模式三)
sa-token.sso-client.is-http=true
# API 接口调用秘钥
sa-token.sso-client.secret-key=SSO-C3-kQwIOrYvnXmSDkwEiFngrKidMcdrgKor
# 配置 Redis 连接 （此处与 SSO-Server 端连接不同的 Redis）
# Redis数据库索引
spring.redis.database=3
# Redis服务器地址
spring.redis.host=127.0.0.1
# Redis服务器连接端口
spring.redis.port=6379
# Redis服务器连接密码（默认为空）
spring.redis.password=
# 连接超时时间
spring.redis.timeout=10s
重启项目，访问测试：
[!WARNING| label:小提示] 注：如果已测试运行模式二，可先将Redis中的数据清空，以防旧数据对测试造成干扰
测试步骤同模式二，不再赘述。
<!-- ### 3、获取 UserInfo 除了账号id，我们可能还需要将用户的昵称、头像等信息从 Server端 带到 Client端，即：用户资料的拉取。 在模式二中我们只需要将需要同步的资料放到 SaSession 即可，但是在模式三中两端不再连接同一个 Redis，这时候我们需要通过 http 接口来同步信息。 在旧版本`（<= v1.34.0）` 框架提供的方案是配置 getUserinfo 接口地址，从 client 调用拉取数据，该方案有以下缺点： - 每次调用只能传递固定 loginId 一个参数，不方便。 - 只能拉取 userinfo 数据，不通用。 - 如果还需要拉取其它业务数据，需要再自定义一个接口，比较麻烦。 为此，我们设计了更通用、灵活的 getData 接口，解决上述三个难题。 #### 3.1、首先在 Server 端开放一个查询数据的接口 ``` java // 示例：获取数据接口（用于在模式三下，为 client 端开放拉取数据的接口） @RequestMapping("/sso/getData") public SaResult getData(String apiType, String loginId) { System.out.println("---------------- 获取数据 ----------------"); System.out.println("apiType=" + apiType); System.out.println("loginId=" + loginId); // 校验签名：只有拥有正确秘钥发起的请求才能通过校验 SaSignUtil.checkRequest(SaHolder.getRequest()); // 自定义返回结果（模拟） return SaResult.ok() .set("id", loginId) .set("name", "LinXiaoYu") .set("sex", "女") .set("age", 18); } ``` > [!WARNING| label:小提示] > 如果配置了 “不同 client 不同秘钥” 模式，则需要将上述的： >   SaSignUtil.checkRequest(SaHolder.getRequest()); > > 改为以下方式： >   String client = SaHolder.getRequest().getHeader("client"); >   SaSsoServerProcessor.instance.ssoServerTemplate.getSignTemplate(client).checkRequest(SaHolder.getRequest()); > > 如果没有配置 “不同 client 不同秘钥” 模式，则请忽略本条提示。 #### 3.2、在 Client 端调用此接口查询数据 在 `SsoClientController` 中新增接口 ``` java // 查询我的账号信息 @RequestMapping("/sso/myInfo") public Object myInfo() { // 组织请求参数 Map<String, Object> map = new HashMap<>(); map.put("apiType", "userinfo"); map.put("loginId", StpUtil.getLoginId()); // 发起请求 Object resData = SaSsoUtil.getData(map); System.out.println("sso-server 返回的信息：" + resData); return resData; } ``` #### 3.3、访问测试 访问测试：[http://sa-sso-client1.com:9001/sso/myInfo](http://sa-sso-client1.com:9001/sso/myInfo) ### 4、自定义接口通信 上述示例展示在 client 端向 server 拉取 userinfo 数据的步骤，如果你还需要拉取其它业务的数据，稍加改造示例便可以实现。 #### 4.1、方式一，使用 apiType 参数来区分业务 我们可以约定好，使用 apiType 来区分不同的业务，例如： - 当 `apiType=userinfo` 时：代表拉取用户资料。 - 当 `apiType=followList` 时：代表拉取用户的关注列表。 - 当 `apiType=fansList` 时：代表拉取用户的粉丝列表。 此时，我们便可以通过在 client 端传入不同的 apiType 参数，来区分不同的业务。 ``` java // 查询我的账号信息 @RequestMapping("/sso/myFollowList") public Object myFollowList() { // 组织请求参数 Map<String, Object> map = new HashMap<>(); map.put("apiType", "followList"); // 关键代码，代表本次我要拉取关注列表 map.put("loginId", StpUtil.getLoginId()); // 发起请求 Object resData = SaSsoUtil.getData(map); System.out.println("sso-server 返回的信息：" + resData); return resData; } ``` 然后在 server 端我们通过不同的 apiType 值，返回不同的信息即可。 #### 4.2、方式二：直接在调用接口时传入一个自定义 path 我们可以 client 端，调用 `SaSsoUtil.getData` 方法时，传入一个自定义 path，例如： ``` java // 查询我的账号信息 @RequestMapping("/sso/myFansList") public Object myFansList() { // 组织请求参数 Map<String, Object> map = new HashMap<>(); // map.put("apiType", "userinfo"); // 此时已经不需要 apiType 参数了 map.put("loginId", StpUtil.getLoginId()); // 发起请求 （传入自定义的 path 地址） Object resData = SaSsoUtil.getData("/sso/getFansList", map); System.out.println("sso-server 返回的信息：" + resData); return resData; } ``` 同时，我们需要在 server 端开放这个自定义的 `/sso/getFansList` 接口： ``` java // 获取指定用户的粉丝列表 @RequestMapping("/sso/getFansList") public Object getFansList(Long loginId) { System.out.println("---------------- 获取 loginId=" + loginId + " 的粉丝列表 ----------------"); // 校验签名：只有拥有正确秘钥发起的请求才能通过校验 SaSignUtil.checkRequest(SaHolder.getRequest()); // 查询数据 (此处仅做模拟) List<Integer> list = Arrays.asList(10041, 10042, 10043, 10044); // 返回 return list; } ``` #### 4.3、访问测试 访问测试：[http://sa-sso-client1.com:9001/sso/myFansList](http://sa-sso-client1.com:9001/sso/myFansList) -->当我们熟读三种模式的单点登录之后，其实不难发现：所谓单点登录，其本质就是多个系统之间的会话共享。
当我们理解这一点之后，三种模式的工作原理也浮出水面：