org.jpos.security

Class SecureDESKey

java.lang.Object

org.jpos.security.SecureKey

org.jpos.security.SecureVariantKey

org.jpos.security.SecureDESKey

All Implemented Interfaces:

java.io.Serializable, Loggeable

public class SecureDESKey
extends SecureVariantKey

The SecureDESKey class represents:
Single, double or triple length DES keys that are secured by a security module. This is typically the DES key encrypted under one of the Local Master Keys of the security module.

SecureDESKey has an extra property "Key Check Value". It allows assuring that two SecureDESKeys owned by two different parties map to the same clear key. This can be a useful manual check for successful key exchange.

NOTE: The security of SecureDESKey is totally dependent on the security of the used security module.

See Also:

SMAdapter, Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
protected static java.util.regex.Pattern	KEY_TYPE_PATTERN Regular expression pattern representing key type string value.

Fields inherited from class org.jpos.security.SecureVariantKey

variant

Fields inherited from class org.jpos.security.SecureKey

keyBytes, keyCheckValue, keyLength, keyName, keyType, scheme

Constructor Summary

Constructors

Constructor and Description
SecureDESKey()
SecureDESKey(short keyLength, java.lang.String keyType, byte[] keyBytes, byte[] keyCheckValue) Constructs an SecureDESKey
SecureDESKey(short keyLength, java.lang.String keyType, byte variant, KeyScheme scheme, byte[] keyBytes, byte[] keyCheckValue) Constructs an SecureDESKey
SecureDESKey(short keyLength, java.lang.String keyType, byte variant, KeyScheme scheme, java.lang.String keyHexString, java.lang.String keyCheckValueHexString) Constructs an SecureDESKey
SecureDESKey(short keyLength, java.lang.String keyType, java.lang.String keyHexString, java.lang.String keyCheckValueHexString) Constructs an SecureDESKey

Method Summary

Modifier and Type	Method and Description
void	dump(java.io.PrintStream p, java.lang.String indent) dumps SecureDESKey basic information
KeyScheme	getScheme() Gets the key scheme used to protect this key.
byte	getVariant() Gets the key variant method used to protect this key.

Methods inherited from class org.jpos.security.SecureVariantKey

setVariant

Methods inherited from class org.jpos.security.SecureKey

getKeyBytes, getKeyCheckValue, getKeyLength, getKeyName, getKeyType, setKeyBytes, setKeyCheckValue, setKeyLength, setKeyName, setKeyType, setScheme

Methods inherited from class java.lang.Object

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

Field Detail

KEY_TYPE_PATTERN

protected static final java.util.regex.Pattern KEY_TYPE_PATTERN

Regular expression pattern representing key type string value.

Constructor Detail

SecureDESKey

public SecureDESKey()

SecureDESKey

public SecureDESKey(short keyLength,
                    java.lang.String keyType,
                    byte variant,
                    KeyScheme scheme,
                    byte[] keyBytes,
                    byte[] keyCheckValue)

Constructs an SecureDESKey

Parameters:

keyLength - e.g. LENGTH_DES, LENGTH_DES3_2KEY, LENGTH_DES3_3KEY

keyType -

variant -

scheme -

keyBytes - DES Key in the secure proprietary format of your security module

keyCheckValue -

See Also:

SMAdapter

SecureDESKey

public SecureDESKey(short keyLength,
                    java.lang.String keyType,
                    byte[] keyBytes,
                    byte[] keyCheckValue)

Constructs an SecureDESKey

Parameters:

keyLength - e.g. LENGTH_DES, LENGTH_DES3_2KEY, LENGTH_DES3_3KEY

keyType -

keyBytes - DES Key in the secure proprietary format of your security module

keyCheckValue -

See Also:

SMAdapter

SecureDESKey

public SecureDESKey(short keyLength,
                    java.lang.String keyType,
                    java.lang.String keyHexString,
                    java.lang.String keyCheckValueHexString)

Constructs an SecureDESKey

Parameters:

keyLength -

keyType -

keyHexString - secure key represented as HexString instead of byte[]

keyCheckValueHexString - key check value represented as HexString instead of byte[]

SecureDESKey

public SecureDESKey(short keyLength,
                    java.lang.String keyType,
                    byte variant,
                    KeyScheme scheme,
                    java.lang.String keyHexString,
                    java.lang.String keyCheckValueHexString)

Constructs an SecureDESKey

Parameters:

keyLength -

keyType -

variant -

scheme -

keyHexString - secure key represented as HexString instead of byte[]

keyCheckValueHexString - key check value represented as HexString instead of byte[]

Method Detail

getVariant

public byte getVariant()

Description copied from class: SecureVariantKey

Gets the key variant method used to protect this key.

Specified by:

getVariant in class SecureVariantKey

Returns:

key variant method used to protect this key.

getScheme

public KeyScheme getScheme()

Description copied from class: SecureKey

Gets the key scheme used to protect this key.

Specified by:

getScheme in class SecureKey

Returns:

key scheme used to protect this key.

dump

public void dump(java.io.PrintStream p,
                 java.lang.String indent)

dumps SecureDESKey basic information

Parameters:

p - a PrintStream usually supplied by Logger

indent - indention string, usually suppiled by Logger

See Also:

Loggeable