加密文档
Contents
[
Hide
]
加密是将可读文本转换为无意义的字节序列的过程，因此只有拥有解密密钥或密码的人才能读取它。此过程在保护您的内容方面发挥着重要作用。它有助于对内容进行编码，验证文档的来源，证明内容在发送后未被修改，并确保文档中的数据是安全的。
本文介绍了 Aspose.Words 如何允许您加密文档以及如何检查文档是否已加密。
使用密码加密
要加密文档，请使用 密码 属性提供充当加密密钥的密码。这将修改文档的内容并使其不可读。加密的文档需要输入此密码才能打开。
您可以找到所需格式的适当 密码 属性。 aspose.words.saving 模块中的每个文档保存格式都有一个相应的类，其中包含该格式的保存选项。例如，DOC 的 DocSaveOptions 类中的 password 属性，或 DOCX、DOCM、DOTX、DOTM 和 FlatOpc 的 OoxmlSaveOptions 类中的 password 属性。
请注意，只有某些文档格式支持加密。例如，RTF 不支持加密。
下表列出了Aspose.Words支持的格式和加密算法：
| 格式 | 加载时支持加密 | 保存时支持加密 |
|---|---|---|
| 文档，DOT | XOR 加密40 位 RC4 加密CryptoAPI RC4 加密 | RC4 加密（40 位） |
| DOCX、DOTX、DOCM、DOTM、FlatOPC、FlatOpcTemplate、FlatOpcMacro 启用、FlatOpcTemplateMacro 启用 | ECMA-376 标准加密ECMA-376 敏捷加密 | ECMA-376 标准加密 (AES128 + SHA1) |
| ODT、OTT | ODF 加密（Blowfish/AES） | ODF 加密（AES256 + SHA256） |
| RC4 加密（40/128 位） |
以下代码示例显示如何使用密码加密文档：
import aspose.words as aw
# Create a document.
doc = aw.Document()
builder = aw.DocumentBuilder(doc)
builder.write("Hello world!")
# DocSaveOptions only applies to Doc and Dot save formats.
options = aw.saving.DocSaveOptions(aw.SaveFormat.DOC);
// Set a password with which the document will be encrypted, and which will be required to open it.
options.password = "MyPassword"
doc.save(artifacts_dir + "DocSaveOptions.SaveAsDoc.doc", options)检查文档是否已加密
在某些情况下，您可能有一个无法读取的文档，并且希望确保该文档已加密且未损坏或压缩。
要检测文档是否已加密以及是否需要密码，可以使用 FileFormatInfo 类的 is_encrypted 属性。此属性还允许您在加载文档之前执行某些操作，例如，通知用户提供密码。
以下代码示例展示了如何检测文档加密：
import aspose.words as aw
# Create a document.
doc = aw.Document()
saveOptions = aw.saving.OdtSaveOptions(aw.SaveFormat.ODT)
saveOptions.password = "MyPassword"
doc.Save(artifacts_dir + "File.DetectDocumentEncryption.odt", saveOptions)
# Create a `FileFormatInfo` object for this document.
info = aw.FileFormatUtil.detect_file_format(artifacts_dir + "File.DetectDocumentEncryption.odt")
# Verify the encryption status of our document.
self.assertTrue(info.is_encrypted)使用或不使用密码打开文档
当我们确保文档已加密后，我们可以尝试在没有密码的情况下打开该文档，这应该会导致异常。
以下代码示例演示如何尝试在没有密码的情况下打开加密文档：
import aspose.words as aw
# Create a document.
doc = aw.Document()
builder = aw.DocumentBuilder(doc)
builder.write("Hello world!")
# OoxmlSaveOptions only applies to Docx, Docm, Dotx, Dotm, or FlatOpc formats.
options = aw.saving.OoxmlSaveOptions(aw.SaveFormat.DOCX)
# Set a password with which the document will be encrypted, and which will be required to open it.
options.password = "MyPassword"
doc.Save(artifacts_dir + "OoxmlSaveOptions.SaveAsDocx.docx", options)
# We will not be able to open this document with Microsoft Word or
# Aspose.Words without providing the correct password.
# The following line will throw an exception.
doc = aw.Document(artifacts_dir + "OoxmlSaveOptions.Password.docx"))当我们看到加密文档没有密码就无法打开后，我们就可以尝试通过输入密码来打开它。
以下代码示例演示如何尝试使用密码打开加密文档：
import aspose.words as aw
# Create a document.
doc = aw.Document()
builder = aw.DocumentBuilder(doc)
builder.write("Hello world!")
# OoxmlSaveOptions only applies to Docx, Docm, Dotx, Dotm, or FlatOpc formats.
options = aw.saving.OoxmlSaveOptions(aw.SaveFormat.DOCX)
# Set a password with which the document will be encrypted, and which will be required to open it.
options.password = "MyPassword"
doc.Save(artifacts_dir + "OoxmlSaveOptions.SaveAsDocx.docx", options)
# Open the encrypted document by passing the correct password in a `LoadOptions` object.
doc = aw.Document(artifacts_dir + "OoxmlSaveOptions.Password.docx", aw.loading.LoadOptions("MyPassword"))
self.assertEqual("Hello world!", doc.get_text().strip())