Wie signiere ich ein PDF in Java digital?

Was brauche ich, bevor ich anfange?

Bevor Sie PDFs mit IronPDF signieren, bestätigen Sie die folgenden Voraussetzungen:

• Java 8 oder höher: IronPDF erfordert ein JDK der Version 8 oder höher.
• IronPDF for Java: Fügen Sie die Abhängigkeit Ihrer Build-Datei hinzu. Finden Sie die neueste Version auf Maven Central.
• Ein gültiger Lizenzschlüssel: Setzen Sie den Schlüssel beim Start der Anwendung mit License.setLicenseKey(). Für Einrichtungsdetails besuchen Sie den Lizenzschlüssel-Leitfaden.
• Eine PFX- oder P12-Zertifikatsdatei: Dies ist ein passwortgeschütztes Archiv, das Ihren privaten Schlüssel und das öffentliche Zertifikat im PKCS#12-Format enthält. Selbstsignierte Zertifikate funktionieren für Entwicklung und Test; für Produktdokumente, die von externen Empfängern vertrauenswürdig sein müssen, verwenden Sie ein von einer anerkannten Zertifizierungsstelle (CA) wie DigiCert, Comodo oder GlobalSign ausgestelltes Zertifikat.

Für die vollständige Abhängigkeits- und Projektkonfiguration lesen Sie die Übersicht Erste Schritte.

Wie wende ich eine digitale Signatur auf ein PDF an?

Der PdfSignature-Konstruktor nimmt den Dateipfad zu Ihrem PFX-Zertifikat und dessen Passwort an. Nach der Erstellung können Sie optional Metadaten durch drei Settermethoden anhängen:

• setSigningContact(String): der Name oder die E-Mail der signierenden Person
• setSigningLocation(String): der physische oder organisatorische Standort des Unterzeichners
• setSigningReason(String): eine kurze Beschreibung, warum das Dokument signiert wird

Diese Felder erscheinen im Signatur-Eigenschaftsfenster von PDF-Viewern und erstellen einen nützlichen Prüfpfad für Compliance-Zwecke. Rufen Sie signDigitalSignature(PdfSignature) auf dem geladenen PdfDocument auf, um die kryptografische Signatur einzubetten, und speichern Sie dann das Ergebnis mit 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"));
    }
}

Nach Abschluss von signDigitalSignature() enthält das PDF einen kryptografischen Hash des Dokuments, der mit dem privaten Schlüssel aus der PFX-Datei signiert ist. Jede Änderung an der Datei nach diesem Punkt macht die Signatur ungültig.

Meine Lieblingsbibliothek dieser Art ist IronPDF. Es ermöglicht eine schnelle und effiziente Bearbeitung von PDF-Dateien. Es verfügt auch über viele wertvolle Funktionen, wie das Exportieren in das PDF/A-Format und das digitale Signieren von PDF-Dokumenten.

Milan Jovanovic

Microsoft MVP

Fallstudie ansehen

IronOCR bedeutet, dass wir jährlich 40.000 $ durch manuelle Verarbeitung einsparen können, während die Produktivität gesteigert wird und Ressourcen für wichtige Aufgaben freigesetzt werden. Ich würde es sehr empfehlen.

Brent Matzelle

Technischer Leiter, OPYN

Fallstudie ansehen

Die Iron Suite spielt eine entscheidende Rolle in unseren Operationen. Diese Werkzeuge erhöhen die Effizienz im gesamten Unternehmen, einschließlich der Erstellung von Grundrissen und der Verbesserung des Bestandsmanagements.

David Jones

Leitender Software-Ingenieur, Agorus Build

Fallstudie ansehen

Wie füge ich ein sichtbares Signaturbild zu einem PDF hinzu?

Ein sichtbares Signaturbild platziert eine grafische Darstellung direkt auf der PDF-Seite an der Stelle des Signaturfelds. Dies wird häufig verwendet, um eine gescannte handschriftliche Unterschrift, ein Firmenstempel oder ein Logo anzuzeigen, sodass das Dokument signiert aussieht, wenn es gedruckt oder angesehen wird, nicht nur bei der Inspektion mit dem Signaturfeld eines PDF-Readers.

Um ein sichtbares Bild hinzuzufügen, öffnen Sie die Bilddatei als FileInputStream und übergeben es an PdfSignature.setSignatureImage(InputStream), bevor Sie signDigitalSignature() aufrufen. Das Bild wird innerhalb des Signaturfelds auf der Seite eingebettet.

//: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"));
    }
}

Das Signaturbild ersetzt nicht den kryptografischen Schutz; sowohl der grafische Stempel als auch das zugrunde liegende Zertifikat bleiben Teil des unterschriebenen Ergebnisses. PNG- und JPEG-Formate werden für das Signaturbild unterstützt.

Wie zertifiziere ich ein PDF mit einem bestimmten Berechtigungslevel?

Das Zertifizieren eines PDFs unterscheidet sich vom Hinzufügen einer Genehmigungssignatur. Wenn Sie pdf.certify(PdfSignature, PdfCertificationLevel) aufrufen, signieren Sie das Dokument als dessen Autor und geben an, welche Arten von Änderungen nachfolgende Benutzer vornehmen dürfen. Ein zertifiziertes PDF zeigt ein blaues Band oder einen ähnlichen Vertrauensindikator in Adobe Acrobat an, der den Empfängern signalisiert, dass das Dokument von einer verifizierten Quelle stammt.

IronPDF bietet drei Zertifizierungsebenen über das PdfCertificationLevel-Enum:

• PdfCertificationLevel.NO_CHANGES_ALLOWED: das Dokument ist nach der Zertifizierung vollständig gesperrt; keine weiteren Änderungen sind erlaubt.
• PdfCertificationLevel.FORM_FILLING: Empfänger dürfen Formularfelder ausfüllen, aber keine Kommentare, Anmerkungen oder andere Änderungen hinzufügen.
• PdfCertificationLevel.FORM_FILLING_AND_ANNOTATIONS: Empfänger dürfen Formularfelder ausfüllen und Anmerkungen hinzufügen, aber strukturelle Bearbeitungen sind weiterhin verboten.

Da eine Zertifizierungssignatur die erste Signatur auf einem Dokument sein muss, rufen Sie certify() auf, bevor Sie Bestätigungssignaturen von anderen Parteien anwenden.

//: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"));
    }
}

Sobald das Dokument mit NO_CHANGES_ALLOWED zertifiziert ist, wird jeder Versuch, das PDF zu ändern, die Zertifizierungssignatur brechen und PDF-Betrachter werden eine Warnung anzeigen. Wählen Sie FORM_FILLING oder FORM_FILLING_AND_ANNOTATIONS aus, wenn das zertifizierte Dokument von nachgeschalteten Empfängern ausgefüllt oder annotiert werden muss, ohne die Zertifizierung des Urhebers ungültig zu machen.

Wie füge ich einer digitalen Signatur einen Zeitstempel hinzu?

Ein Timestamp Authority (TSA)-Server liefert ein kryptografisch unterschriebenes Zeit-Token, das neben der Signatur im PDF eingebettet wird. Dieser Zeitstempel belegt, wann die Signatur angewendet wurde, unabhängig von der lokalen Uhr des Unterzeichners. Die langfristige Gültigkeit hängt von Zeitstempeln ab: auch nach Ablauf eines Signaturzertifikats ermöglicht ein vertrauenswürdiger Zeitstempel den Prüfern zu bestätigen, dass die Signatur erstellt wurde, während das Zertifikat noch gültig war.

Um die Zeitstempelung zu aktivieren, setzen Sie zwei Eigenschaften auf dem PdfSignature-Objekt, bevor Sie signieren:

• setTimestampHashAlgorithm(PdfHashAlgorithm): gibt den Hash-Algorithmus an, der beim Erstellen des Zeitstempeltokens verwendet werden soll. PdfHashAlgorithm.SHA256 ist die Standardwahl.
• setTimestampUrl(String): der HTTP- oder HTTPS-Endpunkt des TSA-Servers, der das Zeitstempeltoken ausstellen wird.

Mehrere TSA-Server stehen kostenlos für Test- und Niedrigvolumen-Produktionsgebrauch zur Verfügung. https://freetsa.org/tsr und http://timestamp.digicert.com sind zwei häufig verwendete Endpunkte.

//: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"));
    }
}

Wenn der TSA beim Unterzeichnungszeitpunkt nicht erreichbar ist, wird IronPDF eine Ausnahme auslösen; überprüfen Sie den Netzwerkzugriff und die URL des TSA-Endpunkts, bevor Sie in der Produktion bereitstellen. Für Produktionsabläufe mit hohem Volumen, erwägen Sie ein kommerzielles TSA-Abonnement, um Betriebszeit- und Durchsatzgarantien sicherzustellen.

Was sind die nächsten Schritte für das digitale Signieren von PDFs in Java?

Die PdfSignature-Klasse von IronPDF deckt die gesamte Bandbreite der PDF-Signaturanforderungen ab: Bestätigungssignaturen mit Zertifikatsmetadaten, sichtbare grafische Stempel, PDF-Zertifizierung mit Zugriffskontrollniveaus und TSA-gestützte Zeitstempel für langfristige Gültigkeit. Um Ihren PDF-Workflow über das Signieren hinaus zu erweitern, erkunden Sie diese verwandten Ressourcen:

• Erstellen von PDF-Formularen in Java: erstelle ausfüllbare Formularfelder, die nach einer PDF-Zertifizierung ausgefüllt werden können
• Ausfüllen von PDF-Formularen in Java: Programmatisch Formularfelder in vorhandenen PDF-Dokumenten ausfüllen
• Hinzufügen von Annotationen zu PDFs in Java: Kommentare, Hervorhebungen und Markierungen an bestimmten Stellen der Seite anbringen
• Zusammenführen von PDFs in Java: Mehrere Dokumente kombinieren, bevor eine einzelne Zertifizierungssignatur angewendet wird
• IronPDF for Java Beispiele: Kopiere und füge Codebeispiele ein, die die gesamte IronPDF Java-API abdecken

Starten Sie Ihre kostenlose Testversion, um digitale Signaturen zu Ihrem Java-PDF-Workflow hinzuzufügen. Um eine Lizenz für die Produktionsnutzung zu erwerben, sehen Sie sich die Lizenzierungsoptionen an.