1. 程式人生 > 程式設計 >PHP開發API介面簽名生成及驗證操作示例

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程式設計有所幫助。