单点登陆（Single Sign On）解决方案

需求

多个应用系统中，用户只须要登陆一次就能够访问全部相互信任的应用系统。

A 网站和 B 网站是同一家公司的关联服务。如今要求，用户只要在其中一个网站登陆，再访问另外一个网站就会自动登陆，请问怎么实现？

涉及到的关键点：

这里就涉及到了 跨域认证 以及 前端页面 JavaScript 跨域 问题。

1、跨域认证问题

互联网服务离不开用户认证。通常流程是下面这样。

• 用户向服务器发送帐户和密码
• 服务器验证经过后，在当前会话 （session）里保存相关数据，如用户角色、用户ID等
• 服务器向用户返回一个 session_id，写入用户 cookie
• 用户以后的每一次请求，都会经过 Cookie 将 session_id 传回服务器
• 服务器收到 session_id ，找到以前存储的数据，由此得知用户身份

下面以 登陆 A 站点 访问 B 站点 为例

方案一： session 持久化

​ 将 session 数据持久化，写入数据库或别的持久层。各类服务受到请求后，都向持久层请求数据。

这种方案，对于各类系统的代码改动量少，只要在权限验证的地方进行判断便可。

• A 登陆成功代码
• 登陆成功后，将 session 存储到 Redis 持久化存储，注意设置有效期
• tip：

Redis 以层级形式、目录形式保存数据，最大四级，格式以下：

set('dir:dir:dir:key', 'value');

/**
 * 将 Session 存储到 Redis
 * @param boolean $logout 是否退出登录 默认否
 * @return array
 */
public function sessionToRedis($logout = false) {
 try {
 if ($logout) {
 (new Redis())->del('Admin:session:' . session_id());
 }else{
 $userInfo = session('CH_ADMIN_LOGIN_STATUS');
 $res = (new Redis())->setex('Admin:session:' . session_id(), 28800, json_encode($userInfo, JSON_UNESCAPED_UNICODE));
 if ($res === false) throw new \Exception('Redis 存储失败');
 return true;
 }
 } catch (\Exception $e) {
 return false;
 }
 }

 

• 登陆成功后 访问 B, B 进行用户身份认证
• 注意 此时 访问 B的连接URL 要携带参数 sessionid！
• B 在处理请求- 身份验证时，先解析是否携带了sessionid参数，携带了则向 redis 中查询相关数据，并将数据保存到当前会话中。此时就成功 登陆 B 了。

/**
 * 经过其余后台单点登录
 * 传递session_id(用于session共享)
 */
$params = $request->param();
if (!empty($params) && isset($params['session_id'])) {
 session_id($params['session_id']);
 // 设置会话id
 $userInfo = Session::get('userinfo', 'admin');
 if (empty($userInfo)) {
 $userInfo = json_decode((new Redis())->get('Admin:session:'.$params['session_id']), true);
 Session::set('userinfo', $userInfo, 'admin');
 }
} else {
 $userInfo = Session::get('userinfo', 'admin');
}

方案二：JWT（JSON Web Token）

服务器索性不保存 session 数据了，「用户数据」加密保存到「客户端」，每次请求都将数据发回服务器，服务器再进行解析获得用户身份信息数据。JWT 就是这种方案的一个表明。

JWT 原理

---

服务器认证后，生成一个 JSON 对象，发回给用户，就像下面这样。

{
 "姓名": "张三",
 "角色": "管理员",
 "到期时间": "2019年10月1日0点0分"
}

之后，用户与服务端通讯的时候，都要发回这个 JSON 对象。服务器彻底只靠这个对象认定用户身份。为了防止用户篡改数据，服务器在生成这个对象的时候，会加上签名（详见后文）。

服务器就不保存任何 session 数据了，也就是说，服务器变成无状态了，从而比较容易实现扩展。

JWT 的数据结构

---

 

 

它是一个很长的字符串，中间用点（.）分隔成三个部分。注意，JWT 内部是没有换行的，这里只是为了便于展现，将它写成了几行。

JWT 的三个部分依次以下。

• Header（头部）
• Payload（负载）
• Signature（签名）

写成一行，就是下面的样子。

Header.Payload.Signature

 

 

 

Header

---

Header 部分是一个 JSON 对象，描述 JWT 的元数据，一般是下面的样子。

{
 "alg": "HS256",
 "typ": "JWT"
}

上面代码中，alg属性表示签名的算法（algorithm），默认是 HMAC SHA256（写成 HS256）；typ属性表示这个令牌（token）的类型（type），JWT 令牌统一写为JWT。

最后，将上面的 JSON 对象使用 Base64URL 算法（详见后文）转成字符串。

Payload

---

Payload 部分也是一个 JSON 对象，用来存放实际须要传递的数据。JWT 规定了7个官方字段，供选用。

• iss (issuer)：签发人
• exp (expiration time)：过时时间
• sub (subject)：主题
• aud (audience)：受众
• nbf (Not Before)：生效时间
• iat (Issued At)：签发时间
• jti (JWT ID)：编号

除了官方字段，你还能够在这个部分定义私有字段，下面就是一个例子。

{
 "sub": "1234567890",
 "name": "John Doe",
 "admin": true
}

注意，JWT 默认是不加密的，任何人均可以读到，因此不要把秘密信息放在这个部分。

这个 JSON 对象也要使用 Base64URL 算法转成字符串。

Signature

---

Signature 部分是对前两部分的签名，防止数据篡改。

首先，须要指定一个密钥（secret）。这个密钥只有服务器才知道，不能泄露给用户。而后，使用 Header 里面指定的签名算法（默认是 HMAC SHA256），按照下面的公式产生签名。

HMACSHA256(
 base64UrlEncode(header) + "." +
 base64UrlEncode(payload),
 secret)

算出签名之后，把 Header、Payload、Signature 三个部分拼成一个字符串，每一个部分之间用"点"（.）分隔，就能够返回给用户。

Base64URL

---

前面提到，Header 和 Payload 串型化的算法是 Base64URL。这个算法跟 Base64 算法基本相似，但有一些小的不一样。

JWT 做为一个令牌（token），有些场合可能会放到 URL（好比 api.example.com/?token=xxx）。Base64 有三个字符+、/和=，在 URL 里面有特殊含义，因此要被替换掉：=被省略、+替换成-，/替换成_。这就是 Base64URL 算法。

JWT 的使用方式

---

客户端收到服务器返回的 JWT，能够储存在 Cookie 里面，也能够储存在 localStorage。

此后，客户端每次与服务器通讯，都要带上这个 JWT。你能够把它放在 Cookie 里面自动发送，可是这样不能跨域，因此更好的作法是放在 HTTP 请求的头信息Authorization字段里面。

Authorization: Bearer <token>

另外一种作法是，跨域的时候，JWT 就放在 POST 请求的数据体里面。

JWT 的几个特色

---

（1）JWT 默认是不加密，但也是能够加密的。生成原始 Token 之后，能够用密钥再加密一次。

（2）JWT 不加密的状况下，不能将秘密数据写入 JWT。

（3）JWT 不只能够用于认证，也能够用于交换信息。有效使用 JWT，能够下降服务器查询数据库的次数。

（4）JWT 的最大缺点是，因为服务器不保存 session 状态，所以没法在使用过程当中废止某个 token，或者更改 token 的权限。也就是说，一旦 JWT 签发了，在到期以前就会始终有效，除非服务器部署额外的逻辑。

（5）JWT 自己包含了认证信息，一旦泄露，任何人均可以得到该令牌的全部权限。为了减小盗用，JWT 的有效期应该设置得比较短。对于一些比较重要的权限，使用时应该再次对用户进行认证。

（6）为了减小盗用，JWT 不该该使用 HTTP 协议明码传输，要使用 HTTPS 协议传输。

2、JavaScript 跨域

单点登陆不免会遇到窗口之间 JS 跨域问题，此时的解决方案是 postMessage

postMessage 是HTML5 XMLHttpRequest Level 2中的API，且是为数很少能够跨域操做的window属性之一，它可用于解决如下方面的问题：

a.） 页面和其打开的新窗口的数据传递

b.） 多窗口之间消息传递

c.） 页面与嵌套的iframe消息传递

d.） 上面三个场景的跨域数据传递

用法：postMessage(data,origin) 方法接受两个参数

data： html5规范支持任意基本类型或可复制的对象，但部分浏览器只支持字符串，因此传参时最好用JSON.stringify()序列化。

origin： 协议+主机+端口号，也能够设置为"*"，表示能够传递给任意窗口，若是要指定和当前窗口同源的话设置为"/"。

1.）a.html：(http://www.domain1.com/a.html)

<iframe id="iframe" src="http://www.domain2.com/b.html" style="display:none;"></iframe>
<script> 
 var iframe = document.getElementById('iframe');
 iframe.onload = function() {
 var data = {
 name: 'aym'
 };
 // 向domain2传送跨域数据
 iframe.contentWindow.postMessage(JSON.stringify(data), 'http://www.domain2.com');
 };
 // 接受domain2返回数据
 window.addEventListener('message', function(e) {
 alert('data from domain2 ---> ' + e.data);
 }, false);
</script>

2.）b.html：(http://www.domain2.com/b.html)

<script>
 // 接收domain1的数据
 window.addEventListener('message', function(e) {
 alert('data from domain1 ---> ' + e.data);
 var data = JSON.parse(e.data);
 if (data) {
 data.number = 16;
 // 处理后再发回domain1
 window.parent.postMessage(JSON.stringify(data), 'http://www.domain1.com');
 }
 }, false);
</script>