登录
推荐 文章 Go 技术 课程 下载 专题 AI
首页 >  文章 >  java教程

Java Key Encapsulation Mechanism API 怎样封装共享密钥

来源:17golang原创

时间:2026-11-20 12:00:12 127浏览 收藏

Java 的 Key Encapsulation Mechanism(KEM)API 解决的是“怎样让双方得到同一份共享秘密”,不是把整段业务数据直接加密。发送方拿接收方的公钥创建 KEM.Encapsulator,调用 encapsulate() 后得到自己的 SecretKey 和一段可传给接收方的封装消息;接收方用私钥创建 KEM.Decapsulator,再用这段消息恢复共享密钥。

官方资料:https://docs.oracle.com/en/java/javase/21/docs/api/java.base/javax/crypto/KEM.html

下面的代码只展示标准 API 的调用边界。KEM.getInstance() 的算法名必须由实际安全 Provider 提供,不能把示例里的占位名当成某个 JDK 内置算法。

先分清 KEM 两端各自保存什么

接收方先生成密钥对:公钥可以发布给发送方,私钥只能留在接收方。发送方不需要接触私钥,只使用公钥创建封装器。封装器每次调用 encapsulate() 都会生成新的共享密钥和封装消息,因此同一公钥也不应把旧消息当成新的会话结果。

Java KEM 公钥私钥封装器封装结果共享密钥和封装消息的结构关系说明图
图1:KEM 角色结构说明图,查看密钥材料与封装消息分别属于哪一侧。
材料由谁持有是否发送
PublicKey接收方产生,发送方使用可以公开
PrivateKey接收方不发送
SecretKey双方各自恢复不发送
encapsulation message发送方产生,接收方输入随协议传输

用 encapsulate 生成共享密钥与封装消息

核心返回值是 KEM.Encapsulated。它同时包含共享密钥 key()、封装消息 encapsulation() 和可选参数 params()。共享密钥留在发送方的密钥对象中,真正交给网络协议的通常是封装消息,必要时还要携带 Provider 规定的参数。

import javax.crypto.KEM;
import javax.crypto.SecretKey;
import java.security.PublicKey;

// receiverPublicKey 来自接收方,实际算法名由安装的 Provider 决定。
KEM kem = KEM.getInstance("KEM-ALGORITHM");
KEM.Encapsulator encapsulator = kem.newEncapsulator(receiverPublicKey);

// 默认返回 Generic 共享秘密,适合继续交给 KDF 处理。
KEM.Encapsulated result = encapsulator.encapsulate();
SecretKey senderSecret = result.key();
byte[] encapsulation = result.encapsulation();
byte[] params = result.params(); // 可能为 null,按 Provider 协议处理

// 传输 encapsulation;如果 params 非空,也要让接收方能恢复同样的参数。
sendToReceiver(encapsulation, params);

这里的 Generic 表示这份秘密通常作为 KDF 的输入材料,而不是暗示它已经是 AES、ChaCha20 等业务加密算法的密钥。若 Provider 支持指定输出范围和算法名,也可以使用带 from、to、algorithm 参数的重载,但必须以该实现支持的组合为准。

接收方怎样用 decapsulate 恢复同一把钥匙

接收方使用与这对密钥匹配的私钥创建 Decapsulator,把发送方传来的封装消息交给 decapsulate()。在相同算法和参数条件下,返回的 SecretKey 就是对应的共享秘密;封装消息本身不是业务明文,也不能替代消息认证和会话协议。

import javax.crypto.KEM;
import javax.crypto.SecretKey;
import java.security.PrivateKey;

// receiverPrivateKey 必须与发送方使用的公钥属于同一密钥对。
KEM receiverKem = KEM.getInstance("KEM-ALGORITHM");
KEM.Decapsulator decapsulator = receiverKem.newDecapsulator(receiverPrivateKey);

// 封装消息长度必须符合 Provider 的契约,否则会抛出解封装异常。
SecretKey receiverSecret = decapsulator.decapsulate(encapsulation);

// senderSecret 与 receiverSecret 供后续协议比较或派生使用,不直接打印密钥内容。
useAsKeyDerivationInput(receiverSecret);
KEM Encapsulated 返回对象及其 key encapsulation params KDF 和 Decapsulator 关系说明图
图2:封装结果结构说明图,查看 key、封装消息、可选 params 与 KDF 的边界。

Provider、params 和异常边界要提前处理

  • 算法不是凭空存在的:KEM.getInstance("KEM-ALGORITHM") 只是示意,运行环境要安装并配置提供该算法的 Provider;没有实现时会在获取实例或创建封装器阶段失败。
  • params 不能随意丢弃:KEM.Encapsulated.params() 可能返回 Provider 需要的参数字节。若协议只传了封装消息,却没有保存这些参数,接收方可能无法用同样的参数创建解封装器。
  • 先确认尺寸和算法:encapsulationSize()、secretSize() 可用于协议边界处理;错误的封装消息、空数组或不支持的输出组合,应按 DecapsulateException、InvalidKeyException 和 InvalidAlgorithmParameterException 分支记录。
  • KEM 不是完整加密协议:共享秘密通常还要进入 KDF,并结合会话身份、消息认证、重放防护和密钥生命周期设计。不要把 encapsulation() 当作密文正文,也不要把共享密钥写入日志。

一句话记忆:发送方用公钥“封装出”共享秘密和封装消息,接收方用私钥“解封装”同一份秘密;Java KEM API 负责这条密码学接口边界,具体算法与上层协议仍由 Provider 和应用设计决定。

相关问题

Java KEM API 从哪个版本开始提供?

javax.crypto.KEM 及其嵌套类型在 Java 21 API 中提供,具体可用算法仍取决于安全 Provider。

encapsulate() 返回的是不是业务数据密文?

不是。返回对象里的封装消息用于让接收方恢复共享秘密,业务数据还需要由后续对称加密和完整的会话协议处理。

声明:本文转载于:17golang原创 如有侵犯,请联系study_golang@163.com删除
相关阅读
更多>
最新阅读
更多>
课程推荐
更多>