io.getlime.security.powerauth.provider

Interface CryptoProviderUtil

All Known Implementing Classes:

CryptoProviderUtilBouncyCastle, CryptoProviderUtilsSpongyCastle

public interface CryptoProviderUtil

Interface for key conversion methods, used to decouple logics from the implementation based on specific Java crypto provider (BC, SC, ...)

Author:

Petr Dvorak

Method Summary

Modifier and Type	Method and Description
PrivateKey	convertBytesToPrivateKey(byte[] keyBytes) Convert a byte array to an EC private key by decoding the D number parameter.
PublicKey	convertBytesToPublicKey(byte[] keyBytes) Converts byte array to an EC public key, by decoding the Q point parameter.
SecretKey	convertBytesToSharedSecretKey(byte[] bytesSecretKey) Converts a byte array to the secret shared key (usually used for AES based operations).
byte[]	convertPrivateKeyToBytes(PrivateKey privateKey) Converts an EC private key to bytes by encoding the D number parameter.
byte[]	convertPublicKeyToBytes(PublicKey publicKey) Converts an EC public key to a byte array by encoding Q point parameter.
byte[]	convertSharedSecretKeyToBytes(SecretKey sharedSecretKey) Converts a shared secret key (usually used for AES based operations) to a byte array.
String	getProviderName() Get the provider name, for example "BC" for Bouncy Castle.

Method Detail

getProviderName

String getProviderName()

Get the provider name, for example "BC" for Bouncy Castle.

Returns:

Name of the provider, for example "BC" for Bouncy Castle.

convertPublicKeyToBytes

byte[] convertPublicKeyToBytes(PublicKey publicKey)
                        throws CryptoProviderException

Converts an EC public key to a byte array by encoding Q point parameter.

Parameters:

publicKey - An EC public key to be converted.

Returns:

A byte array representation of the EC public key.

Throws:

CryptoProviderException - In case crypto provider is not initialized correctly.

convertBytesToPublicKey

PublicKey convertBytesToPublicKey(byte[] keyBytes)
                           throws InvalidKeySpecException,
                                  CryptoProviderException

Converts byte array to an EC public key, by decoding the Q point parameter.

Parameters:

keyBytes - Bytes to be converted to EC public key.

Returns:

An instance of the EC public key on success, or null on failure.

Throws:

InvalidKeySpecException - When provided bytes are not a correct key representation.

CryptoProviderException - When crypto provider is incorrectly initialized.

convertPrivateKeyToBytes

byte[] convertPrivateKeyToBytes(PrivateKey privateKey)

Converts an EC private key to bytes by encoding the D number parameter.

Parameters:

privateKey - An EC private key to be converted to bytes.

Returns:

A byte array containing the representation of the EC private key.

convertBytesToPrivateKey

PrivateKey convertBytesToPrivateKey(byte[] keyBytes)
                             throws InvalidKeySpecException,
                                    CryptoProviderException

Convert a byte array to an EC private key by decoding the D number parameter.

Parameters:

keyBytes - Bytes to be converted to the EC private key.

Returns:

An instance of EC private key decoded from the input bytes.

Throws:

InvalidKeySpecException - The provided key bytes are not a valid EC private key.

CryptoProviderException - When crypto provider is incorrectly initialized.

convertSharedSecretKeyToBytes

byte[] convertSharedSecretKeyToBytes(SecretKey sharedSecretKey)

Converts a shared secret key (usually used for AES based operations) to a byte array.

Parameters:

sharedSecretKey - A shared key to be converted to bytes.

Returns:

A byte array representation of the shared secret key.

convertBytesToSharedSecretKey

SecretKey convertBytesToSharedSecretKey(byte[] bytesSecretKey)

Converts a byte array to the secret shared key (usually used for AES based operations).

Parameters:

bytesSecretKey - Bytes representing the shared key.

Returns:

An instance of the secret key by decoding from provided bytes.