com.entrust.toolkit.security.crypto.signature

Class DsaCapi

java.lang.Object

java.security.SignatureSpi

java.security.Signature

com.entrust.toolkit.security.provider.EntrustDSA

com.entrust.toolkit.security.crypto.signature.DsaCapi

All Implemented Interfaces:

ExtendedSignature

Direct Known Subclasses:

RawDsaCapi

Deprecated.

since 8.0; use DsaWithSha1Signature instead

public class DsaCapi
extends EntrustDSA

An implementation of the DSS (DSA with SHA-1) signature algorithm for use with DSA keys that reside in CAPI.

Applications should not instantiate this class directly. They should use Signature.getInstance("DSA", "Entrust") to create a DSA Signature object, then use Signature.initSign(capiPrivateKey) to initialize that Signature object with a CapiDsaPrivateKey.

Since:

7.0

See Also:

EntrustDSA

Nested Class Summary

Nested classes/interfaces inherited from class com.entrust.toolkit.security.provider.EntrustDSA

EntrustDSA.Raw

Field Summary

Fields inherited from class java.security.Signature

SIGN, state, UNINITIALIZED, VERIFY

Fields inherited from class java.security.SignatureSpi

appRandom

Constructor Summary

Constructors

Constructor and Description
DsaCapi() Deprecated. Create an instance of this class.

Method Summary

Modifier and Type	Method and Description
protected void	engineInitSign(java.security.PrivateKey privateKey) Deprecated. Initializes this signature object with the specified private key for signing operations.
protected void	engineInitVerify(java.security.PublicKey publicKey) Deprecated. Signature verification through CAPI is not supported in this implementation, if this method is called it means there was an error in the toolkit.
protected byte[]	engineSign() Deprecated. Returns the signature bytes of all the data updated so far.
protected void	engineUpdate(byte b) Deprecated. Updates the data to be signed or verified using the specified byte.
protected void	engineUpdate(byte[] b, int offset, int length) Deprecated. Updates the data to be signed or verified, using the specified array of bytes, starting at the specified offset.
protected boolean	engineVerify(byte[] sigBytes) Deprecated. Signature verification through CAPI is not supported in this implementation, if this method is called it means there was an error in the toolkit.
byte[]	getDigest() Deprecated. This method returns the bytes that were actually signed.

Methods inherited from class com.entrust.toolkit.security.provider.EntrustDSA

engineGetParameter, engineSetParameter, engineSetParameter, RStoASN1, RStoASN1

Methods inherited from class java.security.Signature

clone, getAlgorithm, getInstance, getInstance, getInstance, getParameter, getParameters, getProvider, initSign, initSign, initVerify, initVerify, setParameter, setParameter, sign, sign, toString, update, update, update, update, verify, verify

Methods inherited from class java.security.SignatureSpi

engineGetParameters, engineInitSign, engineSign, engineUpdate, engineVerify

Methods inherited from class java.lang.Object

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

Constructor Detail

DsaCapi

public DsaCapi()

Deprecated.

Create an instance of this class. Should not be called explicitly.

Method Detail

engineInitSign

protected void engineInitSign(java.security.PrivateKey privateKey)
                       throws java.security.InvalidKeyException

Deprecated.

Initializes this signature object with the specified private key for signing operations. This method must be called before any of the other engine methods, or a NullPointerException will be thrown.

Overrides:

engineInitSign in class EntrustDSA

Parameters:

privateKey - the CapiDsaPrivateKey to be used to generate the signature.

Throws:

java.security.InvalidKeyException - if the given key does not reside in CAPI, or if no MessageDigest instance can be obtained for the key.

engineSign

protected byte[] engineSign()
                     throws java.security.SignatureException

Deprecated.

Returns the signature bytes of all the data updated so far.

Overrides:

engineSign in class EntrustDSA

Returns:

the signature bytes

Throws:

java.security.SignatureException - if any error occurs creating the signature

engineInitVerify

protected final void engineInitVerify(java.security.PublicKey publicKey)
                               throws java.security.InvalidKeyException

Deprecated.

Signature verification through CAPI is not supported in this implementation, if this method is called it means there was an error in the toolkit.

Overrides:

engineInitVerify in class EntrustDSA

Parameters:

publicKey - the DSA public key belonging to the DSA private key used for signing

Throws:

java.security.InvalidKeyException - always

engineUpdate

protected void engineUpdate(byte b)
                     throws java.security.SignatureException

Deprecated.

Updates the data to be signed or verified using the specified byte.

Overrides:

engineUpdate in class EntrustDSA

Parameters:

b - The byte to use for the update

Throws:

java.security.SignatureException - if there is a problem updating the message digest.

engineUpdate

protected void engineUpdate(byte[] b,
                            int offset,
                            int length)
                     throws java.security.SignatureException

Deprecated.

Updates the data to be signed or verified, using the specified array of bytes, starting at the specified offset.

Overrides:

engineUpdate in class EntrustDSA

Parameters:

b - the array of bytes

offset - the offset to start from in the array of bytes

length - the number of bytes to use, starting at offset

Throws:

java.security.SignatureException - if there is a problem updating the message digest.

engineVerify

protected final boolean engineVerify(byte[] sigBytes)
                              throws java.security.SignatureException

Deprecated.

Signature verification through CAPI is not supported in this implementation, if this method is called it means there was an error in the toolkit.

Overrides:

engineVerify in class EntrustDSA

Parameters:

sigBytes - the signature bytes to be verified

Returns:

true if signature is OK, false otherwise

Throws:

java.security.SignatureException - always

See Also:

EntrustDSA.engineVerify(byte[])

getDigest

public final byte[] getDigest()

Deprecated.

This method returns the bytes that were actually signed. This method should only be called after Signature.sign() or Signature.verify() is called.

Specified by:

getDigest in interface ExtendedSignature

Overrides:

getDigest in class EntrustDSA

Returns:

the bytes of the message digest that were signed