include/openssl/x509.h.in

   1 /*
   2  * {- join("\n * ", @autowarntext) -}
   3  *
   4  * Copyright 1995-2023 The OpenSSL Project Authors. All Rights Reserved.
   5  * Copyright (c) 2002, Oracle and/or its affiliates. All rights reserved
   6  *
   7  * Licensed under the Apache License 2.0 (the "License").  You may not use
   8  * this file except in compliance with the License.  You can obtain a copy
   9  * in the file LICENSE in the source distribution or at
  10  * https://www.openssl.org/source/license.html
  11  */
  12
  13 {-
  14 use OpenSSL::stackhash qw(generate_stack_macros);
  15 -}
  16
  17 #ifndef OPENSSL_X509_H
  18 # define OPENSSL_X509_H
  19 # pragma once
  20
  21 # include <openssl/macros.h>
  22 # ifndef OPENSSL_NO_DEPRECATED_3_0
  23 #  define HEADER_X509_H
  24 # endif
  25
  26 # include <openssl/e_os2.h>
  27 # include <openssl/types.h>
  28 # include <openssl/symhacks.h>
  29 # include <openssl/buffer.h>
  30 # include <openssl/evp.h>
  31 # include <openssl/bio.h>
  32 # include <openssl/asn1.h>
  33 # include <openssl/safestack.h>
  34 # include <openssl/ec.h>
  35
  36 # ifndef OPENSSL_NO_DEPRECATED_1_1_0
  37 #  include <openssl/rsa.h>
  38 #  include <openssl/dsa.h>
  39 #  include <openssl/dh.h>
  40 # endif
  41
  42 # include <openssl/sha.h>
  43 # include <openssl/x509err.h>
  44 # ifndef OPENSSL_NO_STDIO
  45 #  include <stdio.h>
  46 # endif
  47
  48 #ifdef  __cplusplus
  49 extern "C" {
  50 #endif
  51
  52 /* Needed stacks for types defined in other headers */
  53 {-
  54     generate_stack_macros("X509_NAME")
  55     .generate_stack_macros("X509")
  56     .generate_stack_macros("X509_REVOKED")
  57     .generate_stack_macros("X509_CRL");
  58 -}
  59
  60 /* Flags for X509_get_signature_info() */
  61 /* Signature info is valid */
  62 # define X509_SIG_INFO_VALID     0x1
  63 /* Signature is suitable for TLS use */
  64 # define X509_SIG_INFO_TLS       0x2
  65
  66 # define X509_FILETYPE_PEM       1
  67 # define X509_FILETYPE_ASN1      2
  68 # define X509_FILETYPE_DEFAULT   3
  69
  70 /*-
  71  * <https://datatracker.ietf.org/doc/html/rfc5280#section-4.2.1.3>:
  72  * The KeyUsage BITSTRING is treated as a little-endian integer, hence bit `0`
  73  * is 0x80, while bit `7` is 0x01 (the LSB of the integer value), bit `8` is
  74  * then the MSB of the second octet, or 0x8000.
  75  */
  76 # define X509v3_KU_DIGITAL_SIGNATURE     0x0080     /* (0) */
  77 # define X509v3_KU_NON_REPUDIATION       0x0040     /* (1) */
  78 # define X509v3_KU_KEY_ENCIPHERMENT      0x0020     /* (2) */
  79 # define X509v3_KU_DATA_ENCIPHERMENT     0x0010     /* (3) */
  80 # define X509v3_KU_KEY_AGREEMENT         0x0008     /* (4) */
  81 # define X509v3_KU_KEY_CERT_SIGN         0x0004     /* (5) */
  82 # define X509v3_KU_CRL_SIGN              0x0002     /* (6) */
  83 # define X509v3_KU_ENCIPHER_ONLY         0x0001     /* (7) */
  84 # define X509v3_KU_DECIPHER_ONLY         0x8000     /* (8) */
  85 # ifndef OPENSSL_NO_DEPRECATED_3_4
  86 #  define X509v3_KU_UNDEF                0xffff     /* vestigial, not used */
  87 # endif
  88
  89 struct X509_algor_st {
  90     ASN1_OBJECT *algorithm;
  91     ASN1_TYPE *parameter;
  92 } /* X509_ALGOR */ ;
  93
  94 typedef STACK_OF(X509_ALGOR) X509_ALGORS;
  95
  96 typedef struct X509_val_st {
  97     ASN1_TIME *notBefore;
  98     ASN1_TIME *notAfter;
  99 } X509_VAL;
 100
 101 typedef struct X509_sig_st X509_SIG;
 102
 103 typedef struct X509_name_entry_st X509_NAME_ENTRY;
 104
 105 {-
 106     generate_stack_macros("X509_NAME_ENTRY");
 107 -}
 108
 109 # define X509_EX_V_NETSCAPE_HACK         0x8000
 110 # define X509_EX_V_INIT                  0x0001
 111 typedef struct X509_extension_st X509_EXTENSION;
 112 {-
 113     generate_stack_macros("X509_EXTENSION");
 114 -}
 115 typedef STACK_OF(X509_EXTENSION) X509_EXTENSIONS;
 116 typedef struct x509_attributes_st X509_ATTRIBUTE;
 117 {-
 118     generate_stack_macros("X509_ATTRIBUTE");
 119 -}
 120 typedef struct X509_req_info_st X509_REQ_INFO;
 121 typedef struct X509_req_st X509_REQ;
 122 typedef struct x509_cert_aux_st X509_CERT_AUX;
 123 typedef struct x509_cinf_st X509_CINF;
 124
 125 /* Flags for X509_print_ex() */
 126
 127 # define X509_FLAG_COMPAT                0
 128 # define X509_FLAG_NO_HEADER             1L
 129 # define X509_FLAG_NO_VERSION            (1L << 1)
 130 # define X509_FLAG_NO_SERIAL             (1L << 2)
 131 # define X509_FLAG_NO_SIGNAME            (1L << 3)
 132 # define X509_FLAG_NO_ISSUER             (1L << 4)
 133 # define X509_FLAG_NO_VALIDITY           (1L << 5)
 134 # define X509_FLAG_NO_SUBJECT            (1L << 6)
 135 # define X509_FLAG_NO_PUBKEY             (1L << 7)
 136 # define X509_FLAG_NO_EXTENSIONS         (1L << 8)
 137 # define X509_FLAG_NO_SIGDUMP            (1L << 9)
 138 # define X509_FLAG_NO_AUX                (1L << 10)
 139 # define X509_FLAG_NO_ATTRIBUTES         (1L << 11)
 140 # define X509_FLAG_NO_IDS                (1L << 12)
 141 # define X509_FLAG_EXTENSIONS_ONLY_KID   (1L << 13)
 142
 143 /* Flags specific to X509_NAME_print_ex() */
 144
 145 /* The field separator information */
 146
 147 # define XN_FLAG_SEP_MASK        (0xf << 16)
 148
 149 # define XN_FLAG_COMPAT          0/* Traditional; use old X509_NAME_print */
 150 # define XN_FLAG_SEP_COMMA_PLUS  (1 << 16)/* RFC2253 ,+ */
 151 # define XN_FLAG_SEP_CPLUS_SPC   (2 << 16)/* ,+ spaced: more readable */
 152 # define XN_FLAG_SEP_SPLUS_SPC   (3 << 16)/* ;+ spaced */
 153 # define XN_FLAG_SEP_MULTILINE   (4 << 16)/* One line per field */
 154
 155 # define XN_FLAG_DN_REV          (1 << 20)/* Reverse DN order */
 156
 157 /* How the field name is shown */
 158
 159 # define XN_FLAG_FN_MASK         (0x3 << 21)
 160
 161 # define XN_FLAG_FN_SN           0/* Object short name */
 162 # define XN_FLAG_FN_LN           (1 << 21)/* Object long name */
 163 # define XN_FLAG_FN_OID          (2 << 21)/* Always use OIDs */
 164 # define XN_FLAG_FN_NONE         (3 << 21)/* No field names */
 165
 166 # define XN_FLAG_SPC_EQ          (1 << 23)/* Put spaces round '=' */
 167
 168 /*
 169  * This determines if we dump fields we don't recognise: RFC2253 requires
 170  * this.
 171  */
 172
 173 # define XN_FLAG_DUMP_UNKNOWN_FIELDS (1 << 24)
 174
 175 # define XN_FLAG_FN_ALIGN        (1 << 25)/* Align field names to 20
 176                                            * characters */
 177
 178 /* Complete set of RFC2253 flags */
 179
 180 # define XN_FLAG_RFC2253 (ASN1_STRFLGS_RFC2253 | \
 181                         XN_FLAG_SEP_COMMA_PLUS | \
 182                         XN_FLAG_DN_REV | \
 183                         XN_FLAG_FN_SN | \
 184                         XN_FLAG_DUMP_UNKNOWN_FIELDS)
 185
 186 /* readable oneline form */
 187
 188 # define XN_FLAG_ONELINE (ASN1_STRFLGS_RFC2253 | \
 189                         ASN1_STRFLGS_ESC_QUOTE | \
 190                         XN_FLAG_SEP_CPLUS_SPC | \
 191                         XN_FLAG_SPC_EQ | \
 192                         XN_FLAG_FN_SN)
 193
 194 /* readable multiline form */
 195
 196 # define XN_FLAG_MULTILINE (ASN1_STRFLGS_ESC_CTRL | \
 197                         ASN1_STRFLGS_ESC_MSB | \
 198                         XN_FLAG_SEP_MULTILINE | \
 199                         XN_FLAG_SPC_EQ | \
 200                         XN_FLAG_FN_LN | \
 201                         XN_FLAG_FN_ALIGN)
 202
 203 typedef struct X509_crl_info_st X509_CRL_INFO;
 204
 205 typedef struct private_key_st {
 206     int version;
 207     /* The PKCS#8 data types */
 208     X509_ALGOR *enc_algor;
 209     ASN1_OCTET_STRING *enc_pkey; /* encrypted pub key */
 210     /* When decrypted, the following will not be NULL */
 211     EVP_PKEY *dec_pkey;
 212     /* used to encrypt and decrypt */
 213     int key_length;
 214     char *key_data;
 215     int key_free;               /* true if we should auto free key_data */
 216     /* expanded version of 'enc_algor' */
 217     EVP_CIPHER_INFO cipher;
 218 } X509_PKEY;
 219
 220 typedef struct X509_info_st {
 221     X509 *x509;
 222     X509_CRL *crl;
 223     X509_PKEY *x_pkey;
 224     EVP_CIPHER_INFO enc_cipher;
 225     int enc_len;
 226     char *enc_data;
 227 } X509_INFO;
 228 {-
 229     generate_stack_macros("X509_INFO");
 230 -}
 231
 232 /*
 233  * The next 2 structures and their 8 routines are used to manipulate Netscape's
 234  * spki structures - useful if you are writing a CA web page
 235  */
 236 typedef struct Netscape_spkac_st {
 237     X509_PUBKEY *pubkey;
 238     ASN1_IA5STRING *challenge;  /* challenge sent in atlas >= PR2 */
 239 } NETSCAPE_SPKAC;
 240
 241 typedef struct Netscape_spki_st {
 242     NETSCAPE_SPKAC *spkac;      /* signed public key and challenge */
 243     X509_ALGOR sig_algor;
 244     ASN1_BIT_STRING *signature;
 245 } NETSCAPE_SPKI;
 246
 247 /* Netscape certificate sequence structure */
 248 typedef struct Netscape_certificate_sequence {
 249     ASN1_OBJECT *type;
 250     STACK_OF(X509) *certs;
 251 } NETSCAPE_CERT_SEQUENCE;
 252
 253 /*- Unused (and iv length is wrong)
 254 typedef struct CBCParameter_st
 255         {
 256         unsigned char iv[8];
 257         } CBC_PARAM;
 258 */
 259
 260 /* Password based encryption structure */
 261
 262 typedef struct PBEPARAM_st {
 263     ASN1_OCTET_STRING *salt;
 264     ASN1_INTEGER *iter;
 265 } PBEPARAM;
 266
 267 /* Password based encryption V2 structures */
 268
 269 typedef struct PBE2PARAM_st {
 270     X509_ALGOR *keyfunc;
 271     X509_ALGOR *encryption;
 272 } PBE2PARAM;
 273
 274 typedef struct PBKDF2PARAM_st {
 275 /* Usually OCTET STRING but could be anything */
 276     ASN1_TYPE *salt;
 277     ASN1_INTEGER *iter;
 278     ASN1_INTEGER *keylength;
 279     X509_ALGOR *prf;
 280 } PBKDF2PARAM;
 281
 282 #ifndef OPENSSL_NO_SCRYPT
 283 typedef struct SCRYPT_PARAMS_st {
 284     ASN1_OCTET_STRING *salt;
 285     ASN1_INTEGER *costParameter;
 286     ASN1_INTEGER *blockSize;
 287     ASN1_INTEGER *parallelizationParameter;
 288     ASN1_INTEGER *keyLength;
 289 } SCRYPT_PARAMS;
 290 #endif
 291
 292 #ifdef  __cplusplus
 293 }
 294 #endif
 295
 296 # include <openssl/x509_vfy.h>
 297 # include <openssl/pkcs7.h>
 298
 299 #ifdef  __cplusplus
 300 extern "C" {
 301 #endif
 302
 303 # define X509_EXT_PACK_UNKNOWN   1
 304 # define X509_EXT_PACK_STRING    2
 305
 306 # define         X509_extract_key(x)     X509_get_pubkey(x)/*****/
 307 # define         X509_REQ_extract_key(a) X509_REQ_get_pubkey(a)
 308 # define         X509_name_cmp(a,b)      X509_NAME_cmp((a),(b))
 309
 310 void X509_CRL_set_default_method(const X509_CRL_METHOD *meth);
 311 X509_CRL_METHOD *X509_CRL_METHOD_new(int (*crl_init) (X509_CRL *crl),
 312                                      int (*crl_free) (X509_CRL *crl),
 313                                      int (*crl_lookup) (X509_CRL *crl,
 314                                                         X509_REVOKED **ret,
 315                                                         const
 316                                                         ASN1_INTEGER *serial,
 317                                                         const
 318                                                         X509_NAME *issuer),
 319                                      int (*crl_verify) (X509_CRL *crl,
 320                                                         EVP_PKEY *pk));
 321 void X509_CRL_METHOD_free(X509_CRL_METHOD *m);
 322
 323 void X509_CRL_set_meth_data(X509_CRL *crl, void *dat);
 324 void *X509_CRL_get_meth_data(X509_CRL *crl);
 325
 326 const char *X509_verify_cert_error_string(long n);
 327
 328 int X509_verify(X509 *a, EVP_PKEY *r);
 329 int X509_self_signed(X509 *cert, int verify_signature);
 330
 331 int X509_REQ_verify_ex(X509_REQ *a, EVP_PKEY *r, OSSL_LIB_CTX *libctx,
 332                        const char *propq);
 333 int X509_REQ_verify(X509_REQ *a, EVP_PKEY *r);
 334 int X509_CRL_verify(X509_CRL *a, EVP_PKEY *r);
 335 int NETSCAPE_SPKI_verify(NETSCAPE_SPKI *a, EVP_PKEY *r);
 336
 337 NETSCAPE_SPKI *NETSCAPE_SPKI_b64_decode(const char *str, int len);
 338 char *NETSCAPE_SPKI_b64_encode(NETSCAPE_SPKI *x);
 339 EVP_PKEY *NETSCAPE_SPKI_get_pubkey(NETSCAPE_SPKI *x);
 340 int NETSCAPE_SPKI_set_pubkey(NETSCAPE_SPKI *x, EVP_PKEY *pkey);
 341
 342 int NETSCAPE_SPKI_print(BIO *out, NETSCAPE_SPKI *spki);
 343
 344 int X509_signature_dump(BIO *bp, const ASN1_STRING *sig, int indent);
 345 int X509_signature_print(BIO *bp, const X509_ALGOR *alg,
 346                          const ASN1_STRING *sig);
 347
 348 int X509_sign(X509 *x, EVP_PKEY *pkey, const EVP_MD *md);
 349 int X509_sign_ctx(X509 *x, EVP_MD_CTX *ctx);
 350 int X509_REQ_sign(X509_REQ *x, EVP_PKEY *pkey, const EVP_MD *md);
 351 int X509_REQ_sign_ctx(X509_REQ *x, EVP_MD_CTX *ctx);
 352 int X509_CRL_sign(X509_CRL *x, EVP_PKEY *pkey, const EVP_MD *md);
 353 int X509_CRL_sign_ctx(X509_CRL *x, EVP_MD_CTX *ctx);
 354 int NETSCAPE_SPKI_sign(NETSCAPE_SPKI *x, EVP_PKEY *pkey, const EVP_MD *md);
 355
 356 int X509_pubkey_digest(const X509 *data, const EVP_MD *type,
 357                        unsigned char *md, unsigned int *len);
 358 int X509_digest(const X509 *data, const EVP_MD *type,
 359                 unsigned char *md, unsigned int *len);
 360 ASN1_OCTET_STRING *X509_digest_sig(const X509 *cert,
 361                                    EVP_MD **md_used, int *md_is_fallback);
 362 int X509_CRL_digest(const X509_CRL *data, const EVP_MD *type,
 363                     unsigned char *md, unsigned int *len);
 364 int X509_REQ_digest(const X509_REQ *data, const EVP_MD *type,
 365                     unsigned char *md, unsigned int *len);
 366 int X509_NAME_digest(const X509_NAME *data, const EVP_MD *type,
 367                      unsigned char *md, unsigned int *len);
 368
 369 X509 *X509_load_http(const char *url, BIO *bio, BIO *rbio, int timeout);
 370 X509_CRL *X509_CRL_load_http(const char *url, BIO *bio, BIO *rbio, int timeout);
 371 # ifndef OPENSSL_NO_DEPRECATED_3_0
 372 #  include <openssl/http.h> /* OSSL_HTTP_REQ_CTX_nbio_d2i */
 373 #  define X509_http_nbio(rctx, pcert) \
 374       OSSL_HTTP_REQ_CTX_nbio_d2i(rctx, pcert, ASN1_ITEM_rptr(X509))
 375 #  define X509_CRL_http_nbio(rctx, pcrl) \
 376       OSSL_HTTP_REQ_CTX_nbio_d2i(rctx, pcrl, ASN1_ITEM_rptr(X509_CRL))
 377 # endif
 378
 379 # ifndef OPENSSL_NO_STDIO
 380 X509 *d2i_X509_fp(FILE *fp, X509 **x509);
 381 int i2d_X509_fp(FILE *fp, const X509 *x509);
 382 X509_CRL *d2i_X509_CRL_fp(FILE *fp, X509_CRL **crl);
 383 int i2d_X509_CRL_fp(FILE *fp, const X509_CRL *crl);
 384 X509_REQ *d2i_X509_REQ_fp(FILE *fp, X509_REQ **req);
 385 int i2d_X509_REQ_fp(FILE *fp, const X509_REQ *req);
 386 #  ifndef OPENSSL_NO_DEPRECATED_3_0
 387 OSSL_DEPRECATEDIN_3_0 RSA *d2i_RSAPrivateKey_fp(FILE *fp, RSA **rsa);
 388 OSSL_DEPRECATEDIN_3_0 int i2d_RSAPrivateKey_fp(FILE *fp, const RSA *rsa);
 389 OSSL_DEPRECATEDIN_3_0 RSA *d2i_RSAPublicKey_fp(FILE *fp, RSA **rsa);
 390 OSSL_DEPRECATEDIN_3_0 int i2d_RSAPublicKey_fp(FILE *fp, const RSA *rsa);
 391 OSSL_DEPRECATEDIN_3_0 RSA *d2i_RSA_PUBKEY_fp(FILE *fp, RSA **rsa);
 392 OSSL_DEPRECATEDIN_3_0 int i2d_RSA_PUBKEY_fp(FILE *fp, const RSA *rsa);
 393 #  endif
 394 #  ifndef OPENSSL_NO_DEPRECATED_3_0
 395 #   ifndef OPENSSL_NO_DSA
 396 OSSL_DEPRECATEDIN_3_0 DSA *d2i_DSA_PUBKEY_fp(FILE *fp, DSA **dsa);
 397 OSSL_DEPRECATEDIN_3_0 int i2d_DSA_PUBKEY_fp(FILE *fp, const DSA *dsa);
 398 OSSL_DEPRECATEDIN_3_0 DSA *d2i_DSAPrivateKey_fp(FILE *fp, DSA **dsa);
 399 OSSL_DEPRECATEDIN_3_0 int i2d_DSAPrivateKey_fp(FILE *fp, const DSA *dsa);
 400 #   endif
 401 #  endif
 402 #  ifndef OPENSSL_NO_DEPRECATED_3_0
 403 #   ifndef OPENSSL_NO_EC
 404 OSSL_DEPRECATEDIN_3_0 EC_KEY *d2i_EC_PUBKEY_fp(FILE *fp, EC_KEY **eckey);
 405 OSSL_DEPRECATEDIN_3_0 int i2d_EC_PUBKEY_fp(FILE *fp, const EC_KEY *eckey);
 406 OSSL_DEPRECATEDIN_3_0 EC_KEY *d2i_ECPrivateKey_fp(FILE *fp, EC_KEY **eckey);
 407 OSSL_DEPRECATEDIN_3_0 int i2d_ECPrivateKey_fp(FILE *fp, const EC_KEY *eckey);
 408 #   endif /* OPENSSL_NO_EC */
 409 #  endif /* OPENSSL_NO_DEPRECATED_3_0 */
 410 X509_SIG *d2i_PKCS8_fp(FILE *fp, X509_SIG **p8);
 411 int i2d_PKCS8_fp(FILE *fp, const X509_SIG *p8);
 412 X509_PUBKEY *d2i_X509_PUBKEY_fp(FILE *fp, X509_PUBKEY **xpk);
 413 int i2d_X509_PUBKEY_fp(FILE *fp, const X509_PUBKEY *xpk);
 414 PKCS8_PRIV_KEY_INFO *d2i_PKCS8_PRIV_KEY_INFO_fp(FILE *fp,
 415                                                 PKCS8_PRIV_KEY_INFO **p8inf);
 416 int i2d_PKCS8_PRIV_KEY_INFO_fp(FILE *fp, const PKCS8_PRIV_KEY_INFO *p8inf);
 417 int i2d_PKCS8PrivateKeyInfo_fp(FILE *fp, const EVP_PKEY *key);
 418 int i2d_PrivateKey_fp(FILE *fp, const EVP_PKEY *pkey);
 419 EVP_PKEY *d2i_PrivateKey_ex_fp(FILE *fp, EVP_PKEY **a, OSSL_LIB_CTX *libctx,
 420                                const char *propq);
 421 EVP_PKEY *d2i_PrivateKey_fp(FILE *fp, EVP_PKEY **a);
 422 int i2d_PUBKEY_fp(FILE *fp, const EVP_PKEY *pkey);
 423 EVP_PKEY *d2i_PUBKEY_ex_fp(FILE *fp, EVP_PKEY **a, OSSL_LIB_CTX *libctx,
 424                            const char *propq);
 425 EVP_PKEY *d2i_PUBKEY_fp(FILE *fp, EVP_PKEY **a);
 426 # endif
 427
 428 X509 *d2i_X509_bio(BIO *bp, X509 **x509);
 429 int i2d_X509_bio(BIO *bp, const X509 *x509);
 430 X509_CRL *d2i_X509_CRL_bio(BIO *bp, X509_CRL **crl);
 431 int i2d_X509_CRL_bio(BIO *bp, const X509_CRL *crl);
 432 X509_REQ *d2i_X509_REQ_bio(BIO *bp, X509_REQ **req);
 433 int i2d_X509_REQ_bio(BIO *bp, const X509_REQ *req);
 434 #  ifndef OPENSSL_NO_DEPRECATED_3_0
 435 OSSL_DEPRECATEDIN_3_0 RSA *d2i_RSAPrivateKey_bio(BIO *bp, RSA **rsa);
 436 OSSL_DEPRECATEDIN_3_0 int i2d_RSAPrivateKey_bio(BIO *bp, const RSA *rsa);
 437 OSSL_DEPRECATEDIN_3_0 RSA *d2i_RSAPublicKey_bio(BIO *bp, RSA **rsa);
 438 OSSL_DEPRECATEDIN_3_0 int i2d_RSAPublicKey_bio(BIO *bp, const RSA *rsa);
 439 OSSL_DEPRECATEDIN_3_0 RSA *d2i_RSA_PUBKEY_bio(BIO *bp, RSA **rsa);
 440 OSSL_DEPRECATEDIN_3_0 int i2d_RSA_PUBKEY_bio(BIO *bp, const RSA *rsa);
 441 #  endif
 442 #  ifndef OPENSSL_NO_DEPRECATED_3_0
 443 #   ifndef OPENSSL_NO_DSA
 444 OSSL_DEPRECATEDIN_3_0 DSA *d2i_DSA_PUBKEY_bio(BIO *bp, DSA **dsa);
 445 OSSL_DEPRECATEDIN_3_0 int i2d_DSA_PUBKEY_bio(BIO *bp, const DSA *dsa);
 446 OSSL_DEPRECATEDIN_3_0 DSA *d2i_DSAPrivateKey_bio(BIO *bp, DSA **dsa);
 447 OSSL_DEPRECATEDIN_3_0 int i2d_DSAPrivateKey_bio(BIO *bp, const DSA *dsa);
 448 #   endif
 449 #  endif
 450
 451 #  ifndef OPENSSL_NO_DEPRECATED_3_0
 452 #   ifndef OPENSSL_NO_EC
 453 OSSL_DEPRECATEDIN_3_0 EC_KEY *d2i_EC_PUBKEY_bio(BIO *bp, EC_KEY **eckey);
 454 OSSL_DEPRECATEDIN_3_0 int i2d_EC_PUBKEY_bio(BIO *bp, const EC_KEY *eckey);
 455 OSSL_DEPRECATEDIN_3_0 EC_KEY *d2i_ECPrivateKey_bio(BIO *bp, EC_KEY **eckey);
 456 OSSL_DEPRECATEDIN_3_0 int i2d_ECPrivateKey_bio(BIO *bp, const EC_KEY *eckey);
 457 #   endif /* OPENSSL_NO_EC */
 458 #  endif /* OPENSSL_NO_DEPRECATED_3_0 */
 459
 460 X509_SIG *d2i_PKCS8_bio(BIO *bp, X509_SIG **p8);
 461 int i2d_PKCS8_bio(BIO *bp, const X509_SIG *p8);
 462 X509_PUBKEY *d2i_X509_PUBKEY_bio(BIO *bp, X509_PUBKEY **xpk);
 463 int i2d_X509_PUBKEY_bio(BIO *bp, const X509_PUBKEY *xpk);
 464 PKCS8_PRIV_KEY_INFO *d2i_PKCS8_PRIV_KEY_INFO_bio(BIO *bp,
 465                                                  PKCS8_PRIV_KEY_INFO **p8inf);
 466 int i2d_PKCS8_PRIV_KEY_INFO_bio(BIO *bp, const PKCS8_PRIV_KEY_INFO *p8inf);
 467 int i2d_PKCS8PrivateKeyInfo_bio(BIO *bp, const EVP_PKEY *key);
 468 int i2d_PrivateKey_bio(BIO *bp, const EVP_PKEY *pkey);
 469 EVP_PKEY *d2i_PrivateKey_ex_bio(BIO *bp, EVP_PKEY **a, OSSL_LIB_CTX *libctx,
 470                                 const char *propq);
 471 EVP_PKEY *d2i_PrivateKey_bio(BIO *bp, EVP_PKEY **a);
 472 int i2d_PUBKEY_bio(BIO *bp, const EVP_PKEY *pkey);
 473 EVP_PKEY *d2i_PUBKEY_ex_bio(BIO *bp, EVP_PKEY **a, OSSL_LIB_CTX *libctx,
 474                             const char *propq);
 475 EVP_PKEY *d2i_PUBKEY_bio(BIO *bp, EVP_PKEY **a);
 476
 477 DECLARE_ASN1_DUP_FUNCTION(X509)
 478 DECLARE_ASN1_DUP_FUNCTION(X509_ALGOR)
 479 DECLARE_ASN1_DUP_FUNCTION(X509_ATTRIBUTE)
 480 DECLARE_ASN1_DUP_FUNCTION(X509_CRL)
 481 DECLARE_ASN1_DUP_FUNCTION(X509_EXTENSION)
 482 DECLARE_ASN1_DUP_FUNCTION(X509_PUBKEY)
 483 DECLARE_ASN1_DUP_FUNCTION(X509_REQ)
 484 DECLARE_ASN1_DUP_FUNCTION(X509_REVOKED)
 485 int X509_ALGOR_set0(X509_ALGOR *alg, ASN1_OBJECT *aobj, int ptype,
 486                     void *pval);
 487 void X509_ALGOR_get0(const ASN1_OBJECT **paobj, int *pptype,
 488                      const void **ppval, const X509_ALGOR *algor);
 489 void X509_ALGOR_set_md(X509_ALGOR *alg, const EVP_MD *md);
 490 int X509_ALGOR_cmp(const X509_ALGOR *a, const X509_ALGOR *b);
 491 int X509_ALGOR_copy(X509_ALGOR *dest, const X509_ALGOR *src);
 492
 493 DECLARE_ASN1_DUP_FUNCTION(X509_NAME)
 494 DECLARE_ASN1_DUP_FUNCTION(X509_NAME_ENTRY)
 495
 496 int X509_cmp_time(const ASN1_TIME *s, time_t *t);
 497 int X509_cmp_current_time(const ASN1_TIME *s);
 498 int X509_cmp_timeframe(const X509_VERIFY_PARAM *vpm,
 499                        const ASN1_TIME *start, const ASN1_TIME *end);
 500 ASN1_TIME *X509_time_adj(ASN1_TIME *s, long adj, time_t *t);
 501 ASN1_TIME *X509_time_adj_ex(ASN1_TIME *s,
 502                             int offset_day, long offset_sec, time_t *t);
 503 ASN1_TIME *X509_gmtime_adj(ASN1_TIME *s, long adj);
 504
 505 const char *X509_get_default_cert_area(void);
 506 const char *X509_get_default_cert_dir(void);
 507 const char *X509_get_default_cert_file(void);
 508 const char *X509_get_default_cert_dir_env(void);
 509 const char *X509_get_default_cert_file_env(void);
 510 const char *X509_get_default_private_dir(void);
 511
 512 X509_REQ *X509_to_X509_REQ(X509 *x, EVP_PKEY *pkey, const EVP_MD *md);
 513 X509 *X509_REQ_to_X509(X509_REQ *r, int days, EVP_PKEY *pkey);
 514
 515 DECLARE_ASN1_FUNCTIONS(X509_ALGOR)
 516 DECLARE_ASN1_ENCODE_FUNCTIONS(X509_ALGORS, X509_ALGORS, X509_ALGORS)
 517 DECLARE_ASN1_FUNCTIONS(X509_VAL)
 518
 519 DECLARE_ASN1_FUNCTIONS(X509_PUBKEY)
 520
 521 X509_PUBKEY *X509_PUBKEY_new_ex(OSSL_LIB_CTX *libctx, const char *propq);
 522 int X509_PUBKEY_set(X509_PUBKEY **x, EVP_PKEY *pkey);
 523 EVP_PKEY *X509_PUBKEY_get0(const X509_PUBKEY *key);
 524 EVP_PKEY *X509_PUBKEY_get(const X509_PUBKEY *key);
 525 int X509_get_pubkey_parameters(EVP_PKEY *pkey, STACK_OF(X509) *chain);
 526 long X509_get_pathlen(X509 *x);
 527 DECLARE_ASN1_ENCODE_FUNCTIONS_only(EVP_PKEY, PUBKEY)
 528 EVP_PKEY *d2i_PUBKEY_ex(EVP_PKEY **a, const unsigned char **pp, long length,
 529                         OSSL_LIB_CTX *libctx, const char *propq);
 530 # ifndef OPENSSL_NO_DEPRECATED_3_0
 531 DECLARE_ASN1_ENCODE_FUNCTIONS_only_attr(OSSL_DEPRECATEDIN_3_0,RSA, RSA_PUBKEY)
 532 # endif
 533 # ifndef OPENSSL_NO_DEPRECATED_3_0
 534 #  ifndef OPENSSL_NO_DSA
 535 DECLARE_ASN1_ENCODE_FUNCTIONS_only_attr(OSSL_DEPRECATEDIN_3_0,DSA, DSA_PUBKEY)
 536 #  endif
 537 # endif
 538 # ifndef OPENSSL_NO_DEPRECATED_3_0
 539 #  ifndef OPENSSL_NO_EC
 540 DECLARE_ASN1_ENCODE_FUNCTIONS_only_attr(OSSL_DEPRECATEDIN_3_0, EC_KEY, EC_PUBKEY)
 541 #  endif
 542 # endif
 543
 544 DECLARE_ASN1_FUNCTIONS(X509_SIG)
 545 void X509_SIG_get0(const X509_SIG *sig, const X509_ALGOR **palg,
 546                    const ASN1_OCTET_STRING **pdigest);
 547 void X509_SIG_getm(X509_SIG *sig, X509_ALGOR **palg,
 548                    ASN1_OCTET_STRING **pdigest);
 549
 550 DECLARE_ASN1_FUNCTIONS(X509_REQ_INFO)
 551 DECLARE_ASN1_FUNCTIONS(X509_REQ)
 552 X509_REQ *X509_REQ_new_ex(OSSL_LIB_CTX *libctx, const char *propq);
 553
 554 DECLARE_ASN1_FUNCTIONS(X509_ATTRIBUTE)
 555 X509_ATTRIBUTE *X509_ATTRIBUTE_create(int nid, int atrtype, void *value);
 556
 557 DECLARE_ASN1_FUNCTIONS(X509_EXTENSION)
 558 DECLARE_ASN1_ENCODE_FUNCTIONS(X509_EXTENSIONS, X509_EXTENSIONS, X509_EXTENSIONS)
 559
 560 DECLARE_ASN1_FUNCTIONS(X509_NAME_ENTRY)
 561
 562 DECLARE_ASN1_FUNCTIONS(X509_NAME)
 563
 564 int X509_NAME_set(X509_NAME **xn, const X509_NAME *name);
 565
 566 DECLARE_ASN1_FUNCTIONS(X509_CINF)
 567 DECLARE_ASN1_FUNCTIONS(X509)
 568 X509 *X509_new_ex(OSSL_LIB_CTX *libctx, const char *propq);
 569 DECLARE_ASN1_FUNCTIONS(X509_CERT_AUX)
 570
 571 #define X509_get_ex_new_index(l, p, newf, dupf, freef) \
 572     CRYPTO_get_ex_new_index(CRYPTO_EX_INDEX_X509, l, p, newf, dupf, freef)
 573 int X509_set_ex_data(X509 *r, int idx, void *arg);
 574 void *X509_get_ex_data(const X509 *r, int idx);
 575 DECLARE_ASN1_ENCODE_FUNCTIONS_only(X509,X509_AUX)
 576
 577 int i2d_re_X509_tbs(X509 *x, unsigned char **pp);
 578
 579 int X509_SIG_INFO_get(const X509_SIG_INFO *siginf, int *mdnid, int *pknid,
 580                       int *secbits, uint32_t *flags);
 581 void X509_SIG_INFO_set(X509_SIG_INFO *siginf, int mdnid, int pknid,
 582                        int secbits, uint32_t flags);
 583
 584 int X509_get_signature_info(X509 *x, int *mdnid, int *pknid, int *secbits,
 585                             uint32_t *flags);
 586
 587 void X509_get0_signature(const ASN1_BIT_STRING **psig,
 588                          const X509_ALGOR **palg, const X509 *x);
 589 int X509_get_signature_nid(const X509 *x);
 590
 591 void X509_set0_distinguishing_id(X509 *x, ASN1_OCTET_STRING *d_id);
 592 ASN1_OCTET_STRING *X509_get0_distinguishing_id(X509 *x);
 593 void X509_REQ_set0_distinguishing_id(X509_REQ *x, ASN1_OCTET_STRING *d_id);
 594 ASN1_OCTET_STRING *X509_REQ_get0_distinguishing_id(X509_REQ *x);
 595
 596 int X509_alias_set1(X509 *x, const unsigned char *name, int len);
 597 int X509_keyid_set1(X509 *x, const unsigned char *id, int len);
 598 unsigned char *X509_alias_get0(X509 *x, int *len);
 599 unsigned char *X509_keyid_get0(X509 *x, int *len);
 600
 601 DECLARE_ASN1_FUNCTIONS(X509_REVOKED)
 602 DECLARE_ASN1_FUNCTIONS(X509_CRL_INFO)
 603 DECLARE_ASN1_FUNCTIONS(X509_CRL)
 604 X509_CRL *X509_CRL_new_ex(OSSL_LIB_CTX *libctx, const char *propq);
 605
 606 int X509_CRL_add0_revoked(X509_CRL *crl, X509_REVOKED *rev);
 607 int X509_CRL_get0_by_serial(X509_CRL *crl,
 608                             X509_REVOKED **ret, const ASN1_INTEGER *serial);
 609 int X509_CRL_get0_by_cert(X509_CRL *crl, X509_REVOKED **ret, X509 *x);
 610
 611 X509_PKEY *X509_PKEY_new(void);
 612 void X509_PKEY_free(X509_PKEY *a);
 613
 614 DECLARE_ASN1_FUNCTIONS(NETSCAPE_SPKI)
 615 DECLARE_ASN1_FUNCTIONS(NETSCAPE_SPKAC)
 616 DECLARE_ASN1_FUNCTIONS(NETSCAPE_CERT_SEQUENCE)
 617
 618 X509_INFO *X509_INFO_new(void);
 619 void X509_INFO_free(X509_INFO *a);
 620 char *X509_NAME_oneline(const X509_NAME *a, char *buf, int size);
 621
 622 #ifndef OPENSSL_NO_DEPRECATED_3_0
 623 OSSL_DEPRECATEDIN_3_0
 624 int ASN1_verify(i2d_of_void *i2d, X509_ALGOR *algor1,
 625                 ASN1_BIT_STRING *signature, char *data, EVP_PKEY *pkey);
 626 OSSL_DEPRECATEDIN_3_0
 627 int ASN1_digest(i2d_of_void *i2d, const EVP_MD *type, char *data,
 628                 unsigned char *md, unsigned int *len);
 629 OSSL_DEPRECATEDIN_3_0
 630 int ASN1_sign(i2d_of_void *i2d, X509_ALGOR *algor1, X509_ALGOR *algor2,
 631               ASN1_BIT_STRING *signature, char *data, EVP_PKEY *pkey,
 632               const EVP_MD *type);
 633 #endif
 634 int ASN1_item_digest(const ASN1_ITEM *it, const EVP_MD *type, void *data,
 635                      unsigned char *md, unsigned int *len);
 636 int ASN1_item_verify(const ASN1_ITEM *it, const X509_ALGOR *alg,
 637                      const ASN1_BIT_STRING *signature, const void *data,
 638                      EVP_PKEY *pkey);
 639 int ASN1_item_verify_ctx(const ASN1_ITEM *it, const X509_ALGOR *alg,
 640                          const ASN1_BIT_STRING *signature, const void *data,
 641                          EVP_MD_CTX *ctx);
 642 int ASN1_item_sign(const ASN1_ITEM *it, X509_ALGOR *algor1, X509_ALGOR *algor2,
 643                    ASN1_BIT_STRING *signature, const void *data,
 644                    EVP_PKEY *pkey, const EVP_MD *md);
 645 int ASN1_item_sign_ctx(const ASN1_ITEM *it, X509_ALGOR *algor1,
 646                        X509_ALGOR *algor2, ASN1_BIT_STRING *signature,
 647                        const void *data, EVP_MD_CTX *ctx);
 648
 649 #define X509_VERSION_1 0
 650 #define X509_VERSION_2 1
 651 #define X509_VERSION_3 2
 652
 653 long X509_get_version(const X509 *x);
 654 int X509_set_version(X509 *x, long version);
 655 int X509_set_serialNumber(X509 *x, ASN1_INTEGER *serial);
 656 ASN1_INTEGER *X509_get_serialNumber(X509 *x);
 657 const ASN1_INTEGER *X509_get0_serialNumber(const X509 *x);
 658 int X509_set_issuer_name(X509 *x, const X509_NAME *name);
 659 X509_NAME *X509_get_issuer_name(const X509 *a);
 660 int X509_set_subject_name(X509 *x, const X509_NAME *name);
 661 X509_NAME *X509_get_subject_name(const X509 *a);
 662 const ASN1_TIME * X509_get0_notBefore(const X509 *x);
 663 ASN1_TIME *X509_getm_notBefore(const X509 *x);
 664 int X509_set1_notBefore(X509 *x, const ASN1_TIME *tm);
 665 const ASN1_TIME *X509_get0_notAfter(const X509 *x);
 666 ASN1_TIME *X509_getm_notAfter(const X509 *x);
 667 int X509_set1_notAfter(X509 *x, const ASN1_TIME *tm);
 668 int X509_set_pubkey(X509 *x, EVP_PKEY *pkey);
 669 int X509_up_ref(X509 *x);
 670 int X509_get_signature_type(const X509 *x);
 671
 672 # ifndef OPENSSL_NO_DEPRECATED_1_1_0
 673 #  define X509_get_notBefore X509_getm_notBefore
 674 #  define X509_get_notAfter X509_getm_notAfter
 675 #  define X509_set_notBefore X509_set1_notBefore
 676 #  define X509_set_notAfter X509_set1_notAfter
 677 #endif
 678
 679
 680 /*
 681  * This one is only used so that a binary form can output, as in
 682  * i2d_X509_PUBKEY(X509_get_X509_PUBKEY(x), &buf)
 683  */
 684 X509_PUBKEY *X509_get_X509_PUBKEY(const X509 *x);
 685 const STACK_OF(X509_EXTENSION) *X509_get0_extensions(const X509 *x);
 686 void X509_get0_uids(const X509 *x, const ASN1_BIT_STRING **piuid,
 687                     const ASN1_BIT_STRING **psuid);
 688 const X509_ALGOR *X509_get0_tbs_sigalg(const X509 *x);
 689
 690 EVP_PKEY *X509_get0_pubkey(const X509 *x);
 691 EVP_PKEY *X509_get_pubkey(X509 *x);
 692 ASN1_BIT_STRING *X509_get0_pubkey_bitstr(const X509 *x);
 693
 694 #define X509_REQ_VERSION_1 0
 695
 696 long X509_REQ_get_version(const X509_REQ *req);
 697 int X509_REQ_set_version(X509_REQ *x, long version);
 698 X509_NAME *X509_REQ_get_subject_name(const X509_REQ *req);
 699 int X509_REQ_set_subject_name(X509_REQ *req, const X509_NAME *name);
 700 void X509_REQ_get0_signature(const X509_REQ *req, const ASN1_BIT_STRING **psig,
 701                              const X509_ALGOR **palg);
 702 void X509_REQ_set0_signature(X509_REQ *req, ASN1_BIT_STRING *psig);
 703 int X509_REQ_set1_signature_algo(X509_REQ *req, X509_ALGOR *palg);
 704 int X509_REQ_get_signature_nid(const X509_REQ *req);
 705 int i2d_re_X509_REQ_tbs(X509_REQ *req, unsigned char **pp);
 706 int X509_REQ_set_pubkey(X509_REQ *x, EVP_PKEY *pkey);
 707 EVP_PKEY *X509_REQ_get_pubkey(X509_REQ *req);
 708 EVP_PKEY *X509_REQ_get0_pubkey(const X509_REQ *req);
 709 X509_PUBKEY *X509_REQ_get_X509_PUBKEY(X509_REQ *req);
 710 int X509_REQ_extension_nid(int nid);
 711 int *X509_REQ_get_extension_nids(void);
 712 void X509_REQ_set_extension_nids(int *nids);
 713 STACK_OF(X509_EXTENSION) *X509_REQ_get_extensions(X509_REQ *req);
 714 int X509_REQ_add_extensions_nid(X509_REQ *req,
 715                                 const STACK_OF(X509_EXTENSION) *exts, int nid);
 716 int X509_REQ_add_extensions(X509_REQ *req, const STACK_OF(X509_EXTENSION) *ext);
 717 int X509_REQ_get_attr_count(const X509_REQ *req);
 718 int X509_REQ_get_attr_by_NID(const X509_REQ *req, int nid, int lastpos);
 719 int X509_REQ_get_attr_by_OBJ(const X509_REQ *req, const ASN1_OBJECT *obj,
 720                              int lastpos);
 721 X509_ATTRIBUTE *X509_REQ_get_attr(const X509_REQ *req, int loc);
 722 X509_ATTRIBUTE *X509_REQ_delete_attr(X509_REQ *req, int loc);
 723 int X509_REQ_add1_attr(X509_REQ *req, X509_ATTRIBUTE *attr);
 724 int X509_REQ_add1_attr_by_OBJ(X509_REQ *req,
 725                               const ASN1_OBJECT *obj, int type,
 726                               const unsigned char *bytes, int len);
 727 int X509_REQ_add1_attr_by_NID(X509_REQ *req,
 728                               int nid, int type,
 729                               const unsigned char *bytes, int len);
 730 int X509_REQ_add1_attr_by_txt(X509_REQ *req,
 731                               const char *attrname, int type,
 732                               const unsigned char *bytes, int len);
 733
 734 #define X509_CRL_VERSION_1 0
 735 #define X509_CRL_VERSION_2 1
 736
 737 int X509_CRL_set_version(X509_CRL *x, long version);
 738 int X509_CRL_set_issuer_name(X509_CRL *x, const X509_NAME *name);
 739 int X509_CRL_set1_lastUpdate(X509_CRL *x, const ASN1_TIME *tm);
 740 int X509_CRL_set1_nextUpdate(X509_CRL *x, const ASN1_TIME *tm);
 741 int X509_CRL_sort(X509_CRL *crl);
 742 int X509_CRL_up_ref(X509_CRL *crl);
 743
 744 # ifndef OPENSSL_NO_DEPRECATED_1_1_0
 745 #  define X509_CRL_set_lastUpdate X509_CRL_set1_lastUpdate
 746 #  define X509_CRL_set_nextUpdate X509_CRL_set1_nextUpdate
 747 #endif
 748
 749 long X509_CRL_get_version(const X509_CRL *crl);
 750 const ASN1_TIME *X509_CRL_get0_lastUpdate(const X509_CRL *crl);
 751 const ASN1_TIME *X509_CRL_get0_nextUpdate(const X509_CRL *crl);
 752 #ifndef OPENSSL_NO_DEPRECATED_1_1_0
 753 OSSL_DEPRECATEDIN_1_1_0 ASN1_TIME *X509_CRL_get_lastUpdate(X509_CRL *crl);
 754 OSSL_DEPRECATEDIN_1_1_0 ASN1_TIME *X509_CRL_get_nextUpdate(X509_CRL *crl);
 755 #endif
 756 X509_NAME *X509_CRL_get_issuer(const X509_CRL *crl);
 757 const STACK_OF(X509_EXTENSION) *X509_CRL_get0_extensions(const X509_CRL *crl);
 758 STACK_OF(X509_REVOKED) *X509_CRL_get_REVOKED(X509_CRL *crl);
 759 void X509_CRL_get0_signature(const X509_CRL *crl, const ASN1_BIT_STRING **psig,
 760                              const X509_ALGOR **palg);
 761 int X509_CRL_get_signature_nid(const X509_CRL *crl);
 762 int i2d_re_X509_CRL_tbs(X509_CRL *req, unsigned char **pp);
 763
 764 const ASN1_INTEGER *X509_REVOKED_get0_serialNumber(const X509_REVOKED *x);
 765 int X509_REVOKED_set_serialNumber(X509_REVOKED *x, ASN1_INTEGER *serial);
 766 const ASN1_TIME *X509_REVOKED_get0_revocationDate(const X509_REVOKED *x);
 767 int X509_REVOKED_set_revocationDate(X509_REVOKED *r, ASN1_TIME *tm);
 768 const STACK_OF(X509_EXTENSION) *
 769 X509_REVOKED_get0_extensions(const X509_REVOKED *r);
 770
 771 X509_CRL *X509_CRL_diff(X509_CRL *base, X509_CRL *newer,
 772                         EVP_PKEY *skey, const EVP_MD *md, unsigned int flags);
 773
 774 int X509_REQ_check_private_key(const X509_REQ *req, EVP_PKEY *pkey);
 775
 776 int X509_check_private_key(const X509 *cert, const EVP_PKEY *pkey);
 777 int X509_chain_check_suiteb(int *perror_depth,
 778                             X509 *x, STACK_OF(X509) *chain,
 779                             unsigned long flags);
 780 int X509_CRL_check_suiteb(X509_CRL *crl, EVP_PKEY *pk, unsigned long flags);
 781 void OSSL_STACK_OF_X509_free(STACK_OF(X509) *certs);
 782 STACK_OF(X509) *X509_chain_up_ref(STACK_OF(X509) *chain);
 783
 784 int X509_issuer_and_serial_cmp(const X509 *a, const X509 *b);
 785 unsigned long X509_issuer_and_serial_hash(X509 *a);
 786
 787 int X509_issuer_name_cmp(const X509 *a, const X509 *b);
 788 unsigned long X509_issuer_name_hash(X509 *a);
 789
 790 int X509_subject_name_cmp(const X509 *a, const X509 *b);
 791 unsigned long X509_subject_name_hash(X509 *x);
 792
 793 # ifndef OPENSSL_NO_MD5
 794 unsigned long X509_issuer_name_hash_old(X509 *a);
 795 unsigned long X509_subject_name_hash_old(X509 *x);
 796 # endif
 797
 798 # define X509_ADD_FLAG_DEFAULT  0
 799 # define X509_ADD_FLAG_UP_REF   0x1
 800 # define X509_ADD_FLAG_PREPEND  0x2
 801 # define X509_ADD_FLAG_NO_DUP   0x4
 802 # define X509_ADD_FLAG_NO_SS    0x8
 803 int X509_add_cert(STACK_OF(X509) *sk, X509 *cert, int flags);
 804 int X509_add_certs(STACK_OF(X509) *sk, STACK_OF(X509) *certs, int flags);
 805
 806 int X509_cmp(const X509 *a, const X509 *b);
 807 int X509_NAME_cmp(const X509_NAME *a, const X509_NAME *b);
 808 #ifndef OPENSSL_NO_DEPRECATED_3_0
 809 # define X509_NAME_hash(x) X509_NAME_hash_ex(x, NULL, NULL, NULL)
 810 OSSL_DEPRECATEDIN_3_0 int X509_certificate_type(const X509 *x,
 811                                                 const EVP_PKEY *pubkey);
 812 #endif
 813 unsigned long X509_NAME_hash_ex(const X509_NAME *x, OSSL_LIB_CTX *libctx,
 814                                 const char *propq, int *ok);
 815 unsigned long X509_NAME_hash_old(const X509_NAME *x);
 816
 817 int X509_CRL_cmp(const X509_CRL *a, const X509_CRL *b);
 818 int X509_CRL_match(const X509_CRL *a, const X509_CRL *b);
 819 int X509_aux_print(BIO *out, X509 *x, int indent);
 820 # ifndef OPENSSL_NO_STDIO
 821 int X509_print_ex_fp(FILE *bp, X509 *x, unsigned long nmflag,
 822                      unsigned long cflag);
 823 int X509_print_fp(FILE *bp, X509 *x);
 824 int X509_CRL_print_fp(FILE *bp, X509_CRL *x);
 825 int X509_REQ_print_fp(FILE *bp, X509_REQ *req);
 826 int X509_NAME_print_ex_fp(FILE *fp, const X509_NAME *nm, int indent,
 827                           unsigned long flags);
 828 # endif
 829
 830 int X509_NAME_print(BIO *bp, const X509_NAME *name, int obase);
 831 int X509_NAME_print_ex(BIO *out, const X509_NAME *nm, int indent,
 832                        unsigned long flags);
 833 int X509_print_ex(BIO *bp, X509 *x, unsigned long nmflag,
 834                   unsigned long cflag);
 835 int X509_print(BIO *bp, X509 *x);
 836 int X509_ocspid_print(BIO *bp, X509 *x);
 837 int X509_CRL_print_ex(BIO *out, X509_CRL *x, unsigned long nmflag);
 838 int X509_CRL_print(BIO *bp, X509_CRL *x);
 839 int X509_REQ_print_ex(BIO *bp, X509_REQ *x, unsigned long nmflag,
 840                       unsigned long cflag);
 841 int X509_REQ_print(BIO *bp, X509_REQ *req);
 842
 843 int X509_NAME_entry_count(const X509_NAME *name);
 844 int X509_NAME_get_text_by_NID(const X509_NAME *name, int nid,
 845                               char *buf, int len);
 846 int X509_NAME_get_text_by_OBJ(const X509_NAME *name, const ASN1_OBJECT *obj,
 847                               char *buf, int len);
 848
 849 /*
 850  * NOTE: you should be passing -1, not 0 as lastpos. The functions that use
 851  * lastpos, search after that position on.
 852  */
 853 int X509_NAME_get_index_by_NID(const X509_NAME *name, int nid, int lastpos);
 854 int X509_NAME_get_index_by_OBJ(const X509_NAME *name, const ASN1_OBJECT *obj,
 855                                int lastpos);
 856 X509_NAME_ENTRY *X509_NAME_get_entry(const X509_NAME *name, int loc);
 857 X509_NAME_ENTRY *X509_NAME_delete_entry(X509_NAME *name, int loc);
 858 int X509_NAME_add_entry(X509_NAME *name, const X509_NAME_ENTRY *ne,
 859                         int loc, int set);
 860 int X509_NAME_add_entry_by_OBJ(X509_NAME *name, const ASN1_OBJECT *obj, int type,
 861                                const unsigned char *bytes, int len, int loc,
 862                                int set);
 863 int X509_NAME_add_entry_by_NID(X509_NAME *name, int nid, int type,
 864                                const unsigned char *bytes, int len, int loc,
 865                                int set);
 866 X509_NAME_ENTRY *X509_NAME_ENTRY_create_by_txt(X509_NAME_ENTRY **ne,
 867                                                const char *field, int type,
 868                                                const unsigned char *bytes,
 869                                                int len);
 870 X509_NAME_ENTRY *X509_NAME_ENTRY_create_by_NID(X509_NAME_ENTRY **ne, int nid,
 871                                                int type,
 872                                                const unsigned char *bytes,
 873                                                int len);
 874 int X509_NAME_add_entry_by_txt(X509_NAME *name, const char *field, int type,
 875                                const unsigned char *bytes, int len, int loc,
 876                                int set);
 877 X509_NAME_ENTRY *X509_NAME_ENTRY_create_by_OBJ(X509_NAME_ENTRY **ne,
 878                                                const ASN1_OBJECT *obj, int type,
 879                                                const unsigned char *bytes,
 880                                                int len);
 881 int X509_NAME_ENTRY_set_object(X509_NAME_ENTRY *ne, const ASN1_OBJECT *obj);
 882 int X509_NAME_ENTRY_set_data(X509_NAME_ENTRY *ne, int type,
 883                              const unsigned char *bytes, int len);
 884 ASN1_OBJECT *X509_NAME_ENTRY_get_object(const X509_NAME_ENTRY *ne);
 885 ASN1_STRING * X509_NAME_ENTRY_get_data(const X509_NAME_ENTRY *ne);
 886 int X509_NAME_ENTRY_set(const X509_NAME_ENTRY *ne);
 887
 888 int X509_NAME_get0_der(const X509_NAME *nm, const unsigned char **pder,
 889                        size_t *pderlen);
 890
 891 int X509v3_get_ext_count(const STACK_OF(X509_EXTENSION) *x);
 892 int X509v3_get_ext_by_NID(const STACK_OF(X509_EXTENSION) *x,
 893                           int nid, int lastpos);
 894 int X509v3_get_ext_by_OBJ(const STACK_OF(X509_EXTENSION) *x,
 895                           const ASN1_OBJECT *obj, int lastpos);
 896 int X509v3_get_ext_by_critical(const STACK_OF(X509_EXTENSION) *x,
 897                                int crit, int lastpos);
 898 X509_EXTENSION *X509v3_get_ext(const STACK_OF(X509_EXTENSION) *x, int loc);
 899 X509_EXTENSION *X509v3_delete_ext(STACK_OF(X509_EXTENSION) *x, int loc);
 900 STACK_OF(X509_EXTENSION) *X509v3_add_ext(STACK_OF(X509_EXTENSION) **x,
 901                                          X509_EXTENSION *ex, int loc);
 902
 903 int X509_get_ext_count(const X509 *x);
 904 int X509_get_ext_by_NID(const X509 *x, int nid, int lastpos);
 905 int X509_get_ext_by_OBJ(const X509 *x, const ASN1_OBJECT *obj, int lastpos);
 906 int X509_get_ext_by_critical(const X509 *x, int crit, int lastpos);
 907 X509_EXTENSION *X509_get_ext(const X509 *x, int loc);
 908 X509_EXTENSION *X509_delete_ext(X509 *x, int loc);
 909 int X509_add_ext(X509 *x, X509_EXTENSION *ex, int loc);
 910 void *X509_get_ext_d2i(const X509 *x, int nid, int *crit, int *idx);
 911 int X509_add1_ext_i2d(X509 *x, int nid, void *value, int crit,
 912                       unsigned long flags);
 913
 914 int X509_CRL_get_ext_count(const X509_CRL *x);
 915 int X509_CRL_get_ext_by_NID(const X509_CRL *x, int nid, int lastpos);
 916 int X509_CRL_get_ext_by_OBJ(const X509_CRL *x, const ASN1_OBJECT *obj,
 917                             int lastpos);
 918 int X509_CRL_get_ext_by_critical(const X509_CRL *x, int crit, int lastpos);
 919 X509_EXTENSION *X509_CRL_get_ext(const X509_CRL *x, int loc);
 920 X509_EXTENSION *X509_CRL_delete_ext(X509_CRL *x, int loc);
 921 int X509_CRL_add_ext(X509_CRL *x, X509_EXTENSION *ex, int loc);
 922 void *X509_CRL_get_ext_d2i(const X509_CRL *x, int nid, int *crit, int *idx);
 923 int X509_CRL_add1_ext_i2d(X509_CRL *x, int nid, void *value, int crit,
 924                           unsigned long flags);
 925
 926 int X509_REVOKED_get_ext_count(const X509_REVOKED *x);
 927 int X509_REVOKED_get_ext_by_NID(const X509_REVOKED *x, int nid, int lastpos);
 928 int X509_REVOKED_get_ext_by_OBJ(const X509_REVOKED *x, const ASN1_OBJECT *obj,
 929                                 int lastpos);
 930 int X509_REVOKED_get_ext_by_critical(const X509_REVOKED *x, int crit,
 931                                      int lastpos);
 932 X509_EXTENSION *X509_REVOKED_get_ext(const X509_REVOKED *x, int loc);
 933 X509_EXTENSION *X509_REVOKED_delete_ext(X509_REVOKED *x, int loc);
 934 int X509_REVOKED_add_ext(X509_REVOKED *x, X509_EXTENSION *ex, int loc);
 935 void *X509_REVOKED_get_ext_d2i(const X509_REVOKED *x, int nid, int *crit,
 936                                int *idx);
 937 int X509_REVOKED_add1_ext_i2d(X509_REVOKED *x, int nid, void *value, int crit,
 938                               unsigned long flags);
 939
 940 X509_EXTENSION *X509_EXTENSION_create_by_NID(X509_EXTENSION **ex,
 941                                              int nid, int crit,
 942                                              ASN1_OCTET_STRING *data);
 943 X509_EXTENSION *X509_EXTENSION_create_by_OBJ(X509_EXTENSION **ex,
 944                                              const ASN1_OBJECT *obj, int crit,
 945                                              ASN1_OCTET_STRING *data);
 946 int X509_EXTENSION_set_object(X509_EXTENSION *ex, const ASN1_OBJECT *obj);
 947 int X509_EXTENSION_set_critical(X509_EXTENSION *ex, int crit);
 948 int X509_EXTENSION_set_data(X509_EXTENSION *ex, ASN1_OCTET_STRING *data);
 949 ASN1_OBJECT *X509_EXTENSION_get_object(X509_EXTENSION *ex);
 950 ASN1_OCTET_STRING *X509_EXTENSION_get_data(X509_EXTENSION *ne);
 951 int X509_EXTENSION_get_critical(const X509_EXTENSION *ex);
 952
 953 int X509at_get_attr_count(const STACK_OF(X509_ATTRIBUTE) *x);
 954 int X509at_get_attr_by_NID(const STACK_OF(X509_ATTRIBUTE) *x, int nid,
 955                            int lastpos);
 956 int X509at_get_attr_by_OBJ(const STACK_OF(X509_ATTRIBUTE) *sk,
 957                            const ASN1_OBJECT *obj, int lastpos);
 958 X509_ATTRIBUTE *X509at_get_attr(const STACK_OF(X509_ATTRIBUTE) *x, int loc);
 959 X509_ATTRIBUTE *X509at_delete_attr(STACK_OF(X509_ATTRIBUTE) *x, int loc);
 960 STACK_OF(X509_ATTRIBUTE) *X509at_add1_attr(STACK_OF(X509_ATTRIBUTE) **x,
 961                                            X509_ATTRIBUTE *attr);
 962 STACK_OF(X509_ATTRIBUTE) *X509at_add1_attr_by_OBJ(STACK_OF(X509_ATTRIBUTE)
 963                                                   **x, const ASN1_OBJECT *obj,
 964                                                   int type,
 965                                                   const unsigned char *bytes,
 966                                                   int len);
 967 STACK_OF(X509_ATTRIBUTE) *X509at_add1_attr_by_NID(STACK_OF(X509_ATTRIBUTE)
 968                                                   **x, int nid, int type,
 969                                                   const unsigned char *bytes,
 970                                                   int len);
 971 STACK_OF(X509_ATTRIBUTE) *X509at_add1_attr_by_txt(STACK_OF(X509_ATTRIBUTE)
 972                                                   **x, const char *attrname,
 973                                                   int type,
 974                                                   const unsigned char *bytes,
 975                                                   int len);
 976 void *X509at_get0_data_by_OBJ(const STACK_OF(X509_ATTRIBUTE) *x,
 977                               const ASN1_OBJECT *obj, int lastpos, int type);
 978 X509_ATTRIBUTE *X509_ATTRIBUTE_create_by_NID(X509_ATTRIBUTE **attr, int nid,
 979                                              int atrtype, const void *data,
 980                                              int len);
 981 X509_ATTRIBUTE *X509_ATTRIBUTE_create_by_OBJ(X509_ATTRIBUTE **attr,
 982                                              const ASN1_OBJECT *obj,
 983                                              int atrtype, const void *data,
 984                                              int len);
 985 X509_ATTRIBUTE *X509_ATTRIBUTE_create_by_txt(X509_ATTRIBUTE **attr,
 986                                              const char *atrname, int type,
 987                                              const unsigned char *bytes,
 988                                              int len);
 989 int X509_ATTRIBUTE_set1_object(X509_ATTRIBUTE *attr, const ASN1_OBJECT *obj);
 990 int X509_ATTRIBUTE_set1_data(X509_ATTRIBUTE *attr, int attrtype,
 991                              const void *data, int len);
 992 void *X509_ATTRIBUTE_get0_data(X509_ATTRIBUTE *attr, int idx, int atrtype,
 993                                void *data);
 994 int X509_ATTRIBUTE_count(const X509_ATTRIBUTE *attr);
 995 ASN1_OBJECT *X509_ATTRIBUTE_get0_object(X509_ATTRIBUTE *attr);
 996 ASN1_TYPE *X509_ATTRIBUTE_get0_type(X509_ATTRIBUTE *attr, int idx);
 997
 998 int EVP_PKEY_get_attr_count(const EVP_PKEY *key);
 999 int EVP_PKEY_get_attr_by_NID(const EVP_PKEY *key, int nid, int lastpos);
1000 int EVP_PKEY_get_attr_by_OBJ(const EVP_PKEY *key, const ASN1_OBJECT *obj,
1001                              int lastpos);
1002 X509_ATTRIBUTE *EVP_PKEY_get_attr(const EVP_PKEY *key, int loc);
1003 X509_ATTRIBUTE *EVP_PKEY_delete_attr(EVP_PKEY *key, int loc);
1004 int EVP_PKEY_add1_attr(EVP_PKEY *key, X509_ATTRIBUTE *attr);
1005 int EVP_PKEY_add1_attr_by_OBJ(EVP_PKEY *key,
1006                               const ASN1_OBJECT *obj, int type,
1007                               const unsigned char *bytes, int len);
1008 int EVP_PKEY_add1_attr_by_NID(EVP_PKEY *key,
1009                               int nid, int type,
1010                               const unsigned char *bytes, int len);
1011 int EVP_PKEY_add1_attr_by_txt(EVP_PKEY *key,
1012                               const char *attrname, int type,
1013                               const unsigned char *bytes, int len);
1014
1015 /* lookup a cert from a X509 STACK */
1016 X509 *X509_find_by_issuer_and_serial(STACK_OF(X509) *sk, const X509_NAME *name,
1017                                      const ASN1_INTEGER *serial);
1018 X509 *X509_find_by_subject(STACK_OF(X509) *sk, const X509_NAME *name);
1019
1020 DECLARE_ASN1_FUNCTIONS(PBEPARAM)
1021 DECLARE_ASN1_FUNCTIONS(PBE2PARAM)
1022 DECLARE_ASN1_FUNCTIONS(PBKDF2PARAM)
1023 #ifndef OPENSSL_NO_SCRYPT
1024 DECLARE_ASN1_FUNCTIONS(SCRYPT_PARAMS)
1025 #endif
1026
1027 int PKCS5_pbe_set0_algor(X509_ALGOR *algor, int alg, int iter,
1028                          const unsigned char *salt, int saltlen);
1029 int PKCS5_pbe_set0_algor_ex(X509_ALGOR *algor, int alg, int iter,
1030                             const unsigned char *salt, int saltlen,
1031                             OSSL_LIB_CTX *libctx);
1032
1033 X509_ALGOR *PKCS5_pbe_set(int alg, int iter,
1034                           const unsigned char *salt, int saltlen);
1035 X509_ALGOR *PKCS5_pbe_set_ex(int alg, int iter,
1036                              const unsigned char *salt, int saltlen,
1037                              OSSL_LIB_CTX *libctx);
1038
1039 X509_ALGOR *PKCS5_pbe2_set(const EVP_CIPHER *cipher, int iter,
1040                            unsigned char *salt, int saltlen);
1041 X509_ALGOR *PKCS5_pbe2_set_iv(const EVP_CIPHER *cipher, int iter,
1042                               unsigned char *salt, int saltlen,
1043                               unsigned char *aiv, int prf_nid);
1044 X509_ALGOR *PKCS5_pbe2_set_iv_ex(const EVP_CIPHER *cipher, int iter,
1045                                  unsigned char *salt, int saltlen,
1046                                  unsigned char *aiv, int prf_nid,
1047                                  OSSL_LIB_CTX *libctx);
1048
1049 #ifndef OPENSSL_NO_SCRYPT
1050 X509_ALGOR *PKCS5_pbe2_set_scrypt(const EVP_CIPHER *cipher,
1051                                   const unsigned char *salt, int saltlen,
1052                                   unsigned char *aiv, uint64_t N, uint64_t r,
1053                                   uint64_t p);
1054 #endif
1055
1056 X509_ALGOR *PKCS5_pbkdf2_set(int iter, unsigned char *salt, int saltlen,
1057                              int prf_nid, int keylen);
1058 X509_ALGOR *PKCS5_pbkdf2_set_ex(int iter, unsigned char *salt, int saltlen,
1059                                 int prf_nid, int keylen,
1060                                 OSSL_LIB_CTX *libctx);
1061
1062 /* PKCS#8 utilities */
1063
1064 DECLARE_ASN1_FUNCTIONS(PKCS8_PRIV_KEY_INFO)
1065
1066 EVP_PKEY *EVP_PKCS82PKEY(const PKCS8_PRIV_KEY_INFO *p8);
1067 EVP_PKEY *EVP_PKCS82PKEY_ex(const PKCS8_PRIV_KEY_INFO *p8, OSSL_LIB_CTX *libctx,
1068                             const char *propq);
1069 PKCS8_PRIV_KEY_INFO *EVP_PKEY2PKCS8(const EVP_PKEY *pkey);
1070
1071 int PKCS8_pkey_set0(PKCS8_PRIV_KEY_INFO *priv, ASN1_OBJECT *aobj,
1072                     int version, int ptype, void *pval,
1073                     unsigned char *penc, int penclen);
1074 int PKCS8_pkey_get0(const ASN1_OBJECT **ppkalg,
1075                     const unsigned char **pk, int *ppklen,
1076                     const X509_ALGOR **pa, const PKCS8_PRIV_KEY_INFO *p8);
1077
1078 const STACK_OF(X509_ATTRIBUTE) *
1079 PKCS8_pkey_get0_attrs(const PKCS8_PRIV_KEY_INFO *p8);
1080 int PKCS8_pkey_add1_attr(PKCS8_PRIV_KEY_INFO *p8, X509_ATTRIBUTE *attr);
1081 int PKCS8_pkey_add1_attr_by_NID(PKCS8_PRIV_KEY_INFO *p8, int nid, int type,
1082                                 const unsigned char *bytes, int len);
1083 int PKCS8_pkey_add1_attr_by_OBJ(PKCS8_PRIV_KEY_INFO *p8, const ASN1_OBJECT *obj,
1084                                 int type, const unsigned char *bytes, int len);
1085
1086
1087 void X509_PUBKEY_set0_public_key(X509_PUBKEY *pub,
1088                                  unsigned char *penc, int penclen);
1089 int X509_PUBKEY_set0_param(X509_PUBKEY *pub, ASN1_OBJECT *aobj,
1090                            int ptype, void *pval,
1091                            unsigned char *penc, int penclen);
1092 int X509_PUBKEY_get0_param(ASN1_OBJECT **ppkalg,
1093                            const unsigned char **pk, int *ppklen,
1094                            X509_ALGOR **pa, const X509_PUBKEY *pub);
1095 int X509_PUBKEY_eq(const X509_PUBKEY *a, const X509_PUBKEY *b);
1096
1097 # ifdef  __cplusplus
1098 }
1099 # endif
1100 #endif