Class MlKemUtil

java.lang.Object
com.sure.tool.crypto.MlKemUtil

public final class MlKemUtil extends Object
后量子密钥工具,基于 JDK 25 正式特性 JEP 496(Quantum-Resistant Module-Lattice-Based Key Encapsulation Mechanism,ML-KEM / Kyber)。

提供 ML-KEM(Kyber)密钥对生成与 X.509 / PKCS8 编解码。JDK 25 当前提供密钥对生成能力; 封装/解封装 API(JEP 452)尚未进入 JDK 25,待未来 JDK 支持后由 encapsulate/decapsulate 扩展。零第三方运行期依赖。

Since:
1.7.0
Author:
suretool contributors
  • Field Details

    • ML_KEM_512

      public static final String ML_KEM_512
      ML-KEM-512(Kyber-512 后量子标准参数)
      See Also:
    • ML_KEM_768

      public static final String ML_KEM_768
      ML-KEM-768(Kyber-768 后量子标准参数,推荐)
      See Also:
    • ML_KEM_1024

      public static final String ML_KEM_1024
      ML-KEM-1024(Kyber-1024 后量子标准参数)
      See Also:
  • Method Details

    • generateKeyPair

      public static KeyPair generateKeyPair(String algorithm)
      生成指定参数的 ML-KEM 密钥对。
      Parameters:
      algorithm - 算法名(ML_KEM_512 / ML_KEM_768 / ML_KEM_1024)
      Returns:
      生成的密钥对
      Throws:
      IllegalArgumentException - 算法不存在或生成失败
    • publicKeyToBase64

      public static String publicKeyToBase64(PublicKey key)
      将公钥编码为 X.509 Base64 字符串。
      Parameters:
      key - 公钥
      Returns:
      Base64 编码字符串
    • publicKeyFromBase64

      public static PublicKey publicKeyFromBase64(String base64, String algorithm)
      从 X.509 Base64 字符串还原公钥。
      Parameters:
      base64 - Base64 编码的公钥
      algorithm - 算法名(与生成时一致)
      Returns:
      还原的公钥
      Throws:
      IllegalArgumentException - 编码非法或还原失败
    • privateKeyToBase64

      public static String privateKeyToBase64(PrivateKey key)
      将私钥编码为 PKCS8 Base64 字符串。
      Parameters:
      key - 私钥
      Returns:
      Base64 编码字符串
    • privateKeyFromBase64

      public static PrivateKey privateKeyFromBase64(String base64, String algorithm)
      从 PKCS8 Base64 字符串还原私钥。
      Parameters:
      base64 - Base64 编码的私钥
      algorithm - 算法名(与生成时一致)
      Returns:
      还原的私钥
      Throws:
      IllegalArgumentException - 编码非法或还原失败