当前位置:首页 > 文章列表 > 文章 > java教程 > Java Key Encapsulation Mechanism API 怎样封装共享密钥

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

来源:17golang原创 2026-11-20 12:00:12 0浏览 收藏

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删除
Java String Templates 为什么仍要关注模板处理器边界Java String Templates 为什么仍要关注模板处理器边界
上一篇
Java String Templates 为什么仍要关注模板处理器边界
Python 3.14 跨解释器 Queue.put 的阻塞与 QueueFull 处理方案
下一篇
Python 3.14 跨解释器 Queue.put 的阻塞与 QueueFull 处理方案
查看更多
最新文章
查看更多
课程推荐
  • 前端进阶之JavaScript设计模式
    前端进阶之JavaScript设计模式
    设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
    543次学习
  • GO语言核心编程课程
    GO语言核心编程课程
    本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
    516次学习
  • 简单聊聊mysql8与网络通信
    简单聊聊mysql8与网络通信
    如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
    500次学习
  • JavaScript正则表达式基础与实战
    JavaScript正则表达式基础与实战
    在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
    487次学习
  • 从零制作响应式网站—Grid布局
    从零制作响应式网站—Grid布局
    本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
    485次学习
查看更多
AI推荐
  • PubMedQA数据集详解:生物医学问答基准、功能与应用指南
    PubMedQA
    深入了解PubMedQA生物医学问答数据集,涵盖其核心功能、使用方法及在临床决策、药物研发等场景的应用,助力提升NLP模型性能。
    1142次使用
  • H2O EvalGPT:开源LLM大模型评估与排行榜工具
    H2O EvalGPT
    H2O EvalGPT是H2O.ai推出的开源LLM评估平台,提供详细的大模型性能排行榜、行业特定基准测试及A/B测试功能,助您快速选择最适合项目的高性能大语言模型。
    1128次使用
  • LMArena是什么?伯克利AI模型评估平台使用指南与功能解析
    LMArena
    LMArena是加州大学伯克利分校推出的AI模型匿名评测平台。通过盲测投票机制,用户可对比不同大模型回答并生成实时排行榜,助力开发者优化模型及用户选择最佳AI工具。
    1304次使用
  • 斯坦福HELM:大语言模型Holistic Evaluation整体评估框架详解
    HELM
    深入了解斯坦福推出的HELM(Holistic Evaluation of Language Models)大模型评测体系。本文解析其核心功能、安装配置步骤及应用场景,涵盖准确性、公平性、鲁棒性等多维度指标,助力开发者全面优化语言模型性能。
    1243次使用
  • MMBench详解:多模态大模型基准测试、功能特点与使用指南
    MMBench
    MMBench是由上海人工智能实验室等机构联合推出的多模态基准测试平台,提供细粒度能力评估、大规模数据集及VLMEvalKit工具。本文详细介绍其核心功能、安装使用方法及应用场景,助力开发者全面评估多模态模型性能。
    1094次使用
微信登录更方便
  • 密码登录
  • 注册账号
登录即同意 用户协议 和 隐私政策
返回登录
  • 重置密码