使用数字签名
Contents
[
Hide
]
数字签名是电子签名的技术实现，用于对文档进行签名并对签名者进行身份验证，以确保文档自签名以来未被修改。 每个数字签名对于每个签名者都是唯一的，因为遵循PKI协议来生成公钥和私钥。 对文档进行数字签名意味着使用签名者的私钥创建签名，其中使用数学算法对生成的哈希进行加密。
Aspose.Words允许您检测，计数或验证现有的数字签名，还可以向文档添加新签名以找出其中的任何篡改。 您还可以从文档中删除所有数字签名。 使用DigitalSignatureUtil类来处理数字签名。
本文介绍了如何执行上述所有操作来验证数字文档的真实性和完整性。
请注意，只有在运行Java6及更高版本时，您才能访问文档的数字签名。
在线试用
您可以使用我们的 免费网上签名.
支持的格式
Aspose.Words允许您在DOC、OOXML和ODT文档上使用数字签名，并以PDF或XPS格式对生成的文档进行签名。
数字签名的限制
下表介绍了通过Aspose.Words处理数字签名时可能面临的一些限制，以及一些替代选项。
| 限制 | 备选方案 |
|---|---|
| 在加载和保存文档后丢失数字签名。 因此，向服务器处理文档可能会导致所有数字签名丢失，而无需通知。 | 检查文档是否具有数字签名，如果发现任何数字签名，请采取相应的操作。 例如，向客户端发送警报，通知他们他们正在上传的文档包含数字签名，如果处理它，这些签名将丢失。 |
| Aspose.Words支持在文档中使用宏。 但是Aspose.Words还不支持宏上的数字签名。 | 将文档导出回任何Word格式，并使用Microsoft Word向宏添加数字签名。 |
检测、计数和验证数字签名
Aspose.Words允许您使用DetectFileFormat方法和HasDigitalSignature属性检测文档中的数字签名。 值得注意的是，这样的检查只会检测签名的事实，而不是其有效性。
文档可以多次签名，这可以由不同的用户完成。 要检查数字签名的有效性，您需要使用LoadSignatures方法从文档中加载它们并使用IsValid属性。 此外，Aspose.Words还允许您使用Count属性计算文档中的一组所有数字签名。
所有这些都提供了一种在处理文档之前检查文档签名的高效安全方法。
下面的代码示例演示如何检测数字签名的存在并验证它们:
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| // For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Java.git. | |
| FileFormatInfo info = FileFormatUtil.detectFileFormat(getMyDir() + "Digitally signed.docx"); | |
| if (info.hasDigitalSignature()) | |
| { | |
| System.out.println("Document {Path.GetFileName(MyDir + "); | |
| } |
创建数字签名
要创建数字签名，您需要加载确认身份的签名证书。 当您发送数字签名文档时，您还会发送证书和公钥。
Aspose.Words允许您创建X.509证书，这是一种数字证书，使用国际公认的X.509PKI标准来验证公钥是否属于证书中包含的签名者。 为此，请在CertificateHolder类中使用Create方法。
接下来的部分将介绍如何添加数字签名、签名行以及如何对生成的PDF文档进行签名。
签署文件
Aspose.Words允许您使用Sign方法和SignOptions属性对DOC、DOCX或ODT文档进行数字签名。
下面的代码示例演示如何使用证书持有者和签名选项对文档进行签名:
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| // For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Java.git. | |
| CertificateHolder certHolder = CertificateHolder.create(getMyDir() + "morzal.pfx", "aw"); | |
| DigitalSignatureUtil.sign(getMyDir() + "Digitally signed.docx", getArtifactsDir() + "Document.Signed.docx", | |
| certHolder); |
添加签名行
签名行是文档中数字签名的可视化表示形式。 Aspose.Words允许您使用DocumentBuilder.InsertSignatureLine方法插入签名行。 您还可以使用SignatureLineOptions类设置此表示形式的参数。
例如，下图显示了如何显示有效和无效的签名。
此外，如果文档包含签名行并且没有数字签名，则有一个功能要求用户添加签名。
下面的代码示例演示如何使用个人证书和特定签名行对文档进行签名:
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| // For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Java.git. | |
| Document doc = new Document(); | |
| DocumentBuilder builder = new DocumentBuilder(doc); | |
| SignatureLineOptions signatureLineOptions = new SignatureLineOptions(); | |
| { | |
| signatureLineOptions.setSigner("yourname"); | |
| signatureLineOptions.setSignerTitle("Worker"); | |
| signatureLineOptions.setEmail("yourname@aspose.com"); | |
| signatureLineOptions.setShowDate(true); | |
| signatureLineOptions.setDefaultInstructions(false); | |
| signatureLineOptions.setInstructions("Please sign here."); | |
| signatureLineOptions.setAllowComments(true); | |
| } | |
| SignatureLine signatureLine = builder.insertSignatureLine(signatureLineOptions).getSignatureLine(); | |
| signatureLine.setProviderId(UUID.fromString("CF5A7BB4-8F3C-4756-9DF6-BEF7F13259A2")); | |
| doc.save(getArtifactsDir() + "SignDocuments.SignatureLineProviderId.docx"); | |
| SignOptions signOptions = new SignOptions(); | |
| { | |
| signOptions.setSignatureLineId(signatureLine.getId()); | |
| signOptions.setProviderId(signatureLine.getProviderId()); | |
| signOptions.setComments("Document was signed by Aspose"); | |
| signOptions.setSignTime(new Date()); | |
| } | |
| CertificateHolder certHolder = CertificateHolder.create(getMyDir() + "morzal.pfx", "aw"); | |
| DigitalSignatureUtil.sign(getArtifactsDir() + "SignDocuments.SignatureLineProviderId.docx", | |
| getArtifactsDir() + "SignDocuments.CreateNewSignatureLineAndSetProviderId.docx", certHolder, signOptions); |
签署生成的PDF文档
Aspose.Words允许您使用PdfDigitalSignatureDetails属性签名并获取PDF文档的所有详细信息。
下面的代码示例演示如何对生成的PDF进行签名:
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| // For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Java.git. | |
| Document doc = new Document(); | |
| DocumentBuilder builder = new DocumentBuilder(doc); | |
| builder.writeln("Test Signed PDF."); | |
| PdfSaveOptions saveOptions = new PdfSaveOptions(); | |
| { | |
| saveOptions.setDigitalSignatureDetails(new PdfDigitalSignatureDetails( | |
| CertificateHolder.create(getMyDir() + "morzal.pfx", "aw"), "reason", "location", | |
| new Date())); | |
| } | |
| doc.save(getArtifactsDir() + "WorkingWithPdfSaveOptions.DigitallySignedPdfUsingCertificateHolder.pdf", saveOptions); |
下图演示了生成的PDF文档在Adobe Acrobat中打开，数字签名被验证为存在且有效。
检索数字签名值
Aspose.Words还提供了使用SignatureValue属性从数字签名文档中检索数字签名值作为字节数组的能力。
下面的代码示例演示如何从文档中获取作为字节数组的数字签名值:
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| // For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Java.git. | |
| Document doc = new Document(getMyDir() + "Digitally signed.docx"); | |
| for (DigitalSignature digitalSignature : doc.getDigitalSignatures()) | |
| { | |
| String signatureValue = Base64.getEncoder().encodeToString(digitalSignature.getSignatureValue()); | |
| Assert.assertEquals("K1cVLLg2kbJRAzT5WK+m++G8eEO+l7S+5ENdjMxxTXkFzGUfvwxREuJdSFj9AbD" + | |
| "MhnGvDURv9KEhC25DDF1al8NRVR71TF3CjHVZXpYu7edQS5/yLw/k5CiFZzCp1+MmhOdYPcVO+Fm" + | |
| "+9fKr2iNLeyYB+fgEeZHfTqTFM2WwAqo=", signatureValue); | |
| } |
删除数字签名
Aspose.Words允许您使用RemoveAllSignatures方法从签名文档中删除所有数字签名。
下面的代码示例演示如何从文档中加载和删除数字签名:
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| // For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Java.git. | |
| // There are two ways of using the DigitalSignatureUtil class to remove digital signatures | |
| // from a signed document by saving an unsigned copy of it somewhere else in the local file system. | |
| // 1 - Determine the locations of both the signed document and the unsigned copy by filename strings: | |
| DigitalSignatureUtil.removeAllSignatures(getMyDir() + "Digitally signed.docx", | |
| getArtifactsDir() + "DigitalSignatureUtil.LoadAndRemove.FromString.docx"); | |
| // 2 - Determine the locations of both the signed document and the unsigned copy by file streams: | |
| try (FileInputStream streamIn = new FileInputStream(getMyDir() + "Digitally signed.docx")) | |
| { | |
| try (FileOutputStream streamOut = new FileOutputStream(getArtifactsDir() + "DigitalSignatureUtil.LoadAndRemove.FromStream.docx")) | |
| { | |
| DigitalSignatureUtil.removeAllSignatures(streamIn, streamOut); | |
| } | |
| } | |
| // Verify that both our output documents have no digital signatures. | |
| Assert.assertEquals(IterableUtils.size(DigitalSignatureUtil.loadSignatures(getArtifactsDir() + "DigitalSignatureUtil.LoadAndRemove.FromString.docx")), 0); | |
| Assert.assertEquals(IterableUtils.size(DigitalSignatureUtil.loadSignatures(getArtifactsDir() + "DigitalSignatureUtil.LoadAndRemove.FromStream.docx")), 0); |
请注意，您不能只删除文档中的一个数字签名。