org.apache.pdfbox.examples.signature

Class SigUtils

java.lang.Object

org.apache.pdfbox.examples.signature.SigUtils

public class SigUtils
extends Object

Utility class for the signature / timestamp examples.

Author:

Tilman Hausherr

Method Summary

Modifier and Type	Method and Description
static void	checkCertificateUsage(X509Certificate x509Certificate) Log if the certificate is not valid for signature usage.
static void	checkResponderCertificateUsage(X509Certificate x509Certificate) Log if the certificate is not valid for responding.
static void	checkTimeStampCertificateUsage(X509Certificate x509Certificate) Log if the certificate is not valid for timestamping.
static PDSignature	getLastRelevantSignature(PDDocument document) Gets the last relevant signature in the document, i.e.
static int	getMDPPermission(PDDocument doc) Get the access permissions granted for this document in the DocMDP transform parameters dictionary.
static void	setMDPPermission(PDDocument doc, PDSignature signature, int accessPermissions) Set the access permissions granted for this document in the DocMDP transform parameters dictionary.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

getMDPPermission

public static int getMDPPermission(PDDocument doc)

Get the access permissions granted for this document in the DocMDP transform parameters dictionary. Details are described in the table "Entries in the DocMDP transform parameters dictionary" in the PDF specification.

Parameters:

doc - document.

Returns:

the permission value. 0 means no DocMDP transform parameters dictionary exists. Other return values are 1, 2 or 3. 2 is also returned if the DocMDP transform parameters dictionary is found but did not contain a /P entry, or if the value is outside the valid range.

setMDPPermission

public static void setMDPPermission(PDDocument doc,
                                    PDSignature signature,
                                    int accessPermissions)

Set the access permissions granted for this document in the DocMDP transform parameters dictionary. Details are described in the table "Entries in the DocMDP transform parameters dictionary" in the PDF specification.

Parameters:

doc - The document.

signature - The signature object.

accessPermissions - The permission value (1, 2 or 3).

checkCertificateUsage

public static void checkCertificateUsage(X509Certificate x509Certificate)
                                  throws CertificateParsingException

Log if the certificate is not valid for signature usage. Doing this anyway results in Adobe Reader failing to validate the PDF.

Parameters:

x509Certificate -

Throws:

CertificateParsingException

checkTimeStampCertificateUsage

public static void checkTimeStampCertificateUsage(X509Certificate x509Certificate)
                                           throws CertificateParsingException

Log if the certificate is not valid for timestamping.

Parameters:

x509Certificate -

Throws:

CertificateParsingException

checkResponderCertificateUsage

public static void checkResponderCertificateUsage(X509Certificate x509Certificate)
                                           throws CertificateParsingException

Log if the certificate is not valid for responding.

Parameters:

x509Certificate -

Throws:

CertificateParsingException

getLastRelevantSignature

public static PDSignature getLastRelevantSignature(PDDocument document)
                                            throws IOException

Gets the last relevant signature in the document, i.e. the one with the highest offset.

Parameters:

document - to get its last signature

Returns:

last signature or null when none found

Throws:

IOException