Protección contra escritura de presentaciones en PHP

Introducción

Una contraseña de protección contra escritura restringe la modificación de una presentación, pero no cifra su contenido. Los usuarios pueden cargar y ver una presentación protegida contra escritura sin la contraseña. Según la aplicación, también pueden editar el contenido y guardarlo con otro nombre, por lo que la protección contra escritura no debe considerarse un mecanismo de confidencialidad.

Una contraseña de apertura tiene un propósito diferente: cifra la presentación y es necesaria para cargar su contenido. Para cifrar una presentación o validar una contraseña de apertura, consulte Presentaciones protegidas con contraseña.

Los flujos de trabajo en este artículo se aplican tanto a presentaciones PPT como PPTX. Los ejemplos utilizan archivos PPTX; al guardar en PPT, use la extensión .ppt y el formato de guardado PPT correspondiente.

Establecer protección contra escritura en una presentación

Utilice ProtectionManager::setWriteProtection para asignar una contraseña que permita modificar una presentación. Guardar la presentación conserva la configuración de protección.

use aspose\slides\Presentation;
use aspose\slides\SaveFormat;

$presentation = new Presentation("pres.pptx");
try {
    $presentation->getProtectionManager()->setWriteProtection("modify_password");
    $presentation->save("write-protected-pres.pptx", SaveFormat::Pptx);
} finally {
    $presentation->dispose();
}

Cargar una presentación protegida contra escritura

Dado que la protección contra escritura no cifra el contenido de la presentación, no se necesita una contraseña para cargarla. La contraseña solo es relevante al validar la autorización para modificar la presentación protegida.

use aspose\slides\Presentation;

$presentation = new Presentation("write-protected-pres.pptx");
try {
    echo("Slide count: " . $presentation->getSlides()->size() . "\n");
} finally {
    $presentation->dispose();
}

No pase una contraseña de protección contra escritura a LoadOptions::setPassword. Ese método acepta una contraseña de apertura para contenido cifrado. Si una presentación tiene ambos tipos de protección, proporcione la contraseña de apertura para cargarla y gestione la contraseña de protección contra escritura por separado.

Eliminar la protección contra escritura de una presentación

Utilice ProtectionManager::removeWriteProtection para eliminar la restricción de modificación y, a continuación, guarde la presentación.

use aspose\slides\Presentation;
use aspose\slides\SaveFormat;

$presentation = new Presentation("write-protected-pres.pptx");
try {
    $presentation->getProtectionManager()->removeWriteProtection();
    $presentation->save("write-protection-removed.pptx", SaveFormat::Pptx);
} finally {
    $presentation->dispose();
}

Comprobar si una presentación está protegida contra escritura

Para inspeccionar un archivo sin crear una instancia completa de Presentation, llame a PresentationFactory::getPresentationInfo y examine PresentationInfo::isWriteProtected. El método utiliza NullableBool y devuelve NullableBool::True cuando se detecta protección contra escritura.

use aspose\slides\NullableBool;
use aspose\slides\PresentationFactory;

$presentationInfo = PresentationFactory::getInstance()->getPresentationInfo("write-protected-pres.pptx");

if ($presentationInfo->isWriteProtected() == NullableBool::True) {
    echo("The presentation is write protected.\n");
} else {
    echo("Write protection was not detected.\n");
}

La sobrecarga de flujo de PresentationFactory::getPresentationInfo proporciona la misma información para una presentación suministrada como flujo.

Validar una contraseña de protección contra escritura

Utilice PresentationInfo::checkWriteProtection para validar una contraseña de modificación sin cargar la presentación completa. Primero compruebe PresentationInfo::isWriteProtected para que la aplicación solicite o valide una contraseña solo cuando exista protección contra escritura.

use aspose\slides\NullableBool;
use aspose\slides\PresentationFactory;

$presentationInfo = PresentationFactory::getInstance()->getPresentationInfo("write-protected-pres.pptx");

if ($presentationInfo->isWriteProtected() != NullableBool::True) {
    echo("The presentation is not write protected.\n");
} elseif ($presentationInfo->checkWriteProtection("modify_password")) {
    echo("The write-protection password is correct.\n");
} else {
    echo("The write-protection password is incorrect.\n");
}

PresentationInfo::checkWriteProtection valida solo la contraseña de protección contra escritura. No valida una contraseña de apertura ni determina si se puede cargar contenido cifrado. Por el contrario, PresentationInfo::checkPassword valida únicamente una contraseña de apertura. Si ya se ha cargado una presentación completa, ProtectionManager::checkWriteProtection ofrece la comprobación equivalente de protección contra escritura a través de su gestor de protección.

En aplicaciones de producción, no registre contraseñas ni las incluya en mensajes de diagnóstico. Evite intentos de validación repetidos innecesarios y mantenga las contraseñas en memoria solo el tiempo necesario.

Preguntas frecuentes

¿La protección contra escritura cifra una presentación?

No. Restringe la modificación pero deja el contenido de la presentación disponible para cargarlo y visualizarlo.

¿Se requiere la contraseña de protección contra escritura para abrir una presentación?

No. Sólo se necesita una contraseña de apertura para cargar el contenido cifrado de la presentación.

¿Puede una presentación tener tanto una contraseña de apertura como una contraseña de protección contra escritura?

Sí. Proporcione la contraseña de apertura mediante las opciones de carga para abrir la presentación cifrada y valide la contraseña de protección contra escritura por separado cuando se requiera autorización para modificarla.