SSO 单点登录总结（PHP）

本篇文章根据个人理解的知识整理汇总，如有不足之处，请大家多多指正。

单点登录（sso——single sign on）的应用是很普遍的，尤其在大型网站系统中，比如百度，登录百度账号和，再转到百度经验、百度贴吧等是不用重新登录的。本文将从 cookie 和 session 基础详细介绍单点登录的原理，代码实现为 php。

cookie

cookie 是由客户端访问服务器时服务器发送给客户端的特殊信息，且这些信息以文本文件的方式存储在客户端。第一次访问服务器时，服务器会在 http 响应头（response header）返回 cookie 信息。客户端保存 cookie 信息之后，下次访问服务器时，http请求头（request header）会包含 cookie 信息。

简单的说： 服务器不认识访问它的客户端，为了识别它们，就给每个访问它的客户端一个口令，服务器通过口令识别这些客户端。

注意： 不是访问每个服务器都会返回 cookie 的，只有服务器中有设置 cookie ，才会返回给客户端。

cookie 生成和传递流程

• 在本地服务器下的 test.php 中设置 cookie

<?php
// cookie 是 http 标头的一部分，因此 setcookie() 函数必须在其它信息被输出到浏览器前调用，这和对 header() 函数的限制类似
setcookie('testcookie', 'this is test cookie');

• 通过浏览器访问本地服务器 localhost/test.php，报文如下：
  

• 删除本地服务器下 test.php 中的 setcookie，再次访问 localhost/test.php，报文如下：
  

cookie 流程图

简单登录示例：

<?php
# 登录
setcookie('username', 'test');

# 判断是否已登录
if (isset($_cookie['username'])) {
    echo '已登录';
}

关于 cookie 的具体用法暂时不多说明，本篇文章主要讲解机制原理

session

session 是服务器端使用的一种记录客户端状态的机制，使用上比cookie简单一些，相应的也增加了服务器的存储压力。在客户端访问服务器时，服务器会创建 session 并生成一个 session id 发到客户端，客户端下次访问时需要带着 session id，服务器则根据 session id 找到相应的 session。

session 生成和传递流程

• 服务器设置 session：localhost/session.php

<?php
session_start();
$_session['testsession'] = 'this is test';

• 客户端浏览器访问服务器：localhost/session.php，报文如下图：
  

• 客户端浏览器再此访问服务器（注释代码）：localhost/session.php，报文如下：
  

cookie 和 session 的关系图（接上节中的设置）

单点登录

在介绍单点登录的方式之前先介绍一下 php 中的 cookie 中的设置，方便容易理解

bool setcookie ( string $name [, string $value = "" [, int $expire = 0 [, string $path = "" [, string $domain = "" [, bool $secure = false [, bool $httponly = false ]]]]]] )

参数:

• name: cookie 名称。
• value: cookie 值。
• expire: cookie 的过期时间。
• path: cookie 有效的服务器路径。 设置成 '/' 时，cookie 对整个域名 domain 有效。 如果设置成 '/foo/'， cookie 仅仅对 domain 中 /foo/ 目录及其子目录有效（比如 /foo/bar/）。 默认值是设置 cookie 时的当前目录。
• domain: cookie 的有效域名/子域名。 设置成子域名（例如 'www.example.com'），会使 cookie 对这个子域名和它的三级域名有效（例如 w2.www.example.com）。 要让 cookie 对整个域名有效（包括它的全部子域名），只要设置成域名就可以了（这个例子里是 'example.com'）。

由上节我们知道，session 是存放在服务器中的，客户端与服务器的通信会话是通过 session id 识别的， 客户端 session id 是存放在 cookie 中，因此单点登录大致分为：同域名不同站点登录、同域不同子域登录、不同域名登录。

同域名不同站点登录

由 php 中的 cookie 设置说明可以看出，默认下不同站点是共享 cookie 的除非设置了不同的有效服务器路径。如果设置了不同的有效的服务器路径怎么实现共享登录呢？哈哈哈，那就将有效服务器路径设置为默认 '/' 的就好了。

同域不同子域登录

同样，由 php 中的 cookie 设置说明可以看出，只要设置 cookie 的 domain(cookie 的有效域名/子域名) 参数就可以了，如下：

由于 php 中生成 session 会自动配置 cookie，因此我们可以直接在 session 中设置 cookie 有效域

one.sso.test/create_session

<?php
session_set_cookie_params(time()+3600, '/', 'sso.test');
session_start();
$_session['test'] = 'this is test';

two.sso.test/get_session

<?php
session_set_cookie_params(time()+3600, '/', 'sso.test');
session_start();
echo $_session['test'];

其中后者是可以获取到 session 值的。下边两图分别问以上两个子域名的报文和 cookie 信息
图一：

图二：

由图可见他们的 session id 是相同的，因此调用的是服务器上的同一个 session。

注意：在 php 中，配置 session 的 cookie 信息，还可以通过修改 php.ini 文件设置

session.cookie_path = /
session.cookie_domain = '.sso.test'
session.cookie_lifetime = 0

不同域名登录

由于涉及到用户信息安全问题，因此本文通过流程图大致说一下基本liu流程，具体操作看实际应用

注意： 上图中的“返回 cookie 信息”并不是单独返回的，而是在“跳转页面”的 http 响应头（response header）返回，同样异步请求的也是在 js 调用 www.sso2.com 时在 http 响应头response header 返回。

本文到此结束，后续如果有新的理解会补充上去。