與數字簽名一起工作
Contents
[
Hide
]
數位簽名是電子簽名的技術實作，用於簽署文件並確認簽署人身份，以保證文件自簽署後尚未修改。 每個簽名因為遵循 PKI 協議來生成公有與私有的鍵，所以是獨一無二的。 以數位方式簽名是指使用簽署者私鑰來創建一個签名，其中一個數學演算法被用來加密生成之雜湊值。
Aspose.Words可讓您檢驗、計數或驗證現有的數位簽名，以及新增您的文件中的新簽名來找出任何的竄改。 您也可以從文件中移除了所有數位簽名。 使用 DigitalSignatureUtil 類別來處理數位簽名。
這篇文章說明如何做所有上述事以驗證一項數位文件的真實性和完整性。
請注意，您只能在.NET Framework 2.0及以上版本運行時存取文件的數字簽名。
試試網路上
您可以用我們的 Free online signature 來試用這個功能。
支援的格式
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-.NET.git. | |
| FileFormatInfo info = FileFormatUtil.DetectFileFormat(MyDir + "Digitally signed.docx"); | |
| if (info.HasDigitalSignature) | |
| { | |
| Console.WriteLine( | |
| $"Document {Path.GetFileName(MyDir + "Digitally signed.docx")} has digital signatures, " + | |
| "they will be lost if you open/save this document with Aspose.Words."); | |
| } |
建立數位簽名
要建立數位簽名，你必須加載確認身分的簽名證書。 當你傳送一個有數位簽名的文件時，你也傳送你的證書和公開鑰。
Aspose.Words讓您可建立X.509憑證，這種數位憑證使用國際接受的X.509 PKI標準來驗證公鍵是否屬於憑證內包含的簽名者。 要做到這一點，請使用 Create 方法在 CertificateHolder 類中。
接下來的部分說明如何加入數字簽名、簽名欄位以及如何在生成的 PDF 文檔上簽名。
簽署文件
Aspose.Words讓您使用 Sign 方法和 SignOptions 屬性以數字方式簽名 DOC、DOCX、XPS 或 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-.NET.git. | |
| CertificateHolder certHolder = CertificateHolder.Create(MyDir + "morzal.pfx", "aw"); | |
| DigitalSignatureUtil.Sign(MyDir + "Digitally signed.docx", ArtifactsDir + "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-.NET.git. | |
| Document doc = new Document(); | |
| DocumentBuilder builder = new DocumentBuilder(doc); | |
| SignatureLineOptions signatureLineOptions = new SignatureLineOptions | |
| { | |
| Signer = "yourname", | |
| SignerTitle = "Worker", | |
| Email = "yourname@aspose.com", | |
| ShowDate = true, | |
| DefaultInstructions = false, | |
| Instructions = "Please sign here.", | |
| AllowComments = true | |
| }; | |
| SignatureLine signatureLine = builder.InsertSignatureLine(signatureLineOptions).SignatureLine; | |
| signatureLine.ProviderId = Guid.Parse("CF5A7BB4-8F3C-4756-9DF6-BEF7F13259A2"); | |
| doc.Save(ArtifactsDir + "SignDocuments.SignatureLineProviderId.docx"); | |
| SignOptions signOptions = new SignOptions | |
| { | |
| SignatureLineId = signatureLine.Id, | |
| ProviderId = signatureLine.ProviderId, | |
| Comments = "Document was signed by Aspose", | |
| SignTime = DateTime.Now | |
| }; | |
| CertificateHolder certHolder = CertificateHolder.Create(MyDir + "morzal.pfx", "aw"); | |
| DigitalSignatureUtil.Sign(ArtifactsDir + "SignDocuments.SignatureLineProviderId.docx", | |
| ArtifactsDir + "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-.NET.git. | |
| Document doc = new Document(); | |
| DocumentBuilder builder = new DocumentBuilder(doc); | |
| builder.Writeln("Test Signed PDF."); | |
| PdfSaveOptions saveOptions = new PdfSaveOptions | |
| { | |
| DigitalSignatureDetails = new PdfDigitalSignatureDetails( | |
| CertificateHolder.Create(MyDir + "morzal.pfx", "aw"), "reason", "location", | |
| DateTime.Now) | |
| }; | |
| doc.Save(ArtifactsDir + "WorkingWithPdfSaveOptions.DigitallySignedPdfUsingCertificateHolder.pdf", saveOptions); |
檢索數位簽名值
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-.NET.git. | |
| Document doc = new Document(MyDir + "Digitally signed.docx"); | |
| foreach (DigitalSignature digitalSignature in doc.DigitalSignatures) | |
| { | |
| string signatureValue = Convert.ToBase64String(digitalSignature.SignatureValue); | |
| Assert.AreEqual("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-.NET.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(MyDir + "Digitally signed.docx", | |
| ArtifactsDir + "DigitalSignatureUtil.LoadAndRemove.FromString.docx"); | |
| // 2 - Determine the locations of both the signed document and the unsigned copy by file streams: | |
| using (Stream streamIn = new FileStream(MyDir + "Digitally signed.docx", FileMode.Open)) | |
| { | |
| using (Stream streamOut = new FileStream(ArtifactsDir + "DigitalSignatureUtil.LoadAndRemove.FromStream.docx", FileMode.Create)) | |
| { | |
| DigitalSignatureUtil.RemoveAllSignatures(streamIn, streamOut); | |
| } | |
| } | |
| // Verify that both our output documents have no digital signatures. | |
| Assert.That(DigitalSignatureUtil.LoadSignatures(ArtifactsDir + "DigitalSignatureUtil.LoadAndRemove.FromString.docx"), Is.Empty); | |
| Assert.That(DigitalSignatureUtil.LoadSignatures(ArtifactsDir + "DigitalSignatureUtil.LoadAndRemove.FromStream.docx"), Is.Empty); |
請注意，您無法在您的文件中移除一個數字簽名。