Package eu.emi.security.authn.x509
Interface X509CertChainValidator
- All Known Subinterfaces:
X509CertChainValidatorExt
- All Known Implementing Classes:
AbstractValidator
,BinaryCertChainValidator
,DirectoryCertChainValidator
,InMemoryKeystoreCertChainValidator
,KeystoreCertChainValidator
,OpensslCertChainValidator
,PlainCRLValidator
public interface X509CertChainValidator
Implementations are used to perform a manual certificate chain validation.
Implementations shall reuse as many of existing CertificateChecker implementations as
possible. Implementations must be thread safe.
- Author:
- K. Benedyczak
- See Also:
-
Method Summary
Modifier and TypeMethodDescriptionvoid
addUpdateListener
(StoreUpdateListener listener) Registers a listener which can react to errors found during refreshing of the trust material: trusted CAs or CRLs.void
addValidationListener
(ValidationErrorListener listener) Registers a listener which can react to errors found during certificate validation.Returns a list of trusted issuers of certificates.void
removeUpdateListener
(StoreUpdateListener listener) Unregisters a previously registered CA or CRL update listener.void
Unregisters a previously registered validation listener.Performs validation of a provided certificate path.validate
(X509Certificate[] certChain) Performs validation of a provided certificate chain.
-
Method Details
-
validate
Performs validation of a provided certificate path.- Parameters:
certPath
- to be validated- Returns:
- result of validation
-
validate
Performs validation of a provided certificate chain.- Parameters:
certChain
- to be validated- Returns:
- result of validation
-
getTrustedIssuers
X509Certificate[] getTrustedIssuers()Returns a list of trusted issuers of certificates.- Returns:
- array containing trusted issuers' certificates
-
addValidationListener
Registers a listener which can react to errors found during certificate validation. It is useful in two cases: (rarely) if you want to change the default logic of the validator and if you will use the validator indirectly (e.g. to validate SSL socket connections) and want to get the originalValidationError
, not the exception.- Parameters:
listener
- to be registered
-
removeValidationListener
Unregisters a previously registered validation listener. If the listener was not registered then the method does nothing.- Parameters:
listener
- to be unregistered
-
addUpdateListener
Registers a listener which can react to errors found during refreshing of the trust material: trusted CAs or CRLs. This method is useful only if the implementation supports updating of CAs or CRLs, otherwise the listener will not be invoked.- Parameters:
listener
- to be registered
-
removeUpdateListener
Unregisters a previously registered CA or CRL update listener. If the listener was not registered then the method does nothing.- Parameters:
listener
- to be unregistered
-