com.sap.it.api.keystore

Interface KeystoreService

All Superinterfaces:

ITApi

public interface KeystoreService
extends ITApi

Public API to access key storage services.

Method Summary

Methods

Modifier and Type	Method and Description
java.security.cert.Certificate	getCertificate(java.lang.String alias) Returns the certificate associated with the given alias.
java.security.cert.Certificate[]	getCertificateChain(java.lang.String alias) Returns the certificate chain associated with the given alias.
java.security.Key	getKey(java.lang.String alias) Returns the key associated with the given alias.
javax.net.ssl.KeyManager	getKeyManager() Get a KeyManager implementation instance using the service.
javax.net.ssl.KeyManager	getKeyManager(java.lang.String alias) Get a KeyManager implementation instance using the service.
javax.net.ssl.KeyManager[]	getKeyManagers() Get all KeyManager implementation instances using the service.
javax.net.ssl.KeyManager[]	getKeyManagers(java.lang.String alias) Get all KeyManager implementation instances using the service.
java.security.KeyPair	getKeyPair(java.lang.String alias) Returns the key pair associated with the given alias.
javax.net.ssl.TrustManager	getTrustManager() Get a trust manager implementation instance using the service for the default trust store.
javax.net.ssl.TrustManager[]	getTrustManagers() Get all trust manager implementation instances using the service for the default trust store.

Method Detail

getKeyManager

javax.net.ssl.KeyManager getKeyManager()
                                       throws KeystoreException

Get a KeyManager implementation instance using the service.

Returns:

A KeyManager instance or null, if no key manager instance is available.

Throws:

KeystoreException

getKeyManager

javax.net.ssl.KeyManager getKeyManager(java.lang.String alias)
                                       throws KeystoreException

Get a KeyManager implementation instance using the service.

Parameters:

alias - The alias name for the key.

Returns:

A KeyManager instance or null, if no key manager instance is available.

Throws:

KeystoreException

getKeyManagers

javax.net.ssl.KeyManager[] getKeyManagers()
                                          throws KeystoreException

Get all KeyManager implementation instances using the service.

Returns:

A KeyManager instance or null, if no key manager instance is available.

Throws:

KeystoreException

getKeyManagers

javax.net.ssl.KeyManager[] getKeyManagers(java.lang.String alias)
                                          throws KeystoreException

Get all KeyManager implementation instances using the service.

Parameters:

alias - The alias name of the key.

Returns:

A KeyManager instance or null, if no key manager instance is available.

Throws:

KeystoreException

getTrustManager

javax.net.ssl.TrustManager getTrustManager()
                                           throws KeystoreException

Get a trust manager implementation instance using the service for the default trust store.

Returns:

A TrustManager instance or null, if no trust manager instance is available.

Throws:

KeystoreException

getTrustManagers

javax.net.ssl.TrustManager[] getTrustManagers()
                                              throws KeystoreException

Get all trust manager implementation instances using the service for the default trust store.

Returns:

A TrustManager instance or null, if no trust manager instance is available.

Throws:

KeystoreException

getKey

java.security.Key getKey(java.lang.String alias)
                         throws KeystoreException

Returns the key associated with the given alias.

Parameters:

alias - the alias name

Returns:

the requested key, or null if the given alias does not exist or does not identify a key-related entry or the keystore service is not available

Throws:

java.lang.IllegalStateException - if the algorithm for recovering the key cannot be found, if the key cannot be recovered.

KeystoreException

getKeyPair

java.security.KeyPair getKeyPair(java.lang.String alias)
                                 throws KeystoreException

Returns the key pair associated with the given alias.

Parameters:

alias - the alias name

Returns:

the request key pair, or null if the given alias does not exist or the alias does not refer to a private key

Throws:

java.lang.IllegalStateException - if the algorithm for recovering the key cannot be found, if the key cannot be recovered, if the correspondent keystore has not been initialized (loaded).

KeystoreException

getCertificate

java.security.cert.Certificate getCertificate(java.lang.String alias)
                                              throws KeystoreException

Returns the certificate associated with the given alias.

If the given alias name identifies an entry created by a call to setCertificateEntry, or created by a call to setEntry with a TrustedCertificateEntry, then the trusted certificate contained in that entry is returned.

If the given alias name identifies an entry created by a call to setKeyEntry, or created by a call to setEntry with a PrivateKeyEntry, then the first element of the certificate chain in that entry is returned.

Parameters:

alias - the alias name

Returns:

the certificate, or null if the given alias does not exist or does not contain a certificate or the keystore service is not available

Throws:

java.lang.IllegalStateException - if the correspondent keystore has not been initialized (loaded)

KeystoreException

getCertificateChain

java.security.cert.Certificate[] getCertificateChain(java.lang.String alias)
                                                     throws KeystoreException

Returns the certificate chain associated with the given alias. The certificate chain must have been associated with the alias by a call to setKeyEntry, or by a call to setEntry with a PrivateKeyEntry.

Parameters:

alias - the alias name

Returns:

the certificate chain (ordered with the user's certificate first and the root certificate authority last), or null if the given alias does not exist or does not contain a certificate chain or the keystore service is not available

Throws:

java.lang.IllegalStateException - if the keystore has not been initialized (loaded).

KeystoreException