Crypto++ 實戰指南：從入門到封裝 DLL 的完整避坑路線圖

Crypto++ 是 C++ 界公認最強大的密碼學庫，但其大量模板、策略類別、管道式設計讓初學者望而卻步。本文梳理從源碼編譯、核心概念（管道/過濾器/轉換器）、常用演算法調用，到作者親測封裝 CryptoPP32.dll 供跨語言調用的完整實戰路徑，並附 JavaScript 端 JSBN 互操作驗證方案。

一、環境建置與核心概念

• 下載 cryptopp5.4，Visual Studio 開啟 cryptlib.vcxproj 編譯靜態庫。
• 三大核心抽象：
  1. Source：資料來源（StringSource, FileSource）
  2. Filter/Transformation：轉換鏈（加密、壓縮、編碼），可串聯
  3. Sink：資料終點（StringSink, FileSink）
• 典型管道：StringSource(msg, true, new PK_EncryptorFilter(rng, encryptor, new StringSink(cipher)))

二、作者封裝 CryptoPP32.dll 介面精華

為簡化調用，作者將高頻操作封裝為 C 風格介面（extern "C"），支援：

• RSA-OAEP / RSA-PKCS#1 v1.5：金鑰生成、加解密（檔案/字串/純參數）
• RSA-PKCS 簽名/驗簽：支援 SHA-1/256 等雜湊
• HMAC-SHA1：字串/檔案加解密
• Gzip / Base64 / Hex：檔案與字串雙向轉換

關鍵介面範例：

bool RSAES_PKCS_EncryptString(const char* pubFile, const char* msg, std::string& cipher, const char* seed=0);
bool RSAES_PKCS_DecryptString(const char* privFile, const char* cipher, std::string& plain);
bool Base64Encode(const char* plain, std::string& encoded);

三、完整測試程式碼（含 JSBN 互操作參數）

#include "CryptoPP32.h"
using namespace CryptoPP32;

int main() {
    VL_Serializer Serializer;
    VL_REGISTER_SERIALIZABLE_CLASS(&Serializer, TestTree); // 註冊類別

    // 1. 生成金鑰對（檔案/字串雙模式）
    RSAES_PKCS_GenerateKeys("c:\\privkey.rsa", "c:\\pubkey.rsa");
    std::string privStr, pubStr;
    RSAES_PKCS_GenerateKeys(privStr, pubStr);

    // 2. 公鑰加密、私鑰解密
    std::string cipher, plain;
    RSAES_PKCS_EncryptString("c:\\pubkey.rsa", "hello world", cipher, "seed123");
    RSAES_PKCS_DecryptString("c:\\privkey.rsa", cipher.c_str(), plain);

    // 3. JSBN 互操作參數（n, e, d, p, q, dp, dq, u）
    char n[] = "C4E3F7..."; // 1024-bit modulus
    char e[] = "10001h";
    // ... 其餘參數
    RSAES_PKCS_EncryptString(n, e, "test", cipher);
    RSAES_PKCS_DecryptString(n, e, d, p, q, dp, dq, u, cipher.c_str(), plain);
}

四、瀏覽器端 JSBN 互操作架構

Browser (JSBN)  ←→  Server (CryptoPP32.dll)
    RSA-PKCS#1 v1.5 加解密
    參數格式完全一致：n, e, d, p, q, dp, dq, u

驗證結果：雙向加解密完全相容，無需額外轉換層。

五、典型應用場景：會話級金鑰協商

1. 雙方各生成臨時 RSA 金鑰對，交換公鑰。
2. 客戶用服務端公鑰加密對稱金鑰（AES/ChaCha20）傳送。
3. 後續通訊使用對稱加密，性能與安全兼顧。
4. 會話結束銷毀金鑰，實現前向保密。

六、避坑清單

作者提供的完整工程下載（含 cryptopp5.4、CryptoPP32.dll、測試專案）可作為團隊密碼學基建的起點。建議先跑通測試，再按業務需求裁剪介面、升級演算法（如改用 RSA-OAEP-SHA256、Ed25519、X25519）。