iaik.pkcs.pkcs8

Class RawPrivateKey

java.lang.Object

iaik.pkcs.pkcs8.PrivateKeyInfo

iaik.pkcs.pkcs8.RawPrivateKey

All Implemented Interfaces:

ASN1Type, java.io.Serializable, java.lang.Cloneable, java.security.Key, java.security.PrivateKey

public class RawPrivateKey
extends PrivateKeyInfo
implements java.io.Serializable, java.lang.Cloneable

This class implements a raw, generic PKCS#8 private key.

When calling PrivateKeyInfo.getPrivateKey to parse a private key a KeyFactory for the key algorithm is instantiated. If no KeyFactory is available for the key algorithm a generic raw private key is created allowing to get some information about the key (algorithm, encoding).

Version:

File Revision 29

See Also:

Serialized Form

Field Summary

Fields inherited from class iaik.pkcs.pkcs8.PrivateKeyInfo

private_key_algorithm

Fields inherited from interface java.security.PrivateKey

serialVersionUID

Constructor Summary

Constructors

Constructor and Description
RawPrivateKey(ASN1Object obj) Creates a raw PrivateKey from the given ASN.1 object.
RawPrivateKey(byte[] pk) Creates a raw PrivateKey from the given DER encoded byte array.
RawPrivateKey(java.io.InputStream is) Creates a raw PrivateKey from an InputStream.

Method Summary

Methods

Modifier and Type	Method and Description
protected void	decode(byte[] privateKey) Decodes a raw PrivateKey, encoded in DER format.
byte[]	encode() Returns the raw private key (not wrapped in a PKCS#8 PrivateKeyInfo) as DER encoded ASN.1 object.
java.lang.String	getAlgorithm() Returns the name of the key algorithm.
java.lang.String	toString() Returns a string representation of this key.

Methods inherited from class iaik.pkcs.pkcs8.PrivateKeyInfo

clone, createPrivateKeyInfo, decode, equals, getAlgorithmID, getEncoded, getFormat, getPrivateKey, getPrivateKey, getPrivateKey, getPrivateKey, hashCode, toASN1Object, writeTo

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

RawPrivateKey

public RawPrivateKey(byte[] pk)
              throws java.security.InvalidKeyException

Creates a raw PrivateKey from the given DER encoded byte array.

Parameters:

pk - the byte array holding the DER encoded private key info

Throws:

java.security.InvalidKeyException - if the key cannot be parsed

RawPrivateKey

public RawPrivateKey(ASN1Object obj)
              throws java.security.InvalidKeyException

Creates a raw PrivateKey from the given ASN.1 object.

Parameters:

obj - the private key ASN.1 structure

Throws:

java.security.InvalidKeyException - if the key cannot be parsed

RawPrivateKey

public RawPrivateKey(java.io.InputStream is)
              throws java.io.IOException,
                     java.security.InvalidKeyException

Creates a raw PrivateKey from an InputStream.

Parameters:

is - the input stream from where the encoded PrivateKey shall be read

Throws:

java.io.IOException - if an I/O error occurs

java.security.InvalidKeyException - if the key cannot be parsed

Method Detail

decode

protected void decode(byte[] privateKey)
               throws java.security.InvalidKeyException

Decodes a raw PrivateKey, encoded in DER format.

This method only keeps the key encoding.

Specified by:

decode in class PrivateKeyInfo

Parameters:

privateKey - the private key as DER encoded ASN.1 object

Throws:

java.security.InvalidKeyException - if the key cannot be parsed

encode

public byte[] encode()

Returns the raw private key (not wrapped in a PKCS#8 PrivateKeyInfo) as DER encoded ASN.1 object.

This method typically may not be used by an application. Rather it is used by the parent PKCS#8 PrivateKeyInfo.getEncoded() method for encoding the private key.

Specified by:

encode in class PrivateKeyInfo

Returns:

a byte array holding the raw private key as a DER encoded ASN.1 data structure

getAlgorithm

public java.lang.String getAlgorithm()

Returns the name of the key algorithm.

Specified by:

getAlgorithm in interface java.security.Key

Specified by:

getAlgorithm in class PrivateKeyInfo

Returns:

the key algorithm name

toString

public java.lang.String toString()

Returns a string representation of this key.

Overrides:

toString in class PrivateKeyInfo

Returns:

the string representation