cz.ues.platform.security.crypto

Interface CryptographyService

@UESComponent
public interface CryptographyService

Component for performing encryption and decryption.

Since:

UES6-04

Method Summary

Methods

Modifier and Type	Method and Description
byte[]	decrypt(byte[] data, java.security.Key key) Decrypt data.
byte[]	encrypt(byte[] data, java.security.Key key) Encrypt data.
javax.crypto.SecretKey	generateKey() Generates new cryptography key (strongest possible based on concrete cryptography algorithm configuration).
javax.crypto.SecretKey	generateKey(char[] password, byte[] salt)
java.lang.String	generateRandomSecret(int length) Generates secure random sequence of characters.
java.lang.String	getCipherAlgorithm()
java.lang.String	getHashAlgorithm()
java.lang.String	getKeyAlgorithm()
java.lang.String	getPasswordBasedKeyAlgorithm()
java.lang.String	getSecureRandomAlgorithm()
byte[]	hash(byte[] data, java.security.Key key) Creates hash of given data.

Method Detail

encrypt

byte[] encrypt(byte[] data,
java.security.Key key)
throws CryptographyServiceRTException

Encrypt data.

Parameters:

data - Data to encrypt. Data cannot be null.

key - Encryption key

Returns:

encrypted data

Throws:

CryptographyServiceRTException - In case encryption fails

Since:

UES6-04

decrypt

byte[] decrypt(byte[] data,
java.security.Key key)
throws CryptographyServiceRTException

Decrypt data.

Parameters:

data - Data to decrypt. Data cannot be null.

key - Decryption key

Returns:

decrypted data

Throws:

CryptographyServiceRTException - In case decryption fails

Since:

UES6-04

hash

byte[] hash(byte[] data,
java.security.Key key)
throws CryptographyServiceRTException

Creates hash of given data.

Parameters:

data - Data to be hashed. Data cannot be null.

key - Hashing key

Returns:

hashed data

Throws:

CryptographyServiceRTException - In case generating of hash fails

Since:

UES6-06

generateKey

javax.crypto.SecretKey generateKey()
throws CryptographyRTException

Generates new cryptography key (strongest possible based on concrete cryptography algorithm configuration).

Returns:

New cryptography random key

Throws:

CryptographyRTException - In case generating of key fails

Since:

UES6-06

generateKey

javax.crypto.SecretKey generateKey(char[] password,
byte[] salt)
throws CryptographyRTException

Parameters:

password - Password for generator.

salt - The salt for generator.

Returns:

New cryptography key derived from specified password and salt

Throws:

CryptographyRTException

Since:

UES6-06

See Also:

for more informations.

getCipherAlgorithm

java.lang.String getCipherAlgorithm()

Returns:

Cipher Algorithm Name

Since:

UES7-01

getHashAlgorithm

java.lang.String getHashAlgorithm()

Returns:

Hash Algorithm Name

Since:

UES7-01

getPasswordBasedKeyAlgorithm

java.lang.String getPasswordBasedKeyAlgorithm()

Returns:

name of algorithm used for password-based key generation.

Since:

UES7-01

getSecureRandomAlgorithm

java.lang.String getSecureRandomAlgorithm()

Returns:

Name of algorithm used for generation of secure numbers, used by CryptographyService.generateRandomSecret(int).

Since:

UES7-01

getKeyAlgorithm

java.lang.String getKeyAlgorithm()

Returns:

Name of algorithm used to generate key.

Since:

UES7-01

generateRandomSecret

java.lang.String generateRandomSecret(int length)

Generates secure random sequence of characters. Usable as password generator. The algorithm configured for CryptographyService.getSecureRandomAlgorithm() is used internally by this method.

Parameters:

length - - the length of generated secret.

Returns:

The generated sequence.

Since:

UES7-01