Bouncy Castle Cryptography Library 1.49

org.bouncycastle.crypto.engines
Class IESEngine

java.lang.Object
  extended by org.bouncycastle.crypto.engines.IESEngine

public class IESEngine
extends java.lang.Object

Support class for constructing integrated encryption ciphers for doing basic message exchanges on top of key agreement ciphers. Follows the description given in IEEE Std 1363a.


Constructor Summary
IESEngine(BasicAgreement agree, DerivationFunction kdf, Mac mac)
          set up for use with stream mode, where the key derivation function is used to provide a stream of bytes to xor with the message.
IESEngine(BasicAgreement agree, DerivationFunction kdf, Mac mac, BufferedBlockCipher cipher)
          set up for use in conjunction with a block cipher to handle the message.
 
Method Summary
 BufferedBlockCipher getCipher()
           
 Mac getMac()
           
 void init(AsymmetricKeyParameter publicKey, CipherParameters params, EphemeralKeyPairGenerator ephemeralKeyPairGenerator)
          Initialise the encryptor.
 void init(AsymmetricKeyParameter privateKey, CipherParameters params, KeyParser publicKeyParser)
          Initialise the encryptor.
 void init(boolean forEncryption, CipherParameters privParam, CipherParameters pubParam, CipherParameters param)
          Initialise the encryptor.
 byte[] processBlock(byte[] in, int inOff, int inLen)
           
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

IESEngine

public IESEngine(BasicAgreement agree,
                 DerivationFunction kdf,
                 Mac mac)
set up for use with stream mode, where the key derivation function is used to provide a stream of bytes to xor with the message.

Parameters:
agree - the key agreement used as the basis for the encryption
kdf - the key derivation function used for byte generation
mac - the message authentication code generator for the message

IESEngine

public IESEngine(BasicAgreement agree,
                 DerivationFunction kdf,
                 Mac mac,
                 BufferedBlockCipher cipher)
set up for use in conjunction with a block cipher to handle the message.

Parameters:
agree - the key agreement used as the basis for the encryption
kdf - the key derivation function used for byte generation
mac - the message authentication code generator for the message
cipher - the cipher to used for encrypting the message
Method Detail

init

public void init(boolean forEncryption,
                 CipherParameters privParam,
                 CipherParameters pubParam,
                 CipherParameters param)
Initialise the encryptor.

Parameters:
forEncryption - whether or not this is encryption/decryption.
privParam - our private key parameters
pubParam - the recipient's/sender's public key parameters
param - encoding and derivation parameters.

init

public void init(AsymmetricKeyParameter publicKey,
                 CipherParameters params,
                 EphemeralKeyPairGenerator ephemeralKeyPairGenerator)
Initialise the encryptor.

Parameters:
publicKey - the recipient's/sender's public key parameters
params - encoding and derivation parameters.
ephemeralKeyPairGenerator - the ephemeral key pair generator to use.

init

public void init(AsymmetricKeyParameter privateKey,
                 CipherParameters params,
                 KeyParser publicKeyParser)
Initialise the encryptor.

Parameters:
privateKey - the recipient's private key.
params - encoding and derivation parameters.
publicKeyParser - the parser for reading the ephemeral public key.

getCipher

public BufferedBlockCipher getCipher()

getMac

public Mac getMac()

processBlock

public byte[] processBlock(byte[] in,
                           int inOff,
                           int inLen)
                    throws InvalidCipherTextException
Throws:
InvalidCipherTextException

Bouncy Castle Cryptography Library 1.49