SHOW Signed

net.rim.device.api.crypto
Class DSASignatureVerifier

java.lang.Object
  |
  +--net.rim.device.api.crypto.DSASignatureVerifier

All Implemented Interfaces:

SignatureVerifier

public final class DSASignatureVerifier

extends Object

implements SignatureVerifier

Verifies a DSA signature on a message.

The Digital Signature Algorithm ( DSA ) is defined in FIPS 186.

Category:

Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.

Since:

JDE 3.6.0

See Also:

DSASignatureSigner

Constructor Summary

	DSASignatureVerifier(DSAPublicKey key, byte[] r, int rOffset, byte[] s, int sOffset) Construct a DSASignatureVerifier object using SHA-1 for the digest.
	DSASignatureVerifier(DSAPublicKey key, Digest digest, byte[] r, int rOffset, byte[] s, int sOffset) Constructs a DSASignatureVerifier object specifying the digest to use.

Method Summary

	String	getAlgorithm() Returns the name of the signing algorithm used, ie "DSA/" + Digest.getAlgorithm().
	void	update(byte[] data) Adds additional message data to the signature.
	void	update(byte[] data, int offset, int length) Adds additional message data to the signature.
	void	update(int data) Adds additional message data to the signature.
	boolean	verify() Returns true if the signature is valid, false otherwise.

Methods inherited from class java.lang.Object

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

Constructor Detail

DSASignatureVerifier

public DSASignatureVerifier(DSAPublicKey key,
                            byte[] r,
                            int rOffset,
                            byte[] s,
                            int sOffset)
                     throws CryptoTokenException,
                            CryptoUnsupportedOperationException,
                            InvalidSignatureEncodingException

Construct a DSASignatureVerifier object using SHA-1 for the digest.

NOTE: Also, if r and s point to the same buffer, then it is assumed that the length of r and the length of s are both exactly the length of the private key.

Parameters:

key - The DSA public key to use.

r - The array containing the r parameter to use.

rOffset - The starting offset within the array for r.

s - The array containing the s parameter to use.

sOffset - The starting offset within the array for s.

Throws:

CryptoTokenException - Thrown if an error occurs with the crypto token or the crypto token is invalid.

CryptoUnsupportedOperationException - Thrown if a call is made to an unsupported operation.

Since:

JDE 3.6.0

Category:

Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.

DSASignatureVerifier

public DSASignatureVerifier(DSAPublicKey key,
                            Digest digest,
                            byte[] r,
                            int rOffset,
                            byte[] s,
                            int sOffset)
                     throws CryptoTokenException,
                            CryptoUnsupportedOperationException,
                            InvalidSignatureEncodingException

Constructs a DSASignatureVerifier object specifying the digest to use. Although DSA specifies the use of SHA1, we are allowing the use of other digests than SHA1. This could cause some unstable uses though, so be wary of this.

NOTE: If the digest has any state information in it when it is given to the signature verifier, this information will be incorparated into the signature.

NOTE: Also, if r and s point to the same buffer, then it is assumed that the length of r and the length of s are both exactly the length of the private key.

Parameters:

key - The DSA public key to use.

digest - An instance of the digest algorithm to use.

r - The array containing the r parameter to use.

rOffset - The starting offset within the array for r.

s - The array containing the s parameter to use.

sOffset - The starting offset within the array for s.

Throws:

CryptoTokenException - Thrown if an error occurs with the crypto token or the crypto token is invalid.

CryptoUnsupportedOperationException - Thrown if a call is made to an unsupported operation.

Since:

JDE 3.6.0

Category:

Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.

Method Detail

getAlgorithm

public String getAlgorithm()

Returns the name of the signing algorithm used, ie "DSA/" + Digest.getAlgorithm().

Specified by:

getAlgorithm in interface SignatureVerifier

Since:

JDE 3.6.0

Category:

Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.

update

public void update(int data)

Description copied from interface: SignatureVerifier

Adds additional message data to the signature.

Specified by:

update in interface SignatureVerifier

Since:

JDE 3.7.0

Category:

Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.

update

public void update(byte[] data)

Description copied from interface: SignatureVerifier

Adds additional message data to the signature.

Specified by:

update in interface SignatureVerifier

Since:

JDE 3.7.0

Category:

Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.

update

public void update(byte[] data,
                   int offset,
                   int length)

Description copied from interface: SignatureVerifier

Adds additional message data to the signature.

Specified by:

update in interface SignatureVerifier

Since:

JDE 3.7.0

Category:

Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.

verify

public boolean verify()
               throws CryptoTokenException,
                      CryptoUnsupportedOperationException

Description copied from interface: SignatureVerifier

Returns true if the signature is valid, false otherwise.

Specified by:

verify in interface SignatureVerifier

Since:

JDE 3.6.0

Category:

Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.