CryptoAlgorithm (aws-encryption-sdk-java 1.3.5 API)

java.lang.Object
- java.lang.Enum<CryptoAlgorithm>
- - com.amazonaws.encryptionsdk.CryptoAlgorithm

All Implemented Interfaces:

Serializable, Comparable<CryptoAlgorithm>
```
public enum CryptoAlgorithm
extends Enum<CryptoAlgorithm>
```
Describes the cryptographic algorithms available for use in this library.
Format: CryptoAlgorithm(block size, nonce length, tag length, max content length, key algo, key length, short value representing this algorithm, trailing signature alg, trailing signature length)

Enum Constant Summary

Enum Constants
Enum Constant and Description
`ALG_AES_128_GCM_IV12_TAG16_HKDF_SHA256` AES-GCM 128 with HKDF-SHA256
`ALG_AES_128_GCM_IV12_TAG16_HKDF_SHA256_ECDSA_P256` AES-GCM 128 with ECDSA (SHA256 with the secp256r1 curve)
`ALG_AES_128_GCM_IV12_TAG16_NO_KDF` AES-GCM 128
`ALG_AES_192_GCM_IV12_TAG16_HKDF_SHA256` AES-GCM 192
`ALG_AES_192_GCM_IV12_TAG16_HKDF_SHA384_ECDSA_P384` AES-GCM 192 with ECDSA (SHA384 with the secp384r1 curve)
`ALG_AES_192_GCM_IV12_TAG16_NO_KDF` AES-GCM 192
`ALG_AES_256_GCM_IV12_TAG16_HKDF_SHA256` AES-GCM 256
`ALG_AES_256_GCM_IV12_TAG16_HKDF_SHA384_ECDSA_P384` AES-GCM 256 with ECDSA (SHA384 with the secp384r1 curve)
`ALG_AES_256_GCM_IV12_TAG16_NO_KDF` AES-GCM 256

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`static CryptoAlgorithm`	`deserialize(short value)` Returns the CryptoAlgorithm object that matches the given value.
`int`	`getBlockSize()` Returns the block size of this algorithm in bytes.
`String`	`getDataKeyAlgo()` Returns the algorithm associated with the data key.
`int`	`getDataKeyLength()` Returns the length of the data key in bytes.
`SecretKey`	`getEncryptionKeyFromDataKey(SecretKey dataKey, CiphertextHeaders headers)`
`String`	`getKeyAlgo()` Returns the algorithm used for encrypting the plaintext data.
`int`	`getKeyLength()` Returns the length of the key used in this algorithm in bytes.
`long`	`getMaxContentLen()` Returns the maximum content length in bytes that can be processed under a single data key in this algorithm.
`byte`	`getNonceLen()` Returns the nonce length used in this algorithm in bytes.
`int`	`getTagLen()` Returns the tag length used in this algorithm in bytes.
`String`	`getTrailingSignatureAlgo()` Returns the algorithm used to calculate the trailing signature
`short`	`getTrailingSignatureLength()` Returns the length of the trailing signature generated by this algorithm.
`short`	`getValue()` Returns the value used to encode this algorithm in the ciphertext.
`boolean`	`isSafeToCache()` Returns whether data keys used with this crypto algorithm can safely be cached and reused for a different message.
`static CryptoAlgorithm`	`valueOf(String name)` Returns the enum constant of this type with the specified name.
`static CryptoAlgorithm[]`	`values()` Returns an array containing the constants of this enum type, in the order they are declared.

Methods inherited from class java.lang.Enum
clone, compareTo, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

Methods inherited from class java.lang.Object
getClass, notify, notifyAll, wait, wait, wait

- Enum Constant Detail
  - ALG_AES_128_GCM_IV12_TAG16_NO_KDF
```
public static final CryptoAlgorithm ALG_AES_128_GCM_IV12_TAG16_NO_KDF
```
    AES-GCM 128
  - ALG_AES_192_GCM_IV12_TAG16_NO_KDF
```
public static final CryptoAlgorithm ALG_AES_192_GCM_IV12_TAG16_NO_KDF
```
    AES-GCM 192
  - ALG_AES_256_GCM_IV12_TAG16_NO_KDF
```
public static final CryptoAlgorithm ALG_AES_256_GCM_IV12_TAG16_NO_KDF
```
    AES-GCM 256
  - ALG_AES_128_GCM_IV12_TAG16_HKDF_SHA256
```
public static final CryptoAlgorithm ALG_AES_128_GCM_IV12_TAG16_HKDF_SHA256
```
    AES-GCM 128 with HKDF-SHA256
  - ALG_AES_192_GCM_IV12_TAG16_HKDF_SHA256
```
public static final CryptoAlgorithm ALG_AES_192_GCM_IV12_TAG16_HKDF_SHA256
```
    AES-GCM 192
  - ALG_AES_256_GCM_IV12_TAG16_HKDF_SHA256
```
public static final CryptoAlgorithm ALG_AES_256_GCM_IV12_TAG16_HKDF_SHA256
```
    AES-GCM 256
  - ALG_AES_128_GCM_IV12_TAG16_HKDF_SHA256_ECDSA_P256
```
public static final CryptoAlgorithm ALG_AES_128_GCM_IV12_TAG16_HKDF_SHA256_ECDSA_P256
```
    AES-GCM 128 with ECDSA (SHA256 with the secp256r1 curve)
  - ALG_AES_192_GCM_IV12_TAG16_HKDF_SHA384_ECDSA_P384
```
public static final CryptoAlgorithm ALG_AES_192_GCM_IV12_TAG16_HKDF_SHA384_ECDSA_P384
```
    AES-GCM 192 with ECDSA (SHA384 with the secp384r1 curve)
  - ALG_AES_256_GCM_IV12_TAG16_HKDF_SHA384_ECDSA_P384
```
public static final CryptoAlgorithm ALG_AES_256_GCM_IV12_TAG16_HKDF_SHA384_ECDSA_P384
```
    AES-GCM 256 with ECDSA (SHA384 with the secp384r1 curve)
- Method Detail
  - values
```
public static CryptoAlgorithm[] values()
```
    Returns an array containing the constants of this enum type, in the order they are declared. This method may be used to iterate over the constants as follows:
```
for (CryptoAlgorithm c : CryptoAlgorithm.values())
    System.out.println(c);
```
    Returns:
    
    an array containing the constants of this enum type, in the order they are declared
  - valueOf
```
public static CryptoAlgorithm valueOf(String name)
```
    Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)
    
    Parameters:
    
    name - the name of the enum constant to be returned.
    
    Returns:
    
    the enum constant with the specified name
    
    Throws:
    
    IllegalArgumentException - if this enum type has no constant with the specified name
    
    NullPointerException - if the argument is null
  - deserialize
```
public static CryptoAlgorithm deserialize(short value)
```
    Returns the CryptoAlgorithm object that matches the given value.
    
    Parameters:
    
    value - the value of the object
    
    Returns:
    
    the CryptoAlgorithm object that matches the given value, null if no match is found.
  - getBlockSize
```
public int getBlockSize()
```
    Returns the block size of this algorithm in bytes.
  - getNonceLen
```
public byte getNonceLen()
```
    Returns the nonce length used in this algorithm in bytes.
  - getTagLen
```
public int getTagLen()
```
    Returns the tag length used in this algorithm in bytes.
  - getMaxContentLen
```
public long getMaxContentLen()
```
    Returns the maximum content length in bytes that can be processed under a single data key in this algorithm.
  - getKeyAlgo
```
public String getKeyAlgo()
```
    Returns the algorithm used for encrypting the plaintext data.
  - getKeyLength
```
public int getKeyLength()
```
    Returns the length of the key used in this algorithm in bytes.
  - getValue
```
public short getValue()
```
    Returns the value used to encode this algorithm in the ciphertext.
  - getDataKeyAlgo
```
public String getDataKeyAlgo()
```
    Returns the algorithm associated with the data key.
  - getDataKeyLength
```
public int getDataKeyLength()
```
    Returns the length of the data key in bytes.
  - getTrailingSignatureAlgo
```
public String getTrailingSignatureAlgo()
```
    Returns the algorithm used to calculate the trailing signature
  - isSafeToCache
```
public boolean isSafeToCache()
```
    Returns whether data keys used with this crypto algorithm can safely be cached and reused for a different message. If this returns false, reuse of data keys is likely to result in severe cryptographic weaknesses, potentially even with only a single such use.
  - getTrailingSignatureLength
```
public short getTrailingSignatureLength()
```
    Returns the length of the trailing signature generated by this algorithm. The actual trailing signature may be shorter than this.
  - getEncryptionKeyFromDataKey
```
public SecretKey getEncryptionKeyFromDataKey(SecretKey dataKey,
                                             CiphertextHeaders headers)
                                      throws InvalidKeyException
```
    Throws:
    
    InvalidKeyException

Enum CryptoAlgorithm

Enum Constant Summary

Method Summary

Methods inherited from class java.lang.Enum

Methods inherited from class java.lang.Object

Enum Constant Detail

ALG_AES_128_GCM_IV12_TAG16_NO_KDF

ALG_AES_192_GCM_IV12_TAG16_NO_KDF

ALG_AES_256_GCM_IV12_TAG16_NO_KDF

ALG_AES_128_GCM_IV12_TAG16_HKDF_SHA256

ALG_AES_192_GCM_IV12_TAG16_HKDF_SHA256

ALG_AES_256_GCM_IV12_TAG16_HKDF_SHA256

ALG_AES_128_GCM_IV12_TAG16_HKDF_SHA256_ECDSA_P256

ALG_AES_192_GCM_IV12_TAG16_HKDF_SHA384_ECDSA_P384

ALG_AES_256_GCM_IV12_TAG16_HKDF_SHA384_ECDSA_P384

Method Detail

values

valueOf

deserialize

getBlockSize

getNonceLen

getTagLen

getMaxContentLen

getKeyAlgo

getKeyLength

getValue

getDataKeyAlgo

getDataKeyLength

getTrailingSignatureAlgo

isSafeToCache

getTrailingSignatureLength

getEncryptionKeyFromDataKey