nodejs实现单点登录系统

单点登录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协议是无状态协议(客户端和服务器端数据交换完毕，会关闭连接，下次请求重新建立连接)，但我们需要做记住密码等功能时，很明显需要将会话记录下来。

常用的会话跟踪就是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' }) 

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协议写cookie router.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' }) 

注意:

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

   
   
   
   

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

   
   
   
   

3. 浏览器未写入cookie报错this set cookie was blocked because it has the SameSite attribute but Secure not set
   需要设置sameSite和secure属性
   
   
4. 浏览器未写入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' }) 

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.

<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实现单点登录系统实战

效果如图所示:

1. 第一次访问www.a.com首页
2. 跳转到www.c.com:3000登录页面,登录成功后跳转www.a.com首页
3. 再次访问www.a.com首页，无需登录直接跳转
4. 访问www.b.com首页，无需登录直接跳转

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