什么是单点登录系统？用nodejs怎么实现？

什么是单点登录系统？用nodejs怎么实现？下面本篇文章给大家介绍一下使用node实现单点登录系统的方法，希望对大家有所帮助！

单点登录SSO(Single Sign On),就是把2个及以上的业务系统中的登录功能剥离出来，形成一个新的系统，做到一次登录后在任意的业务系统中都无需登录的效果。

一. 基础知识

1.1 同源策略

源 = 协议 + 域名 +端口

以http://www.a.com为例：

• https://www.a.com ❌(协议不同)
• http://www.b.com ❌(域名不同)
• http://www.a.com:3000 ❌(端口不同)

同源策略是浏览器的行为，它通过确保应用下的资源只能被本应用访问，来保证安全。

1.2 会话机制

由于http协议是无状态协议(客户端和服务器端数据交换完毕，会关闭连接，下次请求重新建立连接)，但我们需要做记住密码等功能时，很明显需要将会话记录下来。【相关教程推荐：nodejs视频教程】

常用的会话跟踪就是cookie和session，简单的理解它们就是可以存放key，value的数据结构，区别在于cookie保存在客户端，session保存在服务器端。

二. 单点登录

1. 同父域SSO

同父域，如www.app1.aaa.com,www.app2.aaa.com这两个服务器都是在.aaa.com的父域名。
默认情况下，两个服务器下页面之间的cookie是互相访问不到的。

但是我们可以通过设置cookie的domain属性为共通的父域名,使得两个服务器下页面之间的cookie可以相互访问到。

router.get('/createCookie', async (ctx, next) => {   ctx.cookies.set('username', '123', {     maxAge: 60 * 60 * 1000,     httpOnly: false,     path: '/',     domain:'.a.com' //设置domain为共通的父域名   });   ctx.body = "create cookie ok"})router.get('/getCookie', async (ctx, next) => {   let username=ctx.cookies.get('username')   if (username){     ctx.body=username  }else{     ctx.body='no cookie'   }})

2. 跨域SSO

当我们的域名为www.a.com,www.b.com时，无论怎样设置domain都没用了。

那么就要想办法将身份凭证(token)写入到所有域的cookie中。

2.1 跨域写cookie

2.1.1 利用< script />标签跨域写cookie(jsonp)

在http://www.a.com/index.js中直接向https://www.c.com:3000/sso直接发送网络请求，是无法跨域写入cookie的。

  <script>     $.ajax({       url: 'https://www.c.com:3000/sso?key=username&value=123',       method: 'get',     })   </script>

但是我们可以通过< script />标签发起跨域请求，写入cookie

<script src="https://www.c.com:3000/sso?key=username&value=123"></script>

或者使用jquery jsonp的方式发起跨域请求，写入cookie，这种方式的原理也是通过< script />标签能够跨域实现的。

 $.ajax({       url: 'https://www.c.com:3000/sso?key=username&value=123',       method: 'get',       dataType:'jsonp'     })

这样通过< script />标签就实现了往www.a.com中写入了domain为www.c.com的跨域cookie.

后端

const options = {   key: fs.readFileSync(path.join(__dirname, './https/privatekey.pem')),   cert: fs.readFileSync(path.join(__dirname, './https/certificate.pem')),   secureOptions: 'TLSv1_2_method' //force TLS version 1.2}var server = https.createServer(options,app.callback());  //只能使用https协议写cookierouter.get('/sso', async (ctx, next) => {   let {     key, value  } = ctx.request.query   ctx.cookies.set(key, value, {     maxAge: 60 * 60 * 1000, //有效时间，单位毫秒     httpOnly: false, //表示 cookie 是否仅通过 HTTP(S) 发送，, 且不提供给客户端 JavaScript (默认为 true).     path: '/',     sameSite: 'none', //限制第三方 Cookie     secure: true //cookie是否仅通过 HTTPS 发送   });   ctx.body = 'create Cookie ok'})

注意:

• 浏览器未写入cookie报错his set-cookie was blocked due to http-only
  http-only：表示 cookie 是否仅通过 HTTP(S) 发送，, 且不提供给客户端 JavaScript (默认为 true).
  所以要将httpOnly设置为false.

• 浏览器未写入cookie报错this set-cookie was blocked due to user preference
  这个真的坑，因为我是无痕模式打开的浏览器，但是chrome浏览器默认无痕模式下禁用第三方cookie，修改为允许所有cookie就行了.
  

• 浏览器未写入cookie报错this set cookie was blocked because it has the SameSite attribute but Secure not set
  需要设置sameSite和secure属性

• 浏览器未写入cookie报错server error Error: Cannot send secure cookie over unencrypted connection
  这个我觉得是koa框架写cookie的限制吧，它只能支持https写cookie…，于是我把www.c.com改为了https服务器.

2.1.2 p3p协议头实现IE浏览器跨域

上面说的jsonp的方式在chrome浏览器中完美运行，但是IE浏览器对于cookie更加严格，只用上面方式无法写入cookie，解决办法就是加上p3p的响应头。

router.get('/sso', async (ctx, next) => {   let {     key, value  } = ctx.request.query   ctx.cookies.set(key, value, {     maxAge: 60 * 60 * 1000, //有效时间，单位毫秒     httpOnly: false,     path: '/',     sameSite: 'none',     secure: true   });   ctx.set("P3P", "CP='CURa ADMa DEVa PSAo PSDo OUR BUS UNI PUR INT DEM STA PRE COM NAV OTC NOI DSP COR'") //p3p响应头   ctx.body = 'create Cookie ok'})

2.1.3 url参数实现跨域信息传递

访问http://www.c.com:3000/createToken?from=http://www.a.com/createCookie

www.c.com上生成token后将url重写，带上token，重定向到www.a.com

router.get('/createToken', async (ctx, next) => {   let { from } = ctx.request.query  let token = "123";   ctx.response.redirect(`${from}?token=${token}`)})

www.a.com上从url上获取token，存入cookie

router.get('/createCookie', async (ctx, next) => {   let { token } = ctx.request.query   ctx.cookies.set('token', token, {     maxAge: 60 * 60 * 1000, //有效时间，单位毫秒     httpOnly: false,     path: '/',   });   ctx.body = 'set cookie ok'})

这样就实现了跨域信息的传递.与上面的方式不同，这种方法只是单纯的http请求，适用于所有浏览器，但是缺点也很明显，每次只能分享给一个服务器。

2.2 跨域读cookie

2.2.1 利用< script />标签跨域读cookie(jsonp)

之前2.1.1利用< script />标签在www.a.com中写入了www.c.com的cookie(username,123),现在想要www.a.com请求的时候携带上www.c.com的cookie，也就是说要跨域读cookie.

其实也是同样的方法，在www.a.com上利用< script />跨域访问访问www.c.com,会自动的带上domain为www.c.com的cookie。
www.a.com/index.js

<script src="https://www.c.com:3000/readCookie"></script>

www.c.com

router.get('/readCookie', async (ctx, next) => {   let username = ctx.cookies.get('username')   console.log('cookie', username)})

可以看到读取到了存储在www.a.com里面domain为www.c.com的cookie.

3. nodejs实现单点登录系统实战

效果如图所示:

• 第一次访问www.a.com首页

• 跳转到www.c.com:3000登录页面,登录成功后跳转www.a.com首页

• 再次访问www.a.com首页，无需登录直接跳转

• 访问www.b.com首页，无需登录直接跳转

源码: https://github.com/wantao666/sso-nodejs

详细设计: