PHP做api開發離不開簽名驗證,我這樣設計

Laravel00發表於2021-12-29

文章來自:PHP自學中心
點選進入:PHP技術開發微信群


開發過程中,我們經常會與介面打交道,有的時候是調取別人網站的介面,有的時候是為他人提供自己網站的介面,但是在這調取的過程中都離不開簽名驗證。

我們在設計簽名驗證的時候,請注意要滿足以下幾點:

  • 可變性:每次的簽名必須是不一樣的。

  • 時效性:每次請求的時效,過期作廢等。

  • 唯一性:每次的簽名是唯一的。

  • 完整性:能夠對傳入資料進行驗證,防止篡改。

這裡介紹一種方式,是目前國內網際網路公司常用的一種方式,其中淘寶的支付寶支付介面、淘寶開放平臺介面、騰訊開放平臺等應用的一種方式。


一、簽名引數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('請求不合法');
    }
}
?>
本作品採用《CC 協議》,轉載必須註明作者和本文連結
溫馨提示:微信搜尋並關注   學Laravel  裡面有兩套Laravel課程:【laravel7.x 從入門到核心架構講解】 與 【Laravel高階實戰教程42集】,直接獲取就可以了,學習與交流可加入:Laravel技術交流微信群

相關文章