RSA/DSA/ECDSA/EdDSA signature generation. More...

#include "core/crypto.h"
#include "pkix/x509_common.h"

Typedefs
typedef error_t(*	X509SignGenCallback) (const PrngAlgo prngAlgo, void prngContext, const X509OctetString tbsData, const X509SignAlgoId signAlgoId, const void privateKey, uint8_t output, size_t *written)
	Signature generation callback function. More...

Functions
error_t	x509RegisterSignGenCallback (X509SignGenCallback callback)
	Register signature generation callback function. More...

error_t	x509GenerateSignature (const PrngAlgo prngAlgo, void prngContext, const X509OctetString tbsData, const X509SignAlgoId signAlgoId, const void privateKey, uint8_t output, size_t *written)
	Signature generation. More...

error_t	x509GenerateRsaSignature (const X509OctetString tbsData, const HashAlgo hashAlgo, const RsaPrivateKey privateKey, uint8_t output, size_t *written)
	RSA signature generation. More...

error_t	x509GenerateRsaPssSignature (const PrngAlgo prngAlgo, void prngContext, const X509OctetString tbsData, const HashAlgo hashAlgo, const HashAlgo mgfHashAlgo, size_t saltLen, const RsaPrivateKey privateKey, uint8_t output, size_t written)
	RSA-PSS signature generation. More...

error_t	x509GenerateDsaSignature (const PrngAlgo prngAlgo, void prngContext, const X509OctetString tbsData, const HashAlgo hashAlgo, const DsaPrivateKey privateKey, uint8_t output, size_t *written)
	DSA signature generation. More...

error_t	x509GenerateEcdsaSignature (const PrngAlgo prngAlgo, void prngContext, const X509OctetString tbsData, const HashAlgo hashAlgo, const EcPrivateKey privateKey, uint8_t output, size_t *written)
	ECDSA signature generation. More...

error_t	x509GenerateSm2Signature (const PrngAlgo prngAlgo, void prngContext, const X509OctetString tbsData, const HashAlgo hashAlgo, const EcPrivateKey privateKey, uint8_t output, size_t *written)
	SM2 signature generation. More...

error_t	x509GenerateEd25519Signature (const X509OctetString tbsData, const EddsaPrivateKey privateKey, uint8_t output, size_t written)
	Ed25519 signature generation. More...

error_t	x509GenerateEd448Signature (const X509OctetString tbsData, const EddsaPrivateKey privateKey, uint8_t output, size_t written)
	Ed448 signature generation. More...

error_t	x509GenerateMldsa44Signature (const X509OctetString tbsData, const MldsaPrivateKey privateKey, uint8_t output, size_t written)
	ML-DSA-44 signature generation. More...

error_t	x509GenerateMldsa65Signature (const X509OctetString tbsData, const MldsaPrivateKey privateKey, uint8_t output, size_t written)
	ML-DSA-65 signature generation. More...

error_t	x509GenerateMldsa87Signature (const X509OctetString tbsData, const MldsaPrivateKey privateKey, uint8_t output, size_t written)
	ML-DSA-87 signature generation. More...

Detailed Description

RSA/DSA/ECDSA/EdDSA signature generation.

License

SPDX-License-Identifier: GPL-2.0-or-later

This file is part of CycloneCRYPTO Open.

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.

Author: Oryx Embedded SARL (www.oryx-embedded.com)

Version: 2.6.6

Definition in file x509_sign_generate.h.

Typedef Documentation

◆ X509SignGenCallback

typedef error_t(* X509SignGenCallback) (const PrngAlgo *prngAlgo, void *prngContext, const X509OctetString *tbsData, const X509SignAlgoId *signAlgoId, const void *privateKey, uint8_t *output, size_t *written)

Signature generation callback function.

Definition at line 48 of file x509_sign_generate.h.

Function Documentation

◆ x509GenerateDsaSignature()

error_t x509GenerateDsaSignature	(	const PrngAlgo *	prngAlgo,
		void *	prngContext,
		const X509OctetString *	tbsData,
		const HashAlgo *	hashAlgo,
		const DsaPrivateKey *	privateKey,
		uint8_t *	output,
		size_t *	written
	)

DSA signature generation.

Parameters

[in]	prngAlgo	PRNG algorithm
[in]	prngContext	Pointer to the PRNG context
[in]	tbsData	Pointer to the data to be signed
[in]	hashAlgo	Underlying hash function
[in]	privateKey	Signer's private key
[out]	output	Resulting signature
[out]	written	Length of the resulting signature

Returns: Error code

Definition at line 406 of file x509_sign_generate.c.

◆ x509GenerateEcdsaSignature()

error_t x509GenerateEcdsaSignature	(	const PrngAlgo *	prngAlgo,
		void *	prngContext,
		const X509OctetString *	tbsData,
		const HashAlgo *	hashAlgo,
		const EcPrivateKey *	privateKey,
		uint8_t *	output,
		size_t *	written
	)

ECDSA signature generation.

Parameters

[in]	prngAlgo	PRNG algorithm
[in]	prngContext	Pointer to the PRNG context
[in]	tbsData	Pointer to the data to be signed
[in]	hashAlgo	Underlying hash function
[in]	privateKey	Signer's private key
[out]	output	Resulting signature
[out]	written	Length of the resulting signature

Returns: Error code

Definition at line 476 of file x509_sign_generate.c.

◆ x509GenerateEd25519Signature()

error_t x509GenerateEd25519Signature	(	const X509OctetString *	tbsData,
		const EddsaPrivateKey *	privateKey,
		uint8_t *	output,
		size_t *	written
	)

Ed25519 signature generation.

Parameters

[in]	tbsData	Pointer to the data to be signed
[in]	privateKey	Signer's private key
[out]	output	Resulting signature
[out]	written	Length of the resulting signature

Returns: Error code

Definition at line 621 of file x509_sign_generate.c.

◆ x509GenerateEd448Signature()

error_t x509GenerateEd448Signature	(	const X509OctetString *	tbsData,
		const EddsaPrivateKey *	privateKey,
		uint8_t *	output,
		size_t *	written
	)

Ed448 signature generation.

Parameters

[in]	tbsData	Pointer to the data to be signed
[in]	privateKey	Signer's private key
[out]	output	Resulting signature
[out]	written	Length of the resulting signature

Returns: Error code

Definition at line 677 of file x509_sign_generate.c.

◆ x509GenerateMldsa44Signature()

error_t x509GenerateMldsa44Signature	(	const X509OctetString *	tbsData,
		const MldsaPrivateKey *	privateKey,
		uint8_t *	output,
		size_t *	written
	)

ML-DSA-44 signature generation.

Parameters

[in]	tbsData	Pointer to the data to be signed
[in]	privateKey	Signer's private key
[out]	output	Resulting signature
[out]	written	Length of the resulting signature

Returns: Error code

Definition at line 733 of file x509_sign_generate.c.

◆ x509GenerateMldsa65Signature()

error_t x509GenerateMldsa65Signature	(	const X509OctetString *	tbsData,
		const MldsaPrivateKey *	privateKey,
		uint8_t *	output,
		size_t *	written
	)

ML-DSA-65 signature generation.

Parameters

[in]	tbsData	Pointer to the data to be signed
[in]	privateKey	Signer's private key
[out]	output	Resulting signature
[out]	written	Length of the resulting signature

Returns: Error code

Definition at line 786 of file x509_sign_generate.c.

◆ x509GenerateMldsa87Signature()

error_t x509GenerateMldsa87Signature	(	const X509OctetString *	tbsData,
		const MldsaPrivateKey *	privateKey,
		uint8_t *	output,
		size_t *	written
	)

ML-DSA-87 signature generation.

Parameters

[in]	tbsData	Pointer to the data to be signed
[in]	privateKey	Signer's private key
[out]	output	Resulting signature
[out]	written	Length of the resulting signature

Returns: Error code

Definition at line 839 of file x509_sign_generate.c.

◆ x509GenerateRsaPssSignature()

error_t x509GenerateRsaPssSignature	(	const PrngAlgo *	prngAlgo,
		void *	prngContext,
		const X509OctetString *	tbsData,
		const HashAlgo *	hashAlgo,
		const HashAlgo *	mgfHashAlgo,
		size_t	saltLen,
		const RsaPrivateKey *	privateKey,
		uint8_t *	output,
		size_t *	written
	)

RSA-PSS signature generation.

Parameters

[in]	prngAlgo	PRNG algorithm
[in]	prngContext	Pointer to the PRNG context
[in]	tbsData	Pointer to the data to be signed
[in]	hashAlgo	Hash function
[in]	mgfHashAlgo	MGF hash function
[in]	saltLen	Length of the salt, in bytes
[in]	privateKey	Signer's private key
[out]	output	Resulting signature
[out]	written	Length of the resulting signature

Returns: Error code

Definition at line 352 of file x509_sign_generate.c.

◆ x509GenerateRsaSignature()

error_t x509GenerateRsaSignature	(	const X509OctetString *	tbsData,
		const HashAlgo *	hashAlgo,
		const RsaPrivateKey *	privateKey,
		uint8_t *	output,
		size_t *	written
	)

RSA signature generation.

Parameters

[in]	tbsData	Pointer to the data to be signed
[in]	hashAlgo	Underlying hash function
[in]	privateKey	Signer's private key
[out]	output	Resulting signature
[out]	written	Length of the resulting signature

Returns: Error code

Definition at line 297 of file x509_sign_generate.c.

◆ x509GenerateSignature()

error_t x509GenerateSignature	(	const PrngAlgo *	prngAlgo,
		void *	prngContext,
		const X509OctetString *	tbsData,
		const X509SignAlgoId *	signAlgoId,
		const void *	privateKey,
		uint8_t *	output,
		size_t *	written
	)

Signature generation.

Parameters

[in]	prngAlgo	PRNG algorithm
[in]	prngContext	Pointer to the PRNG context
[in]	tbsData	Pointer to the data to be signed
[in]	signAlgoId	Signature algorithm identifier
[in]	privateKey	Signer's private key
[out]	output	Resulting signature
[out]	written	Length of the resulting signature

Returns: Error code

Definition at line 82 of file x509_sign_generate.c.

◆ x509GenerateSm2Signature()

error_t x509GenerateSm2Signature	(	const PrngAlgo *	prngAlgo,
		void *	prngContext,
		const X509OctetString *	tbsData,
		const HashAlgo *	hashAlgo,
		const EcPrivateKey *	privateKey,
		uint8_t *	output,
		size_t *	written
	)

SM2 signature generation.

Parameters

[in]	prngAlgo	PRNG algorithm
[in]	prngContext	Pointer to the PRNG context
[in]	tbsData	Pointer to the data to be signed
[in]	hashAlgo	Underlying hash function
[in]	privateKey	Signer's private key
[out]	output	Resulting signature
[out]	written	Length of the resulting signature

Returns: Error code

Definition at line 561 of file x509_sign_generate.c.

◆ x509RegisterSignGenCallback()

error_t x509RegisterSignGenCallback ( X509SignGenCallback callback )

Register signature generation callback function.

Parameters

[in] callback Signature generation callback function

Returns: Error code

Definition at line 56 of file x509_sign_generate.c.

Typedefs

Functions

Detailed Description

License

Typedef Documentation

◆ X509SignGenCallback

Function Documentation

◆ x509GenerateDsaSignature()

◆ x509GenerateEcdsaSignature()

◆ x509GenerateEd25519Signature()

◆ x509GenerateEd448Signature()

◆ x509GenerateMldsa44Signature()

◆ x509GenerateMldsa65Signature()

◆ x509GenerateMldsa87Signature()

◆ x509GenerateRsaPssSignature()

◆ x509GenerateRsaSignature()

◆ x509GenerateSignature()

◆ x509GenerateSm2Signature()

◆ x509RegisterSignGenCallback()