org.bouncycastle.tls.crypto.impl.bc

Class BcChaCha20Poly1305

java.lang.Object

org.bouncycastle.tls.crypto.impl.bc.BcChaCha20Poly1305

All Implemented Interfaces:

TlsAEADCipherImpl

public class BcChaCha20Poly1305
extends java.lang.Object
implements TlsAEADCipherImpl

Field Summary

Fields

Modifier and Type	Field and Description
protected int	additionalDataLength
protected org.bouncycastle.crypto.engines.ChaCha7539Engine	cipher
protected boolean	isEncrypting
protected org.bouncycastle.crypto.macs.Poly1305	mac

Constructor Summary

Constructors

Constructor and Description
BcChaCha20Poly1305(boolean isEncrypting)

Method Summary

Modifier and Type	Method and Description
int	doFinal(byte[] input, int inputOffset, int inputLength, byte[] extraInput, byte[] output, int outputOffset) Perform the cipher encryption/decryption returning the output in output.
int	getOutputSize(int inputLength) Return the maximum size of the output for input of inputLength bytes.
void	init(byte[] nonce, int macSize, byte[] additionalData) Initialise the parameters for the AEAD operator.
protected void	initMAC()
void	setKey(byte[] key, int keyOff, int keyLen) Set the key to be used by the AEAD cipher implementation supporting this service.
protected void	updateMAC(byte[] buf, int off, int len)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

cipher

protected final org.bouncycastle.crypto.engines.ChaCha7539Engine cipher

mac

protected final org.bouncycastle.crypto.macs.Poly1305 mac

isEncrypting

protected final boolean isEncrypting

additionalDataLength

protected int additionalDataLength

Constructor Detail

BcChaCha20Poly1305

public BcChaCha20Poly1305(boolean isEncrypting)

Method Detail

doFinal

public int doFinal(byte[] input,
                   int inputOffset,
                   int inputLength,
                   byte[] extraInput,
                   byte[] output,
                   int outputOffset)
            throws java.io.IOException

Description copied from interface: TlsAEADCipherImpl

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

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

Specified by:

doFinal in interface TlsAEADCipherImpl

Parameters:

input - array holding input data to the cipher.

inputOffset - offset into input array data starts at.

inputLength - length of the input data in the array.

extraInput - extra input data to the cipher. Only allowed when encrypting.

output - array to hold the cipher output.

outputOffset - offset into output array to start saving output.

Returns:

the amount of data written to output.

Throws:

java.io.IOException - in case of failure.

getOutputSize

public int getOutputSize(int inputLength)

Description copied from interface: TlsAEADCipherImpl

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

Specified by:

getOutputSize in interface TlsAEADCipherImpl

Parameters:

inputLength - the length (in bytes) of the proposed input.

Returns:

the maximum size of the output.

init

public void init(byte[] nonce,
                 int macSize,
                 byte[] additionalData)
          throws java.io.IOException

Description copied from interface: TlsAEADCipherImpl

Initialise the parameters for the AEAD operator.

Specified by:

init in interface TlsAEADCipherImpl

Parameters:

nonce - the nonce.

macSize - MAC size in bytes.

additionalData - any additional data to be included in the MAC calculation.

Throws:

java.io.IOException - if the parameters are inappropriate.

setKey

public void setKey(byte[] key,
                   int keyOff,
                   int keyLen)
            throws java.io.IOException

Description copied from interface: TlsAEADCipherImpl

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

Specified by:

setKey in interface TlsAEADCipherImpl

Parameters:

key - array holding the AEAD cipher key.

keyOff - offset into the array the key starts at.

keyLen - length of the key in the array.

Throws:

java.io.IOException

initMAC

protected void initMAC()

updateMAC

protected void updateMAC(byte[] buf,
                         int off,
                         int len)