de.schlichtherle.crypto.io.raes
Interface Type0RaesParameters

All Superinterfaces:

RaesParameters

public interface Type0RaesParameters
extends RaesParameters

The parameters of this interface are used with RAES type 0 files. Type 0 RAES files use password based encryption according to the specifications in PKCS #5 V2.0 und PKCS #12 V1.0.

Since:

TrueZIP 6.0

Version:

$Id: Type0RaesParameters.java,v 1.4 2010/08/20 13:09:38 christian_schlichtherle Exp $

Author:

Christian Schlichtherle

See Also:

PKCS #5, PKCS #12

Field Summary

static int	KEY_STRENGTH_128 Identifier for a 128 bit ciphering key.
static int	KEY_STRENGTH_192 Identifier for a 192 bit ciphering key.
static int	KEY_STRENGTH_256 Identifier for a 256 bit ciphering key.

Method Summary

char[]	getCreatePasswd() Returns the password required to create or overwrite the RAES type 0 file.
int	getKeyStrength() Returns the key strength to use for creating or overwriting the RAES file.
char[]	getOpenPasswd() Returns the password required to open the RAES type 0 file for reading.
void	invalidOpenPasswd() Callback to report that the password returned by getOpenPasswd() is wrong.
void	setKeyStrength(int keyStrength) Sets the key strength which was used when creating or overwriting the RAES file.

Field Detail

KEY_STRENGTH_128

static final int KEY_STRENGTH_128

Identifier for a 128 bit ciphering key.

See Also:

Constant Field Values

KEY_STRENGTH_192

static final int KEY_STRENGTH_192

Identifier for a 192 bit ciphering key.

See Also:

Constant Field Values

KEY_STRENGTH_256

static final int KEY_STRENGTH_256

Identifier for a 256 bit ciphering key.

See Also:

Constant Field Values

Method Detail

getCreatePasswd

char[] getCreatePasswd()
                       throws RaesKeyException

Returns the password required to create or overwrite the RAES type 0 file.

Returns:

A clone of the char array holding the password to use for creating or overwriting the RAES file - never null.

Throws:

RaesKeyException - If password retrieval has been disabled or cancelled.

getOpenPasswd

char[] getOpenPasswd()
                     throws RaesKeyException

Returns the password required to open the RAES type 0 file for reading. Please note that this method is called repeatedly until either the returned password is correct or an exception has been thrown.

Returns:

A clone of the char array holding the password to open the RAES file for reading - never null.

Throws:

RaesKeyException - If password retrieval has been disabled or cancelled.

invalidOpenPasswd

void invalidOpenPasswd()

Callback to report that the password returned by getOpenPasswd() is wrong.

getKeyStrength

int getKeyStrength()

Returns the key strength to use for creating or overwriting the RAES file.

See Also:

KEY_STRENGTH_128, KEY_STRENGTH_192, KEY_STRENGTH_256

setKeyStrength

void setKeyStrength(int keyStrength)

Sets the key strength which was used when creating or overwriting the RAES file.