x509_crt.h

Go to the documentation of this file.

#ifndef MBEDTLS_X509_CRT_H
#define MBEDTLS_X509_CRT_H

#if !defined(MBEDTLS_CONFIG_FILE)
#include "config.h"
#else
#include MBEDTLS_CONFIG_FILE
#endif

#include "x509.h"
#include "x509_crl.h"

#ifdef __cplusplus
extern "C" {
#endif

typedef struct mbedtls_x509_crt
{
 mbedtls_x509_buf raw; 
 mbedtls_x509_buf tbs; 
 int version; 
 mbedtls_x509_buf serial; 
 mbedtls_x509_buf sig_oid; 
 mbedtls_x509_buf issuer_raw; 
 mbedtls_x509_buf subject_raw; 
 mbedtls_x509_name issuer; 
 mbedtls_x509_name subject; 
 mbedtls_x509_time valid_from; 
 mbedtls_x509_time valid_to; 
 mbedtls_pk_context pk; 
 mbedtls_x509_buf issuer_id; 
 mbedtls_x509_buf subject_id; 
 mbedtls_x509_buf v3_ext; 
 mbedtls_x509_sequence subject_alt_names; 
 int ext_types; 
 int ca_istrue; 
 int max_pathlen; 
 unsigned int key_usage; 
 mbedtls_x509_sequence ext_key_usage; 
 unsigned char ns_cert_type; 
 mbedtls_x509_buf sig; 
 mbedtls_md_type_t sig_md; 
 mbedtls_pk_type_t sig_pk; 
 void *sig_opts; 
 struct mbedtls_x509_crt *next; 
}
mbedtls_x509_crt;

#define MBEDTLS_X509_ID_FLAG( id ) ( 1 << ( id - 1 ) )

typedef struct
{
 uint32_t allowed_mds; 
 uint32_t allowed_pks; 
 uint32_t allowed_curves; 
 uint32_t rsa_min_bitlen; 
}
mbedtls_x509_crt_profile;

#define MBEDTLS_X509_CRT_VERSION_1 0
#define MBEDTLS_X509_CRT_VERSION_2 1
#define MBEDTLS_X509_CRT_VERSION_3 2

#define MBEDTLS_X509_RFC5280_MAX_SERIAL_LEN 32
#define MBEDTLS_X509_RFC5280_UTC_TIME_LEN 15

#if !defined( MBEDTLS_X509_MAX_FILE_PATH_LEN )
#define MBEDTLS_X509_MAX_FILE_PATH_LEN 512
#endif

typedef struct mbedtls_x509write_cert
{
 int version;
 mbedtls_mpi serial;
 mbedtls_pk_context *subject_key;
 mbedtls_pk_context *issuer_key;
 mbedtls_asn1_named_data *subject;
 mbedtls_asn1_named_data *issuer;
 mbedtls_md_type_t md_alg;
 char not_before[MBEDTLS_X509_RFC5280_UTC_TIME_LEN + 1];
 char not_after[MBEDTLS_X509_RFC5280_UTC_TIME_LEN + 1];
 mbedtls_asn1_named_data *extensions;
}
mbedtls_x509write_cert;

#if defined(MBEDTLS_X509_CRT_PARSE_C)

extern const mbedtls_x509_crt_profile mbedtls_x509_crt_profile_default;

extern const mbedtls_x509_crt_profile mbedtls_x509_crt_profile_next;

extern const mbedtls_x509_crt_profile mbedtls_x509_crt_profile_suiteb;

int mbedtls_x509_crt_parse_der( mbedtls_x509_crt *chain, const unsigned char *buf,
 size_t buflen );

int mbedtls_x509_crt_parse( mbedtls_x509_crt *chain, const unsigned char *buf, size_t buflen );

#if defined(MBEDTLS_FS_IO)

int mbedtls_x509_crt_parse_file( mbedtls_x509_crt *chain, const char *path );

int mbedtls_x509_crt_parse_path( mbedtls_x509_crt *chain, const char *path );
#endif /* MBEDTLS_FS_IO */

int mbedtls_x509_crt_info( char *buf, size_t size, const char *prefix,
 const mbedtls_x509_crt *crt );

int mbedtls_x509_crt_verify_info( char *buf, size_t size, const char *prefix,
 uint32_t flags );

int mbedtls_x509_crt_verify( mbedtls_x509_crt *crt,
 mbedtls_x509_crt *trust_ca,
 mbedtls_x509_crl *ca_crl,
 const char *cn, uint32_t *flags,
 int (*f_vrfy)(void *, mbedtls_x509_crt *, int, uint32_t *),
 void *p_vrfy );

int mbedtls_x509_crt_verify_with_profile( mbedtls_x509_crt *crt,
 mbedtls_x509_crt *trust_ca,
 mbedtls_x509_crl *ca_crl,
 const mbedtls_x509_crt_profile *profile,
 const char *cn, uint32_t *flags,
 int (*f_vrfy)(void *, mbedtls_x509_crt *, int, uint32_t *),
 void *p_vrfy );

#if defined(MBEDTLS_X509_CHECK_KEY_USAGE)

int mbedtls_x509_crt_check_key_usage( const mbedtls_x509_crt *crt,
 unsigned int usage );
#endif /* MBEDTLS_X509_CHECK_KEY_USAGE) */

#if defined(MBEDTLS_X509_CHECK_EXTENDED_KEY_USAGE)

int mbedtls_x509_crt_check_extended_key_usage( const mbedtls_x509_crt *crt,
 const char *usage_oid,
 size_t usage_len );
#endif /* MBEDTLS_X509_CHECK_EXTENDED_KEY_USAGE) */

#if defined(MBEDTLS_X509_CRL_PARSE_C)

int mbedtls_x509_crt_is_revoked( const mbedtls_x509_crt *crt, const mbedtls_x509_crl *crl );
#endif /* MBEDTLS_X509_CRL_PARSE_C */

void mbedtls_x509_crt_init( mbedtls_x509_crt *crt );

void mbedtls_x509_crt_free( mbedtls_x509_crt *crt );
#endif /* MBEDTLS_X509_CRT_PARSE_C */

/* \} name */
/* \} addtogroup x509_module */

#if defined(MBEDTLS_X509_CRT_WRITE_C)

void mbedtls_x509write_crt_init( mbedtls_x509write_cert *ctx );

void mbedtls_x509write_crt_set_version( mbedtls_x509write_cert *ctx, int version );

int mbedtls_x509write_crt_set_serial( mbedtls_x509write_cert *ctx, const mbedtls_mpi *serial );

int mbedtls_x509write_crt_set_validity( mbedtls_x509write_cert *ctx, const char *not_before,
 const char *not_after );

int mbedtls_x509write_crt_set_issuer_name( mbedtls_x509write_cert *ctx,
 const char *issuer_name );

int mbedtls_x509write_crt_set_subject_name( mbedtls_x509write_cert *ctx,
 const char *subject_name );

void mbedtls_x509write_crt_set_subject_key( mbedtls_x509write_cert *ctx, mbedtls_pk_context *key );

void mbedtls_x509write_crt_set_issuer_key( mbedtls_x509write_cert *ctx, mbedtls_pk_context *key );

void mbedtls_x509write_crt_set_md_alg( mbedtls_x509write_cert *ctx, mbedtls_md_type_t md_alg );

int mbedtls_x509write_crt_set_extension( mbedtls_x509write_cert *ctx,
 const char *oid, size_t oid_len,
 int critical,
 const unsigned char *val, size_t val_len );

int mbedtls_x509write_crt_set_basic_constraints( mbedtls_x509write_cert *ctx,
 int is_ca, int max_pathlen );

#if defined(MBEDTLS_SHA1_C)

int mbedtls_x509write_crt_set_subject_key_identifier( mbedtls_x509write_cert *ctx );

int mbedtls_x509write_crt_set_authority_key_identifier( mbedtls_x509write_cert *ctx );
#endif /* MBEDTLS_SHA1_C */

int mbedtls_x509write_crt_set_key_usage( mbedtls_x509write_cert *ctx,
 unsigned int key_usage );

int mbedtls_x509write_crt_set_ns_cert_type( mbedtls_x509write_cert *ctx,
 unsigned char ns_cert_type );

void mbedtls_x509write_crt_free( mbedtls_x509write_cert *ctx );

int mbedtls_x509write_crt_der( mbedtls_x509write_cert *ctx, unsigned char *buf, size_t size,
 int (*f_rng)(void *, unsigned char *, size_t),
 void *p_rng );

#if defined(MBEDTLS_PEM_WRITE_C)

int mbedtls_x509write_crt_pem( mbedtls_x509write_cert *ctx, unsigned char *buf, size_t size,
 int (*f_rng)(void *, unsigned char *, size_t),
 void *p_rng );
#endif /* MBEDTLS_PEM_WRITE_C */
#endif /* MBEDTLS_X509_CRT_WRITE_C */

#ifdef __cplusplus
}
#endif

#endif /* mbedtls_x509_crt.h */