org.eclipse.californium.scandium.dtls.cipher

Class AeadBlockCipher

java.lang.Object

org.eclipse.californium.scandium.dtls.cipher.AeadBlockCipher

public class AeadBlockCipher
extends Object

A generic Authenticated Encryption with Associated Data block cipher mode.

Field Summary

Fields

Modifier and Type	Field and Description
static String	AES_CCM Support java prior 1.7, aes-ccm is a non-java-vm transformation and handled as special transformation.

Constructor Summary

Constructors

Constructor and Description
AeadBlockCipher()

Method Summary

Methods

Modifier and Type	Method and Description
static byte[]	decrypt(CipherSuite suite, SecretKey key, byte[] nonce, byte[] additionalData, byte[] crypted, int cryptedOffset, int cryptedLength) Decrypt with AEAD cipher.
static byte[]	encrypt(int outputOffset, CipherSuite suite, SecretKey key, byte[] nonce, byte[] additionalData, byte[] message) Encrypt with AEAD cipher.
static boolean	isSupported(String transformation, int keyLength) Test, if cipher is supported.

Methods inherited from class java.lang.Object

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

Field Detail

AES_CCM

public static final String AES_CCM

Support java prior 1.7, aes-ccm is a non-java-vm transformation and handled as special transformation.

See Also:

CCMBlockCipher, Constant Field Values

Constructor Detail

AeadBlockCipher

public AeadBlockCipher()

Method Detail

isSupported

public static final boolean isSupported(String transformation,
                  int keyLength)

Test, if cipher is supported.

Parameters:

transformation - name of cipher

keyLength - key length in bytes

Returns:

true, if supported

decrypt

public static final byte[] decrypt(CipherSuite suite,
             SecretKey key,
             byte[] nonce,
             byte[] additionalData,
             byte[] crypted,
             int cryptedOffset,
             int cryptedLength)
                            throws GeneralSecurityException

Decrypt with AEAD cipher.

Parameters:

suite - the cipher suite

key - the encryption key K.

nonce - the nonce N.

additionalData - the additional authenticated data a.

crypted - the encrypted and authenticated message c.

cryptedOffset - the offset within crypted.

cryptedLength - the length within crypted.

Returns:

the decrypted message

Throws:

GeneralSecurityException - if the message could not be de-crypted, e.g. because the ciphertext's block size is not correct

InvalidMacException - if the message could not be authenticated

encrypt

public static final byte[] encrypt(int outputOffset,
             CipherSuite suite,
             SecretKey key,
             byte[] nonce,
             byte[] additionalData,
             byte[] message)
                            throws GeneralSecurityException

Encrypt with AEAD cipher.

Parameters:

outputOffset - offset of the encrypted message within the resulting byte array. Leaves space for the explicit nonce.

suite - the cipher suite

key - the encryption key K.

nonce - the nonce N.

additionalData - the additional authenticated data a.

message - the message to authenticate and encrypt.

Returns:

the encrypted and authenticated message.

Throws:

GeneralSecurityException - if the data could not be encrypted, e.g. because the JVM does not support the AES cipher algorithm