mirror of
https://github.com/guanzhi/GmSSL.git
synced 2026-05-07 17:06:25 +08:00
289 lines
11 KiB
C
289 lines
11 KiB
C
/*
|
||
* Copyright 2014-2024 The GmSSL Project. All Rights Reserved.
|
||
*
|
||
* Licensed under the Apache License, Version 2.0 (the License); you may
|
||
* not use this file except in compliance with the License.
|
||
*
|
||
* http://www.apache.org/licenses/LICENSE-2.0
|
||
*/
|
||
|
||
|
||
|
||
#ifndef GMSSL_SM2_H
|
||
#define GMSSL_SM2_H
|
||
|
||
#include <stdio.h>
|
||
#include <stdint.h>
|
||
#include <stdlib.h>
|
||
#include <gmssl/api.h>
|
||
#include <gmssl/sm3.h>
|
||
|
||
#ifdef __cplusplus
|
||
extern "C" {
|
||
#endif
|
||
|
||
|
||
typedef uint8_t sm2_bn_t[32];
|
||
|
||
typedef struct {
|
||
uint8_t x[32];
|
||
uint8_t y[32];
|
||
} SM2_POINT;
|
||
|
||
#define sm2_point_init(P) memset((P),0,sizeof(SM2_POINT))
|
||
#define sm2_point_set_infinity(P) sm2_point_init(P)
|
||
|
||
|
||
int sm2_point_from_octets(SM2_POINT *P, const uint8_t *in, size_t inlen);
|
||
void sm2_point_to_compressed_octets(const SM2_POINT *P, uint8_t out[33]);
|
||
void sm2_point_to_uncompressed_octets(const SM2_POINT *P, uint8_t out[65]);
|
||
|
||
int sm2_point_from_x(SM2_POINT *P, const uint8_t x[32], int y);
|
||
int sm2_point_from_xy(SM2_POINT *P, const uint8_t x[32], const uint8_t y[32]);
|
||
int sm2_point_is_on_curve(const SM2_POINT *P);
|
||
int sm2_point_is_at_infinity(const SM2_POINT *P);
|
||
int sm2_point_add(SM2_POINT *R, const SM2_POINT *P, const SM2_POINT *Q);
|
||
int sm2_point_sub(SM2_POINT *R, const SM2_POINT *P, const SM2_POINT *Q);
|
||
int sm2_point_neg(SM2_POINT *R, const SM2_POINT *P);
|
||
int sm2_point_dbl(SM2_POINT *R, const SM2_POINT *P);
|
||
int sm2_point_mul(SM2_POINT *R, const uint8_t k[32], const SM2_POINT *P);
|
||
int sm2_point_mul_generator(SM2_POINT *R, const uint8_t k[32]);
|
||
int sm2_point_mul_sum(SM2_POINT *R, const uint8_t k[32], const SM2_POINT *P, const uint8_t s[32]); // R = k * P + s * G
|
||
|
||
|
||
/*
|
||
RFC 5480 Elliptic Curve Cryptography Subject Public Key Information
|
||
ECPoint ::= OCTET STRING
|
||
*/
|
||
#define SM2_POINT_MAX_SIZE (2 + 65)
|
||
int sm2_point_to_der(const SM2_POINT *P, uint8_t **out, size_t *outlen);
|
||
int sm2_point_from_der(SM2_POINT *P, const uint8_t **in, size_t *inlen);
|
||
int sm2_point_print(FILE *fp, int fmt, int ind, const char *label, const SM2_POINT *P);
|
||
int sm2_point_from_hash(SM2_POINT *R, const uint8_t *data, size_t datalen);
|
||
|
||
|
||
typedef struct {
|
||
SM2_POINT public_key;
|
||
uint8_t private_key[32];
|
||
} SM2_KEY;
|
||
|
||
_gmssl_export int sm2_key_generate(SM2_KEY *key);
|
||
int sm2_key_set_private_key(SM2_KEY *key, const uint8_t private_key[32]); // key->public_key will be replaced
|
||
int sm2_key_set_public_key(SM2_KEY *key, const SM2_POINT *public_key); // key->private_key will be cleared // FIXME: support octets as input?
|
||
int sm2_key_print(FILE *fp, int fmt, int ind, const char *label, const SM2_KEY *key);
|
||
|
||
int sm2_public_key_equ(const SM2_KEY *sm2_key, const SM2_KEY *pub_key);
|
||
//int sm2_public_key_copy(SM2_KEY *sm2_key, const SM2_KEY *pub_key); // do we need this?
|
||
int sm2_public_key_digest(const SM2_KEY *key, uint8_t dgst[32]);
|
||
int sm2_public_key_print(FILE *fp, int fmt, int ind, const char *label, const SM2_KEY *pub_key);
|
||
|
||
|
||
/*
|
||
from RFC 5915
|
||
|
||
ECPrivateKey ::= SEQUENCE {
|
||
version INTEGER, -- value MUST be (1)
|
||
privateKey OCTET STRING, -- big endian encoding of integer 这里不是以INTEGER编码的，因此长度固定
|
||
parameters [0] EXPLICIT ECParameters OPTIONAL,
|
||
-- ONLY namedCurve OID is permitted, by RFC 5480
|
||
-- MUST always include this field, by RFC 5915
|
||
publicKey [1] EXPLICIT BIT STRING OPTIONAL -- compressed_point
|
||
-- SHOULD always include this field, by RFC 5915 }
|
||
|
||
ECParameters ::= CHOICE { namedCurve OBJECT IDENTIFIER }
|
||
*/
|
||
#define SM2_PRIVATE_KEY_DEFAULT_SIZE 120 // generated
|
||
#define SM2_PRIVATE_KEY_BUF_SIZE 512 // MUST >= SM2_PRIVATE_KEY_DEFAULT_SIZE
|
||
|
||
int sm2_private_key_to_der(const SM2_KEY *key, uint8_t **out, size_t *outlen);
|
||
int sm2_private_key_from_der(SM2_KEY *key, const uint8_t **in, size_t *inlen);
|
||
int sm2_private_key_print(FILE *fp, int fmt, int ind, const char *label, const uint8_t *d, size_t dlen);
|
||
int sm2_private_key_to_pem(const SM2_KEY *key, FILE *fp);
|
||
int sm2_private_key_from_pem(SM2_KEY *key, FILE *fp);
|
||
|
||
/*
|
||
AlgorithmIdentifier ::= {
|
||
algorithm OBJECT IDENTIFIER { id-ecPublicKey },
|
||
parameters OBJECT IDENTIFIER { id-sm2 } }
|
||
*/
|
||
int sm2_public_key_algor_to_der(uint8_t **out, size_t *outlen);
|
||
int sm2_public_key_algor_from_der(const uint8_t **in, size_t *inlen);
|
||
|
||
/*
|
||
SubjectPublicKeyInfo from RFC 5280
|
||
|
||
SubjectPublicKeyInfo ::= SEQUENCE {
|
||
algorithm AlgorithmIdentifier,
|
||
subjectPublicKey BIT STRING -- uncompressed octets of ECPoint }
|
||
*/
|
||
_gmssl_export int sm2_public_key_info_to_der(const SM2_KEY *a, uint8_t **out, size_t *outlen);
|
||
_gmssl_export int sm2_public_key_info_from_der(SM2_KEY *a, const uint8_t **in, size_t *inlen);
|
||
_gmssl_export int sm2_public_key_info_to_pem(const SM2_KEY *a, FILE *fp);
|
||
_gmssl_export int sm2_public_key_info_from_pem(SM2_KEY *a, FILE *fp);
|
||
|
||
/*
|
||
PKCS #8 PrivateKeyInfo from RFC 5208
|
||
|
||
PrivateKeyInfo ::= SEQUENCE {
|
||
version Version { v1(0) },
|
||
privateKeyAlgorithm AlgorithmIdentifier,
|
||
privateKey OCTET STRING, -- DER-encoding of ECPrivateKey
|
||
attributes [0] IMPLICIT SET OF Attribute OPTIONAL }
|
||
*/
|
||
enum {
|
||
PKCS8_private_key_info_version = 0,
|
||
};
|
||
|
||
|
||
int sm2_private_key_info_to_der(const SM2_KEY *key, uint8_t **out, size_t *outlen);
|
||
int sm2_private_key_info_from_der(SM2_KEY *key, const uint8_t **attrs, size_t *attrslen, const uint8_t **in, size_t *inlen);
|
||
int sm2_private_key_info_print(FILE *fp, int fmt, int ind, const char *label, const uint8_t *d, size_t dlen);
|
||
int sm2_private_key_info_to_pem(const SM2_KEY *key, FILE *fp);
|
||
// FIXME: #define default buffer size for sm2_private_key_info_from_pem
|
||
int sm2_private_key_info_from_pem(SM2_KEY *key, FILE *fp);
|
||
|
||
/*
|
||
EncryptedPrivateKeyInfo ::= SEQUENCE {
|
||
encryptionAlgorithm EncryptionAlgorithmIdentifier, -- id-PBES2
|
||
encryptedData OCTET STRING }
|
||
*/
|
||
_gmssl_export int sm2_private_key_info_encrypt_to_der(const SM2_KEY *key,
|
||
const char *pass, uint8_t **out, size_t *outlen);
|
||
_gmssl_export int sm2_private_key_info_decrypt_from_der(SM2_KEY *key, const uint8_t **attrs, size_t *attrs_len,
|
||
const char *pass, const uint8_t **in, size_t *inlen);
|
||
_gmssl_export int sm2_private_key_info_encrypt_to_pem(const SM2_KEY *key, const char *pass, FILE *fp);
|
||
// FIXME: #define default buffer size
|
||
_gmssl_export int sm2_private_key_info_decrypt_from_pem(SM2_KEY *key, const char *pass, FILE *fp);
|
||
|
||
|
||
typedef struct {
|
||
uint8_t r[32];
|
||
uint8_t s[32];
|
||
} SM2_SIGNATURE;
|
||
|
||
int sm2_do_sign(const SM2_KEY *key, const uint8_t dgst[32], SM2_SIGNATURE *sig);
|
||
int sm2_do_verify(const SM2_KEY *key, const uint8_t dgst[32], const SM2_SIGNATURE *sig);
|
||
|
||
|
||
|
||
|
||
#define SM2_MIN_SIGNATURE_SIZE 8
|
||
#define SM2_MAX_SIGNATURE_SIZE 72
|
||
int sm2_signature_to_der(const SM2_SIGNATURE *sig, uint8_t **out, size_t *outlen);
|
||
int sm2_signature_from_der(SM2_SIGNATURE *sig, const uint8_t **in, size_t *inlen);
|
||
int sm2_signature_print(FILE *fp, int fmt, int ind, const char *label, const uint8_t *sig, size_t siglen);
|
||
_gmssl_export int sm2_sign(const SM2_KEY *key, const uint8_t dgst[32], uint8_t *sig, size_t *siglen);
|
||
_gmssl_export int sm2_verify(const SM2_KEY *key, const uint8_t dgst[32], const uint8_t *sig, size_t siglen);
|
||
|
||
enum {
|
||
SM2_signature_compact_size = 70,
|
||
SM2_signature_typical_size = 71,
|
||
SM2_signature_max_size = 72,
|
||
};
|
||
int sm2_sign_fixlen(const SM2_KEY *key, const uint8_t dgst[32], size_t siglen, uint8_t *sig);
|
||
|
||
|
||
|
||
#define SM2_DEFAULT_ID "1234567812345678"
|
||
#define SM2_DEFAULT_ID_LENGTH (sizeof(SM2_DEFAULT_ID) - 1) // LENGTH for string and SIZE for bytes
|
||
#define SM2_DEFAULT_ID_BITS (SM2_DEFAULT_ID_LENGTH * 8)
|
||
#define SM2_MAX_ID_BITS 65535
|
||
#define SM2_MAX_ID_LENGTH (SM2_MAX_ID_BITS/8)
|
||
|
||
int sm2_compute_z(uint8_t z[32], const SM2_POINT *pub, const char *id, size_t idlen);
|
||
|
||
|
||
typedef struct {
|
||
uint64_t k[4];
|
||
uint64_t x1[4];
|
||
} SM2_SIGN_PRE_COMP;
|
||
|
||
|
||
typedef struct {
|
||
SM3_CTX sm3_ctx;
|
||
SM2_KEY key;
|
||
// FIXME: change `key` to SM2_Z256_POINT and uint64_t[4], inner type, faster sign/verify
|
||
|
||
uint64_t public_key[3][8]; // enough to hold point in Jacobian format
|
||
|
||
uint64_t sign_key[8]; // u64[8] to support SM2_BN
|
||
SM3_CTX inited_sm3_ctx;
|
||
|
||
SM2_SIGN_PRE_COMP pre_comp[32];
|
||
unsigned int num_pre_comp;
|
||
} SM2_SIGN_CTX;
|
||
|
||
|
||
|
||
_gmssl_export int sm2_sign_init(SM2_SIGN_CTX *ctx, const SM2_KEY *key, const char *id, size_t idlen);
|
||
_gmssl_export int sm2_sign_update(SM2_SIGN_CTX *ctx, const uint8_t *data, size_t datalen);
|
||
_gmssl_export int sm2_sign_finish(SM2_SIGN_CTX *ctx, uint8_t *sig, size_t *siglen);
|
||
int sm2_sign_finish_fixlen(SM2_SIGN_CTX *ctx, size_t siglen, uint8_t *sig);
|
||
|
||
_gmssl_export int sm2_verify_init(SM2_SIGN_CTX *ctx, const SM2_KEY *key, const char *id, size_t idlen);
|
||
_gmssl_export int sm2_verify_update(SM2_SIGN_CTX *ctx, const uint8_t *data, size_t datalen);
|
||
_gmssl_export int sm2_verify_finish(SM2_SIGN_CTX *ctx, const uint8_t *sig, size_t siglen);
|
||
|
||
_gmssl_export int sm2_sign_ctx_reset(SM2_SIGN_CTX *ctx);
|
||
|
||
/*
|
||
SM2Cipher ::= SEQUENCE {
|
||
XCoordinate INTEGER,
|
||
YCoordinate INTEGER,
|
||
HASH OCTET STRING SIZE(32),
|
||
CipherText OCTET STRING }
|
||
*/
|
||
#define SM2_MIN_PLAINTEXT_SIZE 1 // re-compute SM2_MIN_CIPHERTEXT_SIZE when modify
|
||
#define SM2_MAX_PLAINTEXT_SIZE 255 // re-compute SM2_MAX_CIPHERTEXT_SIZE when modify
|
||
|
||
typedef struct {
|
||
SM2_POINT point;
|
||
uint8_t hash[32];
|
||
uint8_t ciphertext_size;
|
||
uint8_t ciphertext[SM2_MAX_PLAINTEXT_SIZE];
|
||
} SM2_CIPHERTEXT;
|
||
|
||
int sm2_kdf(const uint8_t *in, size_t inlen, size_t outlen, uint8_t *out);
|
||
|
||
int sm2_do_encrypt(const SM2_KEY *key, const uint8_t *in, size_t inlen, SM2_CIPHERTEXT *out);
|
||
int sm2_do_decrypt(const SM2_KEY *key, const SM2_CIPHERTEXT *in, uint8_t *out, size_t *outlen);
|
||
|
||
#define SM2_MIN_CIPHERTEXT_SIZE 45 // depends on SM2_MIN_PLAINTEXT_SIZE
|
||
#define SM2_MAX_CIPHERTEXT_SIZE 366 // depends on SM2_MAX_PLAINTEXT_SIZE
|
||
int sm2_ciphertext_to_der(const SM2_CIPHERTEXT *c, uint8_t **out, size_t *outlen);
|
||
int sm2_ciphertext_from_der(SM2_CIPHERTEXT *c, const uint8_t **in, size_t *inlen);
|
||
int sm2_ciphertext_print(FILE *fp, int fmt, int ind, const char *label, const uint8_t *a, size_t alen);
|
||
_gmssl_export int sm2_encrypt(const SM2_KEY *key, const uint8_t *in, size_t inlen, uint8_t *out, size_t *outlen);
|
||
_gmssl_export int sm2_decrypt(const SM2_KEY *key, const uint8_t *in, size_t inlen, uint8_t *out, size_t *outlen);
|
||
|
||
enum {
|
||
SM2_ciphertext_compact_point_size = 68,
|
||
SM2_ciphertext_typical_point_size = 69,
|
||
SM2_ciphertext_max_point_size = 70,
|
||
};
|
||
int sm2_do_encrypt_fixlen(const SM2_KEY *key, const uint8_t *in, size_t inlen, int point_size, SM2_CIPHERTEXT *out);
|
||
int sm2_encrypt_fixlen(const SM2_KEY *key, const uint8_t *in, size_t inlen, int point_size, uint8_t *out, size_t *outlen);
|
||
|
||
|
||
int sm2_do_ecdh(const SM2_KEY *key, const SM2_POINT *peer_public, SM2_POINT *out);
|
||
_gmssl_export int sm2_ecdh(const SM2_KEY *key, const uint8_t *peer_public, size_t peer_public_len, SM2_POINT *out);
|
||
|
||
|
||
typedef struct {
|
||
SM2_KEY sm2_key;
|
||
uint8_t buf[SM2_MAX_CIPHERTEXT_SIZE];
|
||
size_t buf_size;
|
||
} SM2_ENC_CTX;
|
||
|
||
_gmssl_export int sm2_encrypt_init(SM2_ENC_CTX *ctx, const SM2_KEY *sm2_key);
|
||
_gmssl_export int sm2_encrypt_update(SM2_ENC_CTX *ctx, const uint8_t *in, size_t inlen, uint8_t *out, size_t *outlen);
|
||
_gmssl_export int sm2_encrypt_finish(SM2_ENC_CTX *ctx, const uint8_t *in, size_t inlen, uint8_t *out, size_t *outlen);
|
||
_gmssl_export int sm2_decrypt_init(SM2_ENC_CTX *ctx, const SM2_KEY *sm2_key);
|
||
_gmssl_export int sm2_decrypt_update(SM2_ENC_CTX *ctx, const uint8_t *in, size_t inlen, uint8_t *out, size_t *outlen);
|
||
_gmssl_export int sm2_decrypt_finish(SM2_ENC_CTX *ctx, const uint8_t *in, size_t inlen, uint8_t *out, size_t *outlen);
|
||
|
||
#ifdef __cplusplus
|
||
}
|
||
#endif
|
||
#endif
|