Chiffrer un document

Le cryptage est le processus qui traduit un texte lisible en séquences d’octets dénuées de sens afin qu’il ne puisse être lu que par la personne qui possède la clé de déchiffrement ou le code secret. Ce processus joue un rôle important dans la sécurisation de votre contenu. Il permet d’encoder le contenu, de vérifier l’origine d’un document, de prouver que le contenu n’a pas été modifié après son envoi et de garantir la sécurité des données du document.

Cet article explique comment Aspose.Words vous permet de crypter un document et comment vérifier si un document est crypté ou non.

Chiffrer avec mot de passe

Pour chiffrer un document, utilisez la propriété mot de passe pour fournir un mot de passe qui fonctionne comme une clé de chiffrement. Cela modifiera le contenu de votre document et le rendra illisible. Le document crypté nécessitera la saisie de ce mot de passe avant de pouvoir être ouvert.

Vous pouvez trouver la propriété mot de passe appropriée pour le format requis. Chaque format de sauvegarde de document dans le module aspose.words.saving possède une classe correspondante contenant des options de sauvegarde pour ce format. Par exemple, la propriété password dans la classe DocSaveOptions pour DOC ou la propriété password dans la classe OoxmlSaveOptions pour DOCX, DOCM, DOTX, DOTM et FlatOpc.

Notez que seuls certains formats de documents prennent en charge le cryptage. Par exemple, RTF ne prend pas en charge le cryptage.

Le tableau ci-dessous répertorie les formats et algorithmes de cryptage pris en charge par Aspose.Words:

Format	Cryptage pris en charge lors du chargement	Cryptage pris en charge lors de l’enregistrement
DOC, DOT	Cryptage XORCryptage RC4 40 bitsCryptoCryptage API RC4	Cryptage RC4 (40 bits)
DOCX, DOTX, DOCM, DOTM, FlatOPC, FlatOpcTemplate, FlatOpcMacroEnabled, FlatOpcTemplateMacroEnabled	Chiffrement standard ECMA-376Chiffrement agile ECMA-376	Cryptage standard ECMA-376 (AES128 + SHA1)
ODT, OTT	Cryptage ODF (Blowfish/AES)	Cryptage ODF (AES256 + SHA256)
PDF		Cryptage RC4 (40/128 bits)

L’exemple de code suivant montre comment chiffrer un document avec un mot de passe:

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)

Vérifier si un document est crypté

Dans certains cas, vous pouvez avoir un document illisible et vouloir être sûr que le document est crypté et non corrompu ou compressé.

Pour détecter si un document est chiffré et si un mot de passe est requis, vous pouvez utiliser la propriété is_encrypted de la classe FileFormatInfo. Cette propriété vous permettra également d’effectuer certaines actions avant de charger un document, par exemple demander à un utilisateur de fournir un mot de passe.

L’exemple de code suivant montre comment détecter le chiffrement du document:

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)

Ouvrir un document avec ou sans mot de passe

Lorsqu’on s’est assuré qu’un document est crypté, on peut tenter d’ouvrir ce document sans mot de passe, ce qui devrait conduire à une exception.

L’exemple de code suivant montre comment essayer d’ouvrir un document chiffré sans mot de passe:

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

Après avoir vu qu’un document crypté ne peut pas être ouvert sans mot de passe, nous pouvons essayer de l’ouvrir en entrant le mot de passe.

L’exemple de code suivant montre comment essayer d’ouvrir un document chiffré avec un mot de passe:

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