本教程详细介绍了如何使用 python 的 cryptography 库中的 fernet 模块实现文件的加密与解密操作。文章将涵盖 fernet 密钥的生成、管理与重用，以及如何在文件中安全地执行加密和解密过程，并强调密钥安全存储的重要性，确保数据机密性。
1. 引言：cryptography.fernet 简介
在信息安全日益重要的今天，对敏感数据进行加密是保护其机密性的基本手段。Python 的 cryptography 库提供了一套强大且易于使用的加密工具，其中 fernet 模块是实现对称加密的理想选择。Fernet 是一种基于 AES 算法的对称加密方案，它确保了消息的认证性、完整性和机密性，并且易于集成到应用程序中。
Fernet 的核心原理在于使用一个共享的密钥进行数据的加密和解密。这意味着，加密数据所使用的密钥必须与解密数据所使用的密钥完全一致。如果密钥丢失或泄露，数据将无法恢复或面临被未授权访问的风险。
2. 核心概念：密钥生成与 Fernet 实例
在使用 Fernet 进行文件加密和解密之前，我们需要理解其两个关键概念：密钥生成和 Fernet 实例的创建。
2.1 密钥生成
Fernet 密钥是一个32字节的 URL 安全的 Base64 编码字符串。它是对称加密的基础，必须严格保密。通过 Fernet.generate_key() 方法可以生成一个全新的密钥。
立即学习“Python免费学习笔记（深入）”；
from cryptography.fernet import Fernet# 生成一个 Fernet 密钥key = Fernet.generate_key()print(f"生成的 Fernet 密钥 (Base64编码): {key.decode()}")
重要提示： 每次调用 Fernet.generate_key() 都会生成一个全新且不同的密钥。对于需要持久化加密的数据，您必须将生成的密钥保存下来并在后续的解密操作中重用它。
2.2 Fernet 实例创建
拥有密钥后，您可以使用它来创建一个 Fernet 实例。这个实例将用于执行实际的加密和解密操作。
# 使用生成的密钥创建 Fernet 实例cipher = Fernet(key)
3. 文件加密与解密操作
Fernet 实例提供了 encrypt() 和 decrypt() 方法来处理字节数据。对于文件操作，我们通常需要以二进制模式读取文件内容，进行加密或解密，然后再将处理后的内容写入文件。
3.1 原地加密与解密实现
以下代码示例展示了如何在一个函数中实现文件的原地（in-place）加密和解密。这意味着文件内容会被直接替换为加密或解密后的数据。
import osfrom cryptography.fernet import Fernetfrom cryptography.fernet import InvalidToken # 用于处理解密失败异常def process_file_in_place(filename: str, cipher: Fernet, action: str, debug: bool = False): """ 对文件内容进行原地加密或解密。 Args: filename (str): 要处理的文件路径。 cipher (Fernet): Fernet 加密实例。 action (str): 操作类型，可以是 "encrypt" 或 "decrypt"。 debug (bool): 是否在加密后打印加密内容。 """ # 以二进制读写模式打开文件 (rb+ 允许读写，文件指针初始在开头) with open(filename, "rb+") as data_file: content = data_file.read() # 读取文件所有内容 # 根据指定操作执行加密或解密 processed_content = b"" if action == "encrypt": processed_content = cipher.encrypt(content) if debug: print(f"加密后的内容 (bytes): {processed_content}") elif action == "decrypt": try: processed_content = cipher.decrypt(content) if debug: print(f"解密后的内容 (bytes): {processed_content}") except InvalidToken: print(f"错误: 无法解密文件 '{filename}'。可能是密钥不匹配或数据已损坏。") return # 解密失败，退出函数 else: raise ValueError("操作类型必须是 'encrypt' 或 'decrypt'") # 将文件指针移到文件开头 data_file.seek(0) # 写入处理后的内容 data_file.write(processed_content) # 如果新内容比旧内容短，则截断文件，确保文件大小正确 data_file.truncate()if __name__ == "__main__": test_filename = "example_data.txt" original_text = "Hello, world! This is a secret message that needs to be protected." # 1. 创建一个原始的明文文件 with open(test_filename, "w", encoding="utf-8") as f: f.write(original_text) print(f"原始文件 '{test_filename}' 内容: {original_text}") # 2. 生成一个 Fernet 密钥并创建实例 # 注意：此密钥仅用于本次运行，实际应用中需要持久化存储 key_for_example = Fernet.generate_key() cipher_for_example = Fernet(key_for_example) print(f"生成的 Fernet 密钥 (Base64编码): {key_for_example.decode()}") # 3. 加密文件 print("n--- 执行加密 ---") process_file_in_place(test_filename, cipher_for_example, "encrypt", debug=True) with open(test_filename, "rb") as f: print(f"加密后文件 '{test_filename}' 的二进制内容 (部分): {f.read()[:50]}...") # 只打印前50字节 # 4. 解密文件 print("n--- 执行解密 ---") process_file_in_place(test_filename, cipher_for_example, "decrypt") with open(test_filename, "r", encoding="utf-8") as f: # 解密后内容可按文本读取 decrypted_text = f.read() print(f"解密后文件 '{test_filename}' 内容: {decrypted_text}") # 5. 验证解密内容是否与原始内容匹配 assert decrypted_text == original_text print("n验证成功：解密内容与原始内容一致。") # 清理测试文件 if os.path.exists(test_filename): os.remove(test_filename)
代码解析：
open(filename, “rb+”)：以二进制读写模式打开文件。r 表示读，b 表示二进制，+ 表示同时允许写操作。文件指针初始位于文件开头。data_file.read()：读取文件的全部内容。对于大文件，可能需要分块读取和处理。cipher.encrypt(content) / cipher.decrypt(content)：执行加密或解密操作。这些方法接受并返回字节串（bytes）。data_file.seek(0)：将文件指针重新定位到文件开头，以便从头开始写入新内容。data_file.write(processed_content)：将加密或解密后的内容写入文件。data_file.truncate()：非常重要！ 如果新写入的内容比原始内容短，文件末尾可能会保留旧数据。truncate() 方法会将文件截断到当前文件指针位置，从而清除多余的旧数据。
4. 密钥管理：持久化与重用
在实际应用中，每次运行程序都生成新密钥是不可行的。为了能够在不同时间点或不同程序实例之间加密和解密数据，密钥必须被持久化存储并重用。
4.1 正确的密钥持久化方法
正确的密钥持久化
以上就是Python cryptography.fernet 实现文件加密与解密教程的详细内容，更多请关注创想鸟其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/1379075.html
微信扫一扫 
支付宝扫一扫 
