Class BcChaCha20Poly1305

Namespace

Org.BouncyCastle.Tls.Crypto.Impl.BC

Assembly

BouncyCastle.Cryptography.dll

public sealed class BcChaCha20Poly1305 : TlsAeadCipherImpl

Inheritance

object

BcChaCha20Poly1305

Implements

TlsAeadCipherImpl

Inherited Members

object.Equals(object)

object.Equals(object, object)

object.GetHashCode()

object.GetType()

object.ReferenceEquals(object, object)

object.ToString()

Constructors

BcChaCha20Poly1305(bool)

public BcChaCha20Poly1305(bool isEncrypting)

Parameters

isEncrypting bool

Methods

DoFinal(byte[], byte[], int, int, byte[], int)

Perform the cipher encryption/decryption returning the output in output.

public int DoFinal(byte[] additionalData, byte[] input, int inputOffset, int inputLength, byte[] output, int outputOffset)

Parameters

additionalData byte[]

any additional data to be included in the MAC calculation.

input byte[]

array holding input data to the cipher.

inputOffset int

offset into input array data starts at.

inputLength int

length of the input data in the array.

output byte[]

array to hold the cipher output.

outputOffset int

offset into output array to start saving output.

Returns

int

the amount of data written to output.

Remarks

Note: we have to use DoFinal() here as it is the only way to guarantee output from the underlying cipher.

Exceptions

IOException

in case of failure.

DoFinal(byte[], int, int, byte[], int)

Perform the cipher encryption/decryption returning the output in output.

public int DoFinal(byte[] input, int inputOffset, int inputLength, byte[] output, int outputOffset)

Parameters

input byte[]

array holding input data to the cipher.

inputOffset int

offset into input array data starts at.

inputLength int

length of the input data in the array.

output byte[]

array to hold the cipher output.

outputOffset int

offset into output array to start saving output.

Returns

int

the amount of data written to output.

Remarks

Note: we have to use DoFinal() here as it is the only way to guarantee output from the underlying cipher.

Exceptions

IOException

in case of failure.

GetOutputSize(int)

Return the maximum size of the output for input of inputLength bytes.

public int GetOutputSize(int inputLength)

Parameters

inputLength int

the length (in bytes) of the proposed input.

Returns

int

the maximum size of the output.

Init(byte[], int, byte[])

Initialise the parameters for the AEAD operator.

public void Init(byte[] nonce, int macSize, byte[] additionalData)

Parameters

nonce byte[]

the nonce.

macSize int

MAC size in bytes.

additionalData byte[]

any additional data to be included in the MAC calculation.

Exceptions

IOException

if the parameters are inappropriate.

Reset()

public void Reset()

SetKey(byte[], int, int)

Set the key to be used by the AEAD cipher implementation supporting this service.

public void SetKey(byte[] key, int keyOff, int keyLen)

Parameters

key byte[]

array holding the AEAD cipher key.

keyOff int

offset into the array the key starts at.

keyLen int

length of the key in the array.

Exceptions

IOException

SetKey(ReadOnlySpan<byte>)

public void SetKey(ReadOnlySpan<byte> key)

Parameters

key ReadOnlySpan<byte>