sa-token/sa-token-doc/sso/sso-home-jump.md
gongjixiaobai f0431e3a54
Update sso-home-jump.md
未登录应该为!
2022-11-09 10:16:08 +08:00

3.5 KiB
Raw Blame History

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


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

sso-home-jump.png

如图所示,用户先从 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端而是跳转到平台中心首页。

SsoServerControllerssoRequest 方法中添加跳转 /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 登录页,我们登录上之后,便会跳转到平台中心首页:

sso-home-jump-do.png

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