Protéger les présentations par mot de passe en JavaScript
Vue d’ensemble
Un mot de passe d’ouverture chiffre une présentation. Le mot de passe correct est nécessaire pour charger et afficher le contenu de la présentation, de sorte que cette protection assure la confidentialité.
Un mot de passe d’ouverture est différent d’un mot de passe de protection en écriture. La protection en écriture restreint la modification mais ne chiffre pas le contenu et n’empêche pas le chargement de la présentation. Pour gérer les mots de passe de modification des présentations, consultez Protéger les présentations en écriture.
Les flux de travail ci‑dessous s’appliquent aux présentations PPT et PPTX. Les exemples utilisent les deux formats lorsque le comportement basé sur les fichiers ou les flux est important.
Chiffrer une présentation avec un mot de passe d’ouverture
Utilisez ProtectionManager.encrypt pour attribuer un mot de passe d’ouverture. Puis utilisez Presentation.save pour enregistrer la présentation chiffrée.
L’exemple suivant chiffre une présentation PPTX :
const slides = require("aspose.slides.via.java");
const presentation = new slides.Presentation("pres.pptx");
try {
presentation.getProtectionManager().encrypt("open_password");
presentation.save("encrypted-pres.pptx", slides.SaveFormat.Pptx);
} finally {
presentation.dispose();
}
Conserver les propriétés du document publiques
Par défaut, Aspose.Slides inclut les propriétés du document dans le chiffrement de la présentation. La méthode ProtectionManager.setEncryptDocumentProperties contrôle ce comportement indépendamment du chiffrement du contenu des diapositives. Passez false avant d’appeler ProtectionManager.encrypt lorsqu’un système d’indexation, de classification, de recherche ou de gestion de documents doit lire les métadonnées sans le mot de passe d’ouverture.
L’exemple suivant crée une présentation PPTX chiffrée tout en laissant ses propriétés intégrées publiques :
const slides = require("aspose.slides.via.java");
const presentation = new slides.Presentation();
try {
const properties = presentation.getDocumentProperties();
properties.setAuthor("Contoso Knowledge Management");
properties.setTitle("Quarterly Product Roadmap");
properties.setKeywords("roadmap, planning, internal");
presentation.getSlides().get_Item(0).setName("Encrypted presentation content");
presentation.getProtectionManager().setEncryptDocumentProperties(false);
presentation.getProtectionManager().encrypt("open_password");
presentation.save("public-properties-encrypted.pptx", slides.SaveFormat.Pptx);
} finally {
presentation.dispose();
}
Passer false à ProtectionManager.setEncryptDocumentProperties ne rend pas les diapositives, les maîtres, les dispositions, les formes, les médias ou tout autre contenu de la présentation publics. Cela ne concerne que les propriétés du document. Pour lire ces propriétés sans charger le contenu chiffré, consultez Gérer les propriétés de la présentation.
Charger une présentation chiffrée
Définissez LoadOptions.setPassword avec le mot de passe d’ouverture et transmettez les options à Presentation lors du chargement du fichier. Le chargement échoue lorsqu’un mot de passe d’ouverture est requis mais que le mot de passe fourni est manquant ou incorrect.
const slides = require("aspose.slides.via.java");
const loadOptions = new slides.LoadOptions();
loadOptions.setPassword("open_password");
const presentation = new slides.Presentation("encrypted-pres.pptx", loadOptions);
try {
// Travailler avec la présentation déchiffrée.
} finally {
presentation.dispose();
}
Supprimer le chiffrement d’une présentation
Chargez la présentation avec son mot de passe d’ouverture, appelez ProtectionManager.removeEncryption et enregistrez le résultat. La présentation enregistrée peut alors être chargée sans mot de passe.
const slides = require("aspose.slides.via.java");
const loadOptions = new slides.LoadOptions();
loadOptions.setPassword("open_password");
const presentation = new slides.Presentation("encrypted-pres.pptx", loadOptions);
try {
presentation.getProtectionManager().removeEncryption();
presentation.save("encryption-removed.pptx", slides.SaveFormat.Pptx);
} finally {
presentation.dispose();
}
Valider un mot de passe d’ouverture avant le chargement
Utilisez PresentationFactory.getPresentationInfo pour obtenir PresentationInfo sans créer d’instance complète de présentation. Vérifiez PresentationInfo.isPasswordProtected avant de demander ou valider un mot de passe. Lorsqu’une protection est présente, validez la valeur fournie avec PresentationInfo.checkPassword.
Flux de travail avec chemin de fichier
L’exemple suivant valide un mot de passe d’ouverture pour un fichier PPTX, transmet la valeur validée à LoadOptions.setPassword, puis charge la présentation complète :
const slides = require("aspose.slides.via.java");
const filePath = "protected-presentation.pptx";
const password = "open_password";
const presentationInfo = slides.PresentationFactory.getInstance().getPresentationInfo(filePath);
if (!presentationInfo.isPasswordProtected()) {
console.log("The presentation does not have an opening password.");
} else if (!presentationInfo.checkPassword(password)) {
console.log("The opening password is incorrect.");
} else {
const loadOptions = new slides.LoadOptions();
loadOptions.setPassword(password);
const presentation = new slides.Presentation(filePath, loadOptions);
try {
console.log("The presentation was validated and loaded successfully.");
} finally {
presentation.dispose();
}
}
Flux de travail avec flux
Utilisez PresentationFactory.getPresentationInfoFromStream pour inspecter un flux lisible Node.js. Après que le flux d’inspection a été consommé, créez un nouveau flux avant de charger la présentation complète avec Presentation.createPresentationFromStream.
L’exemple suivant utilise un fichier PPT :
const slides = require("aspose.slides.via.java");
const fs = require("fs");
const filePath = "protected-presentation.ppt";
const password = "open_password";
const presentationFactory = slides.PresentationFactory.getInstance();
const infoStream = fs.createReadStream(filePath);
slides.PresentationFactory.getPresentationInfoFromStream(presentationFactory, infoStream, function(infoError, presentationInfo) {
if (infoError) {
console.log("The presentation information could not be read: " + infoError.message);
} else if (!presentationInfo.isPasswordProtected()) {
console.log("The presentation does not have an opening password.");
} else if (!presentationInfo.checkPassword(password)) {
console.log("The opening password is incorrect.");
} else {
const loadOptions = new slides.LoadOptions();
loadOptions.setPassword(password);
const presentationStream = fs.createReadStream(filePath);
slides.Presentation.createPresentationFromStream(presentationStream, loadOptions, function(loadError, presentation) {
if (loadError) {
console.log("The presentation could not be loaded: " + loadError.message);
} else {
try {
console.log("The presentation was validated and loaded successfully.");
} finally {
presentation.dispose();
}
}
});
}
});
Valeurs de retour de checkPassword
PresentationInfo.checkPassword renvoie true uniquement lorsque la présentation possède un mot de passe d’ouverture et que le mot de passe fourni est correct. Il renvoie false dans chacun de ces cas :
- Le mot de passe est incorrect.
- La présentation ne possède pas de mot de passe d’ouverture.
- Le mot de passe fourni est
nullou vide.
Le comportement est le même pour les présentations PPT et PPTX.
Vérifier si une présentation chargée est chiffrée
Après avoir chargé une présentation avec le mot de passe correct, inspectez ProtectionManager.isEncrypted pour confirmer que la présentation source était chiffrée. Pour détecter la protection par mot de passe d’ouverture avant le chargement, utilisez PresentationInfo.isPasswordProtected comme indiqué ci‑dessus.
const slides = require("aspose.slides.via.java");
const loadOptions = new slides.LoadOptions();
loadOptions.setPassword("open_password");
const presentation = new slides.Presentation("encrypted-pres.pptx", loadOptions);
try {
const isEncrypted = presentation.getProtectionManager().isEncrypted();
console.log("The presentation is encrypted: " + isEncrypted);
} finally {
presentation.dispose();
}
Recommandations de sécurité
Sécurité
Ne consignez pas les mots de passe d’ouverture et ne les incluez pas dans les messages de diagnostic. Évitez les tentatives de validation répétées inutiles, conservez les mots de passe en mémoire uniquement le temps nécessaire, et réutilisez un résultat de validation réussi lors du chargement immédiat de la présentation.
Les propriétés publiques du document peuvent divulguer les noms d’auteur, les titres, les sujets, les mots‑clé, les informations d’entreprise, les commentaires et les valeurs personnalisées même si le contenu de la présentation est chiffré. Chiffrez les métadonnées sensibles avec la présentation. Laisser les propriétés publiques doit être une décision explicite prise uniquement lorsque les systèmes doivent indexer, classer, rechercher ou gérer le fichier sans mot de passe d’ouverture.
Protéger une présentation par mot de passe en ligne
- Ouvrez l’application Aspose.Slides Lock.
- Sélectionnez ou téléversez la présentation.
- Saisissez un mot de passe pour la protection de visualisation.
- Saisissez éventuellement un mot de passe distinct pour la protection d’édition.
- Appliquez la protection et téléchargez le fichier résultant.
FAQ
Quelle est la différence entre un mot de passe d’ouverture et un mot de passe de protection en écriture ?
Un mot de passe d’ouverture chiffre la présentation et est requis pour charger son contenu. Un mot de passe de protection en écriture restreint la modification sans chiffrer le contenu.
Puis-je valider un mot de passe d’ouverture sans charger toutes les diapositives ?
Oui. Obtenez les informations de la présentation, vérifiez si une protection par mot de passe d’ouverture est présente, et validez le mot de passe avant de créer une instance complète de présentation.
Une application peut-elle lire les métadonnées sans le mot de passe d’ouverture ?
Oui, mais uniquement lorsque la présentation a été chiffrée avec le chiffrement des propriétés du document désactivé. L’application doit alors utiliser le mode de chargement uniquement des propriétés du document décrit dans Gérer les propriétés de la présentation.
Les flux de travail de vérification du mot de passe prennent-ils en charge à la fois PPT et PPTX ?
Oui. La détection et la validation du mot de passe basées sur le chemin de fichier et sur le flux se comportent de la même manière pour les présentations PPT et PPTX.