Module seppiko.commons.utils

Package org.seppiko.commons.utils.crypto

Class AsymmetricUtil

java.lang.Object

org.seppiko.commons.utils.crypto.AsymmetricUtil

All Implemented Interfaces:

Serializable, Cryptography

public class AsymmetricUtil
extends Object
implements Cryptography, Serializable

Public-key cryptography (aka Asymmetric cryptography) utility

Author:

Leonard Woo

See Also:

• Cipher Algorithm Names
• Public-key cryptography
• Serialized Form

Constructor Summary

Constructors

Constructor	Description
AsymmetricUtil(String algorithm)	Public-key cryptography algorithm

Method Summary

Modifier and Type	Method	Description
byte[]	decrypt(byte[] data)	Decrypt data with Asymmetric cryptography
byte[]	decryptWithPublicKey(byte[] data)	Decrypt data with Asymmetric cryptography
byte[]	encrypt(byte[] data)	Encrypt data with Asymmetric cryptography
byte[]	encryptWithPrivateKey(byte[] data)	Encrypt data with Asymmetric cryptography
void	setKeyPair(PublicKey publicKey, PrivateKey privateKey)	Set key-pair
void	setParameterSpec(AlgorithmParameterSpec params)	Set AlgorithmParameterSpec.
void	setProvider(Provider provider)	Set provider.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.seppiko.commons.utils.crypto.Cryptography

setProvider

Constructor Details

AsymmetricUtil

public AsymmetricUtil(String algorithm)
               throws NoSuchAlgorithmException

Public-key cryptography algorithm

Parameters:

algorithm - Algorithm name.

Throws:

NoSuchAlgorithmException - Algorithm name parser failed.

Method Details

setProvider

public void setProvider(Provider provider)

Set provider.

Specified by:

setProvider in interface Cryptography

Parameters:

provider - the provider.

setKeyPair

public void setKeyPair(PublicKey publicKey,
 PrivateKey privateKey)

Set key-pair

Parameters:

publicKey - public key.

privateKey - private key.

See Also:

• KeyGeneratorUtil.keyPairGenerator(java.lang.String)

setParameterSpec

public void setParameterSpec(AlgorithmParameterSpec params)

Set AlgorithmParameterSpec.

Specified by:

setParameterSpec in interface Cryptography

Parameters:

params - AlgorithmParameterSpec subclass.

encrypt

public byte[] encrypt(byte[] data)
               throws InvalidAlgorithmParameterException,
NoSuchPaddingException,
IllegalBlockSizeException,
NoSuchAlgorithmException,
BadPaddingException,
InvalidKeyException,
NullPointerException

Encrypt data with Asymmetric cryptography

Specified by:

encrypt in interface Cryptography

Parameters:

data - plaintext data buffer

Returns:

ciphertext data buffer

Throws:

InvalidAlgorithmParameterException - if the given algorithm parameters are inappropriate for this cipher, or this cipher requires algorithm parameters and params is null, or the given algorithm parameters imply a cryptographic strength that would exceed the legal limits (as determined from the configured jurisdiction policy files).

NoSuchPaddingException - if transformation contains a padding scheme that is not available.

IllegalBlockSizeException - if this cipher is a block cipher, no padding has been requested (only in encryption mode), and the total input length of the data processed by this cipher is not a multiple of block size; or if this encryption algorithm is unable to process the input data provided.

NoSuchAlgorithmException - if transformation is null, empty, in an invalid format, or if no Provider supports a CipherSpi implementation for the specified algorithm.

BadPaddingException - if this cipher is in decryption mode, and (un)padding has been requested, but the decrypted data is not bounded by the appropriate padding bytes.

InvalidKeyException - if the given key is inappropriate for initializing this cipher, or its key-size exceeds the maximum allowable key-size (as determined from the configured jurisdiction policy files).

NullPointerException - public key is null.

decrypt

public byte[] decrypt(byte[] data)
               throws InvalidAlgorithmParameterException,
NoSuchPaddingException,
IllegalBlockSizeException,
NoSuchAlgorithmException,
BadPaddingException,
InvalidKeyException,
NullPointerException

Decrypt data with Asymmetric cryptography

Specified by:

decrypt in interface Cryptography

Parameters:

data - ciphertext data buffer

Returns:

plaintext data buffer

Throws:

InvalidAlgorithmParameterException - if the given algorithm parameters are inappropriate for this cipher, or this cipher requires algorithm parameters and params is null, or the given algorithm parameters imply a cryptographic strength that would exceed the legal limits (as determined from the configured jurisdiction policy files).

NoSuchPaddingException - if transformation contains a padding scheme that is not available.

IllegalBlockSizeException - if this cipher is a block cipher, no padding has been requested (only in encryption mode), and the total input length of the data processed by this cipher is not a multiple of block size; or if this encryption algorithm is unable to process the input data provided.

NoSuchAlgorithmException - if transformation is null, empty, in an invalid format, or if no Provider supports a CipherSpi implementation for the specified algorithm.

BadPaddingException - if this cipher is in decryption mode, and (un)padding has been requested, but the decrypted data is not bounded by the appropriate padding bytes.

InvalidKeyException - if the given key is inappropriate for initializing this cipher, or its key-size exceeds the maximum allowable key-size (as determined from the configured jurisdiction policy files).

NullPointerException - private key is null.

encryptWithPrivateKey

public byte[] encryptWithPrivateKey(byte[] data)
                             throws InvalidAlgorithmParameterException,
NoSuchPaddingException,
IllegalBlockSizeException,
NoSuchAlgorithmException,
BadPaddingException,
InvalidKeyException,
NullPointerException

Encrypt data with Asymmetric cryptography

Parameters:

data - plaintext data buffer

Returns:

ciphertext data buffer

Throws:

InvalidAlgorithmParameterException - if the given algorithm parameters are inappropriate for this cipher, or this cipher requires algorithm parameters and params is null, or the given algorithm parameters imply a cryptographic strength that would exceed the legal limits (as determined from the configured jurisdiction policy files).

NoSuchPaddingException - if transformation contains a padding scheme that is not available.

IllegalBlockSizeException - if this cipher is a block cipher, no padding has been requested (only in encryption mode), and the total input length of the data processed by this cipher is not a multiple of block size; or if this encryption algorithm is unable to process the input data provided.

NoSuchAlgorithmException - if transformation is null, empty, in an invalid format, or if no Provider supports a CipherSpi implementation for the specified algorithm.

BadPaddingException - if this cipher is in decryption mode, and (un)padding has been requested, but the decrypted data is not bounded by the appropriate padding bytes.

InvalidKeyException - if the given key is inappropriate for initializing this cipher, or its key-size exceeds the maximum allowable key-size (as determined from the configured jurisdiction policy files).

NullPointerException - private key is null.

decryptWithPublicKey

public byte[] decryptWithPublicKey(byte[] data)
                            throws InvalidAlgorithmParameterException,
NoSuchPaddingException,
IllegalBlockSizeException,
NoSuchAlgorithmException,
BadPaddingException,
InvalidKeyException,
NullPointerException

Decrypt data with Asymmetric cryptography

Parameters:

data - ciphertext data buffer

Returns:

plaintext data buffer

Throws:

InvalidAlgorithmParameterException - if the given algorithm parameters are inappropriate for this cipher, or this cipher requires algorithm parameters and params is null, or the given algorithm parameters imply a cryptographic strength that would exceed the legal limits (as determined from the configured jurisdiction policy files).

NoSuchPaddingException - if transformation contains a padding scheme that is not available.

IllegalBlockSizeException - if this cipher is a block cipher, no padding has been requested (only in encryption mode), and the total input length of the data processed by this cipher is not a multiple of block size; or if this encryption algorithm is unable to process the input data provided.

NoSuchAlgorithmException - if transformation is null, empty, in an invalid format, or if no Provider supports a CipherSpi implementation for the specified algorithm.

BadPaddingException - if this cipher is in decryption mode, and (un)padding has been requested, but the decrypted data is not bounded by the appropriate padding bytes.

InvalidKeyException - if the given key is inappropriate for initializing this cipher, or its key-size exceeds the maximum allowable key-size (as determined from the configured jurisdiction policy files).

NullPointerException - public key is null.