Class Signature

java.lang.Object
org.mozilla.jss.crypto.Signature

public class Signature extends Object
A class for producing and verifying digital signatures. Instances of this class can be obtain from CryptoTokens.
See Also:
  • Field Details

  • Constructor Details

  • Method Details

    • getProvider

      public Provider getProvider()
      This is not supported yet.
    • initSign

      public void initSign(PrivateKey privateKey) throws InvalidKeyException, TokenException
      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

      public void initVerify(PublicKey publicKey) throws InvalidKeyException, TokenException
      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

      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

      public byte[] sign() throws SignatureException, TokenException
      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

      public int sign(byte[] outbuf, int offset, int len) throws SignatureException, TokenException
      Finish a signing operation and store the signature in the provided buffer.
      Parameters:
      outbuf - Buffer to hold the signature
      offset - 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

      public boolean verify(byte[] signature) throws SignatureException, TokenException
      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 operation
      TokenException - If an error occurred on the token.
    • update

      public void update(byte b) throws SignatureException, TokenException
      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

      public void update(byte[] data) throws SignatureException, TokenException
      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

      public void update(byte[] data, int off, int len) throws SignatureException, TokenException
      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

      public String getAlgorithm()
      Returns the name of the algorithm to be used for signing.
    • getAlgorithmID

      public SignatureAlgorithm getAlgorithmID()
      Returns the algorithm to be used for signing.
    • clone

      protected Object clone() throws CloneNotSupportedException
      Cloning is not supported yet
      Overrides:
      clone in class Object
      Throws:
      CloneNotSupportedException