Package com.itextpdf.signatures

Class LtvVerifier

java.lang.Object

com.itextpdf.signatures.CertificateVerifier

com.itextpdf.signatures.RootStoreVerifier

com.itextpdf.signatures.LtvVerifier

 public class LtvVerifier extends RootStoreVerifier 
      

Verifies the signatures in an LTV document.

Field Summary

Fields

Modifier and Type	Field	Description
protected PdfAcroForm	acroForm	The fields in the revision that is being verified.
protected PdfDocument	document	A document object for the revision that is being verified.
protected PdfDictionary	dss	The document security store for the revision that is being verified
protected boolean	latestRevision	Indicates if we're working with the latest revision.
protected static final org.slf4j.Logger	LOGGER	The Logger instance
protected IMetaInfo	metaInfo	The meta info
protected LtvVerification.CertificateOption	option	Option to specify level of verification; signing certificate only or the entire chain.
protected PdfPKCS7	pkcs7	The PdfPKCS7 object for the signature.
protected String	securityProviderCode	Security provider to use, use null for default
protected String	signatureName	The signature that covers the revision.
protected Date	signDate	The date the revision was signed, or null for the highest revision.
protected boolean	verifyRootCertificate	Verify root.

Fields inherited from class com.itextpdf.signatures.RootStoreVerifier

rootStore

Fields inherited from class com.itextpdf.signatures.CertificateVerifier

onlineCheckingAllowed, verifier

Constructor Summary

Constructors

Constructor	Description
LtvVerifier(PdfDocument document)	Creates a VerificationData object for a PdfReader
LtvVerifier(PdfDocument document, String securityProviderCode)

Method Summary

Modifier and Type	Method	Description
protected PdfPKCS7	coversWholeDocument()	Checks if the signature covers the whole document and throws an exception if the document was altered
List<X509CRL>	getCRLsFromDSS()	Gets a list of X509CRL objects from a Document Security Store.
List<IBasicOCSPResp>	getOCSPResponsesFromDSS()	Gets OCSP responses from the Document Security Store.
protected void	initLtvVerifier(PdfDocument document)
void	setCertificateOption(LtvVerification.CertificateOption option)	Sets the certificate option.
void	setEventCountingMetaInfo(IMetaInfo metaInfo)	Sets the IMetaInfo that will be used during PdfDocument creation.
void	setVerifier(CertificateVerifier verifier)	Sets an extra verifier.
void	setVerifyRootCertificate(boolean verifyRootCertificate)	Set the verifyRootCertificate to false if you can't verify the root certificate.
void	switchToPreviousRevision()	Switches to the previous revision.
List<VerificationOK>	verify(X509Certificate signCert, X509Certificate issuerCert, Date signDate)	Verifies certificates against a list of CRLs and OCSP responses.
List<VerificationOK>	verify(List<VerificationOK> result)	Verifies all the document-level timestamps and all the signatures in the document.
void	verifyChain(Certificate[] chain)	Checks the certificates in a certificate chain: are they valid on a specific date, and do they chain up correctly?
List<VerificationOK>	verifySignature()	Verifies a document level timestamp.

Methods inherited from class com.itextpdf.signatures.RootStoreVerifier

setRootStore

Methods inherited from class com.itextpdf.signatures.CertificateVerifier

setOnlineCheckingAllowed

Methods inherited from class java.lang.Object

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

Field Details

LOGGER

 protected static final org.slf4j.Logger LOGGER 
            

The Logger instance

option

 protected LtvVerification.CertificateOption option 
            

Option to specify level of verification; signing certificate only or the entire chain.

verifyRootCertificate

 protected boolean verifyRootCertificate 
            

Verify root.

document

 protected PdfDocument document 
            

A document object for the revision that is being verified.

acroForm

 protected PdfAcroForm acroForm 
            

The fields in the revision that is being verified.

signDate

 protected Date signDate 
            

The date the revision was signed, or null for the highest revision.

signatureName

 protected String signatureName 
            

The signature that covers the revision.

pkcs7

 protected PdfPKCS7 pkcs7 
            

The PdfPKCS7 object for the signature.

latestRevision

 protected boolean latestRevision 
            

Indicates if we're working with the latest revision.

dss

 protected PdfDictionary dss 
            

The document security store for the revision that is being verified

securityProviderCode

 protected String securityProviderCode 
            

Security provider to use, use null for default

metaInfo

 protected IMetaInfo metaInfo 
            

The meta info

Constructor Details

LtvVerifier

 public LtvVerifier 
             (PdfDocument document) throws GeneralSecurityException 
            

Creates a VerificationData object for a PdfReader

Parameters:

document - The document we want to verify.

Throws:

GeneralSecurityException - if some problem with signature or security are occurred

LtvVerifier

 public LtvVerifier 
             (PdfDocument document, String securityProviderCode) throws GeneralSecurityException 
            

Throws:

GeneralSecurityException

Method Details

setVerifier

 public void setVerifier 
             (CertificateVerifier verifier) 
            

Sets an extra verifier.

Parameters:

verifier - the verifier to set

setCertificateOption

 public void setCertificateOption 
             (LtvVerification.CertificateOption option) 
            

Sets the certificate option.

Parameters:

option - Either CertificateOption.SIGNING_CERTIFICATE (default) or CertificateOption.WHOLE_CHAIN

setVerifyRootCertificate

 public void setVerifyRootCertificate 
             (boolean verifyRootCertificate) 
            

Set the verifyRootCertificate to false if you can't verify the root certificate.

Parameters:

verifyRootCertificate - false if you can't verify the root certificate, otherwise true

setEventCountingMetaInfo

 public void setEventCountingMetaInfo 
             (IMetaInfo metaInfo) 
            

Sets the IMetaInfo that will be used during PdfDocument creation.

Parameters:

metaInfo - meta info to set

verify

 public List<VerificationOK> verify 
             (List<VerificationOK> result) throws IOException, GeneralSecurityException 
            

Verifies all the document-level timestamps and all the signatures in the document.

Parameters:

result - a list of VerificationOK objects

Returns:

a list of all VerificationOK objects after verification

Throws:

IOException - signals that an I/O exception has occurred

GeneralSecurityException - if some problems with signature or security occurred

verifySignature

 public List<VerificationOK> verifySignature() throws GeneralSecurityException, IOException 
            

Verifies a document level timestamp.

Returns:

a list of VerificationOK objects

Throws:

GeneralSecurityException - if some problems with signature or security occurred

IOException - signals that an I/O exception has occurred

verifyChain

 public void verifyChain 
             (Certificate[] chain) throws GeneralSecurityException 
            

Checks the certificates in a certificate chain: are they valid on a specific date, and do they chain up correctly?

Parameters:

chain - the certificate chain

Throws:

GeneralSecurityException - when requested cryptographic algorithm or security provider is not available, if the certificate is invalid on a specific date and if the certificates chained up incorrectly

verify

 public List<VerificationOK> verify 
             (X509Certificate signCert, X509Certificate issuerCert, Date signDate) throws GeneralSecurityException 
            

Verifies certificates against a list of CRLs and OCSP responses.

Overrides:

verify in class RootStoreVerifier

Parameters:

signCert - the signing certificate

issuerCert - the issuer's certificate

signDate - the date the certificate needs to be valid

Returns:

a list of VerificationOK objects. The list will be empty if the certificate couldn't be verified.

Throws:

GeneralSecurityException - if some problems with signature or security occurred

See Also:

• RootStoreVerifier.verify(java.security.cert.X509Certificate, java.security.cert.X509Certificate, java.util.Date)

switchToPreviousRevision

 public void switchToPreviousRevision() throws IOException, GeneralSecurityException 
            

Switches to the previous revision.

Throws:

IOException - signals that an I/O exception has occurred

GeneralSecurityException - if some problems with signature or security occurred

getCRLsFromDSS

 public List<X509CRL> getCRLsFromDSS() throws GeneralSecurityException 
            

Gets a list of X509CRL objects from a Document Security Store.

Returns:

a list of CRLs

Throws:

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

getOCSPResponsesFromDSS

 public List<IBasicOCSPResp> getOCSPResponsesFromDSS() throws GeneralSecurityException 
            

Gets OCSP responses from the Document Security Store.

Returns:

a list of IBasicOCSPResp objects

Throws:

GeneralSecurityException - if OCSP response failed

initLtvVerifier

 protected void initLtvVerifier 
             (PdfDocument document) throws GeneralSecurityException 
            

Throws:

GeneralSecurityException

coversWholeDocument

 protected PdfPKCS7 coversWholeDocument() throws GeneralSecurityException 
            

Checks if the signature covers the whole document and throws an exception if the document was altered

Returns:

a PdfPKCS7 object

Throws:

GeneralSecurityException - if some problems with signature or security occurred