Package org.webpki.crypto

Class SignatureWrapper

java.lang.Object

org.webpki.crypto.SignatureWrapper

public class SignatureWrapper
extends Object

Wrapper over Signature.

Constructor Summary

Constructors

Constructor	Description
SignatureWrapper(AsymSignatureAlgorithms algorithm, PrivateKey privateKey)	Initiates a signer.
SignatureWrapper(AsymSignatureAlgorithms algorithm, PrivateKey privateKey, String provider)	Initites a signer.
SignatureWrapper(AsymSignatureAlgorithms algorithm, PublicKey publicKey)	Initiates a verifier.
SignatureWrapper(AsymSignatureAlgorithms algorithm, PublicKey publicKey, String provider)	Initiates a verifier.

Method Summary

Modifier and Type	Method	Description
SignatureWrapper	ecdsaAsn1SignatureEncoding(boolean flag)	Sets ASN.1 encoding mode for ECDSA.
Provider	getProvider()
byte[]	sign()	See Signature.
static byte[]	sign(PrivateKey privateKey, AsymSignatureAlgorithms algorithm, byte[] data, String provider)	Signature creation conveniance method.
SignatureWrapper	update(byte data)	See Signature.
SignatureWrapper	update(byte[] data)	See Signature.
static void	validate(PublicKey publicKey, AsymSignatureAlgorithms algorithm, byte[] data, byte[] signature, String provider)	Signature validation conveniance method.
boolean	verify(byte[] signature)	See Signature.

Methods inherited from class java.lang.Object

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

Constructor Details

SignatureWrapper

public SignatureWrapper(AsymSignatureAlgorithms algorithm,
 PublicKey publicKey,
 String provider)
                 throws GeneralSecurityException

Initiates a verifier.

Parameters:

algorithm -

publicKey -

provider -

Throws:

GeneralSecurityException

SignatureWrapper

public SignatureWrapper(AsymSignatureAlgorithms algorithm,
 PublicKey publicKey)
                 throws GeneralSecurityException

Initiates a verifier.

Parameters:

algorithm -

publicKey -

Throws:

GeneralSecurityException

SignatureWrapper

public SignatureWrapper(AsymSignatureAlgorithms algorithm,
 PrivateKey privateKey,
 String provider)
                 throws GeneralSecurityException

Initites a signer.

Parameters:

algorithm -

privateKey -

provider -

Throws:

GeneralSecurityException

SignatureWrapper

public SignatureWrapper(AsymSignatureAlgorithms algorithm,
 PrivateKey privateKey)
                 throws GeneralSecurityException

Initiates a signer.

Parameters:

algorithm -

privateKey -

Throws:

GeneralSecurityException

Method Details

ecdsaAsn1SignatureEncoding

public SignatureWrapper ecdsaAsn1SignatureEncoding(boolean flag)

Sets ASN.1 encoding mode for ECDSA.

Default is false.

Parameters:

flag -

Returns:

update

public SignatureWrapper update(byte[] data)
                        throws GeneralSecurityException

See Signature.

Parameters:

data -

Returns:

Throws:

GeneralSecurityException

update

public SignatureWrapper update(byte data)
                        throws GeneralSecurityException

See Signature.

Parameters:

data -

Returns:

Throws:

GeneralSecurityException

getProvider

public Provider getProvider()

verify

public boolean verify(byte[] signature)
               throws GeneralSecurityException

See Signature.

Parameters:

signature -

Returns:

Throws:

GeneralSecurityException

sign

public byte[] sign()
            throws GeneralSecurityException

See Signature.

Returns:

Throws:

GeneralSecurityException

sign

public static byte[] sign(PrivateKey privateKey,
 AsymSignatureAlgorithms algorithm,
 byte[] data,
 String provider)

Signature creation conveniance method.

This method generates JOSE/COSE compatible signatures.

For security related errors, CryptoException is thrown.

Parameters:

privateKey - Signature key

algorithm - Signature algorithm

data - Data to sign

provider - Optional provider or null

Returns:

Signature

validate

public static void validate(PublicKey publicKey,
 AsymSignatureAlgorithms algorithm,
 byte[] data,
 byte[] signature,
 String provider)

Signature validation conveniance method.

This method validates JOSE/COSE compatible signatures.

For security related errors including invalid signatures, CryptoException is thrown.

Parameters:

publicKey - Validtion key

algorithm - Signature algorithm

data - The data what was signed

signature - The signature to be validated

provider - Optional provider or null