Jak podpisać cyfrowo PDF w Javie

Jak Dodać Widoczny Obraz Podpisu do Pliku PDF?

Widoczny obraz podpisu umieszcza graficzną reprezentację bezpośrednio na stronie PDF w miejscu pola podpisu. Jest to często używane do wyświetlenia zeskanowanego odręcznego podpisu, pieczęci firmowej lub logotypu, aby dokument wyglądał na podpisany, gdy jest drukowany lub przeglądany, a nie tylko podczas sprawdzania w panelu podpisu czytelnika PDF.

Aby dodać widoczny obraz, otwórz plik obrazu jako FileInputStream i przekaż go do PdfSignature.setSignatureImage(InputStream) przed wywołaniem signDigitalSignature(). Obraz jest osadzany w polu podpisu na stronie.

//: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 {
        // Ustaw klucz licencyjny IronPDF
        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 {
        // Ustaw klucz licencyjny IronPDF
        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"));
    }
}

Obraz podpisu nie zastępuje ochrony kryptograficznej; zarówno graficzny stempel, jak i podstawowy certyfikat pozostają częścią podpisanego wyniku. Formaty PNG i JPEG są obsługiwane dla obrazu podpisu.

Jak Certyfikować Dokument PDF Z Określonym Poziomem Uprawnień?

Certyfikowanie dokumentu PDF różni się od dodawania podpisu zatwierdzającego. Wywołując pdf.certify(PdfSignature, PdfCertificationLevel), podpisujesz dokument jako jego autor i określasz, jakie rodzaje zmian są dozwolone dla kolejnych użytkowników. Certyfikowany dokument PDF wyświetla niebieską wstążkę lub podobny wskaźnik zaufania w Adobe Acrobat, sygnalizując odbiorcom, że dokument pochodzi z zweryfikowanego źródła.

IronPDF oferuje trzy poziomy certyfikacji poprzez wyliczenie PdfCertificationLevel:

• PdfCertificationLevel.NO_CHANGES_ALLOWED: dokument jest całkowicie zablokowany po certyfikacji; żadne dalsze modyfikacje nie są dozwolone.
• PdfCertificationLevel.FORM_FILLING: odbiorcy mogą wypełniać pola formularza, ale nie mogą dodawać komentarzy, adnotacji ani innych zmian.
• PdfCertificationLevel.FORM_FILLING_AND_ANNOTATIONS: odbiorcy mogą wypełniać pola formularza i dodawać adnotacje, ale zmiany strukturalne są nadal zabronione.

Ponieważ podpis certyfikacyjny musi być pierwszym podpisem na dokumencie, przed dodaniem jakichkolwiek podpisów zatwierdzających od innych stron należy wywołać certify().

//: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 {
        // Ustaw klucz licencyjny IronPDF
        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 {
        // Ustaw klucz licencyjny IronPDF
        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"));
    }
}

Po certyfikacji za pomocą NO_CHANGES_ALLOWED każda próba modyfikacji pliku PDF spowoduje złamanie podpisu certyfikacyjnego, a przeglądarki plików PDF wyświetlą ostrzeżenie. Wybierz FORM_FILLING lub FORM_FILLING_AND_ANNOTATIONS, gdy certyfikowany dokument musi zostać wypełniony lub opatrzony adnotacjami przez dalszych odbiorców bez unieważniania certyfikacji autora.

Jak Dodać Znacznik Czasu do Podpisu Cyfrowego?

Serwer Urzędu Czasu (TSA) dostarcza kryptograficznie podpisany token czasowy, który jest osadzany razem z podpisem w PDF. Ten znacznik czasu udowadnia, kiedy podpis został zastosowany, niezależnie od lokalnego zegara podpisującego. Długoterminowa ważność zależy od znaczników czasu: nawet po wygaśnięciu certyfikatu podpisującego, zaufany znacznik czasu pozwala walidatorom potwierdzić, że podpis został stworzony, gdy certyfikat był jeszcze ważny.

Aby włączyć oznaczanie czasem, przed podpisaniem należy ustawić dwie właściwości obiektu PdfSignature:

• setTimestampHashAlgorithm(PdfHashAlgorithm): określa algorytm haszujący, który ma być używany podczas obliczania tokenu sygnatury czasowej. PdfHashAlgorithm.SHA256 to standardowy wybór.
• setTimestampUrl(String): punkt końcowy HTTP lub HTTPS serwera TSA, który wygeneruje token znacznika czasu.

Kilka serwerów TSA jest dostępnych bezpłatnie do testowania i niskonakładowych zastosowań produkcyjnych. https://freetsa.org/tsr i http://timestamp.digicert.com to dwa powszechnie używane punkty końcowe.

//: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 {
        // Ustaw klucz licencyjny IronPDF
        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 {
        // Ustaw klucz licencyjny IronPDF
        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"));
    }
}

Gdy TSA jest niedostępny w momencie podpisywania, IronPDF rzuci wyjątek; sprawdź dostępność sieci i adres URL punktu końcowego TSA przed wdrożeniem do produkcji. Dla wysokiego obciążenia, rozważ subskrypcję komercyjnego TSA, aby zapewnić gwarancje dostępności i przepustowości.

Jakie Są Kolejne Kroki dla Podpisywania Cyfrowego Plików PDF w Java?

Klasa PdfSignature firmy IronPDF obejmuje pełen zakres wymagań dotyczących podpisów PDF: podpisy zatwierdzające z metadanymi certyfikatu, widoczne pieczęcie graficzne, certyfikację PDF z poziomami kontroli dostępu oraz sygnatury czasowe wspierane przez TSA zapewniające długoterminową ważność. Aby rozszerzyć swoje przepływy pracy PDF poza podpisywanie, odkryj te powiązane zasoby:

• Twórz Formularze PDF w Java: buduj wypełnialne pola formularzy, które można uzupełniać po certyfikacji PDF
• Wypełniaj Formularze PDF w Java: programatycznie wypełniaj pola formularzy w istniejących dokumentach PDF
• Dodawaj Adnotacje do PDF w Java: dołączaj komentarze, podkreślenia i oznaczenia do określonych miejsc na stronach
• Łącz PDF-y w Java: łącz wiele dokumentów przed zastosowaniem pojedynczego podpisu certyfikacyjnego
• Przykłady IronPDF dla Java: kopiuj-wklej próbki kodu obejmujące pełne API Java IronPDF

Rozpocznij swój bezpłatny okres próbny aby dodać podpisy cyfrowe do swojego przepływu pracy z plikami PDF w Java. Aby zakupić licencję do użycia produkcyjnego, zobacz opcje licencjonowania.