Microsoft CryptoAPI 加密技術入門（一）：架構、加密模式與 CSP 核心概念

前言

資訊爆炸時代，資料安全至關重要。Microsoft CryptoAPI 為 Win32 應用程式提供標準加密介面，支援對稱/非對稱加密、雜湊、數位簽章、憑證管理。本文建立核心概念，為深入實作奠基。

一、四大加密模式對比

二、CryptoAPI 架構模型

類似 GDI (圖形裝置介面) 分層設計：

應用程式層
    ↓ 呼叫標準 API
CryptoAPI (加密服務介面)
    ↓ 統一介面
CSP (Cryptographic Service Provider) ← 可替換模組
    ↓ (可選)
加密硬體 (智慧卡、HSM、TPM)

• 應用程式：完全不接觸 CSP 細節，僅呼叫 CryptoAPI
• CryptoAPI：提供五大功能群
  1. 簡易訊息函數
  2. 低層訊息函數
  3. 基礎加密函數 (核心)
  4. 憑證編碼/解碼函數
  5. 憑證存儲管理函數
• CSP：實作具體演算法 (RSA, AES, SHA 等)，由廠商提供 (Microsoft Base/Enhanced/Strong CSP 等)
• 加密硬體：金鑰產生/儲存於安全元件，私鑰永不離開硬體

三、核心物件與控制代碼

四、基本初始化流程

HCRYPTPROV hProv = 0;

// 1. 取得預設 CSP 語境 (Microsoft Base Cryptographic Provider v1.0)
if (!CryptAcquireContext(&hProv, NULL, NULL, PROV_RSA_FULL, 0)) {
    DWORD err = GetLastError();
    if (err == NTE_BAD_KEYSET) {
        // 容器不存在，建立新容器
        if (!CryptAcquireContext(&hProv, NULL, NULL, PROV_RSA_FULL, CRYPT_NEWKEYSET)) {
            // 失敗處理
        }
    } else {
        // 其他錯誤
    }
}

// 後續使用 hProv 建立金鑰、雜湊、加解密...

// 結束時釋放
CryptReleaseContext(hProv, 0);

五、CSP 類型與選擇

六、關鍵資料結構：金鑰 Blob

金鑰在記憶體/檔案中以 Blob 形式儲存：

• PUBLICKEYBLOB：公開金鑰 (可安全傳輸)
• PRIVATEKEYBLOB：私有金鑰 (需加密保護)
• SIMPLEBLOB：用公開金鑰加密的對稱金鑰 (金鑰交換)
• OPAQUEKEYBLOB：硬體金鑰參考 (不含實際金鑰材料)

七、現代化提醒

CryptoAPI 為 Legacy API。Windows Vista+ 引入 CNG (Cryptography Next Generation)，提供：

• 現代演算法：AES-GCM, ChaCha20-Poly1305, ECDSA (P-256/P-384), Ed25519, SHA-3
• 更佳效能：硬體加速 (AES-NI, SHA-NI)、非同步操作
• 彈性金鑰儲存：KSP (Key Storage Provider) 支援 TPM、VBS、雲端 HSM
• 更安全的預設值：常數時間實作、抗側邊通道攻擊

新專案請直接使用 BCrypt*/NCrypt* API。

結語

CryptoAPI 以 CSP 抽象層統一加密服務，核心在於 HCRYPTPROV 語境管理、金鑰 Blob 序列化與五大功能群協作。掌握架構模型與初始化流程，是進入 Windows 密碼學開發的必經之路。

1. 上一篇文章： Microsoft CryptoAPI 加密技術深度解析（二）：非對稱加密、雜湊與數位簽章
2. 下一篇文章： C++ 類別物件複製機制深度解析：複製建構子、預設行為與自訂實作

VC 教學

TCP/IP 學習筆記補遺：真實封包擷取分析與連線流程詳解

實驗環境與資料來源 網路環境：ADSL 寬頻 封包內容：透

自訂編輯框右鍵選單：CEitMenuHandler 類別完整解決方案

問題背景 編輯框控制項右鍵彈出的標準內容選單，若要加入自訂選

Eclipse 平台除錯實戰：從 Java 到 C/C++ 的完整指南

Eclipse 除錯架構 內建 Java 除錯器（JDT）

打造統一風格漂亮介面 (二)：對話框子類化與統一風格模板實作

前言：統一風格的挑戰 上一篇介紹了自繪視窗標題列、邊框、系統