Cryptography for Intel® Integrated Performance Primitives Developer Reference

Developer Reference

Contents

RSA_SetPublicKey, RSA_SetPrivateKeyType1, RSA_SetPrivateKeyType2

Set up an RSA key in the existing RSA key context.

Syntax

IppStatus ippsRSA_SetPublicKey(const IppsBigNumState*
pModulus
, const IppsBigNumState*
pPublicExp
, IppsRSAPublicKeyState*
pKey
);
IppStatus ippsRSA_SetPrivateKeyType1(const IppsBigNumState*
pModulus
, const IppsBigNumState*
pPrivateExp
, IppsRSAPrivateKeyState*
pKey
);
IppStatus ippsRSA_SetPrivateKeyType2(const IppsBigNumState*
pFactorP
, const IppsBigNumState*
pFactorQ
, const IppsBigNumState*
pCrtExpP
, const IppsBigNumState*
pCrtExpQ
, const IppsBigNumState*
pInverseQ
, IppsRSAPrivateKeyState*
pKey
);
Include Files
ippcp.h
Parameters
pModulus
The composite RSA modulus
n
.
pPublicExp
The
e
 component of the RSA public key.
pPrivateExp
The
d
 component of the type 1 RSA private key.
pFactorP
,
pFactorQ
The
p
 and
q
 factors of the RSA modulus
n
 =
p
*
q
.
pCrtExpP
,
pCrtExpQ
The
dP
 and
dQ
 components of the quintuple (
p,q,dP,dQ,qInv
), which defines a type 2 private key.
pInverseQ
The
qInv
 component of the quintuple (
p,q,dP,dQ,qInv
).
pKey
Pointer to the
IppsRSAPublicKeyState
 or
IppsRSAPrivateKeyState
 context.
Description
The
RSA_SetPublicKey
 function sets up the RSA public key (
n
,
e
) in the
IppsRSAPublicKeyState
 context, that is, copies the
n
 and
e
 components supplied by the user into the context.
The
RSA_SetPrivateKeyType1
 function sets up the RSA type 1 private key (
n
,
d
) in the
IppsRSAPrivateKeyState
 context, that is, copies the
n
 and
d
 components supplied by the user into the context.
The
RSA_SetPrivateKeyType2
 function sets up the RSA type 2 private key (
p,q,dP,dQ,qInv
) in the
IppsRSAPrivateKeyState
 context, that is, copies user-supplied
p
 and
q
 factors of the RSA composite modulus into the context, computes the rest of the key components, and copies them into the context:
  • dP
     =
    q
     mod (
    p
    -1)
  • dQ
     =
    p
     mod (
    q
    -1)
  • qInv
     = 1/
    q
     mod
    p
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 any of the context parameters does not match the operation.
ippStsSizeErr
Indicates an error condition if the bit length of a key component specified by the
pModulus
,
pPublicExp
,
pPrivateExp
,
pFactorP
, or
pFactorQ
 pointer exceeds the bit length specified at the initialization.
ippStsOutOfRangeErr
Indicates an error condition if any key component is not positive.

Product and Performance Information

1

Performance varies by use, configuration and other factors. Learn more at www.Intel.com/PerformanceIndex.