eu.emi.security.authn.x509.impl
Class KeystoreCertChainValidator

java.lang.Object
  extended by eu.emi.security.authn.x509.helpers.pkipath.AbstractValidator
      extended by eu.emi.security.authn.x509.helpers.pkipath.PlainCRLValidator
          extended by eu.emi.security.authn.x509.impl.KeystoreCertChainValidator
All Implemented Interfaces:
X509CertChainValidator, X509CertChainValidatorExt

public class KeystoreCertChainValidator
extends PlainCRLValidator

The certificate validator which uses Java KeyStore as a truststore.

The CRLs (Certificate Revocation Lists, if their handling is turned on) can be obtained from two sources: CA certificate extension defining CRL URL and additional list of URLs manually set by the class user. As an additional feature one may provide a simple paths to a local files, using wildcards. All files matching a wildcard are used.

This class is thread-safe.

Author:
K. Benedyczak
See Also:
X509CertChainValidator

Field Summary
 
Fields inherited from class eu.emi.security.authn.x509.helpers.pkipath.PlainCRLValidator
crlStoreImpl, revocationParameters, timer
 
Fields inherited from class eu.emi.security.authn.x509.helpers.pkipath.AbstractValidator
disposed, listeners, observers, validator
 
Constructor Summary
KeystoreCertChainValidator(String truststorePath, char[] password, String type, long truststoreUpdateInterval)
          Constructs a new validator instance with default additional settings (see ValidatorParamsExt.ValidatorParamsExt()).
KeystoreCertChainValidator(String truststorePath, char[] password, String type, long truststoreUpdateInterval, ValidatorParamsExt params)
          Constructs a new validator instance.
 
Method Summary
 String getTruststorePath()
          Returns the current truststore path
 long getTruststoreUpdateInterval()
          Returns the interval between subsequent checks of the truststore file.
 void setTruststoreUpdateInterval(long updateInterval)
          Sets a new interval between subsequent checks of the truststore file.
 
Methods inherited from class eu.emi.security.authn.x509.helpers.pkipath.PlainCRLValidator
createCRLStore, dispose, getCrls, getCRLUpdateInterval, getRevocationParameters, setCrls, setCRLUpdateInterval
 
Methods inherited from class eu.emi.security.authn.x509.helpers.pkipath.AbstractValidator
addUpdateListener, addValidationListener, getProxySupport, getRevocationCheckingMode, getTrustedIssuers, init, notifyListeners, processErrorList, removeUpdateListener, removeValidationListener, validate, validate
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

KeystoreCertChainValidator

public KeystoreCertChainValidator(String truststorePath,
                                  char[] password,
                                  String type,
                                  long truststoreUpdateInterval,
                                  ValidatorParamsExt params)
                           throws IOException,
                                  KeyStoreException
Constructs a new validator instance. CRLs (Certificate Revocation Lists) are taken from the trusted CAs certificate extension and downloaded, unless CRL checking is disabled. Additional CRLs may be provided manually with the CRLParams argument. Those CRLs will take precedence over CRLs from CA certificate extension.

Parameters:
truststorePath - truststore path
password - truststore password
type - truststore type (JKS or PKCS12)
truststoreUpdateInterval - how often (in ms) the truststore file should be checked for updates. The file is reloaded only if its modification timestamp has changed.
params - common validator settings (revocation, initial listeners, proxy support, ...)
Throws:
IOException - if the truststore can not be read
KeyStoreException - if the truststore can not be parsed or if password is incorrect.

KeystoreCertChainValidator

public KeystoreCertChainValidator(String truststorePath,
                                  char[] password,
                                  String type,
                                  long truststoreUpdateInterval)
                           throws IOException,
                                  KeyStoreException
Constructs a new validator instance with default additional settings (see ValidatorParamsExt.ValidatorParamsExt()).

Parameters:
truststorePath - truststore path
password - truststore password
type - truststore type (JKS or PKCS12)
truststoreUpdateInterval - how often (in ms) the truststore file should be checked for updates. The file is reloaded only if its modification timestamp has changed.
Throws:
IOException - if the truststore can not be read
KeyStoreException - if the truststore can not be parsed or if password is incorrect.
Method Detail

getTruststoreUpdateInterval

public long getTruststoreUpdateInterval()
Returns the interval between subsequent checks of the truststore file. Note that the file is actually reread only if its modification time has changed.

Returns:
the current refresh interval in milliseconds

setTruststoreUpdateInterval

public void setTruststoreUpdateInterval(long updateInterval)
Sets a new interval between subsequent checks of the truststore file. Note that the file is actually reread only if its modification time has changed.

Parameters:
updateInterval - the new interval to be set in milliseconds

getTruststorePath

public String getTruststorePath()
Returns the current truststore path

Returns:
the path


Copyright © 2012-2013 European Middleware Initiative. All Rights Reserved.