单点登录笔记
背景
在企业发展初期,企业使用的系统很少,通常一个或者两个,每个系统都有自己的登录模块,运营人员每天用自己的账号登录,很方便。
但随着企业的发展,用到的系统随之增多,运营人员在操作不同的系统时,需要多次登录,而且每个系统的账号都不一样,这对于运营人员
来说,很不方便。于是,就想到是不是可以在一个系统登录,其他系统就不用登录了呢?这就是单点登录要解决的问题。
单点登录英文全称Single Sign On,简称就是SSO。它的解释是:在多个应用系统中,只需要登录一次,就可以访问其他相互信任的应用系统。
如图所示,图中有4个系统,分别是Application1、Application2、Application3、和SSO。Application1、Application2、Application3没有登录模块,而SSO只有登录模块,没有其他的业务模块,当Application1、Application2、Application3需要登录时,将跳到SSO系统,SSO系统完成登录,其他的应用系统也就随之登录了。这完全符合我们对单点登录(SSO)的定义。
技术实现
在说单点登录(SSO)的技术实现之前,我们先说一说普通的登录认证机制。
如上图所示,我们在浏览器(Browser)中访问一个应用,这个应用需要登录,我们填写完用户名和密码后,完成登录认证。这时,我们在这个用户的session中标记登录状态为yes(已登录),同时在浏览器(Browser)中写入Cookie,这个Cookie是这个用户的唯一标识。下次我们再访问这个应用的时候,请求中会带上这个Cookie,服务端会根据这个Cookie找到对应的session,通过session来判断这个用户是否登录。如果不做特殊配置,这个Cookie的名字叫做jsessionid,值在服务端(server)是唯一的。
同域和不同域下的单点登录
一个企业一般情况下只有一个域名,通过二级域名区分不同的系统。比如我们有个域名叫做:a.com,同时有两个业务系统分别为:app1.a.com和app2.a.com。我们要做单点登录(SSO),需要一个登录系统,叫做:sso.a.com。
我们只要在sso.a.com登录,app1.a.com和app2.a.com就也登录了。通过上面的登陆认证机制,我们可以知道,在sso.a.com中登录了,其实是在sso.a.com的服务端的session中记录了登录状态,同时在浏览器端(Browser)的sso.a.com下写入了Cookie。那么我们怎么才能让app1.a.com和app2.a.com登录呢?这里有两个问题:
- Cookie是不能跨域的,我们Cookie的domain属性是sso.a.com,在给app1.a.com和app2.a.com发送请求是带不上的。
- sso、app1和app2是不同的应用,它们的session存在自己的应用内,是不共享的。
那么我们如何解决这两个问题呢?针对第一个问题,sso登录以后,可以将Cookie的域设置为顶域,即.a.com,这样所有子域的系统都可以访问到顶域的Cookie。我们在设置Cookie时,只能设置顶域和自己的域,不能设置其他的域。比如:我们不能在自己的系统中给baidu.com的域设置Cookie。
Cookie的问题解决了,我们再来看看session的问题。我们在sso系统登录了,这时再访问app1,Cookie也带到了app1的服务端(Server),app1的服务端怎么找到这个Cookie对应的Session呢?这里就要把3个系统的Session共享,如图所示。共享Session的解决方案有很多,例如:Spring-Session。这样第2个问题也解决了。
同域下的单点登录就实现了,但这还不是真正的单点登录。
登录认证服务器的控制层
@Controller
public class LoginController {
@Autowired
private StringRedisTemplate redisTemplate;
//获取用户信息
@GetMapping("/userInfo")
@ResponseBody
public String userInfo(
@RequestParam(value = "token",required = true) String token
){
String s = redisTemplate.opsForValue().get(token);
System.out.println("用户的token结果为"+s);
return s;
}
/*
* @description 跳转登录页面
* @param url: 重定向的路径
* @param token: token令牌
* @return java.lang.String
* @author han
* @date 2020年07月06日 16:30
*/
@RequestMapping(value = "/login.html",method = RequestMethod.GET)
public String doLogin(@RequestParam("redirect_url") String url,
Model model,
@CookieValue(value = "sso_token",required = false) String token){
if (!StringUtils.isEmpty(token)){
//说明之前已经登陆过了,就不用在登录了,直接返回到之前的页面
return "redirect:"+url+"?token="+token;
}
model.addAttribute("url",url);
//登录成功跳转页面,跳回到之前的页面
return "login";
}
//登录方法
@RequestMapping(value = "doLogin",method = RequestMethod.POST)
public String loginPage(String username,
String password,
String url,
HttpServletResponse response){
if (!StringUtils.isEmpty(username) && !StringUtils.isEmpty(password)){
//将用户信息存储进redis中
String uuid = UUID.randomUUID().toString().replace("-", "");
redisTemplate.opsForValue().set(uuid,username);
//将token保存到cookie中,
Cookie cookie = new Cookie("sso_token",uuid);
response.addCookie(cookie);
//登陆成功,跳回之前的页面,携带登陆成功的token
return "redirect:"+url+"?token="+uuid;
}
//登录成功跳转页面,跳回到之前的页面
return "login";
}
}
登录认证服务器的配置文件
server.port=8080
spring.redis.host=你的redis的地址
客户端1的控制层
@Controller
public class HelloController {
@Value("${sso.server.url}")
String ssoServerUrl;
@ResponseBody
@RequestMapping(value = "/hello",method = RequestMethod.GET)
public String hello(){
return "hello";
}
/*
* @description
* @param model:
* @param session:
* @param token: 只要在登录页成功登录了,就携带token
* @return java.lang.String
* @author han
* @date 2020年05月27日 12:29
*/
@RequestMapping(value = "/employees",method = RequestMethod.GET)
public String employees(Model model, HttpSession session,
@RequestParam(value = "token",required = false) String token){
//判断token是否为空
if (!StringUtils.isEmpty(token)){
//去ssoserver获取当前token真正的用户信息
RestTemplate restTemplate = new RestTemplate();
String url="http://ssoserver.com:8080/userInfo?token=" + token;
ResponseEntity<String> forEntity = restTemplate.getForEntity(url, String.class);
String entityBody = forEntity.getBody();
System.out.println("获取到的用户信息为"+entityBody);
session.setAttribute("loginUser",entityBody);
}
Object user = session.getAttribute("loginUser");
if (user==null){
//没登录,跳转到登录服务器登录
//跳转过去之后,使用url上的查询参数标识我们自己是哪个页面
return "redirect:"+ssoServerUrl+"?redirect_url=http://client1.com:8081/employees";
}else {
ArrayList<String> list = new ArrayList<>();
list.add("张三");
list.add("李四");
model.addAttribute("emps",list);
return "list";
}
}
}
客户端1的配置文件
server.port=8081
sso.server.url=http://ssoserver.com:8080/login.html
客户端2的内容和客户端1的内容是一样的,只是端口不同,所以客户端2的代码就不粘贴了
接下来是页面部分,模板引擎使用的是thymeleaf,内容如下
登录页面,放在认证服务器中,内容如下
<!DOCTYPE html>
<html lang="en" xmlns:th="http://www.thymeleaf.org">
<head>
<meta charset="UTF-8">
<title>登录页</title>
</head>
<body>
<form action="/doLogin" method="post">
用户名:<input name="username" /><br>
密码:<input name="password" /><br>
<input type="hidden" name="url" th:value="${url}">
<input type="submit" value="登录">
</form>
</body>
</html>
登录后才能访问的页面,放在客户端中,内容如下
<!DOCTYPE html>
<html lang="en" xmlns:th="http://www.thymeleaf.org">
<head>
<meta charset="UTF-8">
<title>员工列表</title>
</head>
<body>
<h1>欢迎</h1>
<ul>
<li th:each="emp : ${emps}">姓名: [[${emp}]]</li>
</ul>
</body>
</html>
运行流程如下: