如何使用Spomkylabs Jose PHP库实现A128CBC-HS256解密及AAD、Tag验证？

我之前也碰到过一模一样的困扰——PHP内置的openssl_decrypt确实不支持A128CBC-HS256这种复合算法，而很多轻量JWE库又只做了解密，忽略了AAD和标签的验证。Spomkylabs的Jose库其实完全能搞定这个需求，只是官方文档对新手不够友好，我整理了一套清晰的实现步骤，你可以直接参考：

1. 先正确安装库 #

首先确保用Composer安装最新版本的库（避免版本兼容问题）：

composer require spomky-labs/jose

2. 完整的解密+验证代码示例 #

下面是针对你的需求写的代码，包含密文解密、AAD验证和标签校验的全流程：

<?php

require 'vendor/autoload.php';

use Jose\Component\Core\AlgorithmManager;
use Jose\Component\Core\JWK;
use Jose\Component\Encryption\Algorithm\ContentEncryption\A128CBCHS256;
use Jose\Component\Encryption\Algorithm\KeyEncryption\Dir;
use Jose\Component\Encryption\JWEDecrypter;
use Jose\Component\Encryption\Serializer\CompactSerializer;

// 替换成你的实际参数
$cek = 'your-content-encryption-key-here'; // 注意：A128CBC-HS256的CEK是32字节（前16字节AES密钥，后16字节HMAC密钥）
$iv = 'your-initialization-vector-here'; // IV固定16字节
$cipherText = 'your-ciphertext-here';
$aad = 'your-additional-authentication-data-here';
$tag = 'your-authentication-tag-here';

// 1. 初始化算法管理器，指定我们要用的复合加密算法
$algorithmManager = AlgorithmManager::create([
    new A128CBCHS256(),
    new Dir() // 直接使用CEK时，用Direct密钥加密算法
]);

// 2. 创建JWEDecrypter实例
$jweDecrypter = new JWEDecrypter(
    $algorithmManager,
    AlgorithmManager::create([]) // Dir算法无需额外密钥加密算法管理器
);

// 3. 将CEK转换为JWK格式（库要求的密钥格式）
$jwk = JWK::create([
    'kty' => 'oct', // 对称密钥类型
    'k' => rtrim(strtr(base64_encode($cek), '+/', '-_'), '='), // 转成URL安全的base64编码
    'alg' => 'dir',
    'enc' => 'A128CBC-HS256'
]);

// 4. 组装JWE Compact格式字符串（库默认优先处理这种格式）
$protectedHeader = json_encode([
    'alg' => 'dir',
    'enc' => 'A128CBC-HS256'
]);
$protectedHeaderBase64 = rtrim(strtr(base64_encode($protectedHeader), '+/', '-_'), '=');

$jweString = sprintf(
    '%s.%s.%s.%s.%s',
    $protectedHeaderBase64,
    '', // Dir算法下加密密钥字段为空
    rtrim(strtr(base64_encode($iv), '+/', '-_'), '='),
    rtrim(strtr(base64_encode($cipherText), '+/', '-_'), '='),
    rtrim(strtr(base64_encode($tag), '+/', '-_'), '=')
);

// 5. 加载JWE并设置AAD
$serializer = new CompactSerializer();
$jwe = $serializer->unserialize($jweString);
$jwe->setAAD($aad); // 直接设置原始AAD字符串，库会自动用于标签验证

// 6. 执行解密与验证
try {
    $jweDecrypter->decryptUsingKey($jwe, $jwk, 0); // 0为密钥索引，单密钥场景固定用0
    $plaintext = $jwe->getPayload();
    echo "解密验证成功！明文：" . $plaintext;
} catch (\Exception $e) {
    echo "验证或解密失败：" . $e->getMessage();
    // 常见错误：CEK格式错误、AAD不匹配、标签校验失败、IV长度不对
}

关键踩坑点提示 #

• CEK格式：A128CBC-HS256的CEK是32字节的复合密钥，如果你拿到的是分开的AES密钥和HMAC密钥，一定要把它们拼接成一个32字节的字符串再使用。
• Base64编码：JWE要求用URL安全的Base64（替换+为-，/为_，去掉末尾的=），不要用标准Base64。
• AAD传递：如果你的AAD已经包含在JWE的保护头里，就不需要单独调用setAAD()，库会自动从头部解析。

我之前部署时也踩过不少细节坑，比如CEK长度不对、编码格式错误，这些地方一定要仔细核对。

内容的提问来源于stack exchange，提问作者Spiral1ng