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() 都会生成新的共享密钥和封装消息,因此同一公钥也不应把旧消息当成新的会话结果。

| 材料 | 由谁持有 | 是否发送 |
|---|---|---|
| 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);

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() 返回的是不是业务数据密文?
不是。返回对象里的封装消息用于让接收方恢复共享秘密,业务数据还需要由后续对称加密和完整的会话协议处理。
-
501 收藏
-
文章 · java教程 | 2个月前 | Java · 异常处理 · 资源管理 · java try-with-resources AutoCloseable close suppressed exception501 收藏
-
501 收藏
-
501 收藏
-
501 收藏
-
128 收藏
-
263 收藏
-
311 收藏
-
474 收藏
-
137 收藏
-
194 收藏
-
262 收藏
-
131 收藏
-
187 收藏
-
465 收藏
-
447 收藏
-
283 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 立即学习 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 立即学习 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 立即学习 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 立即学习 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 立即学习 485次学习