| java.lang.Object
 com.sun.portal.kssl.Signature
All known Subclasses: com.sun.portal.kssl.RSASig,
| Signature | | abstract public class Signature (Code) | | Implements an abstract class that generalizes all signature algorithms.
This version of the implementation only supports ALG_RSA_MD5_PKCS1 and
ALG_RSA_SHA_PKCS1.
|
| Field Summary | |
| final public static byte | ALG_RSA_MD5_PKCS1
Signature algorithm ALG_RSA_MD5_PKCS1 encrypts the 16-byte
MD5 digest using RSA. | | final public static byte | ALG_RSA_SHA_PKCS1
Signature algorithm ALG_RSA_SHA_PKCS1 encrypts the 20-byte
SHA digest using RSA. | | final public static byte | MODE_SIGN
Used in init() methods to indicate signature sign mode. | | final protected static byte | MODE_UNKNOWN
Unknown mode place holder. | | final public static byte | MODE_VERIFY
Used in init() methods to indicate signature verify mode. |
| Constructor Summary | |
| protected | Signature()
Protected constructor. |
| Method Summary | |
| abstract public byte | getAlgorithm()
Gets the signature algorithm. | | public static Signature | getInstance(byte alg, boolean ext)
Creates a Signature object instance of the selected
algorithm. | | abstract public short | getLength()
Gets the byte length of the signature data. | | abstract public void | init(Key theKey, byte theMode)
Initializes the Signature object with the appropriate
Key for signature creation or verification. | | abstract public void | init(Key theKey, byte theMode, byte[] b, int off, int len)
Initializes the Signature object with the appropriate
Key and algorithm specific parameters for signature
creation or verification. | | abstract public short | sign(byte[] inBuf, int inOff, int inLen, byte[] sigBuf, int sigOff)
Generates the signature of all/last input data. | | abstract public void | update(byte[] inBuf, int inOff, int inLen)
Accumulates a signature of the input data. | | abstract public boolean | verify(byte[] inBuf, int inOff, int inLen, byte[] sigBuf, int sigOff, short sigLen)
Verifies the signature of all/last input data against the passed
in signature. |
| ALG_RSA_MD5_PKCS1 | | final public static byte ALG_RSA_MD5_PKCS1(Code) | | Signature algorithm ALG_RSA_MD5_PKCS1 encrypts the 16-byte
MD5 digest using RSA. The digest is padded according to the
PKCS#1 (v1.5) scheme.
|
| ALG_RSA_SHA_PKCS1 | | final public static byte ALG_RSA_SHA_PKCS1(Code) | | Signature algorithm ALG_RSA_SHA_PKCS1 encrypts the 20-byte
SHA digest using RSA. The digest is padded according to the
PKCS#1 (v1.5) scheme.
|
| MODE_SIGN | | final public static byte MODE_SIGN(Code) | | Used in init() methods to indicate signature sign mode.
|
| MODE_UNKNOWN | | final protected static byte MODE_UNKNOWN(Code) | | Unknown mode place holder.
|
| MODE_VERIFY | | final public static byte MODE_VERIFY(Code) | | Used in init() methods to indicate signature verify mode.
|
| Signature | | protected Signature()(Code) | | Protected constructor.
|
| getAlgorithm | | abstract public byte getAlgorithm()(Code) | | Gets the signature algorithm.
the algorithm code defined above |
| getInstance | | public static Signature getInstance(byte alg, boolean ext) throws CryptoException(Code) | | Creates a Signature object instance of the selected
algorithm.
Parameters:
alg - desired signature algorithm
Parameters:
ext - this parameter is here only for compatibility withjavacard.security.Signature, it is ignored a Signature object instance of the requestedalgorithm
exception:
CryptoException - with reason code NO_SUCH_ALGORITHM if the requested algorithm is notsupported |
| getLength | | abstract public short getLength()(Code) | | Gets the byte length of the signature data.
the byte length of signature data |
| init | | abstract public void init(Key theKey, byte theMode) throws CryptoException(Code) | | Initializes the Signature object with the appropriate
Key for signature creation or verification.
Parameters:
theKey - the key object to use for signing or verification
Parameters:
theMode - one of MODE_SIGN or MODE_VERIFY
exception:
CryptoException - with reason code ILLEGAL_VALUEif an invalid mode is specified or if the key type is inconsistent with the mode or signature implementation. |
| init | | abstract public void init(Key theKey, byte theMode, byte[] b, int off, int len) throws CryptoException(Code) | | Initializes the Signature object with the appropriate
Key and algorithm specific parameters for signature
creation or verification.
Parameters:
theKey - the key object to use for signing or verification
Parameters:
theMode - one of MODE_SIGN or MODE_VERIFY
Parameters:
b - byte array containing algorithm specific parameters
Parameters:
off - starting offset of parameter data within the byte array
Parameters:
len - byte length of parameter data
exception:
CryptoException - with reason code ILLEGAL_VALUEif an invalid mode is specified or if the key type is inconsistent with the mode or signature implementation or if this initialization modeis not supported by the signature algorithm |
| sign | | abstract public short sign(byte[] inBuf, int inOff, int inLen, byte[] sigBuf, int sigOff) throws CryptoException(Code) | | Generates the signature of all/last input data. A call to this
method also resets this signature object to the state it was in
when previously initialized via a call to init(). That is, the
object is reset and available to sign another message.
Parameters:
inBuf - the input buffer of data to be signed
Parameters:
inOff - starting offset within the input buffer for data tobe signed
Parameters:
inLen - the byte length of data to be signed
Parameters:
sigBuf - the output buffer to store signature data
Parameters:
sigOff - starting offset within the output buffer at whichto begin signature data number of bytes of signature output in sigBuf
exception:
CryptoException - with the following reason codes: (i)UNINITIALIZED_KEY if key is not initialized, (ii)INVALID_INIT if signature object wasn notproperly initialized, for signing (iii) ILLEGAL_USE if the signature algorithm does not pad the message and themessage is not block aligned |
| update | | abstract public void update(byte[] inBuf, int inOff, int inLen) throws CryptoException(Code) | | Accumulates a signature of the input data. When this method is used,
temporary storage of intermediate results is required. This method
should only be used if all the input data required for the signature
is not available in one byte array. The sign() or verify() method is
recommended whenever possible.
Parameters:
inBuf - the input buffer of data to be signed
Parameters:
inOff - starting offset within the input buffer for data tobe signed
Parameters:
inLen - the byte length of data to be signed
exception:
CryptoException - with UNINITIALIZED_KEYor INVALID_INIT if the signature objectis not properly initialized
See Also: Signature.sign(byte[],int,int,byte[],int)
See Also: Signature.verify(byte[],int,int,byte[],int,short) |
| verify | | abstract public boolean verify(byte[] inBuf, int inOff, int inLen, byte[] sigBuf, int sigOff, short sigLen) throws CryptoException(Code) | | Verifies the signature of all/last input data against the passed
in signature. A call to this method also resets this signature
object to the state it was in when previously initialized via a
call to init(). That is, the object is reset and available to
verify another message.
Parameters:
inBuf - the input buffer of data to be verified
Parameters:
inOff - starting offset within the input buffer for data tobe verified
Parameters:
inLen - the byte length of data to be verified
Parameters:
sigBuf - the input buffer containing signature data
Parameters:
sigOff - starting offset within the sigBuf where signaturedata begins
Parameters:
sigLen - byte length of signature data true if signature verifies, false otherwise
exception:
CryptoException - with the following reason codes: (i)UNINITIALIZED_KEY if key is not initialized, (ii)INVALID_INIT if signature object wasn notproperly initialized, for verification (iii) ILLEGAL_USEif the signature algorithm does not pad the message and themessage is not block aligned |
|
|