Class ValidatorChainBuilder
- java.lang.Object
-
- com.itextpdf.signatures.validation.v1.ValidatorChainBuilder
-
public class ValidatorChainBuilder extends java.lang.Object
A builder class to construct all necessary parts of a validation chain. The builder can be reused to create multiple instances of a validator.
-
-
Field Summary
Fields Modifier and Type Field Description private CertificateChainValidator
certificateChainValidator
private IssuingCertificateRetriever
certificateRetriever
private CRLValidator
crlValidator
private DocumentRevisionsValidator
documentRevisionsValidator
private OCSPValidator
ocspValidator
private SignatureValidationProperties
properties
private RevocationDataValidator
revocationDataValidator
-
Constructor Summary
Constructors Constructor Description ValidatorChainBuilder()
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description CertificateChainValidator
buildCertificateChainValidator()
Create a newCertificateChainValidator
instance.CRLValidator
buildCRLValidator()
Create a newCRLValidator
instance.DocumentRevisionsValidator
buildDocumentRevisionsValidator()
Create a bewDocumentRevisionsValidator
instance with the current configuration.OCSPValidator
buildOCSPValidator()
Create a newOCSPValidator
instance.RevocationDataValidator
buildRevocationDataValidator()
Create a newRevocationDataValidator
instance This method can be used to create multiple validators.SignatureValidator
buildSignatureValidator(PdfDocument document)
Create a newSignatureValidator
instance with the current configuration.(package private) CertificateChainValidator
getCertificateChainValidator()
Retrieves the explicitly added or automatically createdCertificateChainValidator
instance.IssuingCertificateRetriever
getCertificateRetriever()
Retrieves the explicitly added or automatically createdIssuingCertificateRetriever
instance.(package private) CRLValidator
getCRLValidator()
Retrieves the explicitly added or automatically createdCRLValidator
instance.(package private) DocumentRevisionsValidator
getDocumentRevisionsValidator()
Retrieves the explicitly added or automatically createdDocumentRevisionsValidator
instance.(package private) OCSPValidator
getOCSPValidator()
Retrieves the explicitly added or automatically createdOCSPValidator
instance.SignatureValidationProperties
getProperties()
Retrieves the explicitly added or automatically createdSignatureValidationProperties
instance.(package private) RevocationDataValidator
getRevocationDataValidator()
Retrieves the explicitly added or automatically createdRevocationDataValidator
instance.ValidatorChainBuilder
withCertificateChainValidator(CertificateChainValidator certificateChainValidator)
Use this instance of aCertificateChainValidator
in the validation chain.ValidatorChainBuilder
withCRLValidator(CRLValidator crlValidator)
Use this instance of aCRLValidator
in the validation chain.ValidatorChainBuilder
withDocumentRevisionsValidator(DocumentRevisionsValidator documentRevisionsValidator)
Use this instance of aDocumentRevisionsValidator
in the validation chain.ValidatorChainBuilder
withIssuingCertificateRetriever(IssuingCertificateRetriever certificateRetriever)
Use this instance of aIssuingCertificateRetriever
in the validation chain.ValidatorChainBuilder
withKnownCertificates(java.util.Collection<java.security.cert.Certificate> knownCertificates)
Adds known certificates to theIssuingCertificateRetriever
.ValidatorChainBuilder
withOCSPValidator(OCSPValidator ocspValidator)
Use this instance of aOCSPValidator
in the validation chain.ValidatorChainBuilder
withRevocationDataValidator(RevocationDataValidator revocationDataValidator)
Use this instance of aRevocationDataValidator
in the validation chain.ValidatorChainBuilder
withSignatureValidationProperties(SignatureValidationProperties properties)
Use this instance of aSignatureValidationProperties
in the validation chain.ValidatorChainBuilder
withTrustedCertificates(java.util.Collection<java.security.cert.Certificate> trustedCertificates)
Sets the trusted certificates to theIssuingCertificateRetriever
.
-
-
-
Field Detail
-
properties
private SignatureValidationProperties properties
-
certificateRetriever
private IssuingCertificateRetriever certificateRetriever
-
certificateChainValidator
private CertificateChainValidator certificateChainValidator
-
revocationDataValidator
private RevocationDataValidator revocationDataValidator
-
ocspValidator
private OCSPValidator ocspValidator
-
crlValidator
private CRLValidator crlValidator
-
documentRevisionsValidator
private DocumentRevisionsValidator documentRevisionsValidator
-
-
Method Detail
-
buildSignatureValidator
public SignatureValidator buildSignatureValidator(PdfDocument document)
Create a newSignatureValidator
instance with the current configuration. This method can be used to create multiple validators.- Parameters:
document
-PdfDocument
instance which will be validated- Returns:
- a new instance of a signature validator.
-
buildDocumentRevisionsValidator
public DocumentRevisionsValidator buildDocumentRevisionsValidator()
Create a bewDocumentRevisionsValidator
instance with the current configuration. This method can be used to create multiple validators.- Returns:
- a new instance of a document revisions validator.
-
buildCertificateChainValidator
public CertificateChainValidator buildCertificateChainValidator()
Create a newCertificateChainValidator
instance. This method can be used to create multiple validators.- Returns:
- a new instance of a CertificateChainValidator.
-
buildRevocationDataValidator
public RevocationDataValidator buildRevocationDataValidator()
Create a newRevocationDataValidator
instance This method can be used to create multiple validators.- Returns:
- a new instance of a RevocationDataValidator.
-
buildOCSPValidator
public OCSPValidator buildOCSPValidator()
Create a newOCSPValidator
instance. This method can be used to create multiple validators.- Returns:
- a new instance of a OCSPValidator.
-
buildCRLValidator
public CRLValidator buildCRLValidator()
Create a newCRLValidator
instance. This method can be used to create multiple validators.- Returns:
- a new instance of a CRLValidator.
-
withDocumentRevisionsValidator
public ValidatorChainBuilder withDocumentRevisionsValidator(DocumentRevisionsValidator documentRevisionsValidator)
Use this instance of aDocumentRevisionsValidator
in the validation chain.- Parameters:
documentRevisionsValidator
- the document revisions validator instance to use- Returns:
- the current ValidatorChainBuilder.
-
withCRLValidator
public ValidatorChainBuilder withCRLValidator(CRLValidator crlValidator)
Use this instance of aCRLValidator
in the validation chain.- Parameters:
crlValidator
- the CRLValidator instance to use- Returns:
- the current ValidatorChainBuilder.
-
withOCSPValidator
public ValidatorChainBuilder withOCSPValidator(OCSPValidator ocspValidator)
Use this instance of aOCSPValidator
in the validation chain.- Parameters:
ocspValidator
- the OCSPValidator instance to use- Returns:
- the current ValidatorChainBuilder.
-
withRevocationDataValidator
public ValidatorChainBuilder withRevocationDataValidator(RevocationDataValidator revocationDataValidator)
Use this instance of aRevocationDataValidator
in the validation chain.- Parameters:
revocationDataValidator
- the RevocationDataValidator instance to use- Returns:
- the current ValidatorChainBuilder.
-
withCertificateChainValidator
public ValidatorChainBuilder withCertificateChainValidator(CertificateChainValidator certificateChainValidator)
Use this instance of aCertificateChainValidator
in the validation chain.- Parameters:
certificateChainValidator
- the CertificateChainValidator instance to use- Returns:
- the current ValidatorChainBuilder.
-
withSignatureValidationProperties
public ValidatorChainBuilder withSignatureValidationProperties(SignatureValidationProperties properties)
Use this instance of aSignatureValidationProperties
in the validation chain.- Parameters:
properties
- the SignatureValidationProperties instance to use- Returns:
- the current ValidatorChainBuilder.
-
withIssuingCertificateRetriever
public ValidatorChainBuilder withIssuingCertificateRetriever(IssuingCertificateRetriever certificateRetriever)
Use this instance of aIssuingCertificateRetriever
in the validation chain.- Parameters:
certificateRetriever
- the IssuingCertificateRetriever instance to use- Returns:
- the current ValidatorChainBuilder.
-
withKnownCertificates
public ValidatorChainBuilder withKnownCertificates(java.util.Collection<java.security.cert.Certificate> knownCertificates)
Adds known certificates to theIssuingCertificateRetriever
.- Parameters:
knownCertificates
- the list of known certificates to add- Returns:
- the current ValidatorChainBuilder.
-
withTrustedCertificates
public ValidatorChainBuilder withTrustedCertificates(java.util.Collection<java.security.cert.Certificate> trustedCertificates)
Sets the trusted certificates to theIssuingCertificateRetriever
.- Parameters:
trustedCertificates
- the list of trusted certificates to set- Returns:
- the current ValidatorChainBuilder.
-
getDocumentRevisionsValidator
DocumentRevisionsValidator getDocumentRevisionsValidator()
Retrieves the explicitly added or automatically createdDocumentRevisionsValidator
instance.- Returns:
- the explicitly added or automatically created
DocumentRevisionsValidator
instance.
-
getCertificateChainValidator
CertificateChainValidator getCertificateChainValidator()
Retrieves the explicitly added or automatically createdCertificateChainValidator
instance.- Returns:
- the explicitly added or automatically created
CertificateChainValidator
instance.
-
getRevocationDataValidator
RevocationDataValidator getRevocationDataValidator()
Retrieves the explicitly added or automatically createdRevocationDataValidator
instance.- Returns:
- the explicitly added or automatically created
RevocationDataValidator
instance.
-
getCRLValidator
CRLValidator getCRLValidator()
Retrieves the explicitly added or automatically createdCRLValidator
instance.- Returns:
- the explicitly added or automatically created
CRLValidator
instance.
-
getOCSPValidator
OCSPValidator getOCSPValidator()
Retrieves the explicitly added or automatically createdOCSPValidator
instance.- Returns:
- the explicitly added or automatically created
OCSPValidator
instance.
-
getCertificateRetriever
public IssuingCertificateRetriever getCertificateRetriever()
Retrieves the explicitly added or automatically createdIssuingCertificateRetriever
instance.- Returns:
- the explicitly added or automatically created
IssuingCertificateRetriever
instance.
-
getProperties
public SignatureValidationProperties getProperties()
Retrieves the explicitly added or automatically createdSignatureValidationProperties
instance.- Returns:
- the explicitly added or automatically created
SignatureValidationProperties
instance.
-
-