org.eclipse.kura.crypto

Interface CryptoService

public interface CryptoService

The CryptoService is used to provide AES encrypt and decrypt functionality, Base64 encoding and decoding, and SHA1 hash generation.

Method Summary

Modifier and Type	Method and Description
String	decodeBase64(String encodedValue) Returns a decoded string based on the provided encodedValue.
char[]	decryptAes(char[] encryptedValue) Returns a char array based on the provided encrypted value.
String	decryptAes(String encryptedValue) Deprecated.
String	encodeBase64(String stringValue) Returns an encoded string based on the provided stringValue.
char[]	encryptAes(char[] value) Returns an AES encrypted char array based on the provided value.
String	encryptAes(String value) Deprecated.
char[]	getKeyStorePassword(String keyStorePath) Takes a keystore path and returns the corresponding password that can be used to access to the data saved in the specified keystore.
boolean	isFrameworkSecure() Answers if the Kura framework is running in security mode.
void	setKeyStorePassword(String keyStorePath, char[] password) Takes a keystore path as a String and a char array representing a password that has to be stored for the specified keystore.
void	setKeyStorePassword(String keyStorePath, String password) Deprecated.
String	sha1Hash(String s) Returns a SHA1 hashed value of the provided string s.

Method Detail

encryptAes

char[] encryptAes(char[] value)
           throws KuraException

Returns an AES encrypted char array based on the provided value.

Parameters:

value - A char array that will be encrypted.

Returns:

The char array representing the encrypted value.

Throws:

KuraException

decryptAes

char[] decryptAes(char[] encryptedValue)
           throws KuraException

Returns a char array based on the provided encrypted value.

Parameters:

encryptedValue - A char array representing the value to be decrypted.

Returns:

char[] that has been decrypted.

Throws:

KuraException

encryptAes

@Deprecated
String encryptAes(String value)
                       throws NoSuchAlgorithmException,
                              NoSuchPaddingException,
                              InvalidKeyException,
                              IllegalBlockSizeException,
                              BadPaddingException

Deprecated.

Returns an AES encrypted string based on the provided value.

Parameters:

value - A string that will be encrypted.

Returns:

String that has been encrypted.

Throws:

NoSuchAlgorithmException

NoSuchPaddingException

InvalidKeyException

IllegalBlockSizeException

BadPaddingException

decryptAes

@Deprecated
String decryptAes(String encryptedValue)
                       throws NoSuchAlgorithmException,
                              NoSuchPaddingException,
                              InvalidKeyException,
                              IOException,
                              IllegalBlockSizeException,
                              BadPaddingException

Deprecated.

Returns a plain text string based on the provided encrypted value.

Parameters:

encryptedValue - A string representing the value to be decrypted.

Returns:

String that has been decrypted.

Throws:

NoSuchAlgorithmException

NoSuchPaddingException

InvalidKeyException

IOException

IllegalBlockSizeException

BadPaddingException

sha1Hash

String sha1Hash(String s)
         throws NoSuchAlgorithmException,
                UnsupportedEncodingException

Returns a SHA1 hashed value of the provided string s.

Parameters:

s - A string on which to run the SHA1 hasing algorithm.

Returns:

String that has been hashed.

Throws:

NoSuchAlgorithmException

UnsupportedEncodingException

encodeBase64

String encodeBase64(String stringValue)
             throws NoSuchAlgorithmException,
                    UnsupportedEncodingException

Returns an encoded string based on the provided stringValue.

Parameters:

stringValue - A string to be encoded.

Returns:

String that has been encoded.

Throws:

NoSuchAlgorithmException

UnsupportedEncodingException

decodeBase64

String decodeBase64(String encodedValue)
             throws NoSuchAlgorithmException,
                    UnsupportedEncodingException

Returns a decoded string based on the provided encodedValue.

Parameters:

encodedValue - A string to be decoded.

Returns:

String that has been decoded.

Throws:

NoSuchAlgorithmException

UnsupportedEncodingException

getKeyStorePassword

char[] getKeyStorePassword(String keyStorePath)

Takes a keystore path and returns the corresponding password that can be used to access to the data saved in the specified keystore.

Parameters:

keyStorePath - A String that represents a unique identifier of the specified keystore.

Returns:

A char array that represents the password of the specified keystore.

setKeyStorePassword

void setKeyStorePassword(String keyStorePath,
                         char[] password)
                  throws KuraException

Takes a keystore path as a String and a char array representing a password that has to be stored for the specified keystore.

Parameters:

keyStorePath - A String that represents a unique identifier of the specified keystore.

password - A char array that represents the password of the specified keystore.

Throws:

KuraException

setKeyStorePassword

@Deprecated
void setKeyStorePassword(String keyStorePath,
                                     String password)
                              throws IOException

Deprecated.

Takes a keystore path as a String and a char array representing a password that has to be stored for the specified keystore.

Parameters:

keyStorePath - A String that represents a unique identifier of the specified keystore.

password - A String that represents the password of the specified keystore.

Throws:

IOException

isFrameworkSecure

boolean isFrameworkSecure()

Answers if the Kura framework is running in security mode.

Returns:

true if the framework is running in security mode.