调用第三方系统的签名设计与校验实例讲解与实践

news2024/11/25 1:38:44

在现代软件开发中，调用第三方系统API已经成为常见需求。为了保证数据传输的安全性和完整性，许多API采用了签名机制。本文将详细讲解如何设计与校验调用第三方系统的签名，以确保双方通信的安全和可靠。

#### 一、签名机制的意义

签名机制主要有以下几个目的：

1. **身份验证**：确认请求确实来自受信任的客户端。
2. **数据完整性**：防止数据在传输过程中被篡改。
3. **防重放攻击**：防止网络上的重放攻击。

#### 二、基本概念

在讲解具体实现之前，我们先了解几个基本概念：

- **签名（Signature）**：由请求参数通过某种算法生成的字符串，用于验证请求的合法性。
- **密钥（Secret Key）**：用于生成和校验签名的秘钥，通常只有客户端和服务端知道。
- **时间戳（Timestamp）**：用于防止重放攻击，标记请求的发送时间。

#### 三、生成签名的流程

1. **收集请求参数**：将所有请求参数按照一定规则进行排序（通常是按字母顺序）。
2. **拼接参数字符串**：将排序后的请求参数拼接成一个字符串。
3. **附加密钥**：在参数字符串后附加上密钥。
4. **生成签名**：对拼接后的字符串进行哈希运算（如MD5、SHA256）生成签名。

以下是一个PHP示例，演示如何生成签名：


function generateSignature($params, $secretKey) {
    // 按照键名升序排序参数
    ksort($params);
    
    // 将参数拼接成字符串
    $stringToSign = '';
    foreach ($params as $key => $value) {
        $stringToSign .= $key . '=' . $value . '&';
    }
    
    // 去掉最后一个&
    $stringToSign = rtrim($stringToSign, '&');
    
    // 在字符串后附上密钥
    $stringToSign .= $secretKey;
    
    // 生成签名
    $signature = hash('sha256', $stringToSign);
    
    return $signature;
}

// 示例调用
$params = [
    'param1' => 'value1',
    'param2' => 'value2',
    'timestamp' => time()
];

$secretKey = 'your_secret_key';
$signature = generateSignature($params, $secretKey);

echo "生成的签名: " . $signature . "\n";

#### 四、校验签名的流程

1. **接收请求**：服务端接收到客户端的请求，包括请求参数和签名。
2. **生成签名**：服务端使用相同的算法和密钥对请求参数生成签名。
3. **比较签名**：将生成的签名与请求中的签名进行比较，如果一致，则验证通过。

以下是一个PHP示例，演示如何校验签名：


function verifySignature($params, $receivedSignature, $secretKey) {
    // 从参数中移除签名
    unset($params['signature']);
    
    // 生成签名
    $generatedSignature = generateSignature($params, $secretKey);
    
    // 比较签名
    return $generatedSignature === $receivedSignature;
}

// 示例调用
$receivedSignature = $_GET['signature'];
$isValid = verifySignature($_GET, $receivedSignature, $secretKey);

if ($isValid) {
    echo "签名验证通过\n";
} else {
    echo "签名验证失败\n";
}

#### 五、防止重放攻击

为了防止重放攻击，我们通常会在请求中加入时间戳，并对其进行合理的校验。例如：

1. **检查时间戳是否在有效范围内**：如5分钟以内。
2. **记录已处理的请求**：存储近期处理过的请求ID，防止相同请求重复处理。


function isValidTimestamp($timestamp, $allowedTimeWindow = 300) {
    $currentTime = time();
    return abs($currentTime - $timestamp) <= $allowedTimeWindow;
}

// 示例调用
$timestamp = $_GET['timestamp'];
if (!isValidTimestamp($timestamp)) {
    echo "请求已过期\n";
    exit;
}

最后封装成独立请求的服务SDK