SHOW Signed

net.rim.device.api.crypto
Interface PrivateKey

All Superinterfaces:
Key, Persistable, net.rim.vm.Persistable
All Known Implementing Classes:
RSAPrivateKey, KEAPrivateKey, ECPrivateKey, DSAPrivateKey, DHPrivateKey

public interface PrivateKey
extends Key

PrivateKey represents the idea of a private key, which is a key intended to be secret, and has an associated public key intended to be publically disclosed. The private key normally performs operations such as decryption and signing, whereas the public key performs operations such as encryption and verification.

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.

Since:
JDE 3.6.0

Method Summary
 Category: Signed  CryptoSystem getCryptoSystem()
          Returns the CryptoSystem used by this private key.
 Category: Signed  void verify()
          Performs certain integrity checks on the private key parameters.
 
Methods inherited from interface net.rim.device.api.crypto.Key
getAlgorithm
 

Method Detail

getCryptoSystem

public CryptoSystem getCryptoSystem()
Returns the CryptoSystem used by this private key.

Returns:
The crypto system.
Since:
JDE 3.6.0
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.

verify

public void verify()
            throws InvalidKeyException,
                   InvalidCryptoSystemException,
                   CryptoTokenException,
                   CryptoUnsupportedOperationException
Performs certain integrity checks on the private key parameters. These checks are useful to prevent certain types of attacks that involve modifying the parameters and then using a signed message to calculate the real private key parameters.

Throws:
InvalidKeyException - Thrown if the specified key is improperly formatted or invalid.
InvalidCryptoSystemException - Thrown if the specified crypto system is invalid.
CryptoTokenException - Thrown if an error occurs with the crypto token or the crypto token is invalid.
CryptoUnsupportedOperationException - Thrown if a call is made to an unsupported operation.
Since:
JDE 3.6.0
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.


Copyright 1999-2004 Research In Motion Limited. 295 Phillip Street, Waterloo, Ontario, Canada, N2L 3W8. All Rights Reserved.
Copyright 1993-2003 Sun Microsystems, Inc. 901 San Antonio Road, Palo Alto, California, 94303, U.S.A.
Copyright 2002-2003 Nokia Corporation All Rights Reserved.
Java is a trademark or registered trademark of Sun Microsystems, Inc. in the US and other countries.