在 PHP 中为演示文稿添加数字签名

本页内容简介

了解如何使用 PFX 证书对现有 PPTX 演示文稿进行签名，并通过 Java 使用 Aspose.Slides for PHP 验证或移除数字签名。

概述

数字签名帮助收件人确定是谁对演示文稿进行签名以及已签名的内容是否已改变。此处有三个相关的安全概念：

数字证书 是将身份与公钥关联的电子凭证。受信任的证书颁发机构（CA）可以颁发证书，组织也可以使用自签名证书进行内部工作流。
数字签名 是由演示文稿内容和证书持有者的私钥生成的。随后可以使用证书的公钥来验证签名。签名提供来源和完整性的证据；它不会对演示文稿进行加密。
密码保护 控制用户是否可以打开或修改演示文稿。它独立于数字签名，并在受密码保护的演示文稿中有说明。

PowerPoint 在 文件 > 信息 > 保护演示文稿 下提供 添加数字签名 命令。

![PowerPoint 保护演示文稿菜单，突出显示“添加数字签名”] (add-digital-signature-in-powerpoint.png)

打开已签名的演示文稿后，PowerPoint 可以显示签名状态通知。

![PowerPoint 通知，表示演示文稿包含有效签名] (digital-signature-status-in-powerpoint.png)

Aspose.Slides 通过Presentation::getDigitalSignatures公开签名，该方法返回一个DigitalSignatureCollection，其项由DigitalSignature对象表示。一个演示文稿可以包含多个签名。

了解 PFX 证书和密码

PFX 文件（也称为 PKCS#12 文件，通常使用 .pfx 或 .p12 扩展名）可以包含 X.509 证书、其私钥以及证书链。私钥是持有人创建签名的关键。没有可访问私钥的证书无法用于签名演示文稿。

PFX 密码保护证书包和私钥。它不是用于打开或编辑演示文稿的密码。不要将 PFX 文件或其密码提交到源代码管理。生产环境中，请限制对证书文件的访问，并从机密存储或其他受保护的配置源获取其密码。下列示例仅使用环境变量以避免在代码中嵌入密码。

向演示文稿添加数字签名

要在真实的演示工作流中签名，加载现有的 PPTX 文件，从 PFX 证书及其密码创建一个DigitalSignature，将签名添加到演示文稿的集合中，并保存为 PPTX 文件。

$certificatePassword = getenv("PFX_PASSWORD");
if ($certificatePassword === false || $certificatePassword === "") {
    throw new RuntimeException("Set the PFX_PASSWORD environment variable.");
}

$presentation = new Presentation("InputPresentation.pptx");
try {
    $signature = new DigitalSignature("signing-certificate.pfx", $certificatePassword);
    $signature->setComments("Approved for release.");

    $presentation->getDigitalSignatures()->add($signature);
    $presentation->save("InputPresentation-signed.pptx", SaveFormat::Pptx);
} finally {
    $presentation->dispose();
}

将结果保存为新名称可保留未签名的源文件。通过DigitalSignature::setComments设置的值描述签名的目的；它不是安全控制。

验证数字签名

加载已签名的 PPTX 文件时，检查Presentation::getDigitalSignatures返回的每个项。DigitalSignature::isValid方法指示嵌入的签名是否对当前演示文稿内容有效。

$presentation = new Presentation("InputPresentation-signed.pptx");
try {
    $signatures = $presentation->getDigitalSignatures();
    $signatureCount = java_values($signatures->size());

    if ($signatureCount === 0) {
        echo "The presentation does not contain digital signatures." . PHP_EOL;
    } else {
        $allSignaturesAreValid = true;
        $signTimeFormat = new Java("java.text.SimpleDateFormat", "yyyy-MM-dd HH:mm:ss");
        $certificateFactoryClass = new JavaClass("java.security.cert.CertificateFactory");
        $certificateFactory = $certificateFactoryClass->getInstance("X.509");

        for ($index = 0; $index < $signatureCount; $index++) {
            $signature = $signatures->get_Item($index);
            $signatureIsValid = java_values($signature->isValid());
            $signatureStatus = $signatureIsValid ? "VALID" : "INVALID";
            $formattedSignTime = java_values($signTimeFormat->format($signature->getSignTime()));

            $certificateData = $signature->getCertificate();
            $certificateStream = new Java("java.io.ByteArrayInputStream", $certificateData);
            try {
                $certificate = $certificateFactory->generateCertificate($certificateStream);
                $signerName = java_values($certificate->getSubjectX500Principal()->getName());
            } finally {
                $certificateStream->close();
            }

            echo $signerName . ", " . $formattedSignTime . " -- " . $signatureStatus . PHP_EOL;

            $allSignaturesAreValid = $allSignaturesAreValid && $signatureIsValid;
        }

        if ($allSignaturesAreValid) {
            echo "All embedded signatures are valid for the current presentation." . PHP_EOL;
        } else {
            echo "At least one embedded signature is invalid." . PHP_EOL;
        }
    }
} finally {
    $presentation->dispose();
}

无效结果通常表示签名后演示文稿内容或签名数据已更改，或文件已损坏。移除所有签名会得到未签名的演示文稿，因此仅检查项的有效性不足：安全敏感的工作流还必须验证期望的签名数量和签名者身份是否存在。

此有效性结果不应被视为完整的证书信任决策。根据您的安全策略，应用程序可能还需要构建并验证 X.509 证书链，检查证书有效期和吊销状态，确认期望的主题或指纹，验证密钥用法，并评估受信任的时间戳。DigitalSignature::getSignTime本身并不构成受信任的时间戳机构的证明。

移除数字签名

移除签名会改变演示文稿的安全状态。下面的示例加载已签名的 PPTX 文件，使用DigitalSignatureCollection::clear移除所有签名，并保存为未签名的副本。

$presentation = new Presentation("InputPresentation-signed.pptx");
try {
    $presentation->getDigitalSignatures()->clear();
    $presentation->save("InputPresentation-unsigned.pptx", SaveFormat::Pptx);
} finally {
    $presentation->dispose();
}

若只想移除单个签名，可调用DigitalSignatureCollection::removeAt并传入其零基索引。除非工作流明确要求覆盖已签名的原文件，否则请另存为新文件。

编辑和格式注意事项

签名不会使演示文稿只读。用户和应用程序仍可编辑文件，但对已签名内容的更改通常会使现有签名失效。
在签名之前完成所有预期的编辑。如果演示文稿必须更改，请保存修订后的演示文稿并再次签名该修订版。
保持最终输出为 PPTX 格式。将已签名的演示文稿转换为其他格式不会将原 PPTX 的签名转换为有效的签名。
将证书的私钥视为敏感信息。获取私钥及其密码的任何人都可能创建看似来自该证书持有者的签名。
当文档保留策略要求时，保留未签名的源文件或其他受控副本。

常见问题解答

数字签名会加密演示文稿吗？

不会。数字签名提供关于来源和完整性的证据，但演示文稿内容仍然可读，除非另行加密。当需要限制内容访问时，请使用密码保护。

PFX 密码与演示文稿密码是同一个吗？

不是。PFX 密码用于解锁存储在证书包中的私钥。它不控制谁可以打开或编辑 PPTX 文件。

我可以使用自签名证书吗？

技术上，只要自签名证书包含可访问的私钥就可以使用。然而，收件人不会自动信任它，除非该证书已显式添加到其受信任环境。公共或跨组织的工作流通常使用受信任 CA 颁发的证书。

是什么导致签名失效？

在签名后更改已签名的演示内容或签名数据会使签名失效。文件损坏也会导致验证失败。如果移除所有签名，演示文稿将变为未签名，而不是包含无效签名的文件。

有效的签名是否意味着我应该信任签名者？

单凭签名本身不能。签名完整性与签名者信任是独立的决策。生产环境的验证策略还应检查证书链、有效期、吊销状态、期望的身份、密钥用法以及任何受信任的时间戳要求。

证书过期会怎样？

证书过期不会改变演示文稿的字节，但会影响证书信任评估。签名是否仍然可接受取决于您的策略以及是否有有效的受信任时间戳能证明签名发生时证书是有效的。不要仅凭显示的签名时间作为受信任的时间戳。

已签名的演示文稿还能编辑吗？

可以。签名不会锁定文件。编辑已签名的内容通常会使现有签名失效，因此请先完成演示文稿的编辑，然后对最终修订版签名。

演示文稿可以包含多个签名吗？

可以。在保存之前，将每个签名添加到Presentation::getDigitalSignatures返回的集合中。验证时检查每个签名，并确认所有必需的签名者均已出现。

哪些演示文稿格式支持这些操作？

Aspose.Slides 仅在 PPTX 格式下支持本文描述的数字签名操作。不支持 PPT 和 OpenDocument 演示文稿格式的此 API 工作流。

我可以在不影响幻灯片的情况下移除签名吗？

可以。您可以移除单个签名或清除整个集合，然后保存演示文稿。幻灯片内容仍然可用，但已保存的文件不再携带被移除的签名证据。

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