com.google.crypto.tink.aead

Class AeadKeyTemplates

java.lang.Object

com.google.crypto.tink.aead.AeadKeyTemplates

public final class AeadKeyTemplates
extends Object

Pre-generated KeyTemplate for Aead keys.

One can use these templates to generate new Keyset with KeysetHandle.generateNew(com.google.crypto.tink.proto.KeyTemplate). To generate a new keyset that contains a single AesGcmKey, one can do:

 Config.register(AeadConfig.TINK_1_1_0);
 KeysetHandle handle = KeysetHandle.generateNew(AeadKeyTemplates.AES128_GCM);
 Aead aead = AeadFactory.getPrimitive(handle);
 

Since:

1.0.0

Field Summary

Fields

Modifier and Type	Field and Description
static KeyTemplate	AES128_CTR_HMAC_SHA256 A KeyTemplate that generates new instances of AesCtrHmacAeadKey with the following parameters: AES key size: 16 bytes AES CTR IV size: 16 byte HMAC key size: 32 bytes HMAC tag size: 16 bytes HMAC hash function: SHA256
static KeyTemplate	AES128_EAX A KeyTemplate that generates new instances of com.google.crypto.tink.proto.AesEaxKey with the following parameters: Key size: 16 bytes IV size: 16 bytes
static KeyTemplate	AES128_GCM A KeyTemplate that generates new instances of AesGcmKey with the following parameters: Key size: 16 bytes
static KeyTemplate	AES256_CTR_HMAC_SHA256 A KeyTemplate that generates new instances of AesCtrHmacAeadKey with the following parameters: AES key size: 32 bytes AES CTR IV size: 16 byte HMAC key size: 32 bytes HMAC tag size: 32 bytes HMAC hash function: SHA256
static KeyTemplate	AES256_EAX A KeyTemplate that generates new instances of AesEaxKey with the following parameters: Key size: 32 bytes IV size: 16 bytes
static KeyTemplate	AES256_GCM A KeyTemplate that generates new instances of AesGcmKey with the following parameters: Key size: 32 bytes
static KeyTemplate	CHACHA20_POLY1305 A KeyTemplate that generates new instances of ChaCha20Poly1305Key.

Constructor Summary

Constructors

Constructor and Description
AeadKeyTemplates()

Method Summary

Modifier and Type	Method and Description
static KeyTemplate	createAesCtrHmacAeadKeyTemplate(int aesKeySize, int ivSize, int hmacKeySize, int tagSize, HashType hashType)
static KeyTemplate	createAesEaxKeyTemplate(int keySize, int ivSize)
static KeyTemplate	createAesGcmKeyTemplate(int keySize)
static KeyTemplate	createKmsAeadKeyTemplate(String keyUri)
static KeyTemplate	createKmsEnvelopeAeadKeyTemplate(String kekUri, KeyTemplate dekTemplate)

Methods inherited from class java.lang.Object

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

Field Detail

AES128_GCM

public static final KeyTemplate AES128_GCM

A KeyTemplate that generates new instances of AesGcmKey with the following parameters:

• Key size: 16 bytes

On Android KitKat (API level 19), the Aead instance generated by this key template does not support associated data. It might not work at all in older versions.

AES256_GCM

public static final KeyTemplate AES256_GCM

A KeyTemplate that generates new instances of AesGcmKey with the following parameters:

• Key size: 32 bytes

On Android KitKat (API level 19), the Aead instance generated by this key template does not support associated data. It might not work at all in older versions.

AES128_EAX

public static final KeyTemplate AES128_EAX

A KeyTemplate that generates new instances of com.google.crypto.tink.proto.AesEaxKey with the following parameters:

• Key size: 16 bytes
• IV size: 16 bytes

AES256_EAX

public static final KeyTemplate AES256_EAX

A KeyTemplate that generates new instances of AesEaxKey with the following parameters:

• Key size: 32 bytes
• IV size: 16 bytes

AES128_CTR_HMAC_SHA256

public static final KeyTemplate AES128_CTR_HMAC_SHA256

A KeyTemplate that generates new instances of AesCtrHmacAeadKey with the following parameters:

• AES key size: 16 bytes
• AES CTR IV size: 16 byte
• HMAC key size: 32 bytes
• HMAC tag size: 16 bytes
• HMAC hash function: SHA256

AES256_CTR_HMAC_SHA256

public static final KeyTemplate AES256_CTR_HMAC_SHA256

A KeyTemplate that generates new instances of AesCtrHmacAeadKey with the following parameters:

• AES key size: 32 bytes
• AES CTR IV size: 16 byte
• HMAC key size: 32 bytes
• HMAC tag size: 32 bytes
• HMAC hash function: SHA256

CHACHA20_POLY1305

public static final KeyTemplate CHACHA20_POLY1305

A KeyTemplate that generates new instances of ChaCha20Poly1305Key.

Since:

1.1.0

Constructor Detail

AeadKeyTemplates

public AeadKeyTemplates()

Method Detail

createAesGcmKeyTemplate

public static KeyTemplate createAesGcmKeyTemplate(int keySize)

Returns:

a KeyTemplate containing a AesGcmKeyFormat with some specified parameters.

createAesEaxKeyTemplate

public static KeyTemplate createAesEaxKeyTemplate(int keySize,
                                                  int ivSize)

Returns:

a KeyTemplate containing a AesEaxKeyFormat with some specified parameters.

createAesCtrHmacAeadKeyTemplate

public static KeyTemplate createAesCtrHmacAeadKeyTemplate(int aesKeySize,
                                                          int ivSize,
                                                          int hmacKeySize,
                                                          int tagSize,
                                                          HashType hashType)

Returns:

a KeyTemplate containing a AesCtrHmacAeadKeyFormat with some specific parameters.

createKmsAeadKeyTemplate

public static KeyTemplate createKmsAeadKeyTemplate(String keyUri)

Returns:

a new KeyTemplate that can generate a KmsAeadKey pointing to keyUri.

createKmsEnvelopeAeadKeyTemplate

public static KeyTemplate createKmsEnvelopeAeadKeyTemplate(String kekUri,
                                                           KeyTemplate dekTemplate)

Returns:

a new KeyTemplate that can generate a KmsEnvelopeAeadKey whose KEK is pointing to kekUri and DEK template is dekTemplate.