新增 SSO 平台中心模式示例，跳连接进入子系统

sa-token-demo/sa-token-demo-sso-server/src/main/java/com/pj/sso/HomeController.java

@@ -0,0 +1,43 @@
+package com.pj.sso;
+
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+import cn.dev33.satoken.context.SaHolder;
+import cn.dev33.satoken.stp.StpUtil;
+
+/**
+ * SSO 平台中心模式示例，跳连接进入子系统 
+ * 
+ * @author kong
+ * @since 2022-10-24
+ */
+@RestController
+public class HomeController {
+
+	/**
+	 * 平台化首页
+	 * @return
+	 */
+	@RequestMapping("/home")
+	public Object index() {
+		// 如果未登录，则先去登录
+		if(StpUtil.isLogin() == false) {
+			return SaHolder.getResponse().redirect("/sso/auth");
+		}
+		
+		// 拼接各个子系统的地址，格式形如：/sso/auth?redirect=${子系统首页}/sso/login?back=${子系统首页}
+		String link1 = "/sso/auth?redirect=http://sa-sso-client1.com:9001/sso/login?back=http://sa-sso-client1.com:9001/";
+		String link2 = "/sso/auth?redirect=http://sa-sso-client2.com:9001/sso/login?back=http://sa-sso-client2.com:9001/";
+		String link3 = "/sso/auth?redirect=http://sa-sso-client3.com:9001/sso/login?back=http://sa-sso-client3.com:9001/";
+
+		// 组织网页结构返回到前端 
+		String title = "<h2>SSO 平台首页</h2>";
+		String client1 = "<p><a href='" + link1 + "' target='_blank'> 进入Client1系统 </a></p>";
+		String client2 = "<p><a href='" + link2 + "' target='_blank'> 进入Client2系统 </a></p>";
+		String client3 = "<p><a href='" + link3 + "' target='_blank'> 进入Client3系统 </a></p>";
+		
+		return title + client1 + client2 + client3;
+	}
+	
+}

sa-token-doc/_sidebar.md

@@ -42,8 +42,9 @@
 	- [SSO整合：配置域名校验](/sso/sso-check-domain)
 	- [SSO整合：定制化登录页面](/sso/sso-custom-login)
 	- [SSO整合：自定义API路由](/sso/sso-custom-api)
-	- [SSO整合：前后端分离下的整合方案](/sso/sso-h5)
-	- [SSO整合：常见问题总结](/sso/sso-questions)
+	- [SSO扩展：前后端分离下的整合方案](/sso/sso-h5)
+	- [SSO扩展：平台中心跳转模式](/sso/sso-home-jump)
+	- [SSO扩展：常见问题总结](/sso/sso-questions)
 	- [Sa-Sso-Pro：单点登录商业版](/sso/sso-pro)
 
 - **OAuth2.0**

sa-token-doc/sso/sso-home-jump.md

@@ -0,0 +1,92 @@
+# SSO 平台中心跳转模式，点连接跳入子系统
+
+--- 
+
+有的时候，我们需要把 sso-server 搭建成一个平台中心，效果图大致如下：
+
+![sso-home-jump.png](https://oss.dev33.cn/sa-token/doc/sso/sso-home-jump.png 's-w-sh')
+
+如图所示，用户先从 sso-server 登录进入平台首页，在首页上有各个子系统的进入链接，用户点击链接进入子系统（免登录）。
+
+怎么做到如上效果呢？当然，加个超链接跳到子系统并不难，难点在于跳转的同时我们需要让用户自动登录上子系统，从而达到：平台中心一处登录，所有子系统无障碍通行的效果。
+
+怎么做到跳转的时候自动登录呢？直接跳转肯定是不会自动登录的，我们需要对链接改造一下：
+
+假设子系统的地址是：
+
+``` url
+http://sa-sso-client1.com:9001/
+```
+
+那么我们改造后的地址就是：
+
+``` url
+/sso/auth?redirect=http://sa-sso-client1.com:9001/sso/login?back=http://sa-sso-client1.com:9001/
+```
+
+格式形如：`/sso/auth?redirect=${子系统首页}/sso/login?back=${子系统首页}`
+
+--- 
+
+### 完整代码示例：
+
+1、在 sso-server 中添加 `HomeController`，作为平台中心首页：
+
+``` java
+/**
+ * SSO 平台中心模式示例，跳连接进入子系统 
+ */
+@RestController
+public class HomeController {
+	// 平台化首页
+	@RequestMapping("/home")
+	public Object index() {
+		// 如果未登录，则先去登录
+		if(StpUtil.isLogin()) {
+			return SaHolder.getResponse().redirect("/sso/auth");
+		}
+		
+		// 拼接各个子系统的地址，格式形如：/sso/auth?redirect=${子系统首页}/sso/login?back=${子系统首页}
+		String link1 = "/sso/auth?redirect=http://sa-sso-client1.com:9001/sso/login?back=http://sa-sso-client1.com:9001/";
+		String link2 = "/sso/auth?redirect=http://sa-sso-client2.com:9001/sso/login?back=http://sa-sso-client2.com:9001/";
+		String link3 = "/sso/auth?redirect=http://sa-sso-client3.com:9001/sso/login?back=http://sa-sso-client3.com:9001/";
+
+		// 组织网页结构返回到前端 
+		String title = "<h2>SSO 平台首页</h2>";
+		String client1 = "<p><a href='" + link1 + "' target='_blank'> 进入Client1系统 </a></p>";
+		String client2 = "<p><a href='" + link2 + "' target='_blank'> 进入Client2系统 </a></p>";
+		String client3 = "<p><a href='" + link3 + "' target='_blank'> 进入Client3系统 </a></p>";
+		
+		return title + client1 + client2 + client3;
+	}
+}
+```
+
+2、修改一下SSO路由处理的代码，使登录后不再重定向到client端，而是跳转到平台中心首页。
+
+在 `SsoServerController` 的 `ssoRequest` 方法中添加跳转 `/home` 的代码：
+
+``` java
+// SSO-Server端：处理所有SSO相关请求 
+@RequestMapping("/sso/*")
+public Object ssoRequest() {
+	// 如果登录时没有提供redirect参数，则进入平台中心首页 /home，而不是重定向到 client 端 
+	SaRequest req = SaHolder.getRequest();
+	if(req.isPath("/sso/auth") && req.hasParam("redirect") == false && StpUtil.isLogin()) {
+		return SaHolder.getResponse().redirect("/home");
+	}
+	return SaSsoHandle.serverRequest();
+}
+```
+
+新加代码在 4-8 行。
+
+### 测试访问
+
+启动项目，访问：[http://sa-sso-server.com:9000/home](http://sa-sso-server.com:9000/home)
+
+首次访问，因为我们没有登录，所以会被重定向到 `/sso/auth` 登录页，我们登录上之后，便会跳转到平台中心首页：
+
+![sso-home-jump-do.png](https://oss.dev33.cn/sa-token/doc/sso/sso-home-jump-do.png 's-w-sh')
+
+依次点击三个链接，便可在跳转的同时自动登录上子系统。