|
|||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
| SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||
java.lang.Object | +--net.rim.device.api.crypto.ElGamalEncryptorEngine
In ElGamal encryption, two parts are generated and both are required to
decrypt data. The first part is the ciphertext. The ciphertext is
stored in a byte array and is passed into the encryptor engine as the parameter
ciphertext.
The next part is the ephemeral key. The ephemeral key is acquired by calling the getEphmeralKey()
method and sent to the recipient along with the ciphertext. Without the ephemeral key the ciphertext cannot be decrypted.
The version of ElGamal that we implemented can be found in "Applied Cryptography", by Bruce Schneier, in section 19.6 ( 1996 ).
For information on cryptographic algorithms, see Crypto Algorithms.
Certicom Contact Information
Phone:613-254-9258
Email: sales@certicom.com
Website: http://www.certicom.com/rim
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.
| Constructor Summary | ||
|
ElGamalEncryptorEngine(DHPublicKey remoteKey)
Creates an ElGamalEncryptorEngine object using the specified
ElGamal public key. |
|
|
ElGamalEncryptorEngine(DHPublicKey remoteKey,
DHKeyPair localEphemeralKeyPairPair)
Creates an ElGamalEncryptorEngine object. |
|
| Method Summary | ||
|
void |
encrypt(byte[] plaintext,
int plaintextOffset,
byte[] ciphertext,
int ciphertextOffset)
Encrypts the plaintext with the ElGamal algorithm. |
|
String |
getAlgorithm()
Returns the name of the algoritm used to encrypt the data. |
|
int |
getBlockLength()
Return the block length of the encrypted data. |
|
DHPublicKey |
getEphemeralKey()
Returns the ephemeral key used to encrypt the data. |
| Methods inherited from class java.lang.Object |
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
| Constructor Detail |
public ElGamalEncryptorEngine(DHPublicKey remoteKey) throws CryptoTokenException, CryptoUnsupportedOperationException
ElGamalEncryptorEngine object using the specified
ElGamal public key.
remoteKey - The remote key to use for encrypting.CryptoTokenException - Thrown if an error occurs with a crypto token
or the crypto token is invalid.CryptoUnsupportedOperationException - Thrown if a call is made to an
unsupported operation.Certicom Contact Information
Phone:613-254-9258
Email: sales@certicom.com
Website: http://www.certicom.com/rim
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.
public ElGamalEncryptorEngine(DHPublicKey remoteKey, DHKeyPair localEphemeralKeyPairPair) throws CryptoTokenException, CryptoUnsupportedOperationException
ElGamalEncryptorEngine object.
remoteKey - The key to encrypt the data with.localPair - The local key pair to encrypt with, if null this is the
same as the first constructor.CryptoTokenException - Thrown if an error occurs with a crypto token
or the crypto token is invalid.CryptoUnsupportedOperationException - Thrown if a call is made to an
unsupported operation.Certicom Contact Information
Phone:613-254-9258
Email: sales@certicom.com
Website: http://www.certicom.com/rim
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.
| Method Detail |
public void encrypt(byte[] plaintext,
int plaintextOffset,
byte[] ciphertext,
int ciphertextOffset)
throws CryptoTokenException
plaintext - The text to be encoded.plaintextOffset - The offset, or start position of the plaintext data, within
the array.ciphertext - The byte array to hold the ciphertext.ciphertextOffset - The offset, or start position, of the ciphertext
within the array.CryptoTokenException - Thrown if an error occurs with the crypto
token or the crypto token is invalid.Certicom Contact Information
Phone:613-254-9258
Email: sales@certicom.com
Website: http://www.certicom.com/rim
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.
public String getAlgorithm()
This method will always return the String "ElGamal".
Certicom Contact Information
Phone:613-254-9258
Email: sales@certicom.com
Website: http://www.certicom.com/rim
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.
public int getBlockLength()
The block length corresponds to the amount of data that is encrypted at one time.
Certicom Contact Information
Phone:613-254-9258
Email: sales@certicom.com
Website: http://www.certicom.com/rim
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.
public DHPublicKey getEphemeralKey()
Certicom Contact Information
Phone:613-254-9258
Email: sales@certicom.com
Website: http://www.certicom.com/rim
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.
|
|||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
| SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||
Copyright 1999-2009 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.