Package org.mozilla.jss.crypto
Class Signature
java.lang.Object
org.mozilla.jss.crypto.Signature
A class for producing and verifying digital signatures.
Instances of this class can be obtain from
CryptoToken
s.- See Also:
-
Field Summary
Fields -
Constructor Summary
ConstructorsModifierConstructorDescriptionprotected
(package private)
Signature
(SignatureAlgorithm algorithm, SignatureSpi engine) -
Method Summary
Modifier and TypeMethodDescriptionprotected Object
clone()
Cloning is not supported yetReturns the name of the algorithm to be used for signing.Returns the algorithm to be used for signing.This is not supported yet.void
initSign
(PrivateKey privateKey) Initialize the signature context for signing.void
initVerify
(PublicKey publicKey) Initialize the signature context for verifying.void
setParameter
(AlgorithmParameterSpec params) Set parameters for the signing algorithm.byte[]
sign()
Finish a signing operation and return the signature.int
sign
(byte[] outbuf, int offset, int len) Finish a signing operation and store the signature in the provided buffer.void
update
(byte b) Provide more data for a signature or verification operation.void
update
(byte[] data) Provide more data for a signature or verification operation.void
update
(byte[] data, int off, int len) Provide more data for a signature or verification operation.boolean
verify
(byte[] signature) Finish a verification operation.
-
Field Details
-
algorithm
-
engine
-
-
Constructor Details
-
Signature
protected Signature() -
Signature
Signature(SignatureAlgorithm algorithm, SignatureSpi engine)
-
-
Method Details
-
getProvider
This is not supported yet. -
initSign
Initialize the signature context for signing.- Parameters:
privateKey
- The private key with which to sign.- Throws:
InvalidKeyException
- If the key is the wrong type for the algorithm or does not exist on the token of this signature context.TokenException
- If an error occurred on the token.
-
initVerify
Initialize the signature context for verifying.- Parameters:
publicKey
- The public key with which to verify the signature.- Throws:
InvalidKeyException
- If the key is the wrong type for the algorithm.TokenException
- If an error occurs on the token.
-
setParameter
public void setParameter(AlgorithmParameterSpec params) throws InvalidAlgorithmParameterException, TokenException Set parameters for the signing algorithm. This is currently not supported or needed.- Parameters:
params
- Parameters for the signing algorithm.- Throws:
InvalidAlgorithmParameterException
- If there is something wrong with the parameters.TokenException
- If an error occurs on the token.
-
sign
Finish a signing operation and return the signature.- Returns:
- The signature.
- Throws:
SignatureException
- If an error occurs with the signing operation.TokenException
- If an error occurs on the token.
-
sign
Finish a signing operation and store the signature in the provided buffer.- Parameters:
outbuf
- Buffer to hold the signatureoffset
- Offset in buffer at which to store signature.len
- Number of bytes of buffer available for signature.- Returns:
- int The number of bytes placed into outbuf.
- Throws:
SignatureException
- If an error occurred while signing, or len was insufficient to contain the signature.TokenException
- If an error occurred on the token.
-
verify
Finish a verification operation.- Parameters:
signature
- The signature to be verified.- Returns:
- true if the signature is valid, false if it is invalid.
- Throws:
SignatureException
- If an error occurred with the verification operationTokenException
- If an error occurred on the token.
-
update
Provide more data for a signature or verification operation.- Parameters:
b
- A byte to be signed or verified.- Throws:
SignatureException
- If an error occurs in the signature/verifcation.TokenException
- If an error occurs on the token.
-
update
Provide more data for a signature or verification operation.- Parameters:
data
- An array of bytes to be signed or verified.- Throws:
SignatureException
- If an error occurs in the signature/verifcation.TokenException
- If an error occurs on the token.
-
update
Provide more data for a signature or verification operation.- Parameters:
data
- An array of bytes, some of which will be signed or verified.off
- The beginning offset of the bytes to be signed/verified.len
- The number of bytes to be signed/verified.- Throws:
SignatureException
- If an error occurs in the signature/verification.TokenException
- If an error occurs on the token.
-
getAlgorithm
Returns the name of the algorithm to be used for signing. -
getAlgorithmID
Returns the algorithm to be used for signing. -
clone
Cloning is not supported yet- Overrides:
clone
in classObject
- Throws:
CloneNotSupportedException
-