Crittografare un documento

La crittografia è il processo che traduce il testo leggibile in sequenze prive di significato di byte in modo che possa essere letto solo dalla persona che ha la chiave di decrittazione o il codice segreto. Questo processo svolge un ruolo importante nel proteggere i tuoi contenuti. Aiuta a codificare il contenuto, verificare l’origine di un documento, dimostrare che il contenuto non è stato modificato dopo l’invio e garantire che i dati dal documento siano al sicuro.

Questo articolo spiega come Aspose.Words consente di crittografare un documento e come verificare se un documento dispone di crittografia o meno.

Crittografare con password

Per crittografare un documento, utilizzare la proprietà Password per fornire una password che funzioni come chiave di crittografia. Ciò modificherà il contenuto del documento e lo renderà illeggibile. Il documento crittografato richiederà l’inserimento di questa password prima di poter essere aperto.

È possibile trovare la proprietà Password appropriata per il formato richiesto. Ogni formato di salvataggio del documento ha una classe corrispondente contenente le opzioni di salvataggio per questo formato. Ad esempio, la proprietà Password nella classe DocSaveOptions per DOC o la proprietà Password nella classe OoxmlSaveOptions per DOCX, DOCM, DOTX, DOTM, e FlatOpc.

Si noti che solo alcuni formati di documenti supportano la crittografia. Ad esempio, RTF non supporta la crittografia.

La tabella seguente elenca i formati e gli algoritmi di crittografia supportati da Aspose.Words:

Formato	Crittografia supportata durante il caricamento	Crittografia supportata durante il salvataggio
DOC, DOT	XOR encryption40-bit RC4 EncryptionCryptoAPI RC4 Encryption	RC4 Crittografia (40 bit)
DOCX, DOTX, DOCM, DOTM, FlatOPC, FlatOpcTemplate, FlatOpcMacroEnabled, FlatOpcTemplateMacroEnabled	ECMA-376 Standard EncryptionECMA-376 Crittografia agile	ECMA-376 Crittografia standard (AES128 + SHA1)
ODT, OTT	ODF Crittografia (Blowfish/AES)	ODF Crittografia (AES256 + SHA256)
PDF		RC4 Crittografia (40/128 bit)

Il seguente esempio di codice mostra come crittografare un documento con una password:

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Java.git.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

builder.write("Hello world!");

DocSaveOptions saveOptions = new DocSaveOptions();
saveOptions.setPassword("password");

doc.save(getArtifactsDir() + "WorkingWithDocSaveOptions.EncryptDocumentWithPassword.docx", saveOptions);

Controlla se un documento è crittografato

In alcuni casi, si può avere un documento illeggibile e vuole essere sicuri che il documento è crittografato e non danneggiato o compresso.

Per rilevare se un documento è crittografato e se è richiesta una password, è possibile utilizzare la proprietà IsEncrypted della classe FileFormatInfo. Questa proprietà consente anche di eseguire alcune azioni prima di caricare un documento, ad esempio, informare un utente di fornire una password.

Il seguente esempio di codice mostra come rilevare la crittografia del documento:

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Java.git.
FileFormatInfo info = FileFormatUtil.detectFileFormat(getMyDir() + "Encrypted.docx");
System.out.println(info.isEncrypted());

Aprire un documento con o senza password

Quando ci siamo assicurati che un documento sia crittografato, possiamo provare ad aprire questo documento senza una password, il che dovrebbe portare a un’eccezione.

Il seguente esempio di codice mostra come provare ad aprire un documento crittografato senza una password:

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Java.git.
// We will not be able to open this document with Microsoft Word or
// Aspose.Words without providing the correct password.
Document doc = new Document(getMyDir() + "Encrypted.docx");

Dopo aver visto che un documento crittografato non può essere aperto senza una password, possiamo provare ad aprirlo inserendo la password.

Il seguente esempio di codice mostra come provare ad aprire un documento crittografato con una password:

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Java.git.
Document doc = new Document(getMyDir() + "Encrypted.docx", new LoadOptions("docPassword"));

doc.save(getArtifactsDir() + "WorkingWithLoadOptions.LoadAndSaveEncryptedOdt.odt", new OdtSaveOptions("newPassword"));