RSASSASign

Carries out the RSASSA-PSS signature generation scheme using SHA-1 hash algorithm.

Syntax

IppStatus ippsRSASSASign_SHA1(const Ipp8u* pHMsg, const Ipp8u* pSalt, int saltLen, Ipp8u* pSign, IppsRSAState* pCtx);

Parameters

pHMsg	Pointer to the octet message hash to be signed.
pSalt	Pointer to the random octet salt string.
saltLen	Length of the salt string in octets.
pSign	Pointer to the output octet signature.
pCtx	Pointer to the properly initialized IppsRSAState context.

Description

This function is declared in the ippcp.h file. The function uses SHA-1 hash function and SHA-1-based MGF implemented in Intel IPP to generate a message signature according to the RSASSA-PSS scheme and thus is a specific form of the general RSASSASign function. Provided the IppsRSAState context is properly initialized, the entire RSA-SSA signing scheme is carried out in two steps:

Call the SHA1MessageDigest function to compute the message hash to be signed.
Call RSASSASign_SHA1 with pHMsg pointing to the message hash computed in the previous step.

See the description of the RSASSA-PSS Sign primitive in [PKCS 1.2.1] for more details.

Return Values

The function may return any of the values that the general RSASSASign function returns. Specifically:

ippStsLengthErr

Indicates an error condition if any inconsistencies in data lengths are detected.