cybervillains.ca

Class KeyStoreManager

java.lang.Object

cybervillains.ca.KeyStoreManager

public class KeyStoreManager
extends Object

This is the main entry point into the Cybervillains CA. This class handles generation, storage and the persistent mapping of input to duplicated certificates and mapped public keys. Default setting is to immediately persist changes to the store by writing out the keystore and mapping file every time a new certificate is added. This behavior can be disabled if desired, to enhance performance or allow temporary testing without modifying the certificate store. Copyright (c) 2007, Information Security Partners, LLC All rights reserved. In a special exception, Selenium/OpenQA is allowed to use this code under the Apache License 2.0.

Author:

Brad Hill

Field Summary

Fields

Modifier and Type	Field and Description
static String	_caPrivKeyAlias
KeyPairGenerator	_dsaKpg
KeyPairGenerator	_rsaKpg
String	DSA_KEYGEN_ALGO
String	RSA_KEYGEN_ALGO

Constructor Summary

Constructors

Constructor and Description
KeyStoreManager(File root, String certificateRevocationList)

Method Summary

Methods

Modifier and Type	Method and Description
void	addCertAndPrivateKey(String hostname, X509Certificate cert, PrivateKey privKey) Stores a new certificate and its associated private key in the keystore.
protected void	createKeystore() Creates, writes and loads a new keystore and CA root certificate.
X509Certificate	getCertificateByAlias(String alias) Returns the aliased certificate.
X509Certificate	getCertificateByHostname(String hostname) Returns the aliased certificate.
KeyStore	getKeyStore()
X509Certificate	getMappedCertificateForHostname(String hostname) This method returns the mapped certificate for a hostname, or generates a "standard" SSL server certificate issued by the CA to the supplied subject if no mapping has been created.
KeyPair	getRSAKeyPair() Generate an RSA Key Pair
X509Certificate	getSigningCert() Gets the authority root signing cert.
PrivateKey	getSigningPrivateKey() Gets the authority private signing key.
void	persist() Writes the keystore and certificate/keypair mappings to disk.

Methods inherited from class java.lang.Object

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

Field Detail

_caPrivKeyAlias

public static final String _caPrivKeyAlias

See Also:

Constant Field Values

RSA_KEYGEN_ALGO

public final String RSA_KEYGEN_ALGO

See Also:

Constant Field Values

DSA_KEYGEN_ALGO

public final String DSA_KEYGEN_ALGO

See Also:

Constant Field Values

_rsaKpg

public final KeyPairGenerator _rsaKpg

_dsaKpg

public final KeyPairGenerator _dsaKpg

Constructor Detail

KeyStoreManager

public KeyStoreManager(File root,
               String certificateRevocationList)

Method Detail

createKeystore

protected void createKeystore()

Creates, writes and loads a new keystore and CA root certificate.

addCertAndPrivateKey

public void addCertAndPrivateKey(String hostname,
                        X509Certificate cert,
                        PrivateKey privKey)
                          throws KeyStoreException,
                                 CertificateException,
                                 NoSuchAlgorithmException

Stores a new certificate and its associated private key in the keystore.

Throws:

KeyStoreException

CertificateException

NoSuchAlgorithmException

persist

public void persist()
             throws KeyStoreException,
                    NoSuchAlgorithmException,
                    CertificateException

Writes the keystore and certificate/keypair mappings to disk.

Throws:

KeyStoreException

NoSuchAlgorithmException

CertificateException

getCertificateByAlias

public X509Certificate getCertificateByAlias(String alias)
                                      throws KeyStoreException

Returns the aliased certificate. Certificates are aliased by their SHA1 digest.

Throws:

KeyStoreException

See Also:

ThumbprintUtil

getCertificateByHostname

public X509Certificate getCertificateByHostname(String hostname)
                                         throws KeyStoreException,
                                                InvalidKeyException,
                                                SignatureException,
                                                CertificateException,
                                                NoSuchAlgorithmException,
                                                NoSuchProviderException,
                                                UnrecoverableKeyException

Returns the aliased certificate. Certificates are aliased by their hostname.

Throws:

KeyStoreException

UnrecoverableKeyException

NoSuchProviderException

NoSuchAlgorithmException

CertificateException

SignatureException

CertificateNotYetValidException

CertificateExpiredException

InvalidKeyException

CertificateParsingException

See Also:

ThumbprintUtil

getSigningCert

public X509Certificate getSigningCert()
                               throws KeyStoreException

Gets the authority root signing cert.

Throws:

KeyStoreException

getSigningPrivateKey

public PrivateKey getSigningPrivateKey()
                                throws KeyStoreException,
                                       NoSuchAlgorithmException,
                                       UnrecoverableKeyException

Gets the authority private signing key.

Throws:

KeyStoreException

NoSuchAlgorithmException

UnrecoverableKeyException

getMappedCertificateForHostname

public X509Certificate getMappedCertificateForHostname(String hostname)
                                                throws InvalidKeyException,
                                                       SignatureException,
                                                       CertificateException,
                                                       NoSuchAlgorithmException,
                                                       NoSuchProviderException,
                                                       KeyStoreException,
                                                       UnrecoverableKeyException

This method returns the mapped certificate for a hostname, or generates a "standard" SSL server certificate issued by the CA to the supplied subject if no mapping has been created. This is not a true duplication, just a shortcut method that is adequate for web browsers.

Throws:

CertificateParsingException

InvalidKeyException

CertificateExpiredException

CertificateNotYetValidException

SignatureException

CertificateException

NoSuchAlgorithmException

NoSuchProviderException

KeyStoreException

UnrecoverableKeyException

getRSAKeyPair

public KeyPair getRSAKeyPair()

Generate an RSA Key Pair

getKeyStore

public KeyStore getKeyStore()