深入理解pyca/cryptography中的对称加密原语

原创于 2025-06-06 09:04:08 发布

· 267 阅读

版权

深入理解pyca/cryptography中的对称加密原语

cryptography cryptography is a package designed to expose cryptographic primitives and recipes to Python developers. 项目地址: https://gitcode.com/gh_mirrors/cr/cryptography

对称加密基础概念

对称加密是一种加密方法，发送方和接收方使用相同的密钥进行加密和解密操作。在pyca/cryptography项目中，对称加密功能位于hazmat.primitives.ciphers模块中。

重要安全注意事项

单纯对称加密不足：仅提供保密性，不提供真实性验证。攻击者可以伪造消息让应用解密。
必须结合认证机制：推荐使用"加密后MAC"模式(encrypt-then-MAC)，或直接使用AEAD(认证加密)方案。
优先考虑高级接口：项目提供了Fernet和AEAD模块，这些高级接口已经正确处理了安全和认证问题，应优先考虑使用。

核心Cipher类

Cipher类是pyca/cryptography中对称加密的核心类，它组合了加密算法和工作模式。

基本用法示例

import os
from cryptography.hazmat.primitives.ciphers import Cipher, algorithms, modes

# 生成随机密钥和初始向量
key = os.urandom(32)  # AES-256需要32字节密钥
iv = os.urandom(16)   # AES块大小是16字节

# 创建Cipher对象
cipher = Cipher(algorithms.AES(key), modes.CBC(iv))

# 加密过程
encryptor = cipher.encryptor()
ciphertext = encryptor.update(b"秘密消息") + encryptor.finalize()

# 解密过程
decryptor = cipher.decryptor()
plaintext = decryptor.update(ciphertext) + decryptor.finalize()

类方法说明

encryptor(): 返回加密上下文对象
decryptor(): 返回解密上下文对象

支持的加密算法

pyca/cryptography提供了多种对称加密算法实现：

弱算法(不推荐使用)

TripleDES(3DES)
- 已知存在密码分析缺陷
- 性能极差，新应用不应使用
ARC4(Alleged RC4)
- 初始输出流存在严重弱点
- 强烈建议避免使用
SM4
- 中国国家标准算法
- 仅用于兼容性需求

工作模式详解

pyca/cryptography支持多种块密码工作模式：

常用模式

CBC模式(Cipher Block Chaining)
- 需要填充(Padding)
- IV必须随机且不重复
- 示例：
```
iv = os.urandom(16)
mode = modes.CBC(iv)
```
CTR模式(Counter)
- 将块密码转换为流密码
- 不需要填充
- nonce必须唯一
GCM模式(Galois/Counter Mode)
- 认证加密(AEAD)模式
- 同时提供加密和认证
- 推荐使用AESGCM而非此模式
- 参数：
  - initialization_vector: 通常12字节
  - tag: 认证标签(通常16字节)
  - min_tag_length: 最小标签长度(默认16)