Criptografar um documento

A criptografia é o processo que traduz texto legível em sequências de bytes sem sentido, de forma que só possa ser lido pela pessoa que possui a chave de descriptografia ou o código secreto. Este processo desempenha um papel importante na segurança do seu conteúdo. Ajuda a codificar o conteúdo, verificar a origem de um documento, provar que o conteúdo não foi modificado após o envio e garantir que os dados do documento estão seguros.

Este artigo explica como Aspose.Words permite criptografar um documento e como verificar se um documento possui criptografia ou não.

Criptografar com senha

Para criptografar um documento, use a propriedade senha para fornecer uma senha que funcione como uma chave de criptografia. Isso modificará o conteúdo do seu documento e o tornará ilegível. O documento criptografado exigirá que essa senha seja inserida antes de poder ser aberto.

Você pode encontrar a propriedade senha apropriada para o formato necessário. Cada formato de salvamento de documento no módulo aspose.words.saving possui uma classe correspondente contendo opções de salvamento para este formato. Por exemplo, a propriedade password na classe DocSaveOptions para DOC ou a propriedade password na classe OoxmlSaveOptions para DOCX, DOCM, DOTX, DOTM e FlatOpc.

Observe que apenas alguns formatos de documento oferecem suporte à criptografia. Por exemplo, o RTF não oferece suporte à criptografia.

A tabela abaixo lista os formatos e algoritmos de criptografia suportados pelo Aspose.Words:

Formatar	Criptografia suportada durante o carregamento	Criptografia suportada ao salvar
DOC, DOT	Criptografia XORCriptografia RC4 de 40 bitsCryptoAPI RC4 Encryption	Criptografia RC4 (40 bits)
DOCX, DOTX, DOCM, DOTM, FlatOPC, FlatOpcTemplate, FlatOpcMacroEnabled, FlatOpcTemplateMacroEnabled	Criptografia padrão ECMA-376Criptografia ágil ECMA-376	Criptografia padrão ECMA-376 (AES128 + SHA1)
ODT, OTT	Criptografia ODF (Blowfish/AES)	Criptografia ODF (AES256 + SHA256)
PDF		Criptografia RC4 (40/128 bits)

O exemplo de código a seguir mostra como criptografar um documento com uma senha:

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)

Verifique se um documento está criptografado

Em alguns casos, você pode ter um documento ilegível e querer ter certeza de que o documento está criptografado e não corrompido ou compactado.

Para detectar se um documento está criptografado e se é necessária uma senha, você pode usar a propriedade is_encrypted da classe FileFormatInfo. Esta propriedade também permitirá que você execute alguma ação antes de carregar um documento, por exemplo, informar a um usuário para fornecer uma senha.

O exemplo de código a seguir mostra como detectar a criptografia do documento:

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)

Abra um documento com ou sem senha

Quando tivermos certeza de que um documento está criptografado, podemos tentar abri-lo sem senha, o que deve levar a uma exceção.

O exemplo de código a seguir mostra como tentar abrir um documento criptografado sem senha:

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"))

Depois de vermos que um documento criptografado não pode ser aberto sem uma senha, podemos tentar abri-lo digitando a senha.

O exemplo de código a seguir mostra como tentar abrir um documento criptografado com uma senha:

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())