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

SSO 平台中心跳转模式，点连接跳入子系统

---

有的时候，我们需要把 sso-server 搭建成一个平台中心，效果图大致如下：

如图所示，用户先从 sso-server 登录进入平台首页，在首页上有各个子系统的进入链接，用户点击链接进入子系统（免登录）。

怎么做到如上效果呢？当然，加个超链接跳到子系统并不难，难点在于跳转的同时我们需要让用户自动登录上子系统，从而达到：平台中心一处登录，所有子系统无障碍通行的效果。

怎么做到跳转的时候自动登录呢？直接跳转肯定是不会自动登录的，我们需要对链接改造一下：

假设子系统的地址是：

http://sa-sso-client1.com:9001/

那么我们改造后的地址就是：

/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，作为平台中心首页：

/**
 * 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 的代码：

// 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 SaSsoProcessor.instance.serverDister();
}

新加代码在 4-8 行。

测试访问

启动项目，访问：http://sa-sso-server.com:9000/home

首次访问，因为我们没有登录，所以会被重定向到 /sso/auth 登录页，我们登录上之后，便会跳转到平台中心首页：

依次点击三个链接，便可在跳转的同时自动登录上子系统。