Developer Reference

Contents

mbx_sm2_ecdsa_sign

Generates the SM2 ECDSA signature.

Syntax

mbx_status mbx_sm2_ecdsa_sign_mb8(int8u*
pa_sign_r
[8], int8u*
pa_sign_s
[8], const int8u* const
pa_user_id
[8], const int
user_id_len
[8], const int8u* const
pa_msg
[8], const int
msg_len
[8], const int64u* const
pa_eph_skey
[8], const int64u* const
pa_reg_skey
[8], const int64u* const
pa_pubx
[8], const int64u* const
pa_puby
[8], const int64u* const
pa_pubz
[8], int8u*
pBuffer
);
mbx_status mbx_sm2_ecdsa_sign_ssl_mb8(int8u*
pa_sign_r
[8], int8u*
pa_sign_s
[8], const int8u* const
pa_user_id
[8], const int
user_id_len
[8], const int8u* const
pa_msg
[8], const int
msg_len
[8], const BIGNUM* const
pa_eph_skey
[8], const BIGNUM* const
pa_reg_skey
[8], const BIGNUM* const
pa_pubx
[8], const BIGNUM* const
pa_puby
[8], const BIGNUM* const
pa_pubz
[8], int8u*
pBuffer
);
Include Files
crypto_mb/ec_sm2.h
Parameters
pa_sign_r
Array of pointers to the resulting r-components of the signature.
pa_sign_s
Array of pointers to the resulting s-components of the signature.
pa_user_id
Array of pointers to the users ID.
user_id_len
Array of users ID length.
pa_msg
Array of pointers to the message representatives are being signed.
msg_len
Array of messages length.
pa_eph_skey
Array of pointers to the signer's ephemeral private key.
pa_reg_skey
Array of pointers to the signer's regular private key.
pa_pubx
Array of pointers to the party's public keys X-coordinates
pa_puby
Array of pointers to the party's public keys Y-coordinates
pa_pubz
Array of pointers to the party's public keys Z-coordinates
pBuffer
Pointer to the work buffer.
Description
The function computes user ids, messages, and signer public keys representative using SM2 hash algorithm. User ids are specified by
pa_user_id
parameter and its length are specified by
user_id_len
parameter. Messages are specified by
pa_msg
parameter and its length are specified by
msg_len
parameter. Public keys are specified by
pa_pubx
,
pa_puby
, and
pa_pubz
parameters. If the
pa_pubz
parameter is not
NULL
, then it is assumed that signer's public keys are represented in projective coordinates. If the
pa_pubz
parameter is
NULL
, then signer's public keys are considered in affine coordinates.
Computed input data representative signed using regular and private keys specified by
pa_reg_skey
and
pa_eph_skey
parameters correspondingly. Computed signature converts
r-
and
s-
components of the signature into big endian byte strings and stores them separately in locations specified by
pa_sign_r
and
pa_sign_s
parameters.
The work buffer specified by the
pBuffer
parameter is not currently used and can be
NULL
.
The function above has own "twin" with "_ssl" in the name. The only difference in comparison with
mbx_sm2_ecdsa_sign()
is representation of the parameters.
mbx_sm2_ecdsa_sign_ssl()
functions use BIGNUM datatype instead of vector.
Return Values
The
mbx_sm2_ecdsa_sign()
functions return the status that indicates whether the operation completed successfully or not. The status value of 0 indicates that all operations completed successfully. The error condition can be analyzed by the
MBX_GET_STS()
call.

Product and Performance Information

1

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