Mbed TLS v2.28.8
Loading...
Searching...
No Matches
ecdsa.h
Go to the documentation of this file.
1
13/*
14 * Copyright The Mbed TLS Contributors
15 * SPDX-License-Identifier: Apache-2.0 OR GPL-2.0-or-later
16 */
17
18#ifndef MBEDTLS_ECDSA_H
19#define MBEDTLS_ECDSA_H
20
21#if !defined(MBEDTLS_CONFIG_FILE)
22#include "mbedtls/config.h"
23#else
24#include MBEDTLS_CONFIG_FILE
25#endif
26
27#include "mbedtls/ecp.h"
28#include "mbedtls/md.h"
29
39/*
40 * Ecdsa-Sig-Value ::= SEQUENCE {
41 * r INTEGER,
42 * s INTEGER
43 * }
44 *
45 * For each of r and s, the value (V) may include an extra initial "0" bit.
46 */
47#define MBEDTLS_ECDSA_MAX_SIG_LEN(bits) \
48 (/*T,L of SEQUENCE*/ ((bits) >= 61 * 8 ? 3 : 2) + \
49 /*T,L of r,s*/ 2 * (((bits) >= 127 * 8 ? 3 : 2) + \
50 /*V of r,s*/ ((bits) + 8) / 8))
51
53#define MBEDTLS_ECDSA_MAX_LEN MBEDTLS_ECDSA_MAX_SIG_LEN(MBEDTLS_ECP_MAX_BITS)
54
55#ifdef __cplusplus
56extern "C" {
57#endif
58
67
68#if defined(MBEDTLS_ECP_RESTARTABLE)
69
75typedef struct mbedtls_ecdsa_restart_ver mbedtls_ecdsa_restart_ver_ctx;
76
82typedef struct mbedtls_ecdsa_restart_sig mbedtls_ecdsa_restart_sig_ctx;
83
84#if defined(MBEDTLS_ECDSA_DETERMINISTIC)
90typedef struct mbedtls_ecdsa_restart_det mbedtls_ecdsa_restart_det_ctx;
91#endif
92
96typedef struct {
99 mbedtls_ecdsa_restart_ver_ctx *ver;
100 mbedtls_ecdsa_restart_sig_ctx *sig;
101#if defined(MBEDTLS_ECDSA_DETERMINISTIC)
102 mbedtls_ecdsa_restart_det_ctx *det;
103#endif
105
106#else /* MBEDTLS_ECP_RESTARTABLE */
107
108/* Now we can declare functions that take a pointer to that */
110
111#endif /* MBEDTLS_ECP_RESTARTABLE */
112
122
160 const mbedtls_mpi *d, const unsigned char *buf, size_t blen,
161 int (*f_rng)(void *, unsigned char *, size_t), void *p_rng);
162
163#if defined(MBEDTLS_ECDSA_DETERMINISTIC)
164#if !defined(MBEDTLS_DEPRECATED_REMOVED)
165#if defined(MBEDTLS_DEPRECATED_WARNING)
166#define MBEDTLS_DEPRECATED __attribute__((deprecated))
167#else
168#define MBEDTLS_DEPRECATED
169#endif
219 mbedtls_mpi *s, const mbedtls_mpi *d,
220 const unsigned char *buf, size_t blen,
222#undef MBEDTLS_DEPRECATED
223#endif /* MBEDTLS_DEPRECATED_REMOVED */
224
266 mbedtls_mpi *s, const mbedtls_mpi *d,
267 const unsigned char *buf, size_t blen,
268 mbedtls_md_type_t md_alg,
269 int (*f_rng_blind)(void *, unsigned char *, size_t),
270 void *p_rng_blind);
271#endif /* MBEDTLS_ECDSA_DETERMINISTIC */
272
304 const unsigned char *buf, size_t blen,
305 const mbedtls_ecp_point *Q, const mbedtls_mpi *r,
306 const mbedtls_mpi *s);
307
357 mbedtls_md_type_t md_alg,
358 const unsigned char *hash, size_t hlen,
359 unsigned char *sig, size_t *slen,
360 int (*f_rng)(void *, unsigned char *, size_t),
361 void *p_rng);
362
403 mbedtls_md_type_t md_alg,
404 const unsigned char *hash, size_t hlen,
405 unsigned char *sig, size_t *slen,
406 int (*f_rng)(void *, unsigned char *, size_t),
407 void *p_rng,
409
410#if defined(MBEDTLS_ECDSA_DETERMINISTIC)
411#if !defined(MBEDTLS_DEPRECATED_REMOVED)
412#if defined(MBEDTLS_DEPRECATED_WARNING)
413#define MBEDTLS_DEPRECATED __attribute__((deprecated))
414#else
415#define MBEDTLS_DEPRECATED
416#endif
461 const unsigned char *hash, size_t hlen,
462 unsigned char *sig, size_t *slen,
464#undef MBEDTLS_DEPRECATED
465#endif /* MBEDTLS_DEPRECATED_REMOVED */
466#endif /* MBEDTLS_ECDSA_DETERMINISTIC */
467
496 const unsigned char *hash, size_t hlen,
497 const unsigned char *sig, size_t slen);
498
531 const unsigned char *hash, size_t hlen,
532 const unsigned char *sig, size_t slen,
534
552 int (*f_rng)(void *, unsigned char *, size_t), void *p_rng);
553
570 const mbedtls_ecp_keypair *key);
571
579
588
589#if defined(MBEDTLS_ECP_RESTARTABLE)
596void mbedtls_ecdsa_restart_init(mbedtls_ecdsa_restart_ctx *ctx);
597
605void mbedtls_ecdsa_restart_free(mbedtls_ecdsa_restart_ctx *ctx);
606#endif /* MBEDTLS_ECP_RESTARTABLE */
607
608#ifdef __cplusplus
609}
610#endif
611
612#endif /* ecdsa.h */
Configuration options (set of defines)
int mbedtls_ecdsa_write_signature_restartable(mbedtls_ecdsa_context *ctx, mbedtls_md_type_t md_alg, const unsigned char *hash, size_t hlen, unsigned char *sig, size_t *slen, int(*f_rng)(void *, unsigned char *, size_t), void *p_rng, mbedtls_ecdsa_restart_ctx *rs_ctx)
This function computes the ECDSA signature and writes it to a buffer, in a restartable way.
int mbedtls_ecdsa_verify(mbedtls_ecp_group *grp, const unsigned char *buf, size_t blen, const mbedtls_ecp_point *Q, const mbedtls_mpi *r, const mbedtls_mpi *s)
This function verifies the ECDSA signature of a previously-hashed message.
int mbedtls_ecdsa_sign_det_ext(mbedtls_ecp_group *grp, mbedtls_mpi *r, mbedtls_mpi *s, const mbedtls_mpi *d, const unsigned char *buf, size_t blen, mbedtls_md_type_t md_alg, int(*f_rng_blind)(void *, unsigned char *, size_t), void *p_rng_blind)
This function computes the ECDSA signature of a previously-hashed message, deterministic version.
void mbedtls_ecdsa_free(mbedtls_ecdsa_context *ctx)
This function frees an ECDSA context.
int mbedtls_ecdsa_write_signature_det(mbedtls_ecdsa_context *ctx, const unsigned char *hash, size_t hlen, unsigned char *sig, size_t *slen, mbedtls_md_type_t md_alg) MBEDTLS_DEPRECATED
This function computes an ECDSA signature and writes it to a buffer, serialized as defined in RFC-449...
int mbedtls_ecdsa_sign_det(mbedtls_ecp_group *grp, mbedtls_mpi *r, mbedtls_mpi *s, const mbedtls_mpi *d, const unsigned char *buf, size_t blen, mbedtls_md_type_t md_alg) MBEDTLS_DEPRECATED
This function computes the ECDSA signature of a previously-hashed message, deterministic version.
int mbedtls_ecdsa_from_keypair(mbedtls_ecdsa_context *ctx, const mbedtls_ecp_keypair *key)
This function sets up an ECDSA context from an EC key pair.
int mbedtls_ecdsa_write_signature(mbedtls_ecdsa_context *ctx, mbedtls_md_type_t md_alg, const unsigned char *hash, size_t hlen, unsigned char *sig, size_t *slen, int(*f_rng)(void *, unsigned char *, size_t), void *p_rng)
This function computes the ECDSA signature and writes it to a buffer, serialized as defined in RFC-44...
int mbedtls_ecdsa_read_signature_restartable(mbedtls_ecdsa_context *ctx, const unsigned char *hash, size_t hlen, const unsigned char *sig, size_t slen, mbedtls_ecdsa_restart_ctx *rs_ctx)
This function reads and verifies an ECDSA signature, in a restartable way.
int mbedtls_ecdsa_read_signature(mbedtls_ecdsa_context *ctx, const unsigned char *hash, size_t hlen, const unsigned char *sig, size_t slen)
This function reads and verifies an ECDSA signature.
mbedtls_ecp_keypair mbedtls_ecdsa_context
The ECDSA context structure.
Definition ecdsa.h:66
#define MBEDTLS_DEPRECATED
Definition ecdsa.h:168
int mbedtls_ecdsa_genkey(mbedtls_ecdsa_context *ctx, mbedtls_ecp_group_id gid, int(*f_rng)(void *, unsigned char *, size_t), void *p_rng)
This function generates an ECDSA keypair on the given curve.
int mbedtls_ecdsa_can_do(mbedtls_ecp_group_id gid)
This function checks whether a given group can be used for ECDSA.
void mbedtls_ecdsa_restart_ctx
Definition ecdsa.h:109
void mbedtls_ecdsa_init(mbedtls_ecdsa_context *ctx)
This function initializes an ECDSA context.
int mbedtls_ecdsa_sign(mbedtls_ecp_group *grp, mbedtls_mpi *r, mbedtls_mpi *s, const mbedtls_mpi *d, const unsigned char *buf, size_t blen, int(*f_rng)(void *, unsigned char *, size_t), void *p_rng)
This function computes the ECDSA signature of a previously-hashed message.
This file provides an API for Elliptic Curves over GF(P) (ECP).
void mbedtls_ecp_restart_ctx
Definition ecp.h:431
mbedtls_ecp_group_id
Definition ecp.h:113
This file contains the generic message-digest wrapper.
mbedtls_md_type_t
Supported message digests.
Definition md.h:50
The ECP group structure.
Definition ecp.h:270
The ECP key-pair structure.
Definition ecp.h:443
The ECP point structure, in Jacobian coordinates.
Definition ecp.h:167
MPI structure.
Definition bignum.h:196