Como Assinar Digitalmente um PDF em Java

Como Adicionar uma Imagem de Assinatura Visível a um PDF?

Uma imagem de assinatura visível coloca uma representação gráfica diretamente na página do PDF no local do campo de assinatura. Isso é comumente usado para exibir uma assinatura manual digitalizada, um carimbo da empresa ou um logotipo, para que o documento pareça assinado quando impresso ou visualizado, não apenas quando inspecionado com o painel de assinaturas de um leitor de PDF.

Para adicionar uma imagem visível, abra o arquivo de imagem como um FileInputStream e passe-o para PdfSignature.setSignatureImage(InputStream) antes de chamar signDigitalSignature(). A imagem é incorporada dentro do campo de assinatura na página.

//: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 IronPDF;
import IronPDF;
import IronPDF;

public class Main {
    public static void main(String[] args) throws IOException {
        // Configure a chave de licença do 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 assinatura = new PdfSignature("certificado.pfx", "senha123");

        // 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(assinatura);

        // 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 IronPDF;
import IronPDF;
import IronPDF;

public class Main {
    public static void main(String[] args) throws IOException {
        // Configure a chave de licença do 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 assinatura = new PdfSignature("certificado.pfx", "senha123");

        // 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(assinatura);

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

A imagem de assinatura não substitui a proteção criptográfica; tanto o carimbo gráfico quanto o certificado subjacente continuam parte do resultado assinado. Os formatos PNG e JPEG são suportados para a imagem de assinatura.

Como Certificar um PDF Com um Nível de Permissão Específico?

Certificar um PDF difere de adicionar uma assinatura de aprovação. Ao ligar para pdf.certify(PdfSignature, PdfCertificationLevel), você assina o documento como autor e especifica quais tipos de alterações são permitidas para usuários subsequentes. Um PDF certificado exibe um selo azul ou indicador de confiança semelhante no Adobe Acrobat, sinalizando aos destinatários que o documento provém de uma fonte verificada.

O IronPDF oferece três níveis de certificação através da enumeração PdfCertificationLevel:

• PdfCertificationLevel.NO_CHANGES_ALLOWED: o documento fica totalmente bloqueado após a certificação; nenhuma modificação adicional é permitida.
• PdfCertificationLevel.FORM_FILLING: os destinatários podem preencher os campos do formulário, mas não podem adicionar comentários, anotações ou outras alterações.
• PdfCertificationLevel.FORM_FILLING_AND_ANNOTATIONS: os destinatários podem preencher os campos do formulário e adicionar anotações, mas as edições estruturais ainda são proibidas.

Como a assinatura de certificação deve ser a primeira assinatura em um documento, ligue para certify() antes de adicionar quaisquer assinaturas de aprovação de outras partes.

//: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 IronPDF;
import IronPDF;
import com.ironsoftware.ironpdf.signature.PdfCertificationLevel;
import IronPDF;

public class Main {
    public static void main(String[] args) throws IOException {
        // Configure a chave de licença do 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 IronPDF;
import IronPDF;
import com.ironsoftware.ironpdf.signature.PdfCertificationLevel;
import IronPDF;

public class Main {
    public static void main(String[] args) throws IOException {
        // Configure a chave de licença do 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"));
    }
}

Uma vez certificado com NO_CHANGES_ALLOWED, qualquer tentativa de modificar o PDF invalidará a assinatura de certificação e os visualizadores de PDF exibirão um aviso. Selecione FORM_FILLING ou FORM_FILLING_AND_ANNOTATIONS quando o documento certificado precisar ser preenchido ou anotado por destinatários posteriores sem invalidar a certificação do autor.

Como Adicionar um Indicador de Data e Hora a uma Assinatura Digital?

Um servidor de Autoridade de Carimbo de Tempo (TSA) fornece um token de tempo assinado criptograficamente que é incorporado junto com a assinatura no PDF. Este indicador de data e hora prova quando a assinatura foi aplicada, independentemente do relógio local do assinante. A validade a longo prazo depende de carimbos de tempo: mesmo depois que um certificado de assinatura expira, um carimbo de tempo confiável permite que os validadores confirmem que a assinatura foi criada enquanto o certificado ainda era válido.

Para habilitar a marcação de tempo, defina duas propriedades no objeto PdfSignature antes de assinar:

• setTimestampHashAlgorithm(PdfHashAlgorithm): especifica o algoritmo de hash a ser usado ao calcular o token de carimbo de data/hora. PdfHashAlgorithm.SHA256 é a opção padrão.
• setTimestampUrl(String): o endpoint HTTP ou HTTPS do servidor TSA que emitirá o token de carimbo de data/hora.

Vários servidores TSA estão disponíveis sem custo para testes e uso de produção de baixo volume. https://freetsa.org/tsr e http://timestamp.digicert.com são dois endpoints comumente usados.

//: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 IronPDF;
import IronPDF;
import com.ironsoftware.ironpdf.signature.PdfHashAlgorithm;
import IronPDF;

public class Main {
    public static void main(String[] args) throws IOException {
        // Configure a chave de licença do 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 assinatura = new PdfSignature("certificado.pfx", "senha123");

        // 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(assinatura);

        // 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 IronPDF;
import IronPDF;
import com.ironsoftware.ironpdf.signature.PdfHashAlgorithm;
import IronPDF;

public class Main {
    public static void main(String[] args) throws IOException {
        // Configure a chave de licença do 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 assinatura = new PdfSignature("certificado.pfx", "senha123");

        // 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(assinatura);

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

Quando o TSA está inacessível no momento da assinatura, o IronPDF lançará uma exceção; verifique o acesso à rede e a URL do endpoint TSA antes de implantar em produção. Para fluxos de trabalho de produção de alto volume, considere uma assinatura TSA comercial para garantir o tempo de atividade e as garantias de rendimento.

Quais São os Próximos Passos para Assinar PDFs Digitalmente em Java?

A classe PdfSignature do IronPDF abrange toda a gama de requisitos de assinatura em PDF: assinaturas de aprovação com metadados de certificado, carimbos gráficos visíveis, certificação de PDF com níveis de controle de acesso e carimbos de data/hora com suporte da TSA para validade a longo prazo. Para ampliar seu fluxo de trabalho de PDF além da assinatura, explore estes recursos relacionados:

• Criar Formulários PDF em Java: construa campos de formulário preenchíveis que podem ser completados após um PDF ser certificado
• Preencher Formulários PDF em Java: popula campos de formulário programaticamente em documentos PDF existentes
• Adicionar Anotações a PDFs em Java: anexe comentários, destaques e marcações a locais específicos da página
• Mesclar PDFs em Java: combine vários documentos antes de aplicar uma única assinatura de certificação
• Exemplos de IronPDF for Java: copie e cole exemplos de código cobrindo toda a API do IronPDF Java

Inicie seu teste gratuito para adicionar assinaturas digitais ao seu fluxo de trabalho de PDF em Java. Para adquirir uma licença para uso em produção, veja as opções de licenciamento.