PHP開發API介面簽名生成及驗證操作示例
本文例項講述了PHP開發API介面簽名生成及驗證操作。分享給大家供大家參考,具體如下:
開發過程中,我們經常會與介面打交道,有的時候是調取別人網站的介面,有的時候是為他人提供自己網站的介面,但是在這調取的過程中都離不開簽名驗證。
我們在設計簽名驗證的時候,請注意要滿足以下幾點:
- 可變性:每次的簽名必須是不一樣的。
- 時效性:每次請求的時效,過期作廢等。
- 唯一性:每次的簽名是唯一的。
- 完整性:能夠對傳入資料進行驗證,防止篡改。
一、簽名引數sign生成的方法
第1步: 將所有引數(注意是所有引數),除去sign本身,以及值是空的引數,按引數名字母升序排序。
第2步: 然後把排序後的引數按引數1值1引數2值2…引數n值n(這裡的引數和值必須是傳輸引數的原始值,不能是經過處理的,如不能將"轉成”後再拼接)的方式拼接成一個字串。
第3步: 把分配給接入方的驗證金鑰key拼接在第2步得到的字串前面。
第2步: 在上一步得到的字串前面加上驗證金鑰key(這裡的金鑰key是介面提供方分配給介面接入方的),然後計算md5值,得到32位字串,然後轉成大寫.
第4步: 計算第3步字串的md5值(32位),然後轉成大寫,得到的字串作為sign的值。
舉例:
假設傳輸的資料是/interface.php?sign=sign_value&p2=v2& p1=v1&method=cancel&p3=&pn=vn(實際情況最好是通過post方式傳送),其中sign引數對應的sign_value就是簽名的值。
第一步,拼接字串,首先去除sign引數本身,然後去除值是空的引數p3,剩下p2=v2&p1=v1&method=cancel& amp;pn=vn,然後按引數名字元升序排序,method=cancel&p1=v1&p2=v2&pn=vn.
第二步,然後做引數名和值的拼接,最後得到methodcancelp1v1p2v2pnvn
第三步,在上面拼接得到的字串前加上驗證金鑰key,我們假設是abc,得到新的字串abcmethodcancelp1v1p2v2pnvn
第四步,然後將這個字串進行md5計算,假設得到的是abcdef,然後轉為大寫,得到ABCDEF這個值即為sign簽名值。
注意,計算md5之前請確保介面與接入方的字串編碼一致,如統一使用utf-8編碼或者GBK編碼,如果編碼方式不一致則計算出來的簽名會校驗失敗。
二、簽名驗證方法:
根據前面描述的簽名引數sign生成的方法規則,計算得到引數的簽名值,和引數中通知過來的sign對應的引數值進行對比,如果是一致的,那麼就校驗通過,如果不一致,說明引數被修改過。
三、下面直接看程式碼
<?php // 設定一個公鑰(key)和私鑰(secret),公鑰用於區分使用者,私鑰加密資料,不能公開 $key = "c4ca4238a0b923820dcc509a6f75849b"; $secret = "28c8edde3d61a0411511d3b1866f0636"; // 待發送的資料包 $data = array( 'username' => '[email protected]','sex' => '1','age' => '16','addr' => 'guangzhou','key' => $key,'timestamp' => time(),); // 獲取sign function getSign($secret,$data) { // 對陣列的值按key排序 ksort($data); // 生成url的形式 $params = http_build_query($data); // 生成sign $sign = md5($params . $secret); return $sign; } // 傳送的資料加上sign $data['sign'] = getSign($secret,$data); /** * 後臺驗證sign是否合法 * @param [type] $secret [description] * @param [type] $data [description] * @return [type] [description] */ function verifySign($secret,$data) { // 驗證引數中是否有簽名 if (!isset($data['sign']) || !$data['sign']) { echo '傳送的資料簽名不存在'; die(); } if (!isset($data['timestamp']) || !$data['timestamp']) { echo '傳送的資料引數不合法'; die(); } // 驗證請求, 10分鐘失效 if (time() - $data['timestamp'] > 600) { echo '驗證失效, 請重新發送請求'; die(); } $sign = $data['sign']; unset($data['sign']); ksort($data); $params = http_build_query($data); // $secret是通過key在api的資料庫中查詢得到 $sign2 = md5($params . $secret); if ($sign == $sign2) { die('驗證通過'); } else { die('請求不合法'); } } ?>
更多關於PHP相關內容感興趣的讀者可檢視本站專題:《php程式設計安全教程》、《php安全過濾技巧總結》、《PHP基本語法入門教程》、《php面向物件程式設計入門教程》、《php字串(string)用法總結》、《php+mysql資料庫操作入門教程》及《php常見資料庫操作技巧彙總》
希望本文所述對大家PHP程式設計有所幫助。