Crypto++ 庫 Windows 環境快速上手指南：從編譯静態庫到 RSA 加解密完整實戰

Crypto++ 是功能強大的 C++ 密碼學庫，但官方僅提供源碼與 Visual Studio 專案，無預編譯二進位。本文詳述 Windows + Visual Studio 環境下：編譯生成 `cryptlib.lib`、建立 SDK 目錄結構、配置專案屬性、實現 RSA 密鑰生成/加密/解密完整流程，並解決常見運行時庫衝突錯誤。

第一階段：編譯靜態庫 `cryptlib.lib`

1. 下載源碼 (如 `cryptopp560.zip`)，解壓至 `D:\crypto\`。
2. 打開 `cryptest.sln` (VS 2005/2008/2010/2019 均可自動升級)。
3. 選擇配置：**Debug** → 右鍵 `cryptlib` 專案 → **Build**。
4. 首次建置常報 `vc80.idb` 錯誤，**再次 Build 即可成功**。
5. 切換 **Release** 配置，重複建置。
6. 輸出位置：`Win32\Output\Debug\cryptlib.lib`、`Win32\Output\Release\cryptlib.lib`。

第二階段：建立 Crypto++ SDK 目錄結構

C:\Program Files\CryptoPP\
├── include\        # 所有 .h 檔
│   ├── aes.h
│   ├── rsa.h
│   └── ...
└── lib\
    ├── debug\      # Debug 版 cryptlib.lib
    └── release\    # Release 版 cryptlib.lib

將源碼目錄下所有 `*.h` 複製到 `include\`，兩版 `.lib` 分別放入 `lib\debug\`、`lib\release\`。

第三階段：專案屬性配置 (關鍵步驟)

右鍵專案 → **Properties** (Alt+F7)：

第四階段：RSA 加解密完整代碼

1. 頭文件引用與命名空間

#include "randpool.h"
#include "rsa.h"
#include "hex.h"
#include "files.h"
#include 
#include 

using namespace std;
using namespace CryptoPP;

#pragma comment(lib, "cryptlib.lib")

2. 全域隨機數池 (線程不安全，單線程示範用)

RandomPool& GlobalRNG() {
    static RandomPool pool;
    return pool;
}

3. 生成 RSA 密鑰對 (1024 位，OAEP-SHA 填充)

void GenerateRSAKey(unsigned int keyLen, const char* privFile, const char* pubFile, const char* seed) {
    RandomPool rng;
    rng.Put((byte*)seed, strlen(seed));

    // 私鑰生成器
    RSAES_OAEP_SHA_Decryptor priv(rng, keyLen);
    HexEncoder privOut(new FileSink(privFile));
    priv.DEREncode(privOut);
    privOut.MessageEnd();

    // 從私鑰導出公鑰
    RSAES_OAEP_SHA_Encryptor pub(priv);
    HexEncoder pubOut(new FileSink(pubFile));
    pub.DEREncode(pubOut);
    pubOut.MessageEnd();
}

4. RSA 加密 (公鑰)

string RSAEncryptString(const char* pubFile, const char* seed, const char* plaintext) {
    FileSource pubSrc(pubFile, true, new HexDecoder); // true = pumpAll
    RSAES_OAEP_SHA_Encryptor encryptor(pubSrc);

    RandomPool rng;
    rng.Put((byte*)seed, strlen(seed));

    string ciphertext;
    StringSource(plaintext, true,
        new PK_EncryptorFilter(rng, encryptor,
            new HexEncoder(new StringSink(ciphertext))
        )
    );
    return ciphertext; // Hex 編碼字串
}

5. RSA 解密 (私鑰)

string RSADecryptString(const char* privFile, const char* ciphertext) {
    FileSource privSrc(privFile, true, new HexDecoder);
    RSAES_OAEP_SHA_Decryptor decryptor(privSrc);

    string plaintext;
    StringSource(ciphertext, true,
        new HexDecoder(
            new PK_DecryptorFilter(GlobalRNG(), decryptor,
                new StringSink(plaintext)
            )
        )
    );
    return plaintext;
}

6. 主程式測試

int main() {
    const char* seed = "my_seed_123";
    const char* pri = "private.key";
    const char* pub = "public.key";

    GenerateRSAKey(1024, pri, pub, seed);

    const char* msg = "Hello Crypto++ RSA!";
    cout << "Original: " << msg << endl;

    string enc = RSAEncryptString(pub, seed, msg);
    cout << "Encrypted (Hex): " << enc << endl;

    string dec = RSADecryptString(pri, enc.c_str());
    cout << "Decrypted: " << dec << endl;

    return 0;
}

第五階段：常見錯誤與解決

第六階段：現代化建議 (Crypto++ 8.x + CMake + vcpkg)

• vcpkg：`vcpkg install cryptopp:x64-windows` → 自動處理編譯、鏈接、運行時庫一致性。
• CMake：`find_package(Cryptopp REQUIRED)` → `target_link_libraries(myapp Cryptopp::cryptopp)`。
• 密鑰長度：2024 年建議 **RSA 2048 位以上** (3072/4096)，或改用 **ECC (Curve25519/P-256)**。
• 填充模式：優先 **OAEP (RSAES_OAEP_SHA)**，避免 PKCS#1 v1.5 (Bleichenbacher 攻擊)。
• 隨機數：生產環境使用 `AutoSeededRandomPool` (自動收集系統熵源) 替代手動種子。

完成上述配置，你即擁有一個可在 Windows Visual Studio 直接使用的 Crypto++ 開發環境，可專注於業務層密碼學邏輯而非構建系統糾結。