net.rim.device.api.crypto.DSASignatureVerifier
|
|||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||
java.lang.Object
public final class DSASignatureVerifier
Verifies a DSA signature on a message.
The Digital Signature Algorithm ( DSA ) is defined in FIPS 186.
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 |
|---|
public DSASignatureVerifier(DSAPublicKey key,
byte[] r,
int rOffset,
byte[] s,
int sOffset)
throws CryptoTokenException,
CryptoUnsupportedOperationException,
InvalidSignatureEncodingException
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.
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.
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.
InvalidSignatureEncodingException
public DSASignatureVerifier(DSAPublicKey key,
Digest digest,
byte[] r,
int rOffset,
byte[] s,
int sOffset)
throws CryptoTokenException,
CryptoUnsupportedOperationException,
InvalidSignatureEncodingException
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.
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.
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.
InvalidSignatureEncodingException| Method Detail |
|---|
public String getAlgorithm()
"DSA/" + Digest.getAlgorithm().
getAlgorithm in interface SignatureVerifierpublic void update(int data)
SignatureVerifier
update in interface SignatureVerifierdata - The byte to be hashed.public void update(byte[] data)
SignatureVerifier
update in interface SignatureVerifierdata - A byte array containing the message data to hash.
public void update(byte[] data,
int offset,
int length)
SignatureVerifier
update in interface SignatureVerifierdata - The message data to hash.offset - The offset, or initial position to start reading in the data.length - The amount of data to read.
public boolean verify()
throws CryptoTokenException,
CryptoUnsupportedOperationException
SignatureVerifier
verify in interface SignatureVerifierCryptoTokenException - Thrown when a problem occurs with a crypto
token or the crypto token is invalid.
CryptoUnsupportedOperationException - Thrown when a call is made to
an unsupported operation.
|
|||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||
Copyright 1999-2011 Research In Motion Limited. 295 Phillip Street, Waterloo, Ontario, Canada, N2L 3W8. All Rights Reserved.
Java is a trademark of Oracle America Inc. in the US and other countries.
Legal