MechParamECIES Class Reference

Constructs a mechanism parameter for 'Elliptic Curve (Augmented) Encryption Scheme' (ECIES, see ANSI X9.63). More...

Inheritance diagram for MechParamECIES:

Collaboration diagram for MechParamECIES:

Public Member Functions
	MechParamECIES (int mech, int hash_algo, int crypt_algo, int crypt_mech, int crypt_len, int mac_algo, int mac_mech, int mac_len, const ByteArray &secret1, const ByteArray &secret2)
MechanismParameter	getEncoded (void)
Public Member Functions inherited from MechParam
	MechParam (int mech)
	Constructs a mechanism parameter with the given mechanism specifier. More...
MechanismParameter	getEncoded (void)

Detailed Description

Constructs a mechanism parameter for 'Elliptic Curve (Augmented) Encryption Scheme' (ECIES, see ANSI X9.63).

The following example illustrates the usage of the MechParamECIES class:

// encrypt data with ECIES mode
 
MechParamECIES mechParam = MechParamECIES(CXI_MECH_MODE_ENCRYPT,
                                          CXI_MECH_HASH_ALGO_SHA256,       // hash_algo
                                          CXI_KEY_ALGO_AES,                // crypt_algo
                                          CXI_MECH_CHAIN_CBC,              // crypt_mech
                                          256,                             // crypt_len
                                          CXI_KEY_ALGO_RAW,                // mac_algo
                                          CXI_MECH_KDF_XOR_BASE_AND_DATA,  // mac_mech
                                          0,                               // mac_len
                                          ByteArray("MySecret#1"),
                                          ByteArray(0));
 
ByteArray crypt = cxi->crypt(0, ecKey, mechParam.getEncoded(), data);

Constructor & Destructor Documentation

MechParamECIES()

MechParamECIES	(	int	mech,
		int	hash_algo,
		int	crypt_algo,
		int	crypt_mech,
		int	crypt_len,
		int	mac_algo,
		int	mac_mech,
		int	mac_len,
		const ByteArray &	secret1,
		const ByteArray &	secret2
	)

Constructs a mechanism parameter for 'Elliptic Curve (Augmented) Encryption Scheme' (ECIES, see ANSI X9.63).

Parameters

mech	XOR combination of mechanism specifier: crypt mode (see Mode Parameter) CXI_MECH_MODE_ENCRYPT CXI_MECH_MODE_DECRYPT random generator mode (see Random Generation Parameter) CXI_MECH_RND_REAL CXI_MECH_RND_PSEUDO key generation format mode (see Key Generation Parameter) CXI_MECH_KEYGEN_UNCOMP CXI_MECH_KEYGEN_COMP key derivation mode (see Key Derivation Functions) CXI_MECH_KDF_ECDH_COF
hash_algo	hash algorithm,see Hash Algorithms
crypt_algo	algorithm: CXI_KEY_ALGO_AES CXI_KEY_ALGO_RAW (crypt_mech := CXI_MECH_KDF_XOR_DATA)
crypt_mech	mechanism: chaining mode (AES only), see Chaining Modes key derivation mode (raw mode only): CXI_MECH_KDF_XOR_DATA
crypt_len	AES key size (128,192 or 256) or zero on raw mode
mac_algo	algorithm: CXI_KEY_ALGO_AES CXI_KEY_ALGO_RAW (mac_mech := CXI_MECH_MODE_HMAC)
mac_mech	mechanism: hash mode: CXI_MECH_MODE_HMAC or CXI_MECH_MODE_MAC1 underlying hash algorithm on HMAC, see Hash Algorithms
mac_len	AES key size (128,192 or 256) or zero on HMAC optional: mac size in byte for truncated macs when using CXI_MECH_MODE_MAC1.
secret1	secret value #1
secret2	secret value #2

Member Function Documentation

getEncoded()

MechanismParameter getEncoded

(

void

)

Returns

Returns the encoded mechanism parameter.