Cumulus4j API
(1.0.1)

org.cumulus4j.keymanager.api.internal.remote
Class RemoteKeyManagerAPI

java.lang.Object
  extended by org.cumulus4j.keymanager.api.internal.AbstractKeyManagerAPI
      extended by org.cumulus4j.keymanager.api.internal.remote.RemoteKeyManagerAPI
All Implemented Interfaces:
KeyManagerAPI

public class RemoteKeyManagerAPI
extends AbstractKeyManagerAPI

Author:
Marco หงุ่ยตระกูล-Schulze - marco at nightlabs dot de

Field Summary
 
Fields inherited from class org.cumulus4j.keymanager.api.internal.AbstractKeyManagerAPI
FILE_URL_PREFIX
 
Constructor Summary
RemoteKeyManagerAPI()
           
 
Method Summary
protected static String appendFinalSlash(String url)
           
 void deleteUser(String userName)
          Delete a user.
protected  Client getClient()
           
 CryptoSession getCryptoSession(String appServerBaseURL)
           Get a session for a certain application server.
 DateDependentKeyStrategyInitResult initDateDependentKeyStrategy(DateDependentKeyStrategyInitParam param)
          Initialise a new key-store with the DateDependentKeyStrategy.
 void putUser(String userName, char[] password)
          Create a new user or change an existing user's password.
 void setConfiguration(KeyManagerAPIConfiguration configuration)
           Set the configuration for this KeyManagerAPI instance.
protected static void throwUniformInterfaceExceptionAsAuthenticationException(UniformInterfaceException x)
           
protected static void throwUniformInterfaceExceptionAsIOException(UniformInterfaceException x)
           
 
Methods inherited from class org.cumulus4j.keymanager.api.internal.AbstractKeyManagerAPI
equals, getAuthPassword, getAuthUserName, getConf, getConfiguration, getKeyManagerBaseURL, getKeyStoreID
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

RemoteKeyManagerAPI

public RemoteKeyManagerAPI()
                    throws KeyManagerAPIInstantiationException
Throws:
KeyManagerAPIInstantiationException
Method Detail

setConfiguration

public void setConfiguration(KeyManagerAPIConfiguration configuration)
                      throws IllegalArgumentException,
                             KeyManagerAPIInstantiationException
Description copied from interface: KeyManagerAPI

Set the configuration for this KeyManagerAPI instance.

Before a KeyManagerAPI instance can actually be used, it first needs to be configured. The configuration passed to this method will be marked read-only.

Specified by:
setConfiguration in interface KeyManagerAPI
Overrides:
setConfiguration in class AbstractKeyManagerAPI
Parameters:
configuration - the configuration (which will be marked read-only by this operation). Must not be null.
Throws:
IllegalArgumentException - if the configuration is null or incomplete (e.g. configuration.keyStoreID being null).
KeyManagerAPIInstantiationException - if the actual implementation cannot be instantiated.

appendFinalSlash

protected static final String appendFinalSlash(String url)

getClient

protected Client getClient()

initDateDependentKeyStrategy

public DateDependentKeyStrategyInitResult initDateDependentKeyStrategy(DateDependentKeyStrategyInitParam param)
                                                                throws KeyStoreNotEmptyException,
                                                                       IOException
Description copied from interface: KeyManagerAPI
Initialise a new key-store with the DateDependentKeyStrategy.

Parameters:
param - the settings controlling the details of how to initialise it. Must not be null.
Returns:
Throws:
KeyStoreNotEmptyException
IOException

putUser

public void putUser(String userName,
                    char[] password)
             throws AuthenticationException,
                    IOException
Description copied from interface: KeyManagerAPI
Create a new user or change an existing user's password. If the password of the current user is modified, this instance of KeyManagerAPI will be updated with a new configuration, automatically. Other instances of KeyManagerAPI - even in the same JVM - are not updated, though.

Parameters:
userName - the name of the new user.
password - the password of the new user.
Throws:
AuthenticationException - if the authUserName or the authPassword is incorrect.
IOException - if the communication with the key-store (either local key-store-file or remote key-server) fails.

deleteUser

public void deleteUser(String userName)
                throws AuthenticationException,
                       CannotDeleteLastUserException,
                       IOException
Description copied from interface: KeyManagerAPI
Delete a user. If the specified user does not exist, this method is a no-op. Note, that the current user can delete himself. In this case, a 2nd call to this method would cause an AuthenticationException.

Parameters:
userName - the name of the user to be deleted.
Throws:
AuthenticationException - if the authUserName or the authPassword is incorrect.
CannotDeleteLastUserException - if you attempted to delete the last user (which would render the key-store to be totally unreadable).
IOException - if the communication with the key-store (either local key-store-file or remote key-server) fails.

getCryptoSession

public CryptoSession getCryptoSession(String appServerBaseURL)
                               throws IOException,
                                      AuthenticationException
Description copied from interface: KeyManagerAPI

Get a session for a certain application server.

Parameters:
appServerBaseURL - the base-url of the app-server-key-manager-channel (must not be null). This is the part of the URL before the "/KeyManagerChannel" - e.g. if the REST URL of the KeyManagerChannel-service is "https://serverUsingCumulus4j.mydomain.org/org.cumulus4j.keymanager.back.webapp/KeyManagerChannel", then this must be "https://serverUsingCumulus4j.mydomain.org/org.cumulus4j.keymanager.back.webapp".
Returns:
the session; never null.
Throws:
IOException - if the communication with the key-store (either local key-store-file or remote key-server) fails.
AuthenticationException - if the authUserName or the authPassword is incorrect.

throwUniformInterfaceExceptionAsAuthenticationException

protected static void throwUniformInterfaceExceptionAsAuthenticationException(UniformInterfaceException x)
                                                                       throws AuthenticationException
Throws:
AuthenticationException

throwUniformInterfaceExceptionAsIOException

protected static void throwUniformInterfaceExceptionAsIOException(UniformInterfaceException x)
                                                           throws IOException
Throws:
IOException

Cumulus4j API
(1.0.1)

Copyright © 2012 NightLabs Consulting GmbH. All Rights Reserved.