You need to enable JavaScript to run this app. Swift基于ECDH协商AES密钥解密Java加密报文的实现与问题排查
优惠活动
大模型
产品
解决方案
定价
更多

Swift基于ECDH协商AES密钥解密Java加密报文的实现与问题排查

问题根因与修复方案

一、共享密钥生成逻辑完全不对齐

两边生成的密钥不一致的核心原因:

  • Java端的keyAgreement.generateSecret("AES")没有任何HKDF派生步骤:它的逻辑是直接取ECDH协商完成后的原始共享密钥(P-256曲线对应32字节的椭圆曲线点X坐标值),直接构造为AES密钥返回。整个过程没有做SHA256哈希,没有HKDF流程,不涉及盐值、info参数配置。
  • 你当前iOS端的实现,是对原始ECDH共享值额外做了一步HKDF-SHA256派生(空盐、空info、32字节输出),相当于在原始共享值的基础上又做了一层变换,和Java端直接拿原始值当密钥的逻辑完全不一致,因此永远无法对齐。

修复后的iOS共享密钥生成代码

let serverPubKey = try P256.KeyAgreement.PublicKey(pemRepresentation: serverPublicKeyPEM)
let sharedSecret = try privateKey.sharedSecretFromKeyAgreement(with: serverPubKey)
// 直接读取ECDH协商的原始字节构造对称密钥,不做任何额外派生
let symmetricKey = sharedSecret.withUnsafeBytes { rawBuffer in
    SymmetricKey(data: rawBuffer.bindMemory(to: UInt8.self))
}

注意:必须确认双方使用的曲线完全一致,均为P-256(secp256r1),如果Java端配置为其他椭圆曲线(比如secp384r1),原始共享值的长度和内容都会不匹配。

二、加密模式用错,GCM逻辑和后端实现不匹配

你误以为后端采用AES/GCM/NoPadding算法,但贴出的Java实际实现用的是AES/CTR/NoPadding:

  • CTR是无认证的流加密模式,不存在GCM模式要求的16字节认证标签,输出的密文就是纯异或结果,没有额外格式封装。
  • 你当前iOS端硬用AES.GCM.SealedBox(combined:)解析payload,相当于把纯密文强行按照GCM的格式(nonce+密文+认证tag)拆分,最后必然因为认证标签校验失败抛出authenticationFailure错误。

修复后的iOS端解密代码

提前和后端确认固定的16字节IV值(即Java代码里的INITIALIZATION_VECTOR,必须和后端配置完全一致),替换原有GCM解密逻辑:

// 与后端约定的固定IV,16字节长度,大端序
guard let fixedIV = Data(hexLiteral: "后端提供的IV十六进制值") else {
    return
}
guard let payloadData = Data(base64Encoded: payload) else {
    return
}
do {
    // 使用CTR模式解密,与Java端逻辑完全对齐
    let decryptedBase64Data = try AES.CTR.open(
        payloadData,
        using: symmetricKey,
        nonce: fixedIV
    )
    // 注意后端的明文封装逻辑:原始字符串→转UTF8→Base64编码成字符串→再转UTF8字节作为加密输入
    // 因此解密后得到的是一段Base64字符串的UTF8字节,需要二次解码才能拿到最终明文
    guard let base64String = String(data: decryptedBase64Data, encoding: .utf8),
          let originalPlainData = Data(base64Encoded: base64String) else {
        throw DecodeError.invalidFormat
    }
    let finalPlainText = String(data: originalPlainData, encoding: .utf8)
} catch {
    print("解密异常:\(error)")
}

常见踩坑提醒

  • Java端CTR实现的计数器规则为大端序自增,和Apple CryptoKit的AES.CTR实现逻辑完全兼容,不需要额外做字节序转换。
  • P-256曲线的ECDH原始共享值长度为32字节,刚好对应AES-256的密钥长度,不需要做截断或者补位。
  • 如果后续后端切换为HKDF派生共享密钥,必须对齐两边所有HKDF参数:哈希算法、盐值、info、输出长度,不能单方面在某一端加派生步骤。
  • 如果解密后出现密文乱码,优先检查IV值是否和后端完全一致、两边ECDH用的公钥私钥是否为匹配的密钥对、共享密钥的字节是否两端一致(可以把各自生成的32字节密钥转成十六进制打印出来对比,定位是否是密钥不匹配的问题)。

内容的提问来源于stack exchange,提问作者Gorthez

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.28 15:06:08