ASP .NET PDF Signatures Guide: Add Digital Signatures to PDFs in .NET Core Projects

What Is a PDF Digital Signature and Why Use It in ASP.NET?

A digital signature is a cryptographic signature that authenticates the signer's identity and ensures the PDF document hasn't been modified. Unlike a simple electronic signature (such as a typed name), a digital signature uses certificate-based encryption to create a tamper-proof seal. This effectively secures the message content of the file.

In ASP.NET Core applications, digitally signed PDFs are essential for PDF generation workflows involving contracts, invoices, and compliance documents. Users can validate these signatures in Adobe Acrobat Reader or any compatible PDF viewer to confirm the document's current state. The signing process happens server-side, allowing your web application to sign documents automatically during processing without requiring a specific version of client software.

How to Add a Digital Signature to a PDF Document Using a Certificate?

The most secure method to sign a PDF file is using a .pfx or .p12 certificate file. For development and testing environments, you might generate a self signed certificate. This approach applies a cryptographic signature that can be verified by any PDF viewer supporting digital signatures.

The code below demonstrates how to create a new PdfDocument and sign it. Note that we define the password as a string and use the System namespace for basic types.

[HttpPost("sign-basic")]
public IActionResult SignWithCertificate()
{
    var renderer = new ChromePdfRenderer();
    var document = renderer.RenderHtmlAsPdf("<h1>Contract Agreement</h1><p>Terms...</p>");
    string certPath = Path.Combine(_environment.ContentRootPath, "Certificates/certificate.pfx");
    var signature = new PdfSignature(certPath, "yourPassword")
    {
        SigningContact = "legal@company.com",
        SigningLocation = "Chicago, USA",
        SigningReason = "Document Approval"
    };
    document.Sign(signature);
    string outputPath = Path.Combine(Path.GetTempPath(), "signed-contract.pdf");
    document.SaveAs(outputPath);
    return PhysicalFile(outputPath, "application/pdf", "signed-contract.pdf");
}

[HttpPost("sign-basic")]
public IActionResult SignWithCertificate()
{
    var renderer = new ChromePdfRenderer();
    var document = renderer.RenderHtmlAsPdf("<h1>Contract Agreement</h1><p>Terms...</p>");
    string certPath = Path.Combine(_environment.ContentRootPath, "Certificates/certificate.pfx");
    var signature = new PdfSignature(certPath, "yourPassword")
    {
        SigningContact = "legal@company.com",
        SigningLocation = "Chicago, USA",
        SigningReason = "Document Approval"
    };
    document.Sign(signature);
    string outputPath = Path.Combine(Path.GetTempPath(), "signed-contract.pdf");
    document.SaveAs(outputPath);
    return PhysicalFile(outputPath, "application/pdf", "signed-contract.pdf");
}

How Can You Create a Visible Signature on a PDF?

While cryptographic signatures provide security, many workflows require a visual representation of the signature on the PDF page. IronPDF supports adding an image element, such as a handwritten signature scan or company stamp, alongside the cryptographic signature. By default, signatures may be invisible, but you can edit this behavior.

[HttpPost("sign-visible")]
public IActionResult SignWithVisibleImage()
{
    // Load existing PDF
    string pdfPath = Path.Combine(_environment.ContentRootPath, "Documents", "invoice.pdf");
    var document = PdfDocument.FromFile(pdfPath);
    // Certificate + image
    string certPath = Path.Combine(_environment.ContentRootPath, "Certificates", "certificate.pfx");
    string imagePath = Path.Combine(_environment.ContentRootPath, "Images", "signature-image.png");
    var signature = new PdfSignature(certPath, "yourPassword");
    var rect = new IronSoftware.Drawing.Rectangle(50, 100, 200, 80);
    signature.LoadSignatureImageFromFile(imagePath, 0, rect);
    // Sign the PDF
    document.Sign(signature);
    string outFile = Path.Combine(Path.GetTempPath(), "signed-visible.pdf");
    document.SaveAs(outFile);
    return PhysicalFile(outFile, "application/pdf", "signed-visible.pdf");
}

[HttpPost("sign-visible")]
public IActionResult SignWithVisibleImage()
{
    // Load existing PDF
    string pdfPath = Path.Combine(_environment.ContentRootPath, "Documents", "invoice.pdf");
    var document = PdfDocument.FromFile(pdfPath);
    // Certificate + image
    string certPath = Path.Combine(_environment.ContentRootPath, "Certificates", "certificate.pfx");
    string imagePath = Path.Combine(_environment.ContentRootPath, "Images", "signature-image.png");
    var signature = new PdfSignature(certPath, "yourPassword");
    var rect = new IronSoftware.Drawing.Rectangle(50, 100, 200, 80);
    signature.LoadSignatureImageFromFile(imagePath, 0, rect);
    // Sign the PDF
    document.Sign(signature);
    string outFile = Path.Combine(Path.GetTempPath(), "signed-visible.pdf");
    document.SaveAs(outFile);
    return PhysicalFile(outFile, "application/pdf", "signed-visible.pdf");
}

How to Add Signature Form Fields for User Signing?

For documents requiring signatures from external users, you can create interactive signature fields within the PDF form. This allows recipients to sign the document using their own certificate or electronic signature software.

[HttpGet("generate-form")]
    public IActionResult GenerateSignableForm()
    {
        var renderer = new ChromePdfRenderer();
        var PDF = renderer.RenderHtmlAsPdf(@"
    <h1>Agreement Form</h1>
    <p>Please sign below to accept the terms.</p>
    <div style='border:1px solid black;width:300px;height:100px;'>Signature:</div>
");
        var field = new SignatureFormField(
            "ClientSignature",
            0,
            50,
            200,
            300,
            100
        );
        pdf.Form.Add(field);
        string outputPath = Path.Combine(Path.GetTempPath(), "agreement-form.pdf");
        pdf.SaveAs(outputPath);
        return PhysicalFile(outputPath, "application/pdf", "agreement-form.pdf");
    }

[HttpGet("generate-form")]
    public IActionResult GenerateSignableForm()
    {
        var renderer = new ChromePdfRenderer();
        var PDF = renderer.RenderHtmlAsPdf(@"
    <h1>Agreement Form</h1>
    <p>Please sign below to accept the terms.</p>
    <div style='border:1px solid black;width:300px;height:100px;'>Signature:</div>
");
        var field = new SignatureFormField(
            "ClientSignature",
            0,
            50,
            200,
            300,
            100
        );
        pdf.Form.Add(field);
        string outputPath = Path.Combine(Path.GetTempPath(), "agreement-form.pdf");
        pdf.SaveAs(outputPath);
        return PhysicalFile(outputPath, "application/pdf", "agreement-form.pdf");
    }

Conclusion

Implementing ASP .NET PDF signatures with IronPDF provides a straightforward, integrated solution for secure document signing. The PDF library supports multiple signing approaches—from certificate-based cryptographic signatures to visible signature images and interactive form fields—giving you flexibility to match your application's requirements.

IronPDF handles the complexity of PDF processing on your .NET Core server, allowing you to generate, sign, and export secure documents with minimal code. The signed PDFs maintain compatibility with standard software like Adobe Acrobat Reader for verification, ensuring your users can trust the document's authenticity.

Ready to implement PDF signing in your project? Purchase an IronPDF license for production use, or download a free trial to explore all features in your development environment. For technical support and feedback, the Iron Software team is available to answer questions and help you build secure document workflows.