|
|||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
| SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||
java.lang.Object | +--net.rim.device.api.crypto.PKCS1SignatureSigner
The PKCS1SignatureSigner object can sign messages using the RSA PKCS#1 signature scheme.
We implemented the PKCS1 signing as per the PKCS #1 version 2.1 document.
For a code sample using the PKCS1 signature signer, click here.
For information on cryptographic algorithms, see Crypto Algorithms.
Certicom Contact Information
Phone:613-254-9258
Email: sales@certicom.com
Website: http://www.certicom.com/rim
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.
PKCS1SignatureVerifier| Constructor Summary | ||
|
PKCS1SignatureSigner(RSAPrivateKey key)
Constructs an RSA PKCS1SignatureSigner (version 2.0) object which uses the SHA1 digest. |
|
|
PKCS1SignatureSigner(RSAPrivateKey key,
boolean useASN1)
Constructs an RSA PKCS1SignatureSigner object (version 2.0) signing object which uses the given digest. |
|
|
PKCS1SignatureSigner(RSAPrivateKey key,
Digest digest)
Constructs an RSA PKCS1SignatureSigner object (version 2.0) signing object which uses the given digest. |
|
|
PKCS1SignatureSigner(RSAPrivateKey key,
Digest digest,
boolean useASN1)
Constructs an RSA PKCS1SignatureSigner (version 1.5 or 2.0) object that uses the given digest. |
|
| Method Summary | ||
|
String |
getAlgorithm()
Returns a String containing the name of the algorithm (eg "RSA_PKCS1_V15/<DigestAlgorithm>" or "RSA_PKCS1_V20/<DigestAlgorithm>"). |
|
String |
getDigestAlgorithm()
Returns the name of the digest algorithm used, eg "SHA1", etc. |
|
int |
getLength()
Returns the length of the signature in bytes. |
|
static boolean |
isVersion20Supported()
Returns true if PKCS1 version 2.0 is supported. |
|
void |
reset()
Reinitializes the signer, preparing it to generate another signature. |
|
void |
sign(byte[] signature,
int signatureOffset)
Signs the formatted signature data that has been generated from the values passed through the update function. |
|
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. |
| Methods inherited from class java.lang.Object |
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
| Constructor Detail |
public PKCS1SignatureSigner(RSAPrivateKey key) throws CryptoUnsupportedOperationException
PKCS1SignatureSigner (version 2.0) object which uses the SHA1 digest.
key - The private key to use for signing.Certicom Contact Information
Phone:613-254-9258
Email: sales@certicom.com
Website: http://www.certicom.com/rim
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.
public PKCS1SignatureSigner(RSAPrivateKey key, boolean useASN1) throws CryptoUnsupportedOperationException
PKCS1SignatureSigner object (version 2.0) signing object which uses the given digest.
key - The private key to use for signing.useASN1 - A boolean that determines whether or not to ASN1-encode the digest before it is signed.
Set this to false for version 1.5 (which does not use ASN1) or true for version 2.0
(which does use ASN1).CryptoUnsupportedOperationException - Thrown if the OID for the given digest is unknown.Certicom Contact Information
Phone:613-254-9258
Email: sales@certicom.com
Website: http://www.certicom.com/rim
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.
public PKCS1SignatureSigner(RSAPrivateKey key, Digest digest) throws CryptoUnsupportedOperationException
PKCS1SignatureSigner object (version 2.0) signing object which uses the given digest.
key - The private key to use for signing.digest - The digest to use to process the message.CryptoUnsupportedOperationException - Thrown if the OID for the given digest is unknown.Certicom Contact Information
Phone:613-254-9258
Email: sales@certicom.com
Website: http://www.certicom.com/rim
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.
public PKCS1SignatureSigner(RSAPrivateKey key, Digest digest, boolean useASN1) throws CryptoUnsupportedOperationException
PKCS1SignatureSigner (version 1.5 or 2.0) object that uses the given digest.
key - The private key to use for signingdigest - The digest to use to process the message. If digest is null, then
if useASN1 is set to true then a SHA1Digest is created, else a MD5Digest is created.useASN1 - A boolean that determines whether or not to ASN1-encode the digest before it is signed.
Set this to false for version 1.5 (which does not use ASN1) or true for version 2.0
(which does use ASN1).CryptoUnsupportedOperationException - Thrown if the OID for the given digest is unknown.Certicom Contact Information
Phone:613-254-9258
Email: sales@certicom.com
Website: http://www.certicom.com/rim
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 |
public String getAlgorithm()
Certicom Contact Information
Phone:613-254-9258
Email: sales@certicom.com
Website: http://www.certicom.com/rim
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.
public String getDigestAlgorithm()
Certicom Contact Information
Phone:613-254-9258
Email: sales@certicom.com
Website: http://www.certicom.com/rim
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.
public int getLength()
Certicom Contact Information
Phone:613-254-9258
Email: sales@certicom.com
Website: http://www.certicom.com/rim
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.
public static boolean isVersion20Supported()
Certicom Contact Information
Phone:613-254-9258
Email: sales@certicom.com
Website: http://www.certicom.com/rim
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.
public void reset()
SignatureSignerCerticom Contact Information
Phone:613-254-9258
Email: sales@certicom.com
Website: http://www.certicom.com/rim
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.
public void sign(byte[] signature,
int signatureOffset)
throws CryptoTokenException,
CryptoUnsupportedOperationException
signature - A byte array to contain the signature.signatureOffset - The offset, or starting position, of the signature
within the array.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.Certicom Contact Information
Phone:613-254-9258
Email: sales@certicom.com
Website: http://www.certicom.com/rim
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.
public void update(byte[] data)
SignatureSigner
SignatureSignerdata - The message data to hash.Certicom Contact Information
Phone:613-254-9258
Email: sales@certicom.com
Website: http://www.certicom.com/rim
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.
public void update(byte[] data,
int offset,
int length)
SignatureSigner
SignatureSignerdata - The message data to hash.offset - The offset, or the initial position to start reading in the data.length - How much data to read.Certicom Contact Information
Phone:613-254-9258
Email: sales@certicom.com
Website: http://www.certicom.com/rim
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.
public void update(int data)
SignatureSigner
SignatureSignerdata - The byte to be hashed.Certicom Contact Information
Phone:613-254-9258
Email: sales@certicom.com
Website: http://www.certicom.com/rim
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.
|
|||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
| SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||
Copyright 1999-2007 Research In Motion Limited. 295 Phillip Street, Waterloo, Ontario, Canada, N2L 3W8. All Rights Reserved.
Copyright 1993-2003 Sun Microsystems, Inc. 901 San Antonio Road, Palo Alto, California, 94303, U.S.A.
Copyright 2002-2003 Nokia Corporation All Rights Reserved.
Java is a trademark or registered trademark of Sun Microsystems, Inc. in the US and other countries.