PHP原生函数手动解析苹果支付V2 JWS令牌步骤

纸上星河
纸上星河
发布时间:2026-11-18| 5人浏览过
原创

详细介绍如何在不依赖第三方JWT库的情况下,使用PHP原生函数和OpenSSL扩展手动完成苹果支付V2格式JWS令牌的结构拆解、Base64URL解码、证书链提取、公钥提取及签名校验的完整步骤。

在接入苹果 App Store Server Notifications V2 及 App Store Server API 时,苹果下发的所有核心通知、交易凭证(signedTransactionInfo)和续订凭证(signedRenewalInfo)均封装为符合 RFC 7515 规范的 JWS(JSON Web Signature)紧凑序列化字符串。本文介绍仅使用 PHP 原生函数与标配的 OpenSSL 扩展,手动完成 JWS 拆解、Base64URL 解码、X.509 证书链提取、签名有效性验证以及数据载荷解析的全过程。

PHP原生函数手动解析苹果支付V2 JWS令牌步骤

图 1:苹果支付 V2 JWS 令牌的三段式结构与数据关系

准备工作:标准环境与基础工具函数

手动解析要求 PHP 环境启用 openssl 扩展。标准的 JWS 由“头部(Header)”、“载荷(Payload)”和“签名(Signature)”三部分以英文句点 . 拼接而成,编码方式为 RFC 7515 规定的 Base64URL(将标准 Base64 的 + 替换为 -,/ 替换为 _,且省略末尾用于对齐的 = 字符)。

PHP 自带的 base64_decode 无法直接处理 Base64URL 字符集,因此首先实现两个核心辅助函数:Base64URL 解码函数,以及将原始 ECDSA 签名转换为 OpenSSL 识别的 DER 格式函数。

/**
 * Base64URL 安全解码
 */
function base64UrlDecode(string $input): string|false
{
    $remainder = strlen($input) % 4;
    if ($remainder) {
        $padlen = 4 - $remainder;
        $input .= str_repeat('=', $padlen);
    }
    return base64_decode(strtr($input, '-_', '+/'), true);
}

在 JWS 标准中,ES256 算法生成的签名是 64 字节的定长二进制数据(前 32 字节为 $R$ 值,后 32 字节为 $S$ 值)。而 PHP 的 openssl_verify 函数处理 ECDSA 验签时,要求输入符合 ASN.1 DER 编码格式。因此必须手动构建包含 Sequence 与两个 Integer 的 DER 结构包装。

/**
 * 将 ES256 原始 R||S 签名(64字节)转换为 ASN.1 DER 编码
 */
function rawSignatureToDer(string $rawSignature): string
{
    if (strlen($rawSignature) !== 64) {
        throw new InvalidArgumentException("ES256 原始签名必须严格为 64 字节");
    }

    $r = substr($rawSignature, 0, 32);
    $s = substr($rawSignature, 32, 32);

    $encodeInteger = function (string $value): string {
        // 去除左侧冗余 0x00,但若最高位为 1,则保留一个 0x00 防止被判定为负数
        $val = ltrim($value, "\x00");
        if ($val === '') {
            $val = "\x00";
        }
        if (ord($val[0]) & 0x80) {
            $val = "\x00" . $val;
        }
        return "\x02" . chr(strlen($val)) . $val;
    };

    $derR = $encodeInteger($r);
    $derS = $encodeInteger($s);

    $sequence = $derR . $derS;
    return "\x30" . chr(strlen($sequence)) . $sequence;
}

步骤一:拆解 JWS 字符串并提取各段内容

使用 explode('.', $jwsString) 将传入的令牌分割。严格按照规范,分割出的数组元素数量必须刚好为 3。

PHP原生函数手动解析苹果支付V2 JWS令牌步骤

图 2:从 JWS 字符串到完整验证业务载荷的执行步骤

对第一段和第二段分别执行 Base64URL 解码与 JSON 解析,能够获得头部数组和载荷数组:

$token = "eyJhbGciOiJFUzI1NiIsLng1YyI6WyJNSUl...省略...“;

$parts = explode('.', $token);
if (count($parts) !== 3) {
    throw new Exception("JWS 结构无效:段数不等于 3");
}

[$headerB64, $payloadB64, $signatureB64] = $parts;

$headerJson = base64UrlDecode($headerB64);
$payloadJson = base64UrlDecode($payloadB64);
$rawSignature = base64UrlDecode($signatureB64);

$header = json_decode($headerJson, true);
$payload = json_decode($payloadJson, true);

if (!$header || !$payload) {
    throw new Exception("头部或载荷非有效 JSON");
}

步骤二:从头部提取 X.509 证书链与公钥

苹果在 JWS 的 header 中通过 x5c 声明证书链。x5c 是一个包含 DER 编码证书的字符串数组(按照 Base64 编码):

  • x5c[0](叶子证书):直接用于签署当前 JWS 的证书,公钥位于此证书中。
  • x5c[1](中间证书):Apple Worldwide Developer Relations Certification Authority 证书。
  • x5c[2](根证书):Apple Root CA - G3 证书。

为了使用 PHP 的 OpenSSL 函数读取,需要将 Base64 字符串包装为标配的 PEM 文本格式(添加 -----BEGIN CERTIFICATE----- 和 -----END CERTIFICATE----- 标记,并在每 64 个字符处换行)。

PHP原生函数手动解析苹果支付V2 JWS令牌步骤

图 3:x5c 证书链校验与公钥提取机制

下面是将 x5c 数组还原为 PEM 并提取叶证书公钥的代码:

function der2pem(string $derBase64): string
{
    return "-----BEGIN CERTIFICATE-----\n" .
           chunk_split($derBase64, 64, "\n") .
           "-----END CERTIFICATE-----\n";
}

if (!isset($header['x5c']) || !is_array($header['x5c']) || count($header['x5c']) < 2) {
    throw new Exception("头部缺少有效的 x5c 证书链");
}

$leafCertPem = der2pem($header['x5c'][0]);
$intermediateCertPem = der2pem($header['x5c'][1]);

// 从叶子证书中读取公钥
$publicKey = openssl_pkey_get_public($leafCertPem);
if ($publicKey === false) {
    throw new Exception("无法从叶子证书提取公钥:" . openssl_error_string());
}

步骤三:校验证书链信任关系

只提取公钥是不够的。任何中间人都可以自建一对密钥和虚假证书来对篡改后的数据签名。因此必须确认 x5c[0] 确实是由 Apple 官方签发。

验证包括两层工作:一是使用本地保存的官方 Apple Root CA - G3 根证书校验证书链;二是检查证书链各节点未过期且有效。

// 建议预先从 Apple 官网下载 AppleRootCA-G3.cer 并转换为 PEM 保存在本地服务器
$appleRootG3Pem = file_get_contents('/path/to/AppleRootCA-G3.pem');

// 校验中间证书是否由根证书签发且在有效期内
$intermediateCheck = openssl_x509_checkpurpose(
    $intermediateCertPem,
    X509_PURPOSE_ANY,
    [$appleRootG3Pem]
);
if ($intermediateCheck !== true) {
    throw new Exception("中间证书未能通过 Apple 根证书校验");
}

// 校验叶子证书是否由中间证书签发
$leafCheck = openssl_x509_checkpurpose(
    $leafCertPem,
    X509_PURPOSE_ANY,
    [$intermediateCertPem]
);
if ($leafCheck !== true) {
    throw new Exception("叶子证书未能通过中间证书校验");
}

步骤四:使用 OpenSSL 进行签名校验

JWS 签名的原始输入数据由 headerB64 . '.' . $payloadB64 构成。苹果采用 ES256(ECDSA using P-256 and SHA-256)算法。

调用 openssl_verify 时,将签名原文字符串、转换为 DER 格式的签名数据、叶证书提取的公钥以及哈希算法 OPENSSL_ALGO_SHA256 传入:

$dataToVerify = $headerB64 . '.' . $payloadB64;
$derSignature = rawSignatureToDer($rawSignature);

$verifyResult = openssl_verify(
    $dataToVerify,
    $derSignature,
    $publicKey,
    OPENSSL_ALGO_SHA256
);

if ($verifyResult !== 1) {
    throw new Exception("JWS 签名无效,数据可能已被篡改");
}

// 验签通过,业务载荷确认有效
// $payload 中包含真实可信的通知或订单信息

步骤五:递归处理嵌套 JWS

在苹果支付 V2 的通知模型中,顶层通知载荷包含了外层信息(如 notificationType、subtype),而具体的交易明细位于 data.signedTransactionInfo 字段中,该字段本身仍然是一个符合相同规范的独立 JWS 字符串。如果属于订阅变更,data.signedRenewalInfo 也是一个 JWS 字符串。

针对嵌套的 JWS,必须使用完全相同的流程对 signedTransactionInfo 再次进行完整的拆解、验签和解码,才能拿到最终包含 transactionId、productId、expiresDate 等核心字段的真实 JSON 对象。

完整处理函数示例

将上述所有步骤串联为一个完整的、可直接引入业务的 PHP 原生处理函数:

function parseAndVerifyAppleJws(string $jwsToken, string $rootCertPath): array
{
    $parts = explode('.', $jwsToken);
    if (count($parts) !== 3) {
        throw new InvalidArgumentException("非法的 JWS 结构");
    }

    [$headerB64, $payloadB64, $sigB64] = $parts;

    $headerJson = base64UrlDecode($headerB64);
    $payloadJson = base64UrlDecode($payloadB64);
    $rawSig = base64UrlDecode($sigB64);

    if (!$headerJson || !$payloadJson || !$rawSig) {
        throw new RuntimeException("Base64URL 解码失败");
    }

    $header = json_decode($headerJson, true);
    $payload = json_decode($payloadJson, true);

    if ($header['alg'] !== 'ES256' || empty($header['x5c'])) {
        throw new RuntimeException("不支持的算法或缺少证书链");
    }

    $leafPem = der2pem($header['x5c'][0]);
    $interPem = der2pem($header['x5c'][1]);
    $rootPem = file_get_contents($rootCertPath);

    // 1. 校验证书链
    if (openssl_x509_checkpurpose($interPem, X509_PURPOSE_ANY, [$rootPem]) !== true) {
        throw new RuntimeException("中间证书校验失败");
    }
    if (openssl_x509_checkpurpose($leafPem, X509_PURPOSE_ANY, [$interPem]) !== true) {
        throw new RuntimeException("叶子证书校验失败");
    }

    // 2. 转换签名格式
    $derSig = rawSignatureToDer($rawSig);

    // 3. 提取公钥并验签
    $pubKey = openssl_pkey_get_public($leafPem);
    $dataToVerify = $headerB64 . '.' . $payloadB64;
    $res = openssl_verify($dataToVerify, $derSig, $pubKey, OPENSSL_ALGO_SHA256);

    if ($res !== 1) {
        throw new RuntimeException("JWS 验签失败");
    }

    // 4. 若载荷内部包含嵌套的 signedTransactionInfo,递归解析
    if (isset($payload['data']['signedTransactionInfo'])) {
        $payload['data']['parsedTransactionInfo'] = parseAndVerifyAppleJws(
            $payload['data']['signedTransactionInfo'],
            $rootCertPath
        );
    }
    if (isset($payload['data']['signedRenewalInfo'])) {
        $payload['data']['parsedRenewalInfo'] = parseAndVerifyAppleJws(
            $payload['data']['signedRenewalInfo'],
            $rootCertPath
        );
    }

    return $payload;
}
生产环境注意事项:
  1. 缓存证书链校验结果:苹果同一个通知包内的多个 JWS(主通知与内部的 signedTransactionInfo)通常使用相同的叶证书。对证书链逐级做 openssl_x509_checkpurpose 会消耗一定的 I/O 与 CPU,可在短时间内基于证书指纹(SHA-256)做内存级白名单缓存,但验签(openssl_verify)必须每次都对具体的载荷原文严格执行。
  2. 时钟校验:验证通过后,读取载荷内容时需核对 signedDate 或业务时间戳,避免网络抖动导致接收到重放的历史通知。

总结与整体流程回顾

使用 PHP 原生函数处理苹果支付 V2 JWS 令牌,核心在于克服两处格式差异:一是处理 Base64URL 字符替换与末尾补齐,二是将 JWS 的 64 字节 raw ECDSA 签名重构为 OpenSSL 要求的 ASN.1 DER 编码格式。在理清这两个关键点后,完全可以在不加载任何第三方 Composer 依赖的前提下,实现安全、高效、轻量的通知与订单验签逻辑。

PHP原生函数手动解析苹果支付V2 JWS令牌步骤

图 4:全流程数据流转与阶段控制总结

相关专题:

免责声明:本文内容仅供参考,不代表本站观点。转载或引用请注明出处。

Python 相关产品和应用

全部下载
Selenium

Selenium

4.51.0 · Windows

用于浏览器自动化和 Web 测试的 Python 工具。

scikit-learn

scikit-learn

1.9.1 · Windows

常用 Python 机器学习算法与模型评估工具库。

Black

Black

26.10.1 · Windows

强调一致性的 Python 自动代码格式化工具。

Ruff

Ruff

0.17.1 · macOS

由 Rust 编写的高速 Python 代码检查和格式化工具。

pytest

pytest

9.1.1 · Windows

简洁而强大的 Python 自动化测试框架。

FastAPI

FastAPI

0.146.0 · Windows

高性能 Python API 框架,支持类型提示和自动接口文档。

Flask

Flask

3.1.3 · Windows

轻量灵活的 Python Web 应用框架。

Django

Django

6.1.2 · Windows

成熟的 Python Web 框架,适合构建内容站点和业务系统。

Spyder

Spyder

6.1.7 · Windows

面向科学计算与数据分析的 Python 集成开发环境。

SciPy

SciPy

1.18.1 · Windows

面向科学、工程和技术计算的 Python 算法库。