net.rim.device.api.crypto
Interface PublicKey

All Superinterfaces:
Key, Persistable
All Known Implementing Classes:
DHPublicKey, DSAPublicKey, ECPublicKey, KEAPublicKey, RSAPublicKey

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 applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
Since:
BlackBerry API 3.6.0

Method Summary
Category: Signed  CryptoSystem getCryptoSystem()
          Returns the CryptoSystem used by this public key.
Category: Signed  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

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

Returns:
The crypto system.
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
Since:
BlackBerry API 3.6.0

verify

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 applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
Since:
BlackBerry API 3.6.0





Copyright 1999-2010 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. All Rights Reserved.
Copyright 2002-2003 Nokia Corporation All Rights Reserved.
Java is a trademark of Sun Microsystems, Inc.