com.ibm.mqlight.api.security

Class KeyStoreUtils

java.lang.Object

com.ibm.mqlight.api.security.KeyStoreUtils

public class KeyStoreUtils
extends Object

Utilities for creating and maintaining KeyStore instances.

Constructor Summary

Constructors

Constructor and Description
KeyStoreUtils()

Method Summary

Modifier and Type	Method and Description
static void	addPrivateKey(KeyStore keyStore, File pemKeyFile, char[] passwordChars, List<Certificate> certChain) Adds a private key to the specified key store from the passed private key file and certificate chain.
static PrivateKey	createPrivateKey(File pemKeyFile, char[] passwordChars) Creates a PrivateKey instance from the passed private key PEM format file and certificate chain.
static KeyStore	loadKeyStore(File file, String password) Attempts to load the specified file as a KeyStore, determining the key store type from the file extension.

Methods inherited from class java.lang.Object

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

Constructor Detail

KeyStoreUtils

public KeyStoreUtils()

Method Detail

loadKeyStore

public static KeyStore loadKeyStore(File file,
                                    String password)
                             throws KeyStoreException,
                                    NoSuchAlgorithmException,
                                    CertificateException,
                                    IOException

Attempts to load the specified file as a KeyStore, determining the key store type from the file extension.

Parameters:

file - the file containing the key store to be loaded.

password - password for the key store file.

Returns:

A KeyStore instance loaded from the specified file.

Throws:

KeyStoreException - if no KeyStore provider supports the key store type (inferred from the key store file extension).

NoSuchAlgorithmException - if an unknown algorithm is used to check key store identity.

CertificateException - if certificates from the key store could not be loaded.

IOException - if there is a problem accessing the key store file.

addPrivateKey

public static void addPrivateKey(KeyStore keyStore,
                                 File pemKeyFile,
                                 char[] passwordChars,
                                 List<Certificate> certChain)
                          throws IOException,
                                 GeneralSecurityException

Adds a private key to the specified key store from the passed private key file and certificate chain.

Parameters:

keyStore - The key store to receive the private key.

pemKeyFile - A PEM format file containing the private key.

passwordChars - The password that protects the private key.

certChain - The certificate chain to associate with the private key.

Throws:

IOException - if the key store file cannot be read

GeneralSecurityException - if a cryptography problem is encountered.

createPrivateKey

public static PrivateKey createPrivateKey(File pemKeyFile,
                                          char[] passwordChars)
                                   throws IOException,
                                          GeneralSecurityException

Creates a PrivateKey instance from the passed private key PEM format file and certificate chain.

Parameters:

pemKeyFile - A PEM format file containing the private key.

passwordChars - The password that protects the private key.

Returns:

the private key, created by this method.

Throws:

IOException - if the file cannot be read.

GeneralSecurityException - if a cryptography problem is encountered.