介紹如何在 Ubuntu Linux 系統中安裝 Crypto++ 加密函式庫，並編譯使用 Crypto++ 的 C++ 程式碼。
Crypto++（亦稱 CryptoPP、libcrypto++ 或 libcryptopp）是一套開放原始碼的 C++ 密碼學函式庫，除了完整支援常見的演算法之外，Crypto++ 也包含了較冷門、較少被使用的演算法，目前已廣泛被學術界與業界使用。
安裝 Crypto++ 函式庫
套件安裝
若要在 Ubuntu Linux 中安裝 Crypto++ 函式庫，最方便的方式就是使用 apt 安裝 Ubuntu 官方收錄的 Crypto++ 函式庫開發套件：
# 安裝 Crypto++ 函式庫開發套件
sudo apt install libcrypto++-dev
自行編譯安裝
若需要使用最新版的 Crypto++ 函式庫，可以下載最新的 Crypto++ 原始碼，自行編譯後安裝使用。
Crypto++ 最新的原始碼可以從官方網站下載：
# 下載 Crypto++ 原始碼並解壓縮至 cryptopp870 目錄
https://cryptopp.com/cryptopp870.zip
unzip -a cryptopp870.zip -d cryptopp870
或是從 Crypto++ 的 GitHub 套件庫下載：
# 從 GitHub 下載 Crypto++ 原始碼
git clone git://github.com/weidai11/cryptopp.git
進入原始碼目錄，執行 make 編譯：
# 編譯 Crypto++
cd cryptopp870
make -j2
這裡 make 的參數 -j2 是指定同時執行 2 個編譯工作平行處理，通常工作數量可以指定為 CPU 的核心數以加速編譯。
編譯完成後，執行基本的 Crypto++ 函式庫 Validation Suite 測試程式：
# 測試 Crypto++ 函式庫
./cryptest.exe v
[略] Testing NaCl library functions... passed crypto_box, crypto_box_beforenm, crypto_box_afternm passed crypto_box_open, crypto_box_open_afternm passed crypto_box_keypair pairwise consistency passed crypto_sign, crypto_sign_open, crypto_sign_keypair passed crypto_sign_keypair pairwise consistency All tests passed! Seed used was 1670829385 Test started at Mon Dec 12 15:16:25 2022 Test ended at Mon Dec 12 15:16:30 2022
測試程式的輸出很長，基本上只要看最後是否有出現 All tests passed 的訊息即可。
再執行 Test Vectors 測試：
# 測試 Crypto++ 函式庫
./cryptest.exe tv all
[略] Testing MessageDigest algorithm Whirlpool. ......... Testing SymmetricCipher algorithm AES/XTS. ........................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................ Tests complete. Total tests = 17549. Failed tests = 0.
確認輸出中沒有任何錯誤之後，就可以進行安裝了，若要將 Crypto++ 安裝至系統預設的路徑（/usr/local）下，可以執行：
# 將 Crypto++ 安裝至系統預設目錄 /usr/local
sudo make install
如果沒有管理者權限，亦可透過 PREFIX 變數指定安裝路徑，將 Crypto++ 安裝至自行指定的路徑之下：
# 將 Crypto++ 安裝至 ~/cryptopp 目錄
make install PREFIX=~/cryptopp
若要移除自行編譯安裝的 Crypto++ 函式庫，可以使用對應的 make uninstall 指令：
# 將安裝至系統預設目錄 /usr/local 的 Crypto++ 移除
sudo make uinstall
# 將安裝至 ~/cryptopp 目錄的 Crypto++ 移除
make uninstall PREFIX=~/cryptopp
編譯 Crypto++ 程式
以下是一個使用 Crypto++ 函式庫來計算 SHA1 雜湊碼的範例，這裡我們將示範如何使用 g++ 編譯器編譯這個程式：
#include <iostream>
#include <cstdlib>
#include "cryptlib.h"
#include "filters.h"
#include "files.h"
#include "sha.h"
#include "hex.h"
int main () {
using namespace CryptoPP;
SHA1 hash;
std::string msg = "Crypto++ is a free C++ library for cryptography.";
std::string digest;
HexEncoder encoder(new FileSink(std::cout));
hash.Update((const byte*)msg.data(), msg.size());
digest.resize(hash.DigestSize());
hash.Final((byte*) digest.c_str());
std::cout << "Message: " << msg << std::endl;
std::cout << "SHA1 Digest: ";
StringSource(digest, true, new Redirector(encoder));
std::cout << std::endl;
return EXIT_SUCCESS;
}
將這份程式碼儲存至 sha1.cpp 之後，若採用 Ubuntu Linux 官方套件庫的 Crypto++ 函式庫，可以使用以下 g++ 指令進行編譯：
# 編譯 Crypto++ 程式（Ubuntu Linux 官方套件庫 Crypto++ 函式庫）
g++ -I/usr/include/crypto++ -o sha1 sha1.cc -lcryptopp
如果是自行安裝的 Crypto++ 函式庫，可依照自己的安裝路徑，調整引入標頭檔的目錄以及函式庫連結檔的位置，以預設的 /usr/local 安裝路徑來說，編譯指令可以改成這樣：
# 編譯 Crypto++ 程式（自行編譯安裝 Crypto++ 函式庫）
g++ -I/usr/local/include/cryptopp -o sha1 sha1.cc \
-L/usr/local/lib/libcryptopp.a -lcryptopp
編譯完成後，即可執行這個測試程式：
# 執行測試程式
./sha1
Message: Crypto++ is a free C++ library for cryptography. SHA1 Digest: 1A7588E2529D53DD5200371F6CF5084754A9B76C