Proteger presentaciones con contraseña en JavaScript

De qué trata esta página

Cifrar, detectar, validar, abrir y descifrar presentaciones de PowerPoint PPT y PPTX protegidas con contraseña en JavaScript con Aspose.Slides.

Visión general

Una contraseña de apertura cifra una presentación. La contraseña correcta es necesaria para cargar y visualizar el contenido de la presentación, por lo que esta protección brinda confidencialidad.

Una contraseña de apertura es diferente de una contraseña de protección contra escritura. La protección contra escritura restringe la modificación, pero no cifra el contenido ni impide que se cargue la presentación. Para gestionar contraseñas para modificar presentaciones, consulte Write-Protect Presentations.

Los flujos de trabajo a continuación se aplican tanto a presentaciones PPT como PPTX. Los ejemplos utilizan ambos formatos cuando su comportamiento basado en archivos y basado en flujos es importante.

Cifrar una presentación con una contraseña de apertura

Utilice ProtectionManager.encrypt para asignar una contraseña de apertura. Luego use Presentation.save para guardar la presentación cifrada.

El siguiente ejemplo cifra una presentación 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();
}

Mantener las propiedades del documento públicas

Por defecto, Aspose.Slides incluye las propiedades del documento en el cifrado de la presentación. El método ProtectionManager.setEncryptDocumentProperties controla este comportamiento de forma independiente al cifrado del contenido de las diapositivas. Pase false antes de llamar a ProtectionManager.encrypt cuando un sistema de indexación, clasificación, búsqueda o gestión documental necesita leer los metadatos sin la contraseña de apertura.

El siguiente ejemplo crea una presentación PPTX cifrada manteniendo sus propiedades de documento incorporadas públicas:

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

Pasar false a ProtectionManager.setEncryptDocumentProperties no hace públicas las diapositivas, maestros, diseños, formas, medios u otro contenido de la presentación. Afecta solo a las propiedades del documento. Para leer esas propiedades sin cargar el contenido cifrado, consulte Manage Presentation Properties.

Cargar una presentación cifrada

Establezca LoadOptions.setPassword con la contraseña de apertura y pase las opciones a Presentation al cargar el archivo. La carga falla cuando se requiere una contraseña de apertura pero la contraseña suministrada falta o es incorrecta.

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 {
    // Trabajar con la presentación descifrada.
} finally {
    presentation.dispose();
}

Eliminar el cifrado de una presentación

Cargue la presentación con su contraseña de apertura, llame a ProtectionManager.removeEncryption y guarde el resultado. La presentación guardada puede entonces cargarse sin contraseña.

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

Validar una contraseña de apertura antes de cargar

Utilice PresentationFactory.getPresentationInfo para obtener PresentationInfo sin crear una instancia completa de la presentación. Verifique PresentationInfo.isPasswordProtected antes de solicitar o validar una contraseña. Cuando exista protección, valide el valor suministrado con PresentationInfo.checkPassword.

Flujo de trabajo con ruta de archivo

El siguiente ejemplo valida una contraseña de apertura para un archivo PPTX, pasa el valor validado a LoadOptions.setPassword y luego carga la presentación completa:

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

Flujo de trabajo con flujo

Utilice PresentationFactory.getPresentationInfoFromStream para inspeccionar un flujo legible de Node.js. Después de que el flujo de inspección se haya consumido, cree un nuevo flujo antes de cargar la presentación completa con Presentation.createPresentationFromStream.

El siguiente ejemplo usa un archivo 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();
                }
            }
        });
    }
});

Valores de retorno de checkPassword

PresentationInfo.checkPassword devuelve true solo cuando la presentación tiene una contraseña de apertura y la contraseña suministrada es correcta. Devuelve false en cada uno de los siguientes casos:

La contraseña es incorrecta.
La presentación no tiene una contraseña de apertura.
La contraseña suministrada es null o está vacía.

El comportamiento es el mismo para presentaciones PPT y PPTX.

Comprobar si una presentación cargada está cifrada

Después de cargar una presentación con la contraseña correcta, inspeccione ProtectionManager.isEncrypted para confirmar que la presentación fuente estaba cifrada. Para detectar la protección con contraseña de apertura antes de cargar, use PresentationInfo.isPasswordProtected como se mostró anteriormente.

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

Recomendaciones de seguridad

Seguridad

No registre las contraseñas de apertura ni las incluya en mensajes de diagnóstico. Evite intentos de validación repetidos e innecesarios, mantenga las contraseñas en memoria solo el tiempo necesario y reutilice un resultado de validación exitoso al cargar inmediatamente la presentación.

Las propiedades públicas del documento pueden revelar nombres de autores, títulos, asuntos, palabras clave, información de la empresa, comentarios y valores personalizados aunque el contenido de la presentación esté cifrado. Encripte los metadatos sensibles junto con la presentación. Mantener públicas las propiedades debe ser una decisión explícita que solo se tome cuando los sistemas deben indexar, clasificar, buscar o gestionar el archivo sin una contraseña de apertura.

Proteger con contraseña una presentación en línea

Abra la aplicación Aspose.Slides Lock.
Seleccione o cargue la presentación.
Introduzca una contraseña para la protección de visualización.
Opcionalmente introduzca una contraseña distinta para la protección de edición.
Aplique la protección y descargue el archivo resultante.

Ver también

Preguntas frecuentes

¿Cuál es la diferencia entre una contraseña de apertura y una contraseña de protección contra escritura?

Una contraseña de apertura cifra la presentación y es necesaria para cargar su contenido. Una contraseña de protección contra escritura restringe la modificación sin cifrar el contenido.

¿Puedo validar una contraseña de apertura sin cargar todas las diapositivas?

Sí. Obtenga la información de la presentación, compruebe si existe protección con contraseña de apertura y valide la contraseña antes de crear una instancia completa de la presentación.

¿Puede una aplicación leer los metadatos sin la contraseña de apertura?

Sí, pero solo cuando la presentación se cifró con la encriptación de propiedades del documento desactivada. Entonces la aplicación debe usar el modo de carga solo de propiedades del documento descrito en Manage Presentation Properties.

¿Los flujos de trabajo de comprobación de contraseñas admiten tanto PPT como PPTX?

Sí. La detección y validación de contraseñas basada en ruta de archivo y en flujos se comportan de la misma manera para presentaciones PPT y PPTX.

Visor de presentaciones