Visible to Intel only — GUID: GUID-5E880CD2-654B-4239-B4D1-709FDBF8814A
Visible to Intel only — GUID: GUID-5E880CD2-654B-4239-B4D1-709FDBF8814A
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 parameteris not currently used and can be NULL.
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.