How to add Smart Card signature to PDF

Aspose.PDF provides robust capabilities for integrating visual and cryptographic signature components, ensuring both authenticity and professional presentation in digitally signed PDF documents.

Sign With Smart Card Using Signature Field

This example demonstrates how to digitally sign a PDF document using an external certificate with Aspose.PDF for Python and apply a custom signature appearance image:

1. Opening the PDF document.
2. Creating a PdfFileSignature object and binding it to the document.
3. Retrieving a local digital certificate using a custom method get_local_certificate().
4. Setting up an ExternalSignature based on the selected certificate.
5. Applying a custom signature appearance image (e.g., a company logo or handwritten signature).
6. Digitally signing the first page of the document with specified metadata (reason, contact, location).
7. Saving the signed document to a new output file.

This method is ideal for cases where signatures must be applied programmatically using external certificates—such as hardware tokens, certificate stores, or trusted providers—and presented with a personalized visual layout.

Following are the code snippets to sign a PDF document from a smart card:

    import aspose.pdf as ap
    import aspose.pydrawing as drawing

    path_infile = self.data_dir + infile
    path_outfile = self.data_dir + outfile
    path_pngfile = self.data_dir + pngfile

    # Open PDF document
    with ap.Document(path_infile) as document:
        with ap.facades.PdfFileSignature() as pdf_signature:
            # Bind PDF document
            pdf_signature.bind_pdf(document)
            selected_certificates = self.get_local_certificate()
            # Set an external signature settings
            external_signature = ap.forms.ExternalSignature(selected_certificates)
            pdf_signature.signature_appearance = path_pngfile
            # Sign the document
            pdf_signature.sign(1, "Reason", "Contact", "Location", True, drawing.Rectangle(100, 100, 200, 200),
                                external_signature)
            # Save PDF document
            pdf_signature.save(path_outfile)

Verify Digital Signatures

This code snippet demonstrates how to verify digital signatures in a PDF document using Aspose.PDF for Python:

1. Opening the PDF file.
2. Creating a ‘PdfFileSignature object’ and binding it to the document.
3. Retrieving the list of all signature field names using ‘get_signature_names()’.
4. Iterating through each signature and verifying its validity with ‘verify_signature()’.
5. Raising an exception if any signature fails verification.

    import aspose.pdf as ap

    path_infile = self.data_dir + infile

    # Open PDF document
    with ap.Document(path_infile) as document:
        with ap.facades.PdfFileSignature(document) as pdf_signature:
            signature_names = pdf_signature.get_signature_names(True)
            for index in range(len(signature_names)):
                if not pdf_signature.verify_signature(signature_names[index]):
                    raise Exception("Not verified")

Sign with External Certificate

This code snippet demonstrates how to add and sign a digital signature field in a PDF document using Aspose.PDF for Python with an external certificate:

1. Opening the PDF file as a binary stream.
2. Creating a SignatureField and placing it on the first page of the document at a specified position.
3. Retrieving a local digital certificate using a custom method get_local_certificate().
4. Setting up an ExternalSignature with metadata such as authority, reason, and contact information.
5. Assigning a unique field name to the signature field (partial_name = “sig1”).
6. Adding the signature field to the form fields of the PDF.
7. Signing the field with the external certificate.
8. Saving the signed document to an output file.

    import aspose.pdf as ap

    path_infile = self.data_dir + infile
    path_outfile = self.data_dir + outfile

    # Open a document stream
    with open(path_infile, "rb+") as file_stream:
        # Open PDF document from stream
        document = ap.Document(file_stream)

        # Create a signature field
        signature_field = ap.forms.SignatureField(document.pages[1], ap.Rectangle(100, 400, 10, 10, True))
        selected_certificate = self.get_local_certificate()

        # Set external signature settings
        external_signature = ap.forms.ExternalSignature(selected_certificate)
        external_signature.authority = "Me"
        external_signature.reason = "Reason"
        external_signature.contact_info = "Contact"

        # Set a name of signature field
        signature_field.partial_name = "sig1"

        # Add the signature field to the document
        document.form.add(signature_field, 1)

        # Sign the document
        signature_field.sign(external_signature)

        # Save PDF document
        document.save(path_outfile)