public class AsconParameters extends AlgorithmParametersSpi
ASN.1 definitition:
AsconParameters ::= SEQUENCE { nonce OCTET STRING, -- recommended size is 16 octets tLen INTEGER DEFAULT 16 }
AsconParameters can be generated by calling one of the AlgorithmParameters.getInstance
methods. Subsequently, the new AlgorithmParameters object must be initialized with
a proper parameter specification (AsconParameterSpec) or a DER encoded byte array, e.g.
AsconParameterSpec asconParamSpec = ...; AlgorithmParameters params = AlgorithmParameters.getInstance("Ascon", "IAIK-LW"); params.init(asconParamSpec);The AsconParameters can also be initialized with an IvParameterSpec object. In this case, the specified iv will be used as nonce, and 16 will be used as tag len value.
AsconParameterSpec
,
AlgorithmParametersSpi
Constructor and Description |
---|
AsconParameters()
The default constructor.
|
Modifier and Type | Method and Description |
---|---|
protected byte[] |
engineGetEncoded()
Returns the parameters as DER byte array.
|
protected byte[] |
engineGetEncoded(String format)
Returns the parameters as a DER byte array.
|
protected <T extends AlgorithmParameterSpec> |
engineGetParameterSpec(Class<T> paramSpec)
Returns an Ascon Parameter Specification of this Ascon Parameters object.
|
protected void |
engineInit(AlgorithmParameterSpec paramSpec)
Initializes the parameters with the given parameter specification.
|
protected void |
engineInit(byte[] params)
Initializes this AsconParameters object from the given DER encoded byte array.
|
protected void |
engineInit(byte[] params,
String format)
Inits the parameters from an DER encoded byte array.
|
protected String |
engineToString()
Returns a formatted string describing the Ascon Parameters.
|
public AsconParameters()
AlgorithmParameters.getInstance
for obtaining a AsconParameters object.protected void engineInit(AlgorithmParameterSpec paramSpec) throws InvalidParameterSpecException
AsconParameterSpec
or a javax.crypto.spec.IvParameterSpec. If the parameters are given
as IvParameterSpec, a default tag length of 16 is used.engineInit
in class AlgorithmParametersSpi
paramSpec
- the parameter specification - must be an AsconParameterSpec
or a javax.crypto.specIvParameterSpecInvalidParameterSpecException
- if the given parameter specification is
inappropriate for the initialization of this parameter object.protected void engineInit(byte[] params) throws IOException
engineInit
in class AlgorithmParametersSpi
params
- the DER encoded byte arrayIOException
- if an error occurs when decoding the given byte array or
the derived parameter values are invalidprotected void engineInit(byte[] params, String format) throws IOException
Inits the parameters from an DER encoded byte array. Format is ignored.
Only calls {engineInit(params)
for initializing this AsconParameters
object from the given DER encoded byte array, regardless of what is specified
in the format
string.
engineInit
in class AlgorithmParametersSpi
params
- the DER encoded byte arrayformat
- the encoding format; ignoredIOException
- if an error occurs when decoding the given byte arrayprotected <T extends AlgorithmParameterSpec> T engineGetParameterSpec(Class<T> paramSpec) throws InvalidParameterSpecException
paramSpec
identifies the specification class the parameters shall represent, which must be
an AsconParameterSpec
.engineGetParameterSpec
in class AlgorithmParametersSpi
paramSpec
- the specification class the parameters shall represent;
has to be an AsconParameterSpec
InvalidParameterSpecException
- if the requested parameter specification is inappropriate
for this parameter object.protected byte[] engineGetEncoded() throws IOException
engineGetEncoded
in class AlgorithmParametersSpi
IOException
- if an encoding error occursprotected byte[] engineGetEncoded(String format) throws IOException
Format is ignored. Only DER encoding is supported at this time. This method
only calls engineGetEncoded()
, regardless of what
is specified in the format
string.
engineGetEncoded
in class AlgorithmParametersSpi
format
- the encoding format; ignoredIOException
- if an encoding error occursprotected String engineToString()
engineToString
in class AlgorithmParametersSpi
Copyright © 2022–2023 Stiftung SIC. All rights reserved.