|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectnet.rim.device.api.crypto.ElGamalEncryptorEngine
public final class 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.
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.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.Method Detail |
---|
public String getAlgorithm()
This method will always return the String "ElGamal".
getAlgorithm
in interface BlockEncryptorEngine
public void encrypt(byte[] plaintext, int plaintextOffset, byte[] ciphertext, int ciphertextOffset) throws CryptoTokenException
encrypt
in interface BlockEncryptorEngine
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.public DHPublicKey getEphemeralKey()
public int getBlockLength()
The block length corresponds to the amount of data that is encrypted at one time.
getBlockLength
in interface BlockEncryptorEngine
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
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.