Bookshelf v7.8.2: Java Keystore

The BI Presentation Services Credential Store may be a standard Java keystore that allows the storage and management of keys and certificates. The default Keystore implementation provided by Java 2 SDK is a flat file called Java Keystore (JKS). The JKS keystore can be managed by the command line keytool utility that ships with the JDK. Refer to the JDK documentation for more information.

In order for BI Presentation Services to load this type of credential store, specify a Java property file with the options shown in Table 9.

Table 9. Java Keystore Property File Options
Property	Required	Default	Description
KeyStore	No	Value of system property javax.net.ssl.keyStore.	The file where the private keys and their associated certificates are maintained.
KeyStorePwd	No	Value of system property javax.net.ssl. keyStorePassword	Password to access the credential store.
KeyStoreType	No	JKS	The type of Java based credential store (your Java installation must have support for it). JKS is the default implementation of KeyStore.
KeyAlias			Alias of key and certificate pair that will be used to retrieve the key-certificate pair from the store. If not specified, all keys and certificates present will be extracted.
KeyPwd	No	Value of KeyStorePwd	The password for the specific key and certificate to be retrieved from the store.
TrustStore		Value of system property javax.net.ssl.trustStore.	The file where the trusted CA certificates are maintained.
TrustStoreType		JKS	The type of Java based store this is (your Java installation must have support for it).
TurstStorePwd			Password to access trust store (if necessary).

The following example is of a Java Property file that BI Presentation Services uses.

# The file where the private keys and their associated certificates are maintained
KeyStore = D:\\jks\\private.keystore

# What type of keystore this is (your Java runtime must support it)
KeyStoreType = JKS

# The alias of the key/certificate you wish to retrieve from the store
KeyAlias = obips

# The password for the key/certificate you wish to retrieve
# Defaults to the value of KeyStorePwd
KeyPwd = obips

# The file where the trusted CA certificates are maintained
TrustStore = D:\\jks\\trust.keystore

# What type of trust store this is (your Java runtime must support it)
# TrustStoreType = JKS