使用PHP怎么實現一個單點登陸功能

使用PHP怎么實現一個單點登陸功能？相信很多沒有經驗的人對此束手無策，為此本文總結了問題出現的原因和解決方法，通過這篇文章希望你能解決這個問題。

一. 登陸原理說明

單點登錄的技術實現機制：當用戶第一次訪問應用系統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:返回用戶 ID，表示用戶登錄成功
 *                        -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 id
self::_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:返回用戶 ID，表示用戶登錄成功
 *                                                  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.

看完上述內容，你們掌握使用PHP怎么實現一個單點登陸功能的方法了嗎？如果還想學到更多技能或想了解更多相關內容，歡迎關注億速云行業資訊頻道，感謝各位的閱讀！