iaik.security.cipher

Class PBEKeyBMP

java.lang.Object

iaik.security.cipher.PBEKeyBMP

All Implemented Interfaces:

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

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

Version:

File Revision 17

See Also:

Serialized Form

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

Methods

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 password to a 2 bytes big-endian format BMPString.
java.lang.String	getFormat() Returns the format name.
char[]	getKey() Returns the password as char array.
void	setAlgorithm(java.lang.String algorithm) Sets the algorithm name.

Methods inherited from class java.lang.Object

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

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 password to a 2 bytes big-endian format BMPString.

If null is specified as password the encoding returned by this method consists of two 0X00 bytes.

Returns:

the password as byte array

getKey

public char[] getKey()

Returns the password as char array.

Returns:

the password as char array

setAlgorithm

public void setAlgorithm(java.lang.String algorithm)

Sets the algorithm name.

Parameters:

algorithm - the algorithm name

getAlgorithm

public java.lang.String getAlgorithm()

Returns the algorithm name.

Specified by:

getAlgorithm in interface java.security.Key

Returns:

the algorithm name

getFormat

public java.lang.String getFormat()

Returns the format name.

Specified by:

getFormat in interface java.security.Key

Returns:

"RAW_BMP"