org.apache.fulcrum.jce.crypto.algo

Class CryptoStreamGCMImpl

java.lang.Object

org.apache.fulcrum.jce.crypto.extended.CryptoStreamFactoryJ8Template

org.apache.fulcrum.jce.crypto.algo.CryptoStreamGCMImpl

All Implemented Interfaces:

CryptoStreamFactory, CryptoStreamFactoryJ8

public final class CryptoStreamGCMImpl
extends CryptoStreamFactoryJ8Template

Concrete implementation for creating encrypting/decrypting streams. The implementation uses the JCA (Java Crypto Extension) supplied by SUN (using SunJCE 1.42). The implementation uses @see CryptoParametersJ8.TYPES_IMPL#ALGORITHM_J8_GCM for encryption which should be sufficent for most applications. The implementation also supplies a default password in the case that the programmer don't want to have additional hassles. It is easy to reengineer the password being used but much better than a hard-coded password in the application.

Author:

Georg Kallidis The Implementation for CryptoParametersJ8.TYPES GCM.

Field Summary

Fields

Modifier and Type	Field and Description
protected static int	IV_SIZE

Fields inherited from class org.apache.fulcrum.jce.crypto.extended.CryptoStreamFactoryJ8Template

algorithm, count, instances, providerName, PROVIDERNAME, salt, SALT_SIZE

Constructor Summary

Constructors

Constructor and Description
CryptoStreamGCMImpl() Constructor
CryptoStreamGCMImpl(byte[] salt) Constructor

Method Summary

Modifier and Type	Method and Description
protected byte[]	createCipher(InputStream is, int mode, char[] password) Create a Cipher.
protected Key	createKey(char[] password, byte[] salt) Create a AES/GCM key.

Methods inherited from class org.apache.fulcrum.jce.crypto.extended.CryptoStreamFactoryJ8Template

generateSalt, getAlgorithm, getCount, getInputStream, getInputStream, getInputStream, getInputStream, getInstance, getInstance, getInstance, getOutputStream, getOutputStream, getOutputStream, getProviderName, getSalt, getSmartInputStream, getSmartInputStream, getType, resetInstances, setAlgorithm, setCount, setProviderName, setSalt, setType

Methods inherited from class java.lang.Object

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

Field Detail

IV_SIZE

protected static final int IV_SIZE

See Also:

Constant Field Values

Constructor Detail

CryptoStreamGCMImpl

public CryptoStreamGCMImpl()
                    throws GeneralSecurityException

Constructor

Throws:

GeneralSecurityException - - wraps NoSuchAlgorithmException

CryptoStreamGCMImpl

public CryptoStreamGCMImpl(byte[] salt)

Constructor

Parameters:

salt - the salt for the GCM algorithm

Method Detail

createKey

protected Key createKey(char[] password,
                        byte[] salt)
                 throws GeneralSecurityException

Create a AES/GCM key.

Specified by:

createKey in class CryptoStreamFactoryJ8Template

Parameters:

password - the password to use.

salt - if provided this is used, otherweise CryptoStreamFactoryJ8Template.getSalt().

Returns:

the key

Throws:

GeneralSecurityException - if creating the key failed

createCipher

protected byte[] createCipher(InputStream is,
                              int mode,
                              char[] password)
                       throws GeneralSecurityException,
                              IOException

Create a Cipher. Find additional information here: GCMParameterSpec

Specified by:

createCipher in class CryptoStreamFactoryJ8Template

Parameters:

mode - the cipher mode

password - the password

is - the input stream

Returns:

an instance of a cipher

Throws:

GeneralSecurityException - if creating a cipher failed

IOException - creating a cipher failed