在 Java 中对演示文稿进行密码保护

本页内容简介

在 Java 中使用 Aspose.Slides 对受密码保护的 PowerPoint PPT 和 PPTX 演示文稿进行加密、检测、验证、打开和解密。

概述

打开密码会对演示文稿进行加密。必须提供正确的密码才能加载和查看演示文稿内容，因此此保护提供了机密性。

打开密码不同于写保护密码。写保护限制修改，但不加密内容，也不会阻止加载演示文稿。要管理用于修改演示文稿的密码，请参阅Write-Protect Presentations。

以下工作流适用于 PPT 和 PPTX 演示文稿。当文件基于和流基于的行为重要时，示例会使用两种格式。

使用打开密码加密演示文稿

使用IProtectionManager.encrypt来分配打开密码。然后使用IPresentation.save来保存加密后的演示文稿。

以下示例对 PPTX 演示文稿进行加密：

import com.aspose.slides.Presentation;
import com.aspose.slides.SaveFormat;

Presentation presentation = new Presentation("pres.pptx");
try {
    presentation.getProtectionManager().encrypt("open_password");
    presentation.save("encrypted-pres.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

保持文档属性公开

默认情况下，Aspose.Slides 会在演示文稿加密中包含文档属性。IProtectionManager.setEncryptDocumentProperties 方法可以独立于幻灯片内容加密来控制此行为。在需要索引、分类、搜索或文档管理系统在没有打开密码的情况下读取元数据时，请在调用IProtectionManager.encrypt之前传入 false。

以下示例创建加密的 PPTX 演示文稿，同时保持其内置文档属性公开：

import com.aspose.slides.IDocumentProperties;
import com.aspose.slides.Presentation;
import com.aspose.slides.SaveFormat;

Presentation presentation = new Presentation();
try {
    IDocumentProperties 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", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

将 false 传递给IProtectionManager.setEncryptDocumentProperties 并不会使幻灯片、母版、布局、形状、媒体或其他演示文稿内容公开。它仅影响文档属性。要在不加载加密内容的情况下读取这些属性，请参阅Manage Presentation Properties。

加载加密的演示文稿

在加载文件时，将ILoadOptions.setPassword 设置为打开密码，并将该选项传递给Presentation。当需要打开密码但提供的密码缺失或不正确时，加载会失败。

import com.aspose.slides.LoadOptions;
import com.aspose.slides.Presentation;

LoadOptions loadOptions = new LoadOptions();
loadOptions.setPassword("open_password");

Presentation presentation = new Presentation("encrypted-pres.pptx", loadOptions);
try {
    // 对已解密的演示文稿进行操作。
} finally {
    presentation.dispose();
}

从演示文稿中移除加密

使用打开密码加载演示文稿，调用IProtectionManager.removeEncryption，并保存结果。随后保存的演示文稿即可在不使用密码的情况下加载。

import com.aspose.slides.LoadOptions;
import com.aspose.slides.Presentation;
import com.aspose.slides.SaveFormat;

LoadOptions loadOptions = new LoadOptions();
loadOptions.setPassword("open_password");

Presentation presentation = new Presentation("encrypted-pres.pptx", loadOptions);
try {
    presentation.getProtectionManager().removeEncryption();
    presentation.save("encryption-removed.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

在加载前验证打开密码

使用IPresentationFactory.getPresentationInfo获取IPresentationInfo，无需创建完整的演示文稿实例。在请求或验证密码之前，检查IPresentationInfo.isPasswordProtected。如果存在保护，请使用IPresentationInfo.checkPassword验证提供的值。

文件路径工作流

以下示例验证 PPTX 文件的打开密码，将验证后的值传递给ILoadOptions.setPassword，然后加载完整的演示文稿：

import com.aspose.slides.IPresentationInfo;
import com.aspose.slides.LoadOptions;
import com.aspose.slides.Presentation;
import com.aspose.slides.PresentationFactory;

String filePath = "protected-presentation.pptx";
String password = "open_password";
IPresentationInfo presentationInfo = PresentationFactory.getInstance().getPresentationInfo(filePath);

if (!presentationInfo.isPasswordProtected()) {
    System.out.println("The presentation does not have an opening password.");
} else if (!presentationInfo.checkPassword(password)) {
    System.out.println("The opening password is incorrect.");
} else {
    LoadOptions loadOptions = new LoadOptions();
    loadOptions.setPassword(password);

    Presentation presentation = new Presentation(filePath, loadOptions);
    try {
        System.out.println("The presentation was validated and loaded successfully.");
    } finally {
        presentation.dispose();
    }
}

流工作流

IPresentationFactory.getPresentationInfo 的流重载提供相同的工作流。在从该流加载完整演示文稿之前，重置可查找流的位置。

以下示例使用 PPT 文件：

import com.aspose.slides.IPresentationInfo;
import com.aspose.slides.LoadOptions;
import com.aspose.slides.Presentation;
import com.aspose.slides.PresentationFactory;
import java.io.FileInputStream;

String password = "open_password";

FileInputStream presentationStream = new FileInputStream("protected-presentation.ppt");
try {
    IPresentationInfo presentationInfo = PresentationFactory.getInstance().getPresentationInfo(presentationStream);

    if (!presentationInfo.isPasswordProtected()) {
        System.out.println("The presentation does not have an opening password.");
    } else if (!presentationInfo.checkPassword(password)) {
        System.out.println("The opening password is incorrect.");
    } else {
        presentationStream.getChannel().position(0);

        LoadOptions loadOptions = new LoadOptions();
        loadOptions.setPassword(password);

        Presentation presentation = new Presentation(presentationStream, loadOptions);
        try {
            System.out.println("The presentation was validated and loaded successfully.");
        } finally {
            presentation.dispose();
        }
    }
} finally {
    presentationStream.close();
}

checkPassword 返回值

IPresentationInfo.checkPassword 仅在演示文稿具有打开密码且提供的密码正确时返回 true。在以下情况下都会返回 false：

密码不正确。
演示文稿没有打开密码。
提供的密码为 null 或为空。

对于 PPT 和 PPTX 演示文稿的行为相同。

检查已加载的演示文稿是否已加密

使用正确密码加载演示文稿后，检查IProtectionManager.isEncrypted 以确认源演示文稿已加密。要在加载前检测打开密码保护，请使用上文所示的 IPresentationInfo.isPasswordProtected。

import com.aspose.slides.LoadOptions;
import com.aspose.slides.Presentation;

LoadOptions loadOptions = new LoadOptions();
loadOptions.setPassword("open_password");

Presentation presentation = new Presentation("encrypted-pres.pptx", loadOptions);
try {
    boolean isEncrypted = presentation.getProtectionManager().isEncrypted();
    System.out.println("The presentation is encrypted: " + isEncrypted);
} finally {
    presentation.dispose();
}

安全建议

Security

不要记录打开密码或将其包含在诊断信息中。避免不必要的重复验证尝试，仅在需要时将密码保存在内存中，并在立即加载演示文稿时重用成功的验证结果。

即使演示文稿内容已加密，公开的文档属性仍可能泄露作者姓名、标题、主题、关键字、公司信息、备注和自定义值。应将敏感的元数据与演示文稿一起加密。仅在系统必须在没有打开密码的情况下对文件进行索引、分类、搜索或管理时，才应明确决定将属性设为公开。

在线对演示文稿进行密码保护

打开Aspose.Slides Lock 应用程序。
选择或上传演示文稿。
输入用于查看保护的密码。
（可选）输入用于编辑保护的单独密码。
应用保护并下载生成的文件。

常见问题

打开密码与写保护密码有什么区别？

打开密码会加密演示文稿，且必须提供才能加载其内容。写保护密码在不加密内容的情况下限制修改。

是否可以在不加载所有幻灯片的情况下验证打开密码？

可以。获取演示文稿信息，检查是否存在打开密码保护，并在创建完整演示文稿实例之前验证密码。

应用程序是否可以在没有打开密码的情况下读取元数据？

可以，但前提是演示文稿在加密时已禁用文档属性加密。此时应用程序必须使用Manage Presentation Properties 中描述的仅加载文档属性模式。

密码检查工作流是否同时支持 PPT 和 PPTX？

是的。基于文件路径和基于流的密码检测与验证在 PPT 和 PPTX 演示文稿中表现相同。

在 Java 中为演示文稿添加数字签名 Java 中的写保护演示文稿