平博网站平博网站


平博官方网

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

<?phpsession_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

<?phpsession_set_cookie_params(time()+3600, "/", "sso.test");session_start();$_SESSION["test"] = "This is test";

two.sso.test/get_session

<?phpsession_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 返回。

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

欢迎阅读本文章: 屈文峰

平博代理

平博官方网