PHP API 接口数据加密传输与签名校验

用户现在需要一篇PHP的API加密传输和签名校验的生产检查清单,首先得从真实故障切入,比如之前遇到的抓包泄露用户数据,还有签名被绕过的问题?对,先讲背景,比如上个月我们线上支付接口被爬虫刷,就是因为没做签名,数据明文传,抓包就能拿到请求参数,还有篡改的,比如把金额10改成1,因为没校验签名。 然后接下来是检查清单的形式,分几个部分?比如传输层加密、签名机制、密钥管理、异常处理这些?对,要实用,生产环境能直接对照的。 首先背景部分,就说上周生产环境出现的故障:某电商开放平台的订单查询接口被恶意调用,原因是接口只做了HTTP Basic Auth,请求参数明文传输,攻击者抓包后不仅批量爬取用户订单数据,还篡改参数(比如把订单状态改成已完成)骗过服务端校验,最后导致用户投诉和资损。这个场景很真实,符合要求。 然后是方案部分,用检查清单的形式,分点,每个点有落地要求,比如: 一、传输层加固检查项 1. 必须强制HTTPS,禁用HTTP,校验SSL证书有效性,防止中间人攻击 2. 敏感字段(手机号、身份证、金额)单独做AES加密,不能明文出现在URL参数或请求体里 3. 请求头必须带时间戳和nonce随机串,防止重放攻击,时间戳误差超过5分钟直接拒绝 二、签名机制检查项 1. 签名算法必须用HMAC-SHA256,不能用MD5、SHA1这些不安全的 2. 签名参与的参数必须排序,排除sign字段本身,拼接规则前后端统一,比如按参数名ASCII升序,key=value&key=value,最后拼接app_secret再哈希 3. 签名必须放在请求头或者单独字段,不能放在URL参数里(防止日志泄露) 4. 服务端验签失败必须返回统一错误码,不能泄露具体是哪个参数错了 三、密钥管理检查项 1. app_secret不能硬编码在代码里,要用配置中心或者环境变量,不同环境(测试/生产)密钥不同 2. 密钥必须定期轮换,最长不超过90天,轮换期间新旧密钥同时支持,避免业务中断 3. 密钥不能明文存储在日志、数据库、代码仓库里,泄露立即作废 四、异常处理检查项 1. 验签失败、加密失败的情况必须打日志,记录请求IP、参数指纹、错误原因,方便溯源 2. 敏感字段解密失败直接拒绝请求,不能返回默认值或者报错堆栈 3. 重放攻击的请求必须封禁IP,或者加入黑名单,防止暴力破解 然后是代码示例,要可运行的,比如写一个PHP的签名生成和校验的类,还有AES加密解密的?对,用OpenSSL的,不要用mcrypt,那个废弃了。代码里要包含生成签名、验签、AES加密解密、重放校验的逻辑,要能直接跑的。 比如代码里先写个ApiSecurity类,有setParams方法,generateSign方法,verifySign方法,还有aesEncrypt、aesDecrypt,还有checkTimestampAndNonce方法,防止重放。对,还要注意参数排序,HMAC的用法,AES的加密模式用GCM或者CBC?GCM更好,有完整性校验,不过如果要兼容的话CBC也可以,但是要加IV。哦对,代码里要说明,比如AES-256-CBC,密钥是32位,IV是16位,随机生成,和密文一起传?或者IV可以固定?不,IV要随机,但是可以明文和密文一起传,因为IV不需要保密。 然后代码示例要包裹在
里,要可运行,比如:
appSecret = $appSecret;
        $this->aesKey = $aesKey;
    }

    // 生成签名
    public function generateSign(array $params): string
    {
        // 1. 过滤空值和sign字段
        $params = array_filter($params, fn($v) => $v !== '' && $v !== null);
        unset($params['sign']);
        // 2. 按参数名ASCII升序排序
        ksort($params);
        // 3. 拼接成key=value格式
        $string = '';
        foreach ($params as $k => $v) {
            $string .= $k . '=' . $v . '&';
        }
        $string = rtrim($string, '&');
        // 4. 拼接app_secret后做HMAC-SHA256
        return hash_hmac('sha256', $string, $this->appSecret);
    }

    // 校验签名
    public function verifySign(array $params, string $sign): bool
    {
        $calcSign = $this->generateSign($params);
        // 使用哈希比较防止时序攻击
        return hash_equals($calcSign, $sign);
    }

    // AES-256-CBC加密
    public function aesEncrypt(string $plainText): array
    {
        $iv = random_bytes(16);
        $cipherText = openssl_encrypt($plainText, 'AES-256-CBC', $this->aesKey, OPENSSL_RAW_DATA, $iv);
        return [
            'cipher' => base64_encode($cipherText),
            'iv' => base64_encode($iv)
        ];
    }

    // AES-256-CBC解密
    public function aesDecrypt(string $cipherText, string $ivBase64): string
    {
        $iv = base64_decode($ivBase64);
        $cipher = base64_decode($cipherText);
        $decrypted = openssl_decrypt($cipher, 'AES-256-CBC', $this->aesKey, OPENSSL_RAW_DATA, $iv);
        if ($decrypted === false) {
            throw new \RuntimeException('解密失败');
        }
        return $decrypted;
    }

    // 校验时间戳和nonce,防止重放
    public function checkTimestampAndNonce(int $timestamp, string $nonce, int $expire = 300): bool
    {
        // 时间戳误差超过5分钟直接拒绝
        if (abs(time() - $timestamp) > $expire) {
            return false;
        }
        // 这里可以用Redis存已经使用过的nonce,过期时间和时间戳一致
        $redis = new \Redis();
        $redis->connect('127.0.0.1', 6379);
        $key = 'api_n

如需更完整的 PHP 代码保护与在线加密服务,可访问 https://article.vvxyz.com 了解更多。

标签: PHP加密 PHP代码保护 PHP密码加密 代码混淆工具 代码保护策略
← 返回文章列表