SHOW Signed

net.rim.device.api.crypto
Class KEAKeyAgreement

java.lang.Object
  |
  +--net.rim.device.api.crypto.KEAKeyAgreement

public final class KEAKeyAgreement

extends Object

The KEAKeyAgreement class implements the key exchange algorithm (KEA).

A description of the KEA algorithm can be found at KEA.

Category:

Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.

Method Summary

static byte[]

generateSharedSecret(KEAPrivateKey localStaticPrivateKey, KEAPrivateKey localEphemeralPrivateKey, KEAPublicKey remoteStaticPublicKey, KEAPublicKey remoteEphemeralPublicKey) Generates the shared secret using given local and remote, public and private keys.

Methods inherited from class java.lang.Object

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

Method Detail

generateSharedSecret

public static byte[] generateSharedSecret(KEAPrivateKey localStaticPrivateKey,
                                          KEAPrivateKey localEphemeralPrivateKey,
                                          KEAPublicKey remoteStaticPublicKey,
                                          KEAPublicKey remoteEphemeralPublicKey)
                                   throws CryptoTokenException,
                                          CryptoUnsupportedOperationException,
                                          InvalidCryptoSystemException,
                                          InvalidKeyException

Generates the shared secret using given local and remote, public and private keys.

Parameters:

localStaticPrivateKey - The local static private key to use.

localEphemeralPrivateKey - The local ephemeral private key to use.

remoteStaticPublicKey - The remote static public key to use.

remoteEphemeralPublicKey - The remote ephemeral public key to use.

Returns:

A byte array containing the shared secret data.

Throws:

CryptoTokenException - Thrown if an error occurs with a crypto token of the crypto token is invalid.

CryptoUnsupportedOperationException - Thrown if a call is made to an unsupported operation.

InvalidCryptoSystemException - Thrown if the specified crypto system is invalid.

InvalidKeyException - Thrown if the calculated shared secret is not contained within the expected subgroup. This may be thrown if a small subgroup attack is detected.

Since:

JDE 3.6

Category:

Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.