4. Python 实现 AES-CBC 加密：核心组件与实战

AES-CBC（Cipher Block Chaining）是实际应用中最广泛的分组密码工作模式之一。本章将使用 pycryptodome 库，从零实现 AES-CBC 的加解密、IV 安全生成与管理，以及 PKCS7 填充机制。理解这三者的协同关系，是构建安全通信方案的基础。

4.1 AES-CBC 工作模式与核心组件

CBC 模式通过将前一个密文块与当前明文块进行异或（XOR）操作，再送入 AES 加密，从而打破明文块之间的统计独立性。其核心组件包括：

4.2 使用 PyCryptodome 实现 AES-CBC 加解密

pycryptodome 是 Python 生态中最成熟的密码学库之一，提供了对 AES-CBC 模式的原生支持。以下代码演示了完整的加解密流程，包含密钥生成、IV 管理、填充处理与异常捕获。

from Crypto.Cipher import AES
from Crypto.Random import get_random_bytes
from Crypto.Util.Padding import pad, unpad
import os

def aes_cbc_encrypt(plaintext: bytes, key: bytes) -> tuple:
    """
    AES-CBC 加密函数
    :param plaintext: 明文（字节串）
    :param key: AES 密钥（16/24/32 字节）
    :return: (iv, ciphertext) 元组
    """
    # 1. 生成随机 IV（16 字节）
    iv = get_random_bytes(AES.block_size)

    # 2. 创建 CBC 模式加密器
    cipher = AES.new(key, AES.MODE_CBC, iv)

    # 3. PKCS7 填充明文
    padded_data = pad(plaintext, AES.block_size)

    # 4. 执行加密
    ciphertext = cipher.encrypt(padded_data)

    return iv, ciphertext

def aes_cbc_decrypt(iv: bytes, ciphertext: bytes, key: bytes) -> bytes:
    """
    AES-CBC 解密函数
    :param iv: 初始向量（16 字节）
    :param ciphertext: 密文（字节串）
    :param key: AES 密钥（必须与加密时一致）
    :return: 原始明文（字节串）
    """
    # 1. 创建 CBC 模式解密器
    cipher = AES.new(key, AES.MODE_CBC, iv)

    # 2. 执行解密
    padded_data = cipher.decrypt(ciphertext)

    # 3. 移除 PKCS7 填充
    try:
        plaintext = unpad(padded_data, AES.block_size)
    except ValueError as e:
        raise ValueError("填充验证失败，密文可能被篡改或密钥错误") from e

    return plaintext

# 使用示例
if __name__ == "__main__":
    # 生成 256 位密钥（32 字节）
    key = get_random_bytes(32)
    message = b"AES-CBC 实战加密消息 -- 安全通信方案设计"

    # 加密
    iv, ciphertext = aes_cbc_encrypt(message, key)
    print(f"IV (hex): {iv.hex()}")
    print(f"密文 (hex): {ciphertext.hex()}")

    # 解密
    decrypted = aes_cbc_decrypt(iv, ciphertext, key)
    print(f"解密结果: {decrypted.decode('utf-8')}")

4.3 IV 生成与安全管理

IV 的安全性是 CBC 模式的核心。错误的 IV 管理会导致严重的安全漏洞，包括明文恢复和重放攻击。

4.4 PKCS7 填充机制详解

AES 是分组密码，要求输入明文长度为 16 字节的整数倍。PKCS7 填充在明文末尾添加 N 个字节，每个字节的值均为 N，其中 N 是补齐到块边界所需的字节数（1 ≤ N ≤ 16）。

4.5 完整实战：安全消息加密与传输格式

在实际通信方案中，IV 需要与密文一起传输。常见的做法是将 IV 拼接在密文头部，接收方先提取前 16 字节作为 IV，剩余部分作为密文。

def encrypt_message(plaintext: bytes, key: bytes) -> bytes:
    """
    加密消息并返回可传输的字节串（IV + 密文）
    """
    iv, ciphertext = aes_cbc_encrypt(plaintext, key)
    # 将 IV 拼接在密文前面
    return iv + ciphertext

def decrypt_message(encrypted_data: bytes, key: bytes) -> bytes:
    """
    从传输格式中提取 IV 并解密
    """
    if len(encrypted_data) < AES.block_size:
        raise ValueError("数据长度不足，无法提取 IV")

    iv = encrypted_data[:AES.block_size]
    ciphertext = encrypted_data[AES.block_size:]
    return aes_cbc_decrypt(iv, ciphertext, key)

# 实战测试
key = get_random_bytes(32)
original = b"安全通信：AES-CBC 模式实战演练"

# 加密传输
packet = encrypt_message(original, key)
print(f"传输数据长度: {len(packet)} 字节")
print(f"IV: {packet[:16].hex()}")
print(f"密文: {packet[16:].hex()}")

# 接收解密
recovered = decrypt_message(packet, key)
print(f"恢复明文: {recovered.decode('utf-8')}")

4.6 常见错误与调试指南

4.7 本章小结

• AES-CBC 模式通过 IV 和密文反馈实现语义安全，相同明文在不同 IV 下产生不同密文。
• PKCS7 填充确保任意长度明文都能被 AES 处理，解密时必须严格验证填充完整性。
• IV 必须随机生成、唯一且不可预测，传输时拼接在密文头部。
• pycryptodome 的 Crypto.Cipher.AES 模块提供了简洁的 API，配合 pad/unpad 函数可快速实现安全加解密。
• 生产环境应额外添加完整性校验（如 HMAC）或直接使用认证加密模式（如 GCM）。