在做api開發時，簽名驗證怎麼設計?

心无引擎,眼无流派發表於2024-05-28
API

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

設計簽名驗證的時候，需要注意以下幾點：

1.可變性：每次的簽名必須是不一樣的。

2.時效性：每次請求的時效，過期作廢等

3.唯一性：每次的簽名是唯一的

4.完整性：能夠對傳入的資料進行驗證，防止篡改

這裡介紹一種方式：

一,簽名引數sign生成的方法

第1步：將所有引數（注意是所有引數），出去sign本身，以及值是空的引數，按照引數名字母升序排序。

第2步：然後把排序後的引數按引數1值1引數2值2.....引數n值n(這裡的引數和值必須是傳輸引數的原始值，不能是經過處理的，如不能將轉成後再拼接)的方式拼接成一個字串。

第3步：把分配給接入方的驗證秘鑰key拼接在第2步得到的字串的前面

第4步：在上一步得到的字串前面加上驗證秘鑰key，然後計算md5值，得到32位字串，然後轉成大寫。

第5步：計算第4步字串的md5值（32位），然後轉為大寫，得到的字元作為sign的值

舉例：

假設傳輸的資料是/iinterface.php?sign=sign_value&p2=v2&p1=v1$method=cancel&p3=&pn=vn(實際情況最好是透過post方式傳遞)，其中sign引數對應的sing_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); //http_build_query()
    // 生成sign
    $sign = md5($params . $secret); //md5()
    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('請求不合法');
    }
}

　　

相關文章