A Developer's Guide to Digitally Signing PDFs with C

X509Certificate2 オブジェクトの使用

最大限の制御を実現するために、証明書ファイルからX509Certificate2標準に完全に準拠しており、堅牢かつ安全なデジタル署名実装方法を提供します。 証明書オブジェクトを作成する際は、X509KeyStorageFlags が Exportable に設定されていることを確認してください。これは、基盤となる暗号化APIで必須です。コードリポジトリでデジタル署名の実用的な例をご確認ください。

Install-Package IronPdf

using IronPdf;
using IronPdf.Signing;
using System.Security.Cryptography.X509Certificates;

// Create a new PDF from an HTML string for demonstration.
var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf("<h1>Signed Document</h1><p>This document has been digitally signed.</p>");

// Load the certificate from a .pfx file with its password.
// The X509KeyStorageFlags.Exportable flag is crucial for allowing the private key to be used in the signing process.
var cert = new X509Certificate2("IronSoftware.pfx", "123456", X509KeyStorageFlags.Exportable);

// Create a PdfSignature object using the loaded certificate.
var signature = new PdfSignature(cert);

// Apply the signature to the PDF document.
pdf.Sign(signature);

// Save the securely signed PDF document.
pdf.SaveAs("Signed.pdf");

using IronPdf;
using IronPdf.Signing;
using System.Security.Cryptography.X509Certificates;

// Create a new PDF from an HTML string for demonstration.
var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf("<h1>Signed Document</h1><p>This document has been digitally signed.</p>");

// Load the certificate from a .pfx file with its password.
// The X509KeyStorageFlags.Exportable flag is crucial for allowing the private key to be used in the signing process.
var cert = new X509Certificate2("IronSoftware.pfx", "123456", X509KeyStorageFlags.Exportable);

// Create a PdfSignature object using the loaded certificate.
var signature = new PdfSignature(cert);

// Apply the signature to the PDF document.
pdf.Sign(signature);

// Save the securely signed PDF document.
pdf.SaveAs("Signed.pdf");

上記のコードは、最初にシンプルなPDFを生成します。 次に、.pfx 証明書ファイルを X509Certificate2 オブジェクトに読み込みます。 デジタル ID を表すこのオブジェクトは、PdfSignature コンストラクターに渡されます。 最後に、pdf.Sign メソッドは、この署名をドキュメントに適用してから保存します。 For more information on the X509Certificate2 class, you can refer to the official Microsoft documentation.

デジタル署名に詳細を追加する

デジタル署名には証明書だけでなく、リッチなメタデータを埋め込むことができます。 これには署名の場所、理由、連絡先情報、信頼できる機関からのタイムスタンプが含まれます。 これにより、文書の監査証跡が改善され、検証者に貴重な情報が提供されます。 また、set and edit metadata for additional document properties（メタデータの設定と編集）も可能です。

IronPDFはまた、最新のSHA256およびSHA512ハッシュアルゴリズムを使用したタイムスタンピングサーバーもサポートしています。 IronPDF は、最新の SHA256 および SHA512 ハッシュ アルゴリズムを使用するタイムスタンプ サーバーもサポートしています。

using IronPdf;
using IronPdf.Signing;
using IronSoftware.Drawing;
using System;

// Load an existing PDF document to be signed.
var pdf = PdfDocument.FromFile("invoice.pdf");

// Create a PdfSignature object directly from the certificate file and password.
var signature = new PdfSignature("IronSoftware.pfx", "123456");

// Add detailed metadata to the signature for a comprehensive audit trail.
// These properties enhance the signature's credibility and provide context
signature.SignatureDate = DateTime.Now;
signature.SigningContact = "legal@ironsoftware.com";
signature.SigningLocation = "Chicago, USA";
signature.SigningReason = "Contractual Agreement";

// Add a secure timestamp from a trusted Time Stamp Authority (TSA).
// This provides cryptographic proof of the signing time.
signature.TimeStampUrl = new Uri("[http://timestamp.digicert.com](http://timestamp.digicert.com)");
signature.TimestampHashAlgorithm = TimestampHashAlgorithms.SHA256;

// Apply a visual appearance to the signature. (More on this in the next section)
signature.SignatureImage = new PdfSignatureImage("assets/visual-signature.png", 0, new Rectangle(350, 750, 200, 100));

// Sign the PDF document with the configured signature object.
pdf.Sign(signature);

// Save the final, signed PDF document.
pdf.SaveAs("DetailedSignature.pdf");

using IronPdf;
using IronPdf.Signing;
using IronSoftware.Drawing;
using System;

// Load an existing PDF document to be signed.
var pdf = PdfDocument.FromFile("invoice.pdf");

// Create a PdfSignature object directly from the certificate file and password.
var signature = new PdfSignature("IronSoftware.pfx", "123456");

// Add detailed metadata to the signature for a comprehensive audit trail.
// These properties enhance the signature's credibility and provide context
signature.SignatureDate = DateTime.Now;
signature.SigningContact = "legal@ironsoftware.com";
signature.SigningLocation = "Chicago, USA";
signature.SigningReason = "Contractual Agreement";

// Add a secure timestamp from a trusted Time Stamp Authority (TSA).
// This provides cryptographic proof of the signing time.
signature.TimeStampUrl = new Uri("[http://timestamp.digicert.com](http://timestamp.digicert.com)");
signature.TimestampHashAlgorithm = TimestampHashAlgorithms.SHA256;

// Apply a visual appearance to the signature. (More on this in the next section)
signature.SignatureImage = new PdfSignatureImage("assets/visual-signature.png", 0, new Rectangle(350, 750, 200, 100));

// Sign the PDF document with the configured signature object.
pdf.Sign(signature);

// Save the final, signed PDF document.
pdf.SaveAs("DetailedSignature.pdf");

緑のチェックマークを得るには、証明書をビューアの信頼されたIDに追加する必要があります。 緑のチェックマークを得るためには、証明書をビューワの信頼されたアイデンティティに追加する必要があります。

特定のPDFリビジョンを保存して署名する

これはインクリメンタル保存と呼ばれます。 PDFに署名する際、署名はドキュメントの特定のリビジョンに適用されます。 これは、ドキュメントが複数の承認ステージを経るワークフローにおいて重要です。 これは、ドキュメントが複数の承認ステージを経るワークフローにとって重要です。 PDF の変更履歴の管理の詳細については、詳細なガイドをご覧ください。

次の例では、PDFをロードして編集し、現在のリビジョンにサインした後、将来の変更としてフォーム入力のみを許可します。 ファイルを保存する前に、SaveAsRevision を使用して、現在の状態をド​​キュメントの履歴にコミットします。

using IronPdf.Signing;

// Load a PDF file with change tracking enabled.
// This enables incremental save functionality for revision management
var pdf = PdfDocument.FromFile("annual_census.pdf", ChangeTrackingModes.EnableChangeTracking);

// Placeholder for edits: You might add text, fill forms, or add annotations here.
// For example: pdf.Annotations.Add(new TextAnnotation(...));
// Or: pdf.Form["fieldName"].Value = "New Value";

// Sign the current state of the document using SignWithFile for convenience.
// We set permissions to allow further signatures and form filling.
pdf.SignWithFile(
    "assets/IronSignature.p12", 
    "password", 
    SignaturePermissions.AdditionalSignaturesAndFormFillingAllowed);

// Save the current state as a distinct revision within the PDF's history.
// This creates a snapshot that can be referenced later
PdfDocument pdfWithRevision = pdf.SaveAsRevision();

// Save the final PDF with its full revision history to a new file.
pdfWithRevision.SaveAs("annual_census_signed.pdf");

using IronPdf.Signing;

// Load a PDF file with change tracking enabled.
// This enables incremental save functionality for revision management
var pdf = PdfDocument.FromFile("annual_census.pdf", ChangeTrackingModes.EnableChangeTracking);

// Placeholder for edits: You might add text, fill forms, or add annotations here.
// For example: pdf.Annotations.Add(new TextAnnotation(...));
// Or: pdf.Form["fieldName"].Value = "New Value";

// Sign the current state of the document using SignWithFile for convenience.
// We set permissions to allow further signatures and form filling.
pdf.SignWithFile(
    "assets/IronSignature.p12", 
    "password", 
    SignaturePermissions.AdditionalSignaturesAndFormFillingAllowed);

// Save the current state as a distinct revision within the PDF's history.
// This creates a snapshot that can be referenced later
PdfDocument pdfWithRevision = pdf.SaveAsRevision();

// Save the final PDF with its full revision history to a new file.
pdfWithRevision.SaveAs("annual_census_signed.pdf");

シンプルなビューアは最新バージョンしか表示しないかもしれませんが、Adobe Acrobatのようなツールはリビジョン履歴全体を開示し、どのバージョンが誰によって署名され、署名間でどのような変更が行われたかを示します。 高セキュリティとコンプライアンスが必要な複雑なドキュメントワークフローを管理するために、包括的なソリューションが必要です。 高セキュリティとコンプライアンスを必要とする複雑なドキュメントワークフローを管理する企業向けに、包括的なソリューションが必要な場合があります。

Iron SoftwareはIron Suiteを提供し、IronPDFによる署名と操作のほか、さまざまなドキュメント処理タスクをカバーする他のライブラリが含まれており、一回の支払いで利用可能です。 Iron Softwareは、サイン及び操作のためのIronPDFを含むIron Suiteを提供しており、さまざまなドキュメント処理タスクに対応する他のライブラリも、1回限りの支払いで利用できます。

リビジョン間で署名を管理および検証するにはどうすればよいですか？

PDFドキュメントには、さまざまなリビジョンにわたって複数の署名を適用できます。 - 以前のリビジョンへのロールバック: GetRevisionメソッドを使用して、ドキュメントを以前の状態に戻すことができます。

-以前のリビジョンにロールバック: GetRevision メソッドを使用して、ドキュメントを以前の状態に戻すことができます。 - すべての署名を検証する: VerifySignaturesメソッドは、ドキュメントのすべてのリビジョンにわたるすべての署名の有効性をチェックします。
-すべての署名を検証: VerifySignatures メソッドは、ドキュメントのすべてのリビジョンにわたるすべての署名の有効性をチェックします。 すべての署名が有効であり、不正な変更が加えられていない場合にのみ、true を返します。
-署名の削除: RemoveSignatures メソッドは、ドキュメントのすべてのリビジョンからすべてのデジタル署名を削除し、署名のないクリーンなバージョンを作成します。

// Load a PDF with a complex signature history.
var pdf = PdfDocument.FromFile("multi_signed_report.pdf");

// Verify all signatures across all revisions.
// This ensures document integrity throughout its entire history
bool allSignaturesValid = pdf.VerifySignatures();
Console.WriteLine($"All signatures are valid: {allSignaturesValid}");

// Roll back to the first revision (index 0).
// Useful for reviewing the original document state
if (pdf.RevisionCount > 1)
{
    PdfDocument firstRevision = pdf.GetRevision(0);
    firstRevision.SaveAs("report_first_revision.pdf");
}

// Create a completely unsigned version of the document.
// This removes all digital signatures while preserving content
pdf.RemoveSignatures();
pdf.SaveAs("report_unsigned.pdf");

// Load a PDF with a complex signature history.
var pdf = PdfDocument.FromFile("multi_signed_report.pdf");

// Verify all signatures across all revisions.
// This ensures document integrity throughout its entire history
bool allSignaturesValid = pdf.VerifySignatures();
Console.WriteLine($"All signatures are valid: {allSignaturesValid}");

// Roll back to the first revision (index 0).
// Useful for reviewing the original document state
if (pdf.RevisionCount > 1)
{
    PdfDocument firstRevision = pdf.GetRevision(0);
    firstRevision.SaveAs("report_first_revision.pdf");
}

// Create a completely unsigned version of the document.
// This removes all digital signatures while preserving content
pdf.RemoveSignatures();
pdf.SaveAs("report_unsigned.pdf");

スタンプされた PDF の結果はどのようになりますか?

右下隅に手書きの署名画像が押印された最終PDF。