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' => 'abc@qq.com',
    '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('請求不合法');
    }
}
?>

 


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM