Constructor Detail

• Crypto

  public Crypto()

Method Detail

• sign

  public static java.lang.String sign(java.lang.String message,
                      byte[] key)

  Signs the given String with HMAC-SHA1 using the given key.

  By default this uses the platform default JSSE provider. This can be overridden by defining application.crypto.provider in .

  Parameters:

  message - The message to sign.

  key - The private key to sign with.

  Returns:

  A hexadecimal encoded signature.

• sign

  public static java.lang.String sign(java.lang.String message)

  Signs the given String with HMAC-SHA1 using the application's secret key.

  By default this uses the platform default JSSE provider. This can be overridden by defining application.crypto.provider in .

  Parameters:

  message - The message to sign.

  Returns:

  A hexadecimal encoded signature.

• signToken

  public static java.lang.String signToken(java.lang.String token)

  Sign a token. This produces a new token, that has this token signed with a nonce. This primarily exists to defeat the BREACH vulnerability, as it allows the token to effectively be random per request, without actually changing the value.

  Parameters:

  token - The token to sign

  Returns:

  The signed token

• extractSignedToken

  public static java.lang.String extractSignedToken(java.lang.String token)

  Extract a signed token that was signed by signToken(String).

  Parameters:

  token - The signed token to extract.

  Returns:

  The verified raw token, or null if the token isn't valid.

• generateToken

  public static java.lang.String generateToken()

  Generate a cryptographically secure token

• generateSignedToken

  public static java.lang.String generateSignedToken()

  Generate a signed token

• compareSignedTokens

  public static boolean compareSignedTokens(java.lang.String tokenA,
                            java.lang.String tokenB)

  Compare two signed tokens

• constantTimeEquals

  public static boolean constantTimeEquals(java.lang.String a,
                           java.lang.String b)

  Constant time equals method. Given a length that both Strings are equal to, this method will always run in constant time. This prevents timing attacks.

• encryptAES

  public static java.lang.String encryptAES(java.lang.String value)

  Encrypt a String with the AES encryption standard using the application's secret key.

  The provider used is by default this uses the platform default JSSE provider. This can be overridden by defining application.crypto.provider in application.conf.

  The transformation algorithm used is the provider specific implementation of the AES name. On Oracles JDK, this is AES/ECB/PKCS5Padding. This algorithm is suitable for small amounts of data, typically less than 32 bytes, hence is useful for encrypting credit card numbers, passwords etc. For larger blocks of data, this algorithm may expose patterns and be vulnerable to repeat attacks.

  The transformation algorithm can be configured by defining application.crypto.aes.transformation in application.conf. Although any cipher transformation algorithm can be selected here, the secret key spec used is always AES, so only AES transformation algorithms will work.

  Parameters:

  value - The String to encrypt.

  Returns:

  An hexadecimal encrypted string.

• encryptAES

  public static java.lang.String encryptAES(java.lang.String value,
                            java.lang.String privateKey)

  Encrypt a String with the AES encryption standard and the supplied private key.

  The private key must have a length of 16 bytes.

  The provider used is by default this uses the platform default JSSE provider. This can be overridden by defining application.crypto.provider in application.conf.

  The transformation algorithm used is the provider specific implementation of the AES name. On Oracles JDK, this is AES/ECB/PKCS5Padding. This algorithm is suitable for small amounts of data, typically less than 32bytes, hence is useful for encrypting credit card numbers, passwords etc. For larger blocks of data, this algorithm may expose patterns and be vulnerable to repeat attacks.

  The transformation algorithm can be configured by defining application.crypto.aes.transformation in application.conf. Although any cipher transformation algorithm can be selected here, the secret key spec used is always AES, so only AES transformation algorithms will work.

  Parameters:

  value - The String to encrypt.

  privateKey - The key used to encrypt.

  Returns:

  An hexadecimal encrypted string.

• decryptAES

  public static java.lang.String decryptAES(java.lang.String value)

  Decrypt a String with the AES encryption standard using the application's secret key.

  The provider used is by default this uses the platform default JSSE provider. This can be overridden by defining application.crypto.provider in application.conf.

  The transformation used is by default AES/ECB/PKCS5Padding. It can be configured by defining application.crypto.aes.transformation in application.conf. Although any cipher transformation algorithm can be selected here, the secret key spec used is always AES, so only AES transformation algorithms will work.

  Parameters:

  value - An hexadecimal encrypted string.

  Returns:

  The decrypted String.

• decryptAES

  public static java.lang.String decryptAES(java.lang.String value,
                            java.lang.String privateKey)

  Decrypt a String with the AES encryption standard.

  The private key must have a length of 16 bytes.

  The provider used is by default this uses the platform default JSSE provider. This can be overridden by defining application.crypto.provider in application.conf.

  The transformation used is by default AES/ECB/PKCS5Padding. It can be configured by defining application.crypto.aes.transformation in application.conf. Although any cipher transformation algorithm can be selected here, the secret key spec used is always AES, so only AES transformation algorithms will work.

  Parameters:

  value - An hexadecimal encrypted string.

  privateKey - The key used to encrypt.

  Returns:

  The decrypted String.