Package org.mozilla.jss.pkcs11

Class PK11KeyWrapper

java.lang.Object

org.mozilla.jss.pkcs11.PK11KeyWrapper

All Implemented Interfaces:

KeyWrapper

public final class PK11KeyWrapper
extends Object
implements KeyWrapper

Field Summary

Fields

Modifier and Type	Field	Description
static final org.slf4j.Logger	logger

Method Summary

Modifier and Type	Method	Description
void	initUnwrap()	For plaintext-wrapped keys.
void	initUnwrap(PrivateKey unwrappingKey, AlgorithmParameterSpec parameters)
void	initUnwrap(SymmetricKey unwrappingKey, AlgorithmParameterSpec parameters)
void	initWrap()	For wrapping keys in plaintext.
void	initWrap(PublicKey wrappingKey, AlgorithmParameterSpec parameters)
void	initWrap(SymmetricKey wrappingKey, AlgorithmParameterSpec parameters)
PrivateKey	unwrapPrivate(byte[] wrapped, PrivateKey.Type type, PublicKey publicKey)	Unwraps a private key, creating a permanent private key object.
SymmetricKey	unwrapSymmetric(byte[] wrapped, SymmetricKey.Type type, int keyLen)	Unwraps a key and allows it to be used for all operations.
SymmetricKey	unwrapSymmetric(byte[] wrapped, SymmetricKey.Type type, SymmetricKey.Usage usage, int keyLen)
SymmetricKey	unwrapSymmetricPerm(byte[] wrapped, SymmetricKey.Type type, int keyLen)	Unwraps a key and allows it to be used for all operations.
SymmetricKey	unwrapSymmetricPerm(byte[] wrapped, SymmetricKey.Type type, SymmetricKey.Usage usage, int keyLen)
PrivateKey	unwrapTemporaryPrivate(byte[] wrapped, PrivateKey.Type type, PublicKey publicKey)	Unwraps a private key, creating a temporary private key object.
byte[]	wrap(PrivateKey toBeWrapped)
byte[]	wrap(SymmetricKey toBeWrapped)

Methods inherited from class java.lang.Object

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

Field Details

logger

public static final org.slf4j.Logger logger

Method Details

initWrap

public void initWrap(SymmetricKey wrappingKey,
 AlgorithmParameterSpec parameters)
              throws InvalidKeyException,
InvalidAlgorithmParameterException

Specified by:

initWrap in interface KeyWrapper

Throws:

InvalidKeyException

InvalidAlgorithmParameterException

initWrap

public void initWrap(PublicKey wrappingKey,
 AlgorithmParameterSpec parameters)
              throws InvalidKeyException,
InvalidAlgorithmParameterException

Specified by:

initWrap in interface KeyWrapper

Throws:

InvalidKeyException

InvalidAlgorithmParameterException

initWrap

public void initWrap()
              throws InvalidKeyException,
InvalidAlgorithmParameterException

Description copied from interface: KeyWrapper

For wrapping keys in plaintext.

Specified by:

initWrap in interface KeyWrapper

Throws:

InvalidKeyException

InvalidAlgorithmParameterException

initUnwrap

public void initUnwrap(PrivateKey unwrappingKey,
 AlgorithmParameterSpec parameters)
                throws InvalidKeyException,
InvalidAlgorithmParameterException

Specified by:

initUnwrap in interface KeyWrapper

Throws:

InvalidKeyException

InvalidAlgorithmParameterException

initUnwrap

public void initUnwrap(SymmetricKey unwrappingKey,
 AlgorithmParameterSpec parameters)
                throws InvalidKeyException,
InvalidAlgorithmParameterException

Specified by:

initUnwrap in interface KeyWrapper

Throws:

InvalidKeyException

InvalidAlgorithmParameterException

initUnwrap

public void initUnwrap()
                throws InvalidKeyException,
InvalidAlgorithmParameterException

Description copied from interface: KeyWrapper

For plaintext-wrapped keys.

Specified by:

initUnwrap in interface KeyWrapper

Throws:

InvalidKeyException

InvalidAlgorithmParameterException

wrap

public byte[] wrap(PrivateKey toBeWrapped)
            throws InvalidKeyException,
IllegalStateException,
TokenException

Specified by:

wrap in interface KeyWrapper

Throws:

InvalidKeyException

IllegalStateException

TokenException

wrap

public byte[] wrap(SymmetricKey toBeWrapped)
            throws InvalidKeyException,
IllegalStateException,
TokenException

Specified by:

wrap in interface KeyWrapper

Throws:

InvalidKeyException

IllegalStateException

TokenException

unwrapPrivate

public PrivateKey unwrapPrivate(byte[] wrapped,
 PrivateKey.Type type,
 PublicKey publicKey)
                         throws TokenException,
InvalidKeyException,
IllegalStateException

Unwraps a private key, creating a permanent private key object. A permanent private key object resides on a token until it is explicitly deleted from the token.

Specified by:

unwrapPrivate in interface KeyWrapper

publicKey - Used to calculate the key identifier that must be stored with the private key. Must be a RSAPublicKey or a DSAPublicKey.

Throws:

InvalidKeyException - If the type of the public key does not match the type of the private key to be unwrapped.

TokenException

IllegalStateException

unwrapTemporaryPrivate

public PrivateKey unwrapTemporaryPrivate(byte[] wrapped,
 PrivateKey.Type type,
 PublicKey publicKey)
                                  throws TokenException,
InvalidKeyException,
IllegalStateException

Unwraps a private key, creating a temporary private key object. A temporary private key is one that does not permanently reside on a token. As soon as it is garbage-collected, it is gone forever.

Specified by:

unwrapTemporaryPrivate in interface KeyWrapper

publicKey - Used to calculate the key identifier that must be stored with the private key. Must be a RSAPublicKey or a DSAPublicKey.

Throws:

InvalidKeyException - If the type of the public key does not match the type of the private key to be unwrapped.

TokenException

IllegalStateException

unwrapSymmetric

public SymmetricKey unwrapSymmetric(byte[] wrapped,
 SymmetricKey.Type type,
 SymmetricKey.Usage usage,
 int keyLen)
                             throws TokenException,
IllegalStateException,
InvalidAlgorithmParameterException

Specified by:

unwrapSymmetric in interface KeyWrapper

usage - The operation the key will be used for after it is unwrapped. You have to specify this so that the key can be properly marked with the operation it supports. Some PKCS #11 tokens require that a key be marked for an operation before it can perform that operation.

keyLen - The expected length of the key in bytes. This is only used for variable-length keys (RC4) and non-padding algorithms. Otherwise, it can be set to anything(like 0).

Throws:

TokenException

IllegalStateException

InvalidAlgorithmParameterException

unwrapSymmetric

public SymmetricKey unwrapSymmetric(byte[] wrapped,
 SymmetricKey.Type type,
 int keyLen)
                             throws TokenException,
IllegalStateException,
InvalidAlgorithmParameterException

Description copied from interface: KeyWrapper

Unwraps a key and allows it to be used for all operations.

Specified by:

unwrapSymmetric in interface KeyWrapper

keyLen - The expected length of the key in bytes. This is only used for variable-length keys (RC4) and non-padding algorithms. Otherwise, it can be set to anything(like 0).

Throws:

TokenException

IllegalStateException

InvalidAlgorithmParameterException

unwrapSymmetricPerm

public SymmetricKey unwrapSymmetricPerm(byte[] wrapped,
 SymmetricKey.Type type,
 SymmetricKey.Usage usage,
 int keyLen)
                                 throws TokenException,
IllegalStateException,
InvalidAlgorithmParameterException

Specified by:

unwrapSymmetricPerm in interface KeyWrapper

Throws:

TokenException

IllegalStateException

InvalidAlgorithmParameterException

unwrapSymmetricPerm

public SymmetricKey unwrapSymmetricPerm(byte[] wrapped,
 SymmetricKey.Type type,
 int keyLen)
                                 throws TokenException,
IllegalStateException,
InvalidAlgorithmParameterException

Description copied from interface: KeyWrapper

Unwraps a key and allows it to be used for all operations.

Specified by:

unwrapSymmetricPerm in interface KeyWrapper

keyLen - The expected length of the key in bytes. This is only used for variable-length keys (RC4) and non-padding algorithms. Otherwise, it can be set to anything(like 0).

Throws:

TokenException

IllegalStateException

InvalidAlgorithmParameterException