er.extensions.crypting

Class ERXAbstractAESCrypter

java.lang.Object

er.extensions.crypting.ERXAbstractAESCrypter

All Implemented Interfaces:

ERXCrypterInterface

Direct Known Subclasses:

ERXAESCrypter

public abstract class ERXAbstractAESCrypter
extends Object
implements ERXCrypterInterface

ERXAbstractAESCrypter is an AES implementation of the crypter interface that allows subclasses to override the source of the cipher key. The AES cipher is a two-way cipher meaning the original string that was encrypted can be retrieved. The way that this version of the AES cipher is encrypted it is safe to use as a form value.

Author:

qdolan

Constructor Summary

Constructors

Constructor and Description
ERXAbstractAESCrypter()

Method Summary

Modifier and Type	Method and Description
int	blockSize() Returns the block size for this cipher.
protected Cipher	createCipher(int mode) Creates an AES cipher for a given mode.
String	decrypt(String cryptedText) Decodes an AES encoded string.
protected Cipher	decryptCipher() Method used to return the shared instance of the decryption cipher.
String	encrypt(String clearText) AES encodes a given string using the secret key specified in the System property: er.extensions.ERXAESCipherKey.
protected Cipher	encryptCipher() Method used to return the shared instance of the encryption cipher.
protected abstract Key	secretKey() Returns the secret key to use for this cipher.
void	setBlockSize(int blockSize) Sets the block size to use for this cipher.

Methods inherited from class java.lang.Object

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

Constructor Detail

ERXAbstractAESCrypter

public ERXAbstractAESCrypter()

Method Detail

setBlockSize

public void setBlockSize(int blockSize)

Sets the block size to use for this cipher.

Parameters:

blockSize - the block size to use for this cipher

blockSize

public int blockSize()

Returns the block size for this cipher.

Returns:

the block size for this cipher

secretKey

protected abstract Key secretKey()
                          throws Exception

Returns the secret key to use for this cipher.

Returns:

a secret key for the cipher

Throws:

Exception

createCipher

protected Cipher createCipher(int mode)

Creates an AES cipher for a given mode. The two possible modes for a cipher are: ENCRYPT and DECRYPT.

Parameters:

mode - of the cipher (encrypting or decrypting)

Returns:

an AES cipher initialized with the given mode and with the secretKey from the above method.

encryptCipher

protected Cipher encryptCipher()

Method used to return the shared instance of the encryption cipher.

Returns:

AES encryption cipher

decryptCipher

protected Cipher decryptCipher()

Method used to return the shared instance of the decryption cipher.

Returns:

decryption cipher

decrypt

public String decrypt(String cryptedText)

Decodes an AES encoded string. Note that the originally encoded string should have been encoded with the same secret key as is used for the decoding cipher or else you are going to get garbage. To encode a string have a look at encrypt.

Specified by:

decrypt in interface ERXCrypterInterface

Parameters:

cryptedText - AES encoded string to be decoded

Returns:

decode clear text string

encrypt

public String encrypt(String clearText)

AES encodes a given string using the secret key specified in the System property: er.extensions.ERXAESCipherKey. The AES cipher is a two way cipher meaning that given the secret key you can de-cipher what the original string is. For one-way encryption look at methods dealing with the SHA algorithm. To decode an AES encoded string use the method: decrypt. The resultant string from encoding a string is base64url encoded and safe for use in urls and cookies.

Specified by:

encrypt in interface ERXCrypterInterface

Parameters:

clearText - string to be encrypted

Returns:

encrypted string