Comment signer numériquement un PDF en Java

De quoi ai-je besoin avant de commencer?

Avant de signer des PDF avec IronPDF, confirmez les prérequis suivants :

• Java 8 ou supérieur : IronPDF nécessite un JDK version 8 ou supérieure.
• IronPDF for Java : Ajoutez la dépendance à votre fichier de construction. Trouvez la dernière version sur Maven Central.
• Une clé de licence valide : Définissez la clé au démarrage de l'application avec License.setLicenseKey(). Pour les détails de configuration, visitez le guide des clés de licence.
• Un fichier de certificat PFX ou P12 : C'est une archive protégée par mot de passe contenant votre clé privée et certificat public au format PKCS#12. Les certificats auto-signés fonctionnent pour le développement et les tests; pour les documents de production qui doivent être dignes de confiance pour les destinataires externes, utilisez un certificat délivré par une autorité de certification reconnue (CA) telle que DigiCert, Comodo ou GlobalSign.

Pour la configuration complète des dépendances et du projet, consultez la Vue d'ensemble de démarrage.

Comment puis-je appliquer une signature numérique à un PDF ?

Le constructeur PdfSignature prend le chemin d'accès à votre certificat PFX et son mot de passe. Une fois construit, vous pouvez attacher des métadonnées optionnelles via trois méthodes de définition :

• setSigningContact(String) : le nom ou l'email de la personne signant
• setSigningLocation(String) : le lieu physique ou organisationnel du signataire
• setSigningReason(String) : une brève description de pourquoi le document est signé

Ces champs apparaissent dans le panneau des propriétés de la signature des visualiseurs PDF et créent un enregistrement d'audit utile à des fins de conformité. Appelez signDigitalSignature(PdfSignature) sur le PdfDocument chargé pour intégrer la signature cryptographique, puis enregistrez le résultat avec saveAs().

//:path=/static-assets/ironpdf-java/content-code-examples/how-to/how-to-digitally-sign-pdfs-java-tutorial/apply-signature.java
import java.io.IOException;
import java.nio.file.Path;
import com.ironsoftware.ironpdf.License;
import com.ironsoftware.ironpdf.PdfDocument;
import com.ironsoftware.ironpdf.signature.PdfSignature;

public class Main {
    public static void main(String[] args) throws IOException {
        // Set the IronPDF license key
        License.setLicenseKey("IRONPDF-MYLICENSE-KEY-1EF01");

        // Load the PDF to sign
        PdfDocument pdf = PdfDocument.fromFile(Path.of("contract.pdf"));

        // Construct the PdfSignature with the certificate path and password
        PdfSignature signature = new PdfSignature("certificate.pfx", "password123");

        // Set metadata that will appear in the signature properties panel
        signature.setSigningContact("Jane Doe");
        signature.setSigningLocation("Austin, TX");
        signature.setSigningReason("Contract Approval");

        // Embed the digital signature in the PDF
        pdf.signDigitalSignature(signature);

        // Save the signed document
        pdf.saveAs(Path.of("contract-signed.pdf"));
    }
}

//:path=/static-assets/ironpdf-java/content-code-examples/how-to/how-to-digitally-sign-pdfs-java-tutorial/apply-signature.java
import java.io.IOException;
import java.nio.file.Path;
import com.ironsoftware.ironpdf.License;
import com.ironsoftware.ironpdf.PdfDocument;
import com.ironsoftware.ironpdf.signature.PdfSignature;

public class Main {
    public static void main(String[] args) throws IOException {
        // Set the IronPDF license key
        License.setLicenseKey("IRONPDF-MYLICENSE-KEY-1EF01");

        // Load the PDF to sign
        PdfDocument pdf = PdfDocument.fromFile(Path.of("contract.pdf"));

        // Construct the PdfSignature with the certificate path and password
        PdfSignature signature = new PdfSignature("certificate.pfx", "password123");

        // Set metadata that will appear in the signature properties panel
        signature.setSigningContact("Jane Doe");
        signature.setSigningLocation("Austin, TX");
        signature.setSigningReason("Contract Approval");

        // Embed the digital signature in the PDF
        pdf.signDigitalSignature(signature);

        // Save the signed document
        pdf.saveAs(Path.of("contract-signed.pdf"));
    }
}

Après l'achèvement de signDigitalSignature(), le PDF contient un hachage cryptographique du contenu du document signé avec la clé privée du fichier PFX. Toute modification du fichier après ce point invalidera la signature.

Ma bibliothèque préférée de ce genre est IronPDF. Elle permet une manipulation rapide et efficace des fichiers PDF. Elle dispose également de nombreuses fonctionnalités précieuses, comme l'exportation au format PDF/A et la signature numérique des documents PDF.

Milan Jovanovic

Microsoft MVP

Voir l'étude de cas

IronOCR signifie que nous pouvons économiser 40 000 $ par an grâce au traitement manuel, tout en améliorant la productivité et en libérant des ressources pour des tâches à fort impact. Je le recommande vivement.

Brent Matzelle

Directeur technique, OPYN

Voir l'étude de cas

Iron Suite joue un rôle crucial dans nos opérations. Ce sont des outils qui augmentent l'efficacité de l'entreprise, y compris la création de plans d'étage et l'amélioration de la gestion des stocks.

David Jones

Ingénieur logiciel principal, Agorus Build

Voir l'étude de cas

Comment puis-je ajouter une image de signature visible à un PDF ?

Une image de signature visible place une représentation graphique directement sur la page du PDF à l'emplacement du champ de signature. C'est couramment utilisé pour afficher une signature manuscrite numérisée, un tampon d'entreprise, ou un logo afin que le document semble signé lorsqu'il est imprimé ou visualisé, et pas seulement inspecté avec le panneau des signatures d'un lecteur PDF.

Pour ajouter une image visible, ouvrez le fichier image en tant que FileInputStream et passez-le à PdfSignature.setSignatureImage(InputStream) avant d'appeler signDigitalSignature(). L'image est intégrée dans le champ de signature sur la page.

//:path=/static-assets/ironpdf-java/content-code-examples/how-to/how-to-digitally-sign-pdfs-java-tutorial/visible-signature-image.java
import java.io.FileInputStream;
import java.io.IOException;
import java.nio.file.Path;
import com.ironsoftware.ironpdf.License;
import com.ironsoftware.ironpdf.PdfDocument;
import com.ironsoftware.ironpdf.signature.PdfSignature;

public class Main {
    public static void main(String[] args) throws IOException {
        // Set the IronPDF license key
        License.setLicenseKey("IRONPDF-MYLICENSE-KEY-1EF01");

        // Load the PDF document to sign
        PdfDocument pdf = PdfDocument.fromFile(Path.of("agreement.pdf"));

        // Build the PdfSignature from a PFX certificate
        PdfSignature signature = new PdfSignature("certificate.pfx", "password123");

        // Set signing metadata
        signature.setSigningContact("Alice Johnson");
        signature.setSigningLocation("Chicago, IL");
        signature.setSigningReason("Agreement Authorization");

        // Open the signature image file and attach it to the signature
        FileInputStream imageStream = new FileInputStream("signature.png");
        signature.setSignatureImage(imageStream);

        // Apply the digital signature with the visible image to the PDF
        pdf.signDigitalSignature(signature);

        // Save the signed PDF with the visible signature image embedded
        pdf.saveAs(Path.of("agreement-signed.pdf"));
    }
}

//:path=/static-assets/ironpdf-java/content-code-examples/how-to/how-to-digitally-sign-pdfs-java-tutorial/visible-signature-image.java
import java.io.FileInputStream;
import java.io.IOException;
import java.nio.file.Path;
import com.ironsoftware.ironpdf.License;
import com.ironsoftware.ironpdf.PdfDocument;
import com.ironsoftware.ironpdf.signature.PdfSignature;

public class Main {
    public static void main(String[] args) throws IOException {
        // Set the IronPDF license key
        License.setLicenseKey("IRONPDF-MYLICENSE-KEY-1EF01");

        // Load the PDF document to sign
        PdfDocument pdf = PdfDocument.fromFile(Path.of("agreement.pdf"));

        // Build the PdfSignature from a PFX certificate
        PdfSignature signature = new PdfSignature("certificate.pfx", "password123");

        // Set signing metadata
        signature.setSigningContact("Alice Johnson");
        signature.setSigningLocation("Chicago, IL");
        signature.setSigningReason("Agreement Authorization");

        // Open the signature image file and attach it to the signature
        FileInputStream imageStream = new FileInputStream("signature.png");
        signature.setSignatureImage(imageStream);

        // Apply the digital signature with the visible image to the PDF
        pdf.signDigitalSignature(signature);

        // Save the signed PDF with the visible signature image embedded
        pdf.saveAs(Path.of("agreement-signed.pdf"));
    }
}

L'image de signature ne remplace pas la protection cryptographique; le timbre graphique et le certificat sous-jacent restent tous deux partie du résultat signé. Les formats PNG et JPEG sont pris en charge pour l'image de signature.

Comment puis-je certifier un PDF avec un niveau de permission spécifique ?

La certification d'un PDF diffère de l'ajout d'une signature d'approbation. Lorsque vous appelez pdf.certify(PdfSignature, PdfCertificationLevel), vous signez le document en tant qu'auteur et spécifiez quels types de modifications sont autorisés par les utilisateurs suivants. Un PDF certifié affiche un ruban bleu ou un indicateur de confiance similaire dans Adobe Acrobat, signalant aux destinataires que le document provient d'une source vérifiée.

IronPDF offre trois niveaux de certification via l'énumération PdfCertificationLevel :

• PdfCertificationLevel.NO_CHANGES_ALLOWED : le document est entièrement verrouillé après certification ; aucune autre modification n'est permise.
• PdfCertificationLevel.FORM_FILLING : les destinataires peuvent remplir les champs du formulaire mais ne peuvent pas ajouter de commentaires, d'annotations ou d'autres modifications.
• PdfCertificationLevel.FORM_FILLING_AND_ANNOTATIONS : les destinataires peuvent remplir les champs du formulaire et ajouter des annotations, mais les modifications structurelles sont toujours interdites.

Parce qu'une signature de certification doit être la première signature sur un document, appelez certify() avant d'appliquer des signatures d'approbation d'autres parties.

//:path=/static-assets/ironpdf-java/content-code-examples/how-to/how-to-digitally-sign-pdfs-java-tutorial/certify-pdf.java
import java.io.IOException;
import java.nio.file.Path;
import com.ironsoftware.ironpdf.License;
import com.ironsoftware.ironpdf.PdfDocument;
import com.ironsoftware.ironpdf.signature.PdfCertificationLevel;
import com.ironsoftware.ironpdf.signature.PdfSignature;

public class Main {
    public static void main(String[] args) throws IOException {
        // Set the IronPDF license key
        License.setLicenseKey("IRONPDF-MYLICENSE-KEY-1EF01");

        // Load the PDF that will be certified
        PdfDocument pdf = PdfDocument.fromFile(Path.of("report.pdf"));

        // Create the PdfSignature from the author's certificate
        PdfSignature signature = new PdfSignature("author-certificate.pfx", "password123");

        // Set author metadata for the certification signature
        signature.setSigningContact("Legal Department");
        signature.setSigningLocation("San Francisco, CA");
        signature.setSigningReason("Official Publication");

        // Certify the document with NO_CHANGES_ALLOWED to lock it completely
        // Use FORM_FILLING to allow form field input after certification
        // Use FORM_FILLING_AND_ANNOTATIONS to also permit annotations
        pdf.certify(signature, PdfCertificationLevel.NO_CHANGES_ALLOWED);

        // Save the certified PDF
        pdf.saveAs(Path.of("report-certified.pdf"));
    }
}

//:path=/static-assets/ironpdf-java/content-code-examples/how-to/how-to-digitally-sign-pdfs-java-tutorial/certify-pdf.java
import java.io.IOException;
import java.nio.file.Path;
import com.ironsoftware.ironpdf.License;
import com.ironsoftware.ironpdf.PdfDocument;
import com.ironsoftware.ironpdf.signature.PdfCertificationLevel;
import com.ironsoftware.ironpdf.signature.PdfSignature;

public class Main {
    public static void main(String[] args) throws IOException {
        // Set the IronPDF license key
        License.setLicenseKey("IRONPDF-MYLICENSE-KEY-1EF01");

        // Load the PDF that will be certified
        PdfDocument pdf = PdfDocument.fromFile(Path.of("report.pdf"));

        // Create the PdfSignature from the author's certificate
        PdfSignature signature = new PdfSignature("author-certificate.pfx", "password123");

        // Set author metadata for the certification signature
        signature.setSigningContact("Legal Department");
        signature.setSigningLocation("San Francisco, CA");
        signature.setSigningReason("Official Publication");

        // Certify the document with NO_CHANGES_ALLOWED to lock it completely
        // Use FORM_FILLING to allow form field input after certification
        // Use FORM_FILLING_AND_ANNOTATIONS to also permit annotations
        pdf.certify(signature, PdfCertificationLevel.NO_CHANGES_ALLOWED);

        // Save the certified PDF
        pdf.saveAs(Path.of("report-certified.pdf"));
    }
}

Une fois certifié avec NO_CHANGES_ALLOWED, toute tentative de modification du PDF brisera la signature de certification et les visionneuses PDF afficheront un avertissement. Choisissez FORM_FILLING ou FORM_FILLING_AND_ANNOTATIONS lorsque le document certifié a besoin d'être rempli ou annoté par des destinataires ultérieurs sans invalider la certification de l'auteur.

Comment puis-je ajouter un horodatage à une signature numérique ?

Un serveur d'Autorité de Horodatage (TSA) fournit un jeton temporel signé cryptographiquement qui est intégré aux côtés de la signature dans le PDF. Cet horodatage prouve quand la signature a été appliquée, indépendamment de l'horloge locale du signataire. La validité à long terme dépend des horodatages : même après l'expiration d'un certificat de signature, un horodatage fiable permet aux validateurs de confirmer que la signature a été créée alors que le certificat était encore valide.

Pour activer la timestamping, définissez deux propriétés sur l'objet PdfSignature avant de signer :

• setTimestampHashAlgorithm(PdfHashAlgorithm) : spécifie l'algorithme de hachage à utiliser lors de la création du jeton de timestamp. PdfHashAlgorithm.SHA256 est le choix standard.
• setTimestampUrl(String) : l'adresse HTTP ou HTTPS du serveur TSA qui délivrera le jeton de timestamp.

Plusieurs serveurs TSA sont disponibles sans frais pour les tests et une utilisation en production à faible volume. https://freetsa.org/tsr et http://timestamp.digicert.com sont deux points d'accès couramment utilisés.

//:path=/static-assets/ironpdf-java/content-code-examples/how-to/how-to-digitally-sign-pdfs-java-tutorial/timestamp-signature.java
import java.io.IOException;
import java.nio.file.Path;
import com.ironsoftware.ironpdf.License;
import com.ironsoftware.ironpdf.PdfDocument;
import com.ironsoftware.ironpdf.signature.PdfHashAlgorithm;
import com.ironsoftware.ironpdf.signature.PdfSignature;

public class Main {
    public static void main(String[] args) throws IOException {
        // Set the IronPDF license key
        License.setLicenseKey("IRONPDF-MYLICENSE-KEY-1EF01");

        // Load the PDF to sign with a timestamp
        PdfDocument pdf = PdfDocument.fromFile(Path.of("invoice.pdf"));

        // Construct the PdfSignature from the certificate file
        PdfSignature signature = new PdfSignature("certificate.pfx", "password123");

        // Set signature metadata
        signature.setSigningContact("Finance Team");
        signature.setSigningLocation("Seattle, WA");
        signature.setSigningReason("Invoice Authorization");

        // Configure the timestamp: set the hash algorithm and TSA endpoint
        signature.setTimestampHashAlgorithm(PdfHashAlgorithm.SHA256);
        signature.setTimestampUrl("https://freetsa.org/tsr");

        // Apply the digital signature; IronPDF will contact the TSA to obtain
        // and embed a timestamp token alongside the cryptographic signature
        pdf.signDigitalSignature(signature);

        // Save the timestamped, signed PDF
        pdf.saveAs(Path.of("invoice-signed-timestamped.pdf"));
    }
}

//:path=/static-assets/ironpdf-java/content-code-examples/how-to/how-to-digitally-sign-pdfs-java-tutorial/timestamp-signature.java
import java.io.IOException;
import java.nio.file.Path;
import com.ironsoftware.ironpdf.License;
import com.ironsoftware.ironpdf.PdfDocument;
import com.ironsoftware.ironpdf.signature.PdfHashAlgorithm;
import com.ironsoftware.ironpdf.signature.PdfSignature;

public class Main {
    public static void main(String[] args) throws IOException {
        // Set the IronPDF license key
        License.setLicenseKey("IRONPDF-MYLICENSE-KEY-1EF01");

        // Load the PDF to sign with a timestamp
        PdfDocument pdf = PdfDocument.fromFile(Path.of("invoice.pdf"));

        // Construct the PdfSignature from the certificate file
        PdfSignature signature = new PdfSignature("certificate.pfx", "password123");

        // Set signature metadata
        signature.setSigningContact("Finance Team");
        signature.setSigningLocation("Seattle, WA");
        signature.setSigningReason("Invoice Authorization");

        // Configure the timestamp: set the hash algorithm and TSA endpoint
        signature.setTimestampHashAlgorithm(PdfHashAlgorithm.SHA256);
        signature.setTimestampUrl("https://freetsa.org/tsr");

        // Apply the digital signature; IronPDF will contact the TSA to obtain
        // and embed a timestamp token alongside the cryptographic signature
        pdf.signDigitalSignature(signature);

        // Save the timestamped, signed PDF
        pdf.saveAs(Path.of("invoice-signed-timestamped.pdf"));
    }
}

Lorsque le TSA est inaccessible au moment de la signature, IronPDF lancera une exception; vérifiez l'accès réseau et l'URL de l'endpoint TSA avant de déployer en production. Pour les flux de travail de production à haut volume, envisagez un abonnement commercial TSA pour garantir disponibilité et garanties de débit.

Quelles sont les prochaines étapes pour signer numériquement des PDF en Java ?

La classe PdfSignature d'IronPDF couvre l'ensemble des exigences de signature PDF : signatures d'approbation avec métadonnées de certificat, tampons graphiques visibles, certification PDF avec niveaux de contrôle d'accès, et timestamps soutenus par la TSA pour une validité à long terme. Pour étendre votre flux de travail PDF au-delà de la signature, explorez ces ressources connexes :

• Créer des formulaires PDF en Java : construisez des champs de formulaire remplissables qui peuvent être complétés après la certification d'un PDF
• Remplir des formulaires PDF en Java : remplissez par programmation les champs de formulaire dans des documents PDF existants
• Ajouter des annotations aux PDF en Java : attachez des commentaires, surlignages, et annotations à des emplacements de page spécifiques
• Fusionner des PDFs en Java : combinez plusieurs documents avant d'appliquer une signature de certification unique
• Exemples IronPDF for Java : copiez-collez des exemples de code couvrant toute l'API Java d'IronPDF

Commencez votre essai gratuit pour ajouter des signatures numériques à votre flux de travail Java PDF. Pour acheter une licence pour une utilisation en production, voir les options de licence.