SHOW Signed

net.rim.device.api.crypto
Interface PublicKey

All Superinterfaces:

Key, Persistable, net.rim.vm.Persistable

All Known Implementing Classes:

RSAPublicKey, KEAPublicKey, ECPublicKey, DSAPublicKey, DHPublicKey

public interface PublicKey

extends Key

PublicKey is an interface which represents the idea of a public key.

A public key is a key intended to be publicly available (not secret) which has an associated private key intended to be secret. The public key normally performs operations such as encryption and verification, where as the private key performs operations such as decryption and signing.

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

	CryptoSystem	getCryptoSystem() Returns the CryptoSystem used by this public key.
	void	verify() Performs certain integrity checks on the public 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 public key.

Returns:

The crypto system.

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 public 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 private key parameters.

Throws:

InvalidKeyException - Thrown if the specified key is invalid or malformed.

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.

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.