Proteggere e rimuovere la protezione

Le cartelle di lavoro di Excel spesso memorizzano informazioni finanziarie, aziendali o personali sensibili che devono essere protette da accessi non autorizzati. Aspose.Cells for Node.js via Java offre una serie completa di funzionalità di protezione che rispecchiano le capacità di Microsoft Excel, consentendo di proteggere i dati a livello di file, di cartella di lavoro e di foglio di lavoro.

Crittografare e decrittografare i file Excel

Una password impostata su un file Excel impedisce agli utenti non autorizzati di aprire o visualizzare il contenuto della cartella di lavoro. Per crittografare una cartella di lavoro, assegnare una stringa di password a workbook.getSettings().setPassword(...) e quindi salvare la cartella di lavoro. Aspose.Cells scrive il file in forma crittografata. Per aprire una cartella di lavoro crittografata per la decrittografia, creare un’istanza di un oggetto LoadOptions, impostare loadOptions.setPassword(...) sulla stessa password utilizzata durante la crittografia e passarla al costruttore Workbook. Aspose.Cells applica la password fornita in modo trasparente, così che il resto del codice possa interagire con il contenuto decrittografato come se il file fosse una normale cartella di lavoro.

const AsposeCells = require("aspose.cells");
let workbook = new AsposeCells.Workbook();
let sheet = workbook.getWorksheets().get(0);
let cell = sheet.getCells().get("A1");
cell.putValue("Confidential Data");
workbook.getSettings().setPassword("OpenPassword123");
workbook.save("encrypted.xlsx");
let loadOptions = new AsposeCells.LoadOptions();
loadOptions.setPassword("OpenPassword123");
let decryptedWorkbook = new AsposeCells.Workbook("encrypted.xlsx", loadOptions);
console.log("Decrypted cell A1 value: " + decryptedWorkbook.getWorksheets().get(0).getCells().get("A1").getStringValue());

Protezione in sola lettura (password per la modifica)

Excel supporta due distinti livelli di password. Il primo è una password di apertura, che crittografa il file stesso ed è trattato nella sezione precedente. Il secondo è una password di modifica, che non impedisce agli utenti di aprire la cartella di lavoro; al contrario, Excel consiglia di aprire il file in modalità di sola lettura a meno che non venga fornita la password di modifica. Configurare questo comportamento in Aspose.Cells tramite workbook.getSettings().getWriteProtection(). Impostare la relativa proprietà Password sulla password di modifica e la proprietà Author per identificare chi ha applicato la protezione. Utilizzare il metodo writeProtection.validatePassword(string) per controllare se la password di modifica fornita è corretta, restituendo true in caso di corrispondenza e false altrimenti.

const AsposeCells = require("aspose.cells");
let workbook = new AsposeCells.Workbook();
// Scrivi un valore di esempio nella cella A1 del primo foglio di lavoro
workbook.getWorksheets().get(0).getCells().get("A1").putValue("Sample Data");
// Configura la protezione da scrittura: imposta la password per modificare e l'autore
workbook.getSettings().getWriteProtection().setPassword("ModifyPwd");
workbook.getSettings().getWriteProtection().setAuthor("AuthorName");
// Salva la cartella di lavoro in modo che la protezione da scrittura venga mantenuta
workbook.save("WriteProtectedWorkbook.xlsx");
// Valida la password per modificare utilizzando la password corretta
let isCorrectValid = workbook.getSettings().getWriteProtection().validatePassword("ModifyPwd");
console.log("ValidatePassword(\"ModifyPwd\") returned: " + isCorrectValid);
// Valida la password per modificare utilizzando una password errata per dimostrare l'altro ramo
let isWrongValid = workbook.getSettings().getWriteProtection().validatePassword("WrongPwd");
console.log("ValidatePassword(\"WrongPwd\") returned: " + isWrongValid);

Proteggere e rimuovere la protezione della struttura della cartella di lavoro

La protezione della struttura della cartella di lavoro impedisce ad altri utenti di visualizzare fogli di lavoro nascosti, aggiungere nuovi fogli di lavoro, spostare fogli di lavoro, eliminare fogli di lavoro, nascondere fogli di lavoro o rinominare fogli di lavoro. Lo stato protetto si applica alla struttura del foglio anziché al contenuto delle celle all’interno di qualsiasi foglio. Per applicare la protezione della struttura, chiamare workbook.protect(ProtectionType.Structure, "password"). Per rimuovere la protezione, chiamare workbook.unprotect("password") e fornire la password corretta. Il valore enum ProtectionType.Structure è utilizzato qui ed è distinto da altri tipi di protezione come ProtectionType.Windows.

const AsposeCells = require("aspose.cells");
let workbook = new AsposeCells.Workbook();
// Aggiungi un secondo foglio di lavoro
workbook.getWorksheets().add();
// Scrivi un valore di esempio nella cella A1 del primo foglio di lavoro
workbook.getWorksheets().get(0).getCells().get(0, 0).putValue("Sample Data");
// Proteggi la struttura della cartella di lavoro
workbook.protect(AsposeCells.ProtectionType.STRUCTURE, "StructPwd");
// Salva la cartella di lavoro come structure_protected.xlsx
let filePath = "structure_protected.xlsx";
workbook.save(filePath);
// Ricarica il file in una nuova istanza di Workbook
let loadedWorkbook = new AsposeCells.Workbook(filePath);
// Rimuovi la protezione della struttura
loadedWorkbook.unprotect("StructPwd");
// Stampa il messaggio di conferma
console.log("Structure protection has been successfully removed from the workbook.");

Proteggere e rimuovere la protezione dei fogli di lavoro

La protezione del foglio di lavoro blocca le celle di un foglio di lavoro contro modifiche accidentali o intenzionali. Gli utenti non possono modificare le celle bloccate senza fornire la password. Questa è la protezione tipica utilizzata per salvaguardare formule, intestazioni o aree designate per l’inserimento dei dati nei fogli di calcolo condivisi. Per proteggere un foglio di lavoro, chiamare worksheet.protect(ProtectionType.All, "password"). L’uso di ProtectionType.All abilita ogni opzione di protezione disponibile, come la selezione di celle bloccate, la formattazione delle celle, l’inserimento di righe e colonne e l’eliminazione di righe e colonne. Per rimuovere la protezione, chiamare worksheet.unprotect("password") con la password corretta. È disponibile un controllo più granulare combinando altri tipi di protezione come Contents, Objects e Scenarios tramite l’OR bit per bit.

const AsposeCells = require("aspose.cells");
let workbook = new AsposeCells.Workbook();
let sheet = workbook.getWorksheets().get(0);
sheet.getCells().get("A1").putValue("Sample Data");
sheet.protect(AsposeCells.ProtectionType.ALL, "SheetPwd");
workbook.save("sheet_protected.xlsx");
let workbookReloaded = new AsposeCells.Workbook("sheet_protected.xlsx");
let sheetReloaded = workbookReloaded.getWorksheets().get(0);
sheetReloaded.unprotect("SheetPwd");
console.log("Worksheet protection removed successfully.");

Aggiungere e convalidare le firme digitali

Una firma digitale garantisce ai destinatari che il contenuto della cartella di lavoro è autentico e non è stato alterato da quando è stato firmato. Aspose.Cells fornisce il supporto per le firme digitali tramite classi come AsposeCells.DigitalSignature e AsposeCells.DigitalSignatureCollection. Il flusso tipico crea un AsposeCells.DigitalSignature direttamente da un file di certificato .pfx insieme alla relativa password e ai commenti di firma, aggiunge la firma a una DigitalSignatureCollection e applica la raccolta alla cartella di lavoro tramite workbook.addDigitalSignature(DigitalSignatureCollection). La proprietà DigitalSignature.Comments può registrare il contesto della firma, come l’ora e lo scopo della firma. Qualsiasi modifica apportata alla cartella di lavoro dopo la firma invalida la firma, quindi una fase di convalida sul lato ricevente può rilevare eventuali manomissioni.

const AsposeCells = require("aspose.cells");
let signature = new AsposeCells.DigitalSignature("signature.pfx", "pfx-password", "Signed by Aspose.Cells", new Date());
let signatures = new AsposeCells.DigitalSignatureCollection();
signatures.add(signature);
let workbook = new AsposeCells.Workbook();
workbook.getWorksheets().get(0).getCells().get("A1").putValue("Sample Value");
workbook.addDigitalSignature(signatures);
workbook.save("signed_workbook.xlsx");
console.log("The workbook has been digitally signed.");
Prestazioni Inserisci una tabella pivot