Class KeyManagement

java.lang.Object
org.kopi.ebics.client.KeyManagement
public class KeyManagement extends Object
Everything that has to do with key handling. If you have a totally new account use sendINI() and sendHIA() to send you newly created keys to the bank. Then wait until the bank activated your keys. If you are migrating from FTAM. Just send HPB, your EBICS account should be usable without delay.

  • Constructor Details

    • KeyManagement

      public KeyManagement(EbicsSession session)
      Constructs a new KeyManagement instance with a given ebics session
      Parameters:
      session - the ebics session

  • Method Details

    • sendINI

      public void sendINI(String orderId) throws EbicsException, IOException
      Sends the user's signature key (A005) to the bank. After successful operation the user is in state "initialized".
      Parameters:
      orderId - the order ID. Let it null to generate a random one.
      Throws:
      EbicsException - server generated error message
      IOException - communication error

    • sendHIA

      public void sendHIA(String orderId) throws IOException, EbicsException
      Sends the public part of the protocol keys to the bank.
      Parameters:
      orderId - the order ID. Let it null to generate a random one.
      Throws:
      IOException - communication error
      EbicsException - server generated error message

    • sendHPB

      public void sendHPB() throws IOException, GeneralSecurityException, EbicsException
      Sends encryption and authentication keys to the bank. This order is only allowed for a new user at the bank side that has been created by copying the A005 key. The keys will be activated immediately after successful completion of the transfer.
      Throws:
      IOException - communication error
      GeneralSecurityException - data decryption error
      EbicsException - server generated error message

    • lockAccess

      public void lockAccess() throws IOException, EbicsException
      Sends the SPR order to the bank. After that you have to start over with sending INI and HIA.
      Throws:
      IOException - Communication exception
      EbicsException - Error message generated by the bank.