Bouncy Castle for Java：密码学与加密完整指南

1. 什么是 Bouncy Castle 及其用途

Bouncy Castle（通常简称为 BC）是 Java（和 .NET）平台最强大且广泛使用的密码学库之一。它为开发者提供了一套丰富的 API，用于实现加密、数字签名、哈希、密钥生成以及证书处理。与标准的 Java Cryptography Extension (JCE) 不同，Bouncy Castle 支持更多算法，包括许多过时的、实验性的和较少使用的算法，这使其成为安全专家和从事非标准协议开发的开发者不可或缺的工具。

它的用途是什么？首先，标准 Java 库（JCA/JCE）不包含许多现代和专用算法（例如 Twofish、Serpent、GOST、SM2/SM3/SM4）。Bouncy Castle 填补了这一空白。其次，它提供了“轻量级”（Lightweight API）实现，无需在全局 JVM 中安装安全提供者（Provider），这适用于嵌入式系统和注重隔离的应用程序。第三，该库得到积极维护，通过安全审计，并且是许多开源项目（例如 Java 的 OpenSSL）的事实标准。

Bouncy Castle 由两个主要组件组成：提供者（bcprov-jdk18on），它与 Java 安全架构集成，以及 PKIX/CMS/SMIME/TLS 包（bcpkix-jdk18on、bcmail-jdk18on、bctls-jdk18on），它们实现高级协议，如 S/MIME、TLS 和 X.509 证书处理。本文将重点介绍库的核心——提供者及其轻量级 API。

2. 安装

Bouncy Castle 通过 Maven Central 分发。要在 Java 项目（Maven、Gradle、SBT）中使用，请将以下依赖项添加到您的构建文件中。

对于 Maven (pom.xml)：

<!-- 核心提供者（必需） -->\n<dependency>\n    <groupId>org.bouncycastle</groupId>\n    <artifactId>bcprov-jdk18on</artifactId>\n    <version>1.78.1</version> <!-- 在 mvnrepository.com 上查看最新版本 -->\n</dependency>\n\n<!-- 用于证书、CMS、S/MIME 处理（可选） -->\n<dependency>\n    <groupId>org.bouncycastle</groupId>\n    <artifactId>bcpkix-jdk18on</artifactId>\n    <version>1.78.1</version>\n</dependency>

对于 Gradle (build.gradle)：

implementation 'org.bouncycastle:bcprov-jdk18on:1.78.1'\nimplementation 'org.bouncycastle:bcpkix-jdk18on:1.78.1' // 可选

重要提示： 如果您使用旧版 Java（低于 8），则需要 bcprov-jdk15on 版本。对于 Java 8+，请使用 bcprov-jdk18on。添加依赖项后，您需要在代码中注册提供者（如果您使用标准 JCE API）或直接使用轻量级 API。

3. 快速入门——最小工作示例

最简单的示例：使用 AES-256 算法在 GCM 模式（认证加密）下通过轻量级 API 加密字符串。

import org.bouncycastle.crypto.*;\nimport org.bouncycastle.crypto.engines.AESEngine;\nimport org.bouncycastle.crypto.modes.GCMBlockCipher;\nimport org.bouncycastle.crypto.params.*;\nimport org.bouncycastle.util.encoders.Hex;\n\nimport java.security.SecureRandom;\n\npublic class QuickStart {\n\n    public static void main(String[] args) throws Exception {\n        // 1. 生成密钥和 IV（初始化向量）\n        SecureRandom secureRandom =