Interface IEbicsCipher

Provides the cipher algorithm to help the EbicsTransaction to encrypt and decrypt data.

Namespace: Subsembly.EBICS

Assembly: Subsembly.EBICS.Core.dll

Syntax

public interface IEbicsCipher

Methods

Decrypt(Byte[], EbicsDataBuffer)

Decrypts the entire data buffer in place.

Declaration

void Decrypt(byte[] vbTransactionKey, EbicsDataBuffer dBuffer)

Parameters

Type	Name	Description
System.Byte[]	vbTransactionKey	Transaction key to be used for decrypting the data. Must not be null.
EbicsDataBuffer	dBuffer	Data buffer that contains encrypted data to be decrypted. Must not be null. The content and length of this buffer is modified and will hold the decrypted data on return.

Encrypt(Byte[], EbicsDataBuffer)

Encrypts the entire data buffer in place.

Declaration

void Encrypt(byte[] vbTransactionKey, EbicsDataBuffer dBuffer)

Parameters

Type	Name	Description
System.Byte[]	vbTransactionKey	Transaction key to be used for encrypting the data. Must not be null.
EbicsDataBuffer	dBuffer	Data buffer that contains plain data to be encrypted. The data in this buffer will be replaced by the padded and encrypted data. Must not be null. The buffer is enlarged in order to hold the additional padding bytes.

Remarks

The provided buffer will be enlarged beyond its original length in order to accomodate any padding required by the cipher algorithm. Therefore, the caller should use PaddedLength(Int32) in order to create a buffer with sufficient capacity and avoid re-allocation.

GenerateTransactionKey()

Generates a new transaction key suitable for subsequent encryption.

Declaration

byte[] GenerateTransactionKey()

Returns

Type	Description
System.Byte[]	The generated transaction key.

PaddedLength(Int32)

Computes the padded length of the encrypted data based on the plain data length.

Declaration

int PaddedLength(int nLength)

Parameters

Type	Name	Description
System.Int32	nLength	Plain unencrypted byte length of the data that shall be encrypted.

Returns

Type	Description
System.Int32	The byte length that is required in order to hold the padded and encrypted data of the given length.

Exceptions

Type	Condition
System.ArgumentOutOfRangeException	The given nLength was negative.