Package org.bouncycastle.crypto.signers

Class ISO9796d2PSSSigner

  • All Implemented Interfaces:
    Signer, SignerWithRecovery
    public class ISO9796d2PSSSigner
extends java.lang.Object
implements SignerWithRecovery
    ISO9796-2 - mechanism using a hash function with recovery (scheme 2 and 3).

    Note: the usual length for the salt is the length of the hash function used in bytes.

    • Method Summary

      All Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      byte[] generateSignature()
      generate a signature for the loaded message using the key we were initialised with.
      byte[] getRecoveredMessage()
      Return a reference to the recoveredMessage message, either as it was added to a just generated signature, or extracted from a verified one.
      boolean hasFullMessage()
      Return true if the full message was recoveredMessage.
      void init​(boolean forSigning, CipherParameters param)
      Initialise the signer.
      void reset()
      reset the internal state
      void update​(byte b)
      update the internal digest with the byte b
      void update​(byte[] in, int off, int len)
      update the internal digest with the byte array in
      void updateWithRecoveredMessage​(byte[] signature)
      Perform an update with the recovered message before adding any other data.
      boolean verifySignature​(byte[] signature)
      return true if the signature represents a ISO9796-2 signature for the passed in message.

      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

    • Constructor Detail

      • ISO9796d2PSSSigner

        public ISO9796d2PSSSigner​(AsymmetricBlockCipher cipher,
                          Digest digest,
                          int saltLength,
                          boolean implicit)
        Generate a signer with either implicit or explicit trailers for ISO9796-2, scheme 2 or 3.
        Parameters:
        cipher - base cipher to use for signature creation/verification
        digest - digest to use.
        saltLength - length of salt in bytes.
        implicit - whether or not the trailer is implicit or gives the hash.

      • ISO9796d2PSSSigner

        public ISO9796d2PSSSigner​(AsymmetricBlockCipher cipher,
                          Digest digest,
                          int saltLength)
        Constructor for a signer with an explicit digest trailer.
        Parameters:
        cipher - cipher to use.
        digest - digest to sign with.
        saltLength - length of salt in bytes.

    • Method Detail

      • init

        public void init​(boolean forSigning,
                 CipherParameters param)
        Initialise the signer.
        Specified by:
        init in interface Signer
        Parameters:
        forSigning - true if for signing, false if for verification.
        param - parameters for signature generation/verification. If the parameters are for generation they should be a ParametersWithRandom, a ParametersWithSalt, or just an RSAKeyParameters object. If RSAKeyParameters are passed in a SecureRandom will be created.
        Throws:
        java.lang.IllegalArgumentException - if wrong parameter type or a fixed salt is passed in which is the wrong length.

      • updateWithRecoveredMessage

        public void updateWithRecoveredMessage​(byte[] signature)
                                throws InvalidCipherTextException
        Description copied from interface: SignerWithRecovery
        Perform an update with the recovered message before adding any other data. This must be the first update method called, and calling it will result in the signer assuming that further calls to update will include message content past what is recoverable.
        Specified by:
        updateWithRecoveredMessage in interface SignerWithRecovery
        Parameters:
        signature - the signature that we are in the process of verifying.
        Throws:
        InvalidCipherTextException

      • update

        public void update​(byte b)
        update the internal digest with the byte b
        Specified by:
        update in interface Signer

      • update

        public void update​(byte[] in,
                   int off,
                   int len)
        update the internal digest with the byte array in
        Specified by:
        update in interface Signer

      • reset

        public void reset()
        reset the internal state
        Specified by:
        reset in interface Signer

      • verifySignature

        public boolean verifySignature​(byte[] signature)
        return true if the signature represents a ISO9796-2 signature for the passed in message.
        Specified by:
        verifySignature in interface Signer