com.itextpdf.signatures

Class LtvVerification

java.lang.Object

com.itextpdf.signatures.LtvVerification

public class LtvVerification
extends Object

Add verification according to PAdES-LTV (part 4).

Author:

Paulo Soares

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	LtvVerification.CertificateInclusion Certificate inclusion in the DSS and VRI dictionaries in the CERT and CERTS keys.
static class	LtvVerification.CertificateOption Options for how many certificates to include.
static class	LtvVerification.Level What type of verification to include.

Constructor Summary

Constructors

Constructor and Description
LtvVerification(PdfDocument document) The verification constructor.
LtvVerification(PdfDocument document, String securityProviderCode) The verification constructor.

Method Summary

Modifier and Type	Method and Description
boolean	addVerification(String signatureName, Collection<byte[]> ocsps, Collection<byte[]> crls, Collection<byte[]> certs) Adds verification to the signature.
boolean	addVerification(String signatureName, IOcspClient ocsp, ICrlClient crl, LtvVerification.CertificateOption certOption, LtvVerification.Level level, LtvVerification.CertificateInclusion certInclude) Add verification for a particular signature.
static String	convertToHex(byte[] bytes) Converts an array of bytes to a String of hexadecimal values
void	merge() Merges the validation with any validation already in the document or creates a new one.

Methods inherited from class java.lang.Object

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

Constructor Detail

LtvVerification

public LtvVerification(PdfDocument document)

The verification constructor. This class should only be created with PdfStamper.getLtvVerification() otherwise the information will not be added to the Pdf.

Parameters:

document - The PdfDocument to apply the validation to.

LtvVerification

public LtvVerification(PdfDocument document,
                       String securityProviderCode)

The verification constructor. This class should only be created with PdfStamper.getLtvVerification() otherwise the information will not be added to the Pdf.

Parameters:

document - The PdfDocument to apply the validation to.

securityProviderCode - Security provider to use

Method Detail

addVerification

public boolean addVerification(String signatureName,
                               IOcspClient ocsp,
                               ICrlClient crl,
                               LtvVerification.CertificateOption certOption,
                               LtvVerification.Level level,
                               LtvVerification.CertificateInclusion certInclude)
                        throws IOException,
                               GeneralSecurityException

Add verification for a particular signature.

Parameters:

signatureName - the signature to validate (it may be a timestamp)

ocsp - the interface to get the OCSP

crl - the interface to get the CRL

certOption - options as to how many certificates to include

level - the validation options to include

certInclude - certificate inclusion options

Returns:

true if a validation was generated, false otherwise

Throws:

GeneralSecurityException - when requested cryptographic algorithm or security provider is not available

IOException - signals that an I/O exception has occurred

addVerification

public boolean addVerification(String signatureName,
                               Collection<byte[]> ocsps,
                               Collection<byte[]> crls,
                               Collection<byte[]> certs)
                        throws IOException,
                               GeneralSecurityException

Adds verification to the signature.

Parameters:

signatureName - name of the signature

ocsps - collection of DER-encoded BasicOCSPResponses

crls - collection of DER-encoded CRLs

certs - collection of DER-encoded certificates

Returns:

boolean

Throws:

IOException - signals that an I/O exception has occurred

GeneralSecurityException - when requested cryptographic algorithm or security provider is not available

merge

public void merge()

Merges the validation with any validation already in the document or creates a new one.

convertToHex

public static String convertToHex(byte[] bytes)

Converts an array of bytes to a String of hexadecimal values

Parameters:

bytes - a byte array

Returns:

the same bytes expressed as hexadecimal values