iaik.security.pq.dilithium

Class Dilithium

java.lang.Object

java.security.SignatureSpi

iaik.security.pq.dilithium.Dilithium

public final class Dilithium
extends SignatureSpi

The base signature SPI class for the Dilithium [0] algorithm. It is responsible for signature creation and verification and contains the basic functionality to perform these operations.

References: [0] Bai, Ducas, Kiltz, Lepoint, Lyubashevsky, Schwabe, Seiler and Stehlé: "CRYSTALS-Dilithium" - 8 February, 2021

Field Summary

Fields inherited from class java.security.SignatureSpi

appRandom

Constructor Summary

Constructors

Constructor and Description
Dilithium()

Method Summary

Modifier and Type	Method and Description
protected Object	engineGetParameter(String s) Not Supported
protected AlgorithmParameters	engineGetParameters()
protected void	engineInitSign(PrivateKey privateKey)
protected void	engineInitSign(PrivateKey privateKey, SecureRandom random)
protected void	engineInitVerify(PublicKey publicKey)
protected void	engineSetParameter(AlgorithmParameterSpec parameterSpec) Call this to change if randomized Signing is used or not Otherwise the DilithiumAlgorithmParameterSpec has to have the same security level as the parameters in the private key
protected void	engineSetParameter(String param, Object o) Not Supported
protected byte[]	engineSign()
protected void	engineUpdate(byte b)
protected void	engineUpdate(byte[] bytes, int off, int len)
protected boolean	engineVerify(byte[] sigBytes)

Methods inherited from class java.security.SignatureSpi

clone, engineSign, engineUpdate, engineVerify

Methods inherited from class java.lang.Object

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

Constructor Detail

Dilithium

public Dilithium()

Method Detail

engineInitVerify

protected void engineInitVerify(PublicKey publicKey)
                         throws InvalidKeyException

Specified by:

engineInitVerify in class SignatureSpi

Throws:

InvalidKeyException

engineInitSign

protected void engineInitSign(PrivateKey privateKey,
                              SecureRandom random)
                       throws InvalidKeyException

Overrides:

engineInitSign in class SignatureSpi

Throws:

InvalidKeyException

engineInitSign

protected void engineInitSign(PrivateKey privateKey)
                       throws InvalidKeyException

Specified by:

engineInitSign in class SignatureSpi

Throws:

InvalidKeyException

engineUpdate

protected void engineUpdate(byte b)
                     throws SignatureException

Specified by:

engineUpdate in class SignatureSpi

Throws:

SignatureException

engineUpdate

protected void engineUpdate(byte[] bytes,
                            int off,
                            int len)
                     throws SignatureException

Specified by:

engineUpdate in class SignatureSpi

Throws:

SignatureException

engineSign

protected byte[] engineSign()
                     throws SignatureException

Specified by:

engineSign in class SignatureSpi

Throws:

SignatureException

engineVerify

protected boolean engineVerify(byte[] sigBytes)
                        throws SignatureException

Specified by:

engineVerify in class SignatureSpi

Throws:

SignatureException

engineSetParameter

protected void engineSetParameter(String param,
                                  Object o)
                           throws InvalidParameterException

Not Supported

Specified by:

engineSetParameter in class SignatureSpi

Throws:

InvalidParameterException

engineSetParameter

protected void engineSetParameter(AlgorithmParameterSpec parameterSpec)
                           throws InvalidAlgorithmParameterException

Call this to change if randomized Signing is used or not Otherwise the DilithiumAlgorithmParameterSpec has to have the same security level as the parameters in the private key

Overrides:

engineSetParameter in class SignatureSpi

Parameters:

parameterSpec - the parameters

Throws:

InvalidAlgorithmParameterException - when the AlgorithmParameterSpec is not an instance of DilithiumAlgorithmParameterSpec or the security levels do not match

engineGetParameter

protected Object engineGetParameter(String s)
                             throws InvalidParameterException

Not Supported

Specified by:

engineGetParameter in class SignatureSpi

Throws:

InvalidParameterException

engineGetParameters

protected AlgorithmParameters engineGetParameters()

Overrides:

engineGetParameters in class SignatureSpi

Returns:

the AlgorithmParameters for Dilithium