RSASSAVerify

Carries out the RSA-SSA signature verification scheme.

Syntax

IppStatus ippsRSASSAVerify(const Ipp8u* pHMsg, int hashLen, const Ipp8u* pSign, IppBool* pIsValid, IppsRSAState* pCtx, IppHash hushFunc, IppMGF mgfFunc);

Parameters

pHMsg	Pointer to the octet message hash that has been signed.
hashLen	Length in octets of the message hash *pHMsg.
pSign	Pointer to the octet signature string to be verified.
pIsValid	Pointer to the verification result.
pCtx	Pointer to the properly initialized IppsRSAState context.
hashFunc	Hash function, which meets the General Definition of a Hash Function.
mgfFunc	MGF, which meets the definition provided in section User's Implementation of a Mask Generation Function.

Description

This function is declared in the ippcp.h file. The function carries out the RSASSA-PSS signature verification scheme defined in [PKCS 1.2.1]. RSASSAVerify verifies the signature generated by the RSASSASign function that uses the same hashFunc and mgfFunc parameters.

Return Values

ippStsNoErr	Indicates no error. Any other value indicates an error or warning.
ippStsNullPtrErr	Indicates an error condition if any of the specified pointers is NULL.
ippStsContextMatchErr	Indicates an error condition if the context parameter does not match the operation.
ippStsInvalidCryptoKeyErr	Indicates an error condition if the RSA context has not been properly set up for the operation.
ippStsLengthErr	Indicates an error condition if the input length parameter does not meet any of the following conditions: hashLen > 0, hashLen + 2 > `N` , where `N` is the length of the RSA modulus in octets.