iaik.security.cipher

Class PBEKeyBMP

java.lang.Object

iaik.security.cipher.PBEKeyBMP

All Implemented Interfaces:

java.io.Serializable, java.security.Key, javax.crypto.SecretKey, javax.security.auth.Destroyable

public class PBEKeyBMP
extends java.lang.Object
implements javax.crypto.SecretKey

A secret key for PBE (Password Based Encryption).

PKCS#12 breaks with the recommendation of PKCS#5 suggesting passwords to consist of printable ASCII characters. PKCS #12 creates passwords from BMPStrings with a NULL terminator by encoding every character of the original BMPString in 2 bytes in big-endian format (most-significant byte first).

This class returns the password as a byte array of the default ASCII encoding. But in contrast to PBEKey here the password is created from a BMPstring with a NULL terminator.

E.g.: User-password "Beavis" would lead to the following string of 14 bytes:

0x00 0x42 0x00 0x65 0x00 0x61 0x00 0x76 0x00 0x69 0x00 0x73 0x00 0x00

You can also use the "PKCS#12" SecretKeyFactory for converting a password to a PBEKeyBMP.

See Also:

SecretKey, SecretKey, PBEKey, PbeWithSHAAnd3_KeyTripleDES_CBC, PbeWithSHAAnd40BitRC2_CBC, Serialized Form

Field Summary

Fields inherited from interface javax.crypto.SecretKey

serialVersionUID

Constructor Summary

Constructors

Constructor and Description
PBEKeyBMP(char[] password) Creates a new PBEKeyBMP from a char array.
PBEKeyBMP(javax.crypto.spec.PBEKeySpec keySpec) Creates a new PBEKey from a PBEKeySpec.
PBEKeyBMP(java.lang.String password) Creates a new PBEKeyBMP from a String.

Method Summary

Modifier and Type	Method and Description
java.lang.String	getAlgorithm() Returns the algorithm name.
byte[]	getEncoded() Returns the password as byte array.
static byte[]	getEncoded(char[] password) Converts the ASCII passwort to a 2 bytes big-endian format BMPString.
java.lang.String	getFormat() Returns the format name.
char[]	getKey() Returns the password as char array.

Methods inherited from class java.lang.Object

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

Methods inherited from interface javax.security.auth.Destroyable

destroy, isDestroyed

Constructor Detail

PBEKeyBMP

public PBEKeyBMP(java.lang.String password)

Creates a new PBEKeyBMP from a String.

Parameters:

password - the password as a string

PBEKeyBMP

public PBEKeyBMP(char[] password)

Creates a new PBEKeyBMP from a char array.

Parameters:

password - the password as a char array

PBEKeyBMP

public PBEKeyBMP(javax.crypto.spec.PBEKeySpec keySpec)

Creates a new PBEKey from a PBEKeySpec.

Parameters:

keySpec - the password as KeySpec

Method Detail

getEncoded

public final byte[] getEncoded()

Returns the password as byte array.

Specified by:

getEncoded in interface java.security.Key

Returns:

the password as byte array

getEncoded

public static final byte[] getEncoded(char[] password)

Converts the ASCII passwort to a 2 bytes big-endian format BMPString.

Returns:

the password as byte array

getKey

public char[] getKey()

Returns the password as char array.

Returns:

the password as char array

getAlgorithm

public java.lang.String getAlgorithm()

Returns the algorithm name.

Specified by:

getAlgorithm in interface java.security.Key

Returns:

"PBE"

getFormat

public java.lang.String getFormat()

Returns the format name.

Specified by:

getFormat in interface java.security.Key

Returns:

"RAW_BMP"