Developer Reference

Contents

ECCPSharedSecretDHC

Computes a shared secret field element by using the Diffie-Hellman scheme and the elliptic curve cofactor.

Syntax

IppStatus ippsECCPSharedSecretDHC(const IppsBigNumState*
pPrivateA
, const IppsECCPPointState*
pPublicB
, IppsBigNumState*
pShare
, IppsECCPState*
pECC
);
Include Files
ippcp.h
Parameters
pPrivateA
Pointer to your own private key
privKey
.
pPublicB
Pointer to the public key
pubKey
.
pShare
Pointer to the secret number
bnShare
.
pECC
Pointer to the context of the elliptic cryptosystem.
Description
The function computes a secret number
bnShare
which is a secret key shared between two participants of the cryptosystem. Both participants (Alice and Bob) use the cryptosystem for getting a common secret point on the elliptic curve by using the Diffie-Hellman scheme and elliptic curve cofactor
h
.
Alice and Bob perform the following operations:
  1. Alice calculates her own public key
    pubKeyA
    by using her private key
    privKeyA
    :
    pubKeyA = privKeyA
    ·
    G
    , where
    G
    is the base point of the elliptic curve. Alice passes the public key to Bob.
  2. Bob calculates his own public key
    pubKeyB
    by using his private key
    privKeyB
    :
    pubKeyB = privKeyB
    ·
    G
    , where
    G
    is a base point of the elliptic curve. Bob passes the public key to Alice.
  3. Alice gets Bob's public key and calculates the secret point
    shareA
    . When calculating, she uses her own private key and Bob's public key and applies the following formula:
    shareA =
    h
    ·
    privKeyA
    ·
    pubKeyB =
    h
    ·
    privKeyA
    ·
    privKeyB
    ·
    G
    , where
    h
    is the elliptic curve cofactor.
  4. Bob gets Alice's public key and calculates the secret point
    shareB
    . When calculating, he uses his own private key and Alice's public key and applies the following formula:
    shareB =
    h
    ·
    privKeyB
    ·
    pubKeyA =
    h
    ·
    privKeyB
    ·
    privKeyA
    ·
    G
    , where
    h
    is the elliptic curve cofactor.
Shared secret
bnShare
is an x-coordinate of the secret point on the elliptic curve.
The elliptic curve domain parameters must be hitherto defined by one of the functions:
ECCPSet
or
ECCPSetStd
.
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 one of the contexts pointed by
pPublicB
,
pShare
, or
pECC
is not valid.
ippStsRangeErr
Indicates an error condition if the memory size of
bnShare
pointed by
pShare
is less than the value of
feBitSize
in the function
ECCPInit
.
ippStsShareKeyErr
Indicates an error condition if the shared secret key is not valid. (For example, the shared secret key is invalid if the result of the secret point calculation is the point at infinity.)

Product and Performance Information

1

Intel's compilers may or may not optimize to the same degree for non-Intel microprocessors for optimizations that are not unique to Intel microprocessors. These optimizations include SSE2, SSE3, and SSSE3 instruction sets and other optimizations. Intel does not guarantee the availability, functionality, or effectiveness of any optimization on microprocessors not manufactured by Intel. Microprocessor-dependent optimizations in this product are intended for use with Intel microprocessors. Certain optimizations not specific to Intel microarchitecture are reserved for Intel microprocessors. Please refer to the applicable product User and Reference Guides for more information regarding the specific instruction sets covered by this notice.

Notice revision #20110804