PHP版單點登陸實現方案

本篇文章主要介紹了PHP版單點登陸實現方案的執行個體，具有一定的參考價值，有需要的可以瞭解一下。

摘要：

本文主要介紹了利用webservice,session,cookie技術，來進行通用的單點登入系統的分析與設計。具體實現語言為PHP。單點 登入，英文名為Single Sign On，簡稱為 SSO，是目前企業，網路業務的使用者綜合處理的重要組成部分。而SSO的定義，是在多個應用系統中，使用者只需要登陸一次就可以訪問所有相互信任的應用系 統。

動機：

用過ucenter的全站登入方式的朋友，應該都知道這是典型的觀察者模式的解決方案。使用者中心作為subject, 其所屬observer的註冊和刪除統一在ucenter的後台進行。而各個子應用網站都對應一個observer。每次使用者中心的登入動作，都會觸發 js指令碼回調w3c標準的子站登入介面(api/uc.php)。

這種方式的缺點，本人認為主要是兩點：1. 子網站過多時，回調介面相應增多，這個在分布子站的量的限制上，如何控制來使登入效率不會太低，不好把握; 2. 當某個子站回調介面出現問題時，預設的登入過程會卡住(可以限制登入程式的執行時間，但相應出現問題子站後面的子站的回調介面就調不到了。

基於以上問題，在實際開發過程中，本人設計了另一套單點登入系統。

一. 登陸原理說明

單點登入的技術實現機制：當使用者第一次訪問應用系統1的時候，因為還沒有登入，會被引導到認證系統中進行登入;根據使用者提供的登入資訊，認證系統進行身份效驗，如果通過效驗，應該返回給使用者一個認證的憑據--ticket;使用者再訪問別的應用的時候，就會將這個ticket帶上，作為自己認證的憑據，應用系統接受到請求之後會把ticket送到認證系統進行效驗，檢查ticket的合法性。如果通過效驗，使用者就可以在不用再次登入的情況下訪問應用系統2和應用系統3了。

可以看出，要實現SSO，需要以下主要的功能：

a) 所有應用系統共用一個身份認證系統;

b) 所有應用系統能夠識別和提取ticket資訊;

c) 應用系統能夠識別已經登入過的使用者，能自動判斷目前使用者是否登入過，從而完成單點登入的功能

基於以上基本原則，本人用php語言設計了一套單點登入系統的程式，目前已投入正式產生伺服器運行。本系統程式，將ticket資訊以全系統唯一的 session id作為媒介，從而擷取當前線上使用者的全站資訊(登陸狀態資訊及其他需要處理的使用者全站資訊)。

二. 過程說明：

登陸流程:

1. 第一次登陸某個站：

a) 使用者輸入使用者名稱+密碼,向使用者驗證中心發送登入請求

b) 當前登入網站，通過webservice請求,使用者驗證中心驗證使用者名稱，密碼的合法性。如果驗證通過，則產生ticket，用於標識當前會話的使用者，並將當前登陸子站的網站標識符記錄到使用者中心，最後

c) 將擷取的使用者資料和ticket返回給子站。如果驗證不通過，則返回相應的錯誤狀態代碼。

d) 根據上一步的webservice請求返回的結果，當前子站對使用者進行登陸處理：如狀態代碼表示成功的話，則當前網站通過本站cookie儲存ticket，並本站記錄使用者的登入狀態。狀態代碼表示失敗的話，則給使用者相應的登入失敗提示。

2. 登陸狀態下，使用者轉到另一子：

a) 通過本站cookie或session驗證使用者的登入狀態：如驗證通過，進入正常本站處理常式;否則戶中心驗證使用者的登入狀態(發送ticket到使用者驗證中心)，如驗證通過，則對返回的使用者資訊進行本地的登入處理，否則表明使用者未登入。

登出流程

a) 當前登出站清除使用者本站的登入狀態 和 本地儲存的使用者全站唯一的隨機id

b) 通過webservice介面，清除全站記錄的全站唯一的隨機id。webservice介面會返回，登出其他已登入子站的javascript代碼，本站輸出此代碼。

c) js代碼訪問相應站W3C標準的登出指令碼

三. 代碼說明：

本文所涉及到相關代碼，已打包上傳，如有興趣，可在本文最後下載連結處點擊下載。

1. 登陸流程：

使用者從開啟瀏覽器開始，第一個登陸的子網站，必須調用UClientSSO::loginSSO()方法。該方法返回全站唯一的隨機id用於標識該使用者。該隨機id在UClientSSO::loginSSO()中已通過本站cookie儲存，即該子網站保留了使用者已登陸標識的存根於本站。

a) UClientSSO::loginSSO()方法如下：

 <?php/** * 使用者驗證中心 登陸使用者處理 * * @param string $username   - 使用者名稱 * @param string $password   - 使用者原始密碼 * @param boolean $remember   - 是否永久記住登陸帳號 * @param boolean $alreadyEnc  - 傳入的密碼是否已經經過simpleEncPass加密過 * * @return array  - integer $return['status'] 大於 0:返回使用者識別碼，表示使用者登入成功 *                        -1:使用者不存在，或者被刪除 *                        -2:密碼錯 *                                                 -11：驗證碼錯誤 *                     string $return['username']   : 使用者名稱 *                     string $return['password']   : 密碼 *                     string $return['email']    : Email */static public function loginSSO($username, $password, $remember=false, $alreadyEnc=false) {self::_init();self::_removeLocalSid();$ret = array();////1. 處理傳入webservice介面的參數//$_params = array(        'username' => $username,        'password' => $alreadyEnc ? trim($password) : self::simpleEncPass(trim($password)),        'ip'    => self::onlineip(),        'siteFlag' => self::$site,        'remember' => $remember);$_params['checksum'] = self::_getCheckSum($_params['username'] . $_params['password'] .$_params['ip'] . $_params['siteFlag'] . $_params['remember']);//// 2.調用webservice介面，進行登陸處理//$aRet = self::_callSoap('loginUCenter', $_params);if (intval($aRet['resultFlag']) > 0 && $aRet['sessID']) {//成功登陸//設定本地session idself::_setLocalSid($aRet['sessID']);//設定使用者中心的統一session id指令碼路徑self::$_synloginScript = urldecode($aRet['script']);$ret = $aRet['userinfo'];} else {$ret['status'] = $aRet['resultFlag'];}return $ret;}//end of function         //b) 使用者驗證中心的webservice服務程式，接收到登陸驗證請求後，調用UCenter::loginUCenter()方法來處理登陸請求。/*** 使用者驗證中心 登陸使用者處理** @param string $username* @param string $password* @param string $ip* @param string $checksum* @return array*/static public function loginUCenter($username, $password, $ip, $siteFlag, $remember=false) {self::_init();session_start();$ret = array();$arr_login_res   = login_user($username, $password, $ip);$res_login     = $arr_login_res['status'];        //$ret['resultFlag'] = $res_login;if ($res_login < 1) {//登陸失敗} else {//登陸成功$_SESSION[self::$_ucSessKey] = $arr_login_res;$_SESSION[self::$_ucSessKey]['salt'] =self::_getUserPassSalt($_SESSION[self::$_ucSessKey]['username'], $_SESSION[self::$_ucSessKey]['password']);$ret['userinfo'] = $_SESSION[self::$_ucSessKey];$ret['sessID']  = session_id();    //產生全站的唯一session id，作為ticket全站通行////合作中心站回調登陸介面(設定使用者中心的統一session id)//self::_createCoSitesInfo();$uinfo = array();$_timestamp = time();$_rawCode = array(            'action' => 'setSid',            'sid'  => $ret['sessID'],            'time'  => $_timestamp,);if ($remember) {$uinfo = array(                'remember' => 1,                'username' => $username,                'password' => $password);}$ret['script'] = '';$_rawStr = http_build_query(array_merge($_rawCode, $uinfo));//// 合作網站的全域cookie設定指令碼地址//foreach ((array)self::$_coSitesInfo as $_siteInfo) {$_code = self::authcode($_rawStr, 'ENCODE', $_siteInfo['key']);$_src = $_siteInfo['url'] . '?code=' . $_code . '&time=' . $_timestamp;$ret['script'] .= urlencode('');}//// 記住已登陸戰//self::registerLoggedSite($siteFlag, $ret['sessID']);unset($ret['userinfo']['salt']);}return $ret;}?>

2. 本站登陸成功後，進行本地化的使用者登陸處理，其後驗證使用者是否登陸只在本地驗證。（本地存取登陸使用者狀態的資訊，請設定為關閉瀏覽器就退出）

3. 當檢測使用者登陸狀態時，請先調用本地的驗證處理，若本地驗證不通過，再調用UClientSSO::checkUserLogin()方法到使用者中心檢測使用者的登陸狀態。

a) UClientSSO::checkUserLogin()方法如下：

 <?php /** * 使用者單點登陸驗證函式 * * @return array  - integer $return['status'] 大於 0:返回使用者識別碼，表示使用者登入成功 *                                                  0:使用者沒有在全站登陸 *                        -1:使用者不存在，或者被刪除 *                        -2:密碼錯 *                        -3:未進行過單點登陸處理 *                                                 -11：驗證碼錯誤 *                     string $return['username']   : 使用者名稱 *                     string $return['password']   : 密碼 *                     string $return['email']    : Email */ public static function checkUserLogin(){ self::_init(); $ret = array(); $_sessId = self::_getLocalSid(); if (empty($_sessId)) { //永久記住帳號處理 if(isset($_COOKIE[_UC_USER_COOKIE_NAME]) && !empty($_COOKIE[_UC_USER_COOKIE_NAME])) {  // // 根據cookie裡的使用者名稱和密碼判斷使用者是否已經登陸。 // $_userinfo = explode('|g|', self::authcode($_COOKIE[_UC_USER_COOKIE_NAME], 'DECODE', self::$_authcodeKey));  $username = $_userinfo[0]; $password = isset($_userinfo[1]) ? $_userinfo[1] : ''; if (empty($password)) { $ret['status'] = -3; } else { return self::loginSSO($username, $password, true, true); }  } else { $ret['status'] = -3; }  } else { // //本站原先已經登陸過，通過保留的sesson id存根去使用者中心驗證 // $_params = array(             'sessId'  => $_sessId,             'siteFlag' => self::$site,             'checksum' => md5($_sessId . self::$site . self::$_mcComunicationKey) ); $aRet = self::_callSoap('getOnlineUser', $_params); if (intval($aRet['resultFlag']) > 0) { //成功登陸 $ret = $aRet['userinfo']; } else { $ret['status'] = $aRet['resultFlag']; } }  return $ret; }         b) 使用者驗證中心的webservice服務程式，接收到檢驗登陸的請求後，調用UCenter::getOnlineUser()方法來處理登陸請求： [php]/** * 根據sid，擷取當前登陸的使用者資訊 * * @param string $sessId    - 全站唯一session id，用做ticket * @return array */ /** * 根據sid，擷取當前登陸的使用者資訊 * * @param string $sessId    - 全站唯一session id，用做ticket * @return array */ static public function getOnlineUser($sessId, $siteFlag) { self::_init(); session_id(trim($sessId)); session_start();  $ret = array(); $_userinfo = $_SESSION[self::$_ucSessKey];  if (isset($_userinfo['username']) && isset($_userinfo['password']) && self::_getUserPassSalt($_userinfo['username'], $_userinfo['password'])) { $ret['resultFlag'] = "1"; $ret['userinfo'] = $_userinfo;  self::registerLoggedSite($siteFlag, $sessId);        //記住已登陸戰 unset($ret['userinfo']['salt']); } else { $ret['resultFlag'] = "0"; }  return ($ret); } ?>

4. 單點登出時，調用UClientSSO::logoutSSO()方法。調用成功後，如需其他已登陸站立即登出，請調用 UClientSSO::getSynloginScript()方法擷取W3C標準的script，在頁面輸出。

a) UClientSSO::logoutSSO()方法如下：

<?php/*** 全站單點登出* - 通過webservice請求登出掉使用者的全站唯一標識** @return integer  1: 成功*                   -11：驗證碼錯誤*/public static function logoutSSO(){    self::_init();    $_sessId = self::_getLocalSid();    //    //本站沒有登陸的話，不讓同步登出其他站    //    if (empty($_sessId)) {        self::_initSess(true);        return false;    }    $_params = array(        'sessId'  => $_sessId,        'siteFlag' => self::$site,        'checksum' => md5($_sessId . self::$site . self::$_mcComunicationKey)    );    $aRet = self::_callSoap('logoutUCenter', $_params);    if (intval($aRet['resultFlag']) > 0) {        //成功登出        self::_removeLocalSid();        //移除本站記錄的sid存根        self::$_synlogoutScript = urldecode($aRet['script']);        $ret = 1;    } else {        $ret = $aRet['resultFlag'];    }    return intval($ret);}          [/php]    b) 使用者驗證中心的webservice服務程式，接收到全站登出請求後，調用UCenter::loginUCenter()方法來處理登陸請求：/*** 登出全站處理** @param string - 全站唯一session id，用做ticket* @return boolean*/static public function logoutUCenter($sessId) {    self::_init();    session_id(trim($sessId));    session_start();    $_SESSION = array();    return empty($_SESSION) ? true : false;}?>

四. 代碼部署：

1. 使用者驗證中心設定

a) 使用者驗證中心向分站提供的webservice服務介面檔案，即UserSvc.php部署在hostname/webapps/port/ UserSvc.php中。查看wsdl內容，請訪問https://hostname/port/ UserSvc.php?wsdl

b) 使用者中心使用者單點服務類檔案為UCenterSSO.class.php，檔案路徑為在hostname/webapps/include /UCenterSSO.class.php。該檔案為使用者單點登陸處理 的服務端類，被hostname/webapps/port/ UserSvc.php調用。用於擷取使用者的登陸資訊，是否單點登陸的狀態資訊，單點登出處理等。

c) 使用者驗證中心通過W3C標準，利用cookie方式記錄，刪除全站統一的使用者唯一隨機id 的指令檔為hostname/webapps/port/cookie_mgr.php.

2. 子網站設定

a) 各子網站請將，UClientSSO.class.php部署在使用者中心服務用戶端目錄下。部署好後，請修改最後一行的UClientSSO::setSite('1'); 參數值為使用者驗證中心統一分配給各站的標識id.

b) 在部署的使用者中心服務用戶端包下的api目錄下下，請將logout_sso.php指令碼轉移到此處，並編寫進行本站登出的處理指令碼。

c) 在子網站驗證使用者登陸狀態的代碼部分，額外增加到使用者中心的單點登陸驗證的處理。

即在首先通過本站驗證使用者的登陸狀態，如果未通過驗證，則去使用者中心驗證。驗證操作要調用UClientSSO::checkUserLogin();介面，介面含義請查看代碼注釋。

d) 在分站的登出處理指令碼中，通過UClientSSO::getSynlogoutScript();擷取script串輸出即可。

五. 擴充功能:

1. 記錄跟蹤所有線上使用者

因為所有使用者的登入都要經過使用者驗證中心，所有使用者的ticket都在驗證中心產生，可以將使用者和該ticket(session id)在記憶體表中建立一個映射表。得到所有線上使用者的記錄表。

後期如有必要跟蹤使用者狀態來實現其他功能，只要跟蹤這個映射表就可以了。其他功能可以為: 擷取線上使用者列表，判斷使用者線上狀態，擷取線上使用者人數等。

2. 特殊統計處理

因為整個系統登入登出要經過使用者驗證中心，所以可以針對使用者的特殊統計進行處理。如使用者每天的登入次數，登陸時間，登陸狀態失效時間，各時段的線上使用者人數走勢等。

六. 其他事項：

1. 本站登陸狀態有效時間問題：

全站要求使用者登陸狀態在關閉瀏覽器時就失效。要求各分站對session或cookie的處理方式按照如下進行：

a) Session方式記錄使用者登陸狀態的網站

請在網站通用指令碼開始處，添加一下代碼

 <?php session_write_close(); ini_set('session.auto_start', 0);          //關閉session自動啟動 ini_set('session.cookie_lifetime', 0);      //設定session在瀏覽器關閉時失效 ini_set('session.gc_maxlifetime', 3600); //session在瀏覽器未關閉時的持續存活時間    ?>

b) cookie方式記錄使用者登陸狀態的網站

請在設定使用者登陸狀態的cookie時，設定cookie有效時間為null.

原文連結：http://www.cnblogs.com/linzhenjie/archive/2012/08/24/2653585.html

以上就是本文的全部內容，希望對大家的學習有所協助。