| 1 | /*
|
|---|
| 2 | * Copyright 2015-2021 The OpenSSL Project Authors. All Rights Reserved.
|
|---|
| 3 | *
|
|---|
| 4 | * Licensed under the Apache License 2.0 (the "License"). You may not use
|
|---|
| 5 | * this file except in compliance with the License. You can obtain a copy
|
|---|
| 6 | * in the file LICENSE in the source distribution or at
|
|---|
| 7 | * https://www.openssl.org/source/license.html
|
|---|
| 8 | */
|
|---|
| 9 |
|
|---|
| 10 | #ifndef OSSL_CRYPTO_ASN1_H
|
|---|
| 11 | # define OSSL_CRYPTO_ASN1_H
|
|---|
| 12 | # pragma once
|
|---|
| 13 |
|
|---|
| 14 | # include <openssl/asn1.h>
|
|---|
| 15 | # include <openssl/core_dispatch.h> /* OSSL_FUNC_keymgmt_import() */
|
|---|
| 16 |
|
|---|
| 17 | /* Internal ASN1 structures and functions: not for application use */
|
|---|
| 18 |
|
|---|
| 19 | /* ASN1 public key method structure */
|
|---|
| 20 |
|
|---|
| 21 | #include <openssl/core.h>
|
|---|
| 22 |
|
|---|
| 23 | struct evp_pkey_asn1_method_st {
|
|---|
| 24 | int pkey_id;
|
|---|
| 25 | int pkey_base_id;
|
|---|
| 26 | unsigned long pkey_flags;
|
|---|
| 27 | char *pem_str;
|
|---|
| 28 | char *info;
|
|---|
| 29 | int (*pub_decode) (EVP_PKEY *pk, const X509_PUBKEY *pub);
|
|---|
| 30 | int (*pub_encode) (X509_PUBKEY *pub, const EVP_PKEY *pk);
|
|---|
| 31 | int (*pub_cmp) (const EVP_PKEY *a, const EVP_PKEY *b);
|
|---|
| 32 | int (*pub_print) (BIO *out, const EVP_PKEY *pkey, int indent,
|
|---|
| 33 | ASN1_PCTX *pctx);
|
|---|
| 34 | int (*priv_decode) (EVP_PKEY *pk, const PKCS8_PRIV_KEY_INFO *p8inf);
|
|---|
| 35 | int (*priv_encode) (PKCS8_PRIV_KEY_INFO *p8, const EVP_PKEY *pk);
|
|---|
| 36 | int (*priv_print) (BIO *out, const EVP_PKEY *pkey, int indent,
|
|---|
| 37 | ASN1_PCTX *pctx);
|
|---|
| 38 | int (*pkey_size) (const EVP_PKEY *pk);
|
|---|
| 39 | int (*pkey_bits) (const EVP_PKEY *pk);
|
|---|
| 40 | int (*pkey_security_bits) (const EVP_PKEY *pk);
|
|---|
| 41 | int (*param_decode) (EVP_PKEY *pkey,
|
|---|
| 42 | const unsigned char **pder, int derlen);
|
|---|
| 43 | int (*param_encode) (const EVP_PKEY *pkey, unsigned char **pder);
|
|---|
| 44 | int (*param_missing) (const EVP_PKEY *pk);
|
|---|
| 45 | int (*param_copy) (EVP_PKEY *to, const EVP_PKEY *from);
|
|---|
| 46 | int (*param_cmp) (const EVP_PKEY *a, const EVP_PKEY *b);
|
|---|
| 47 | int (*param_print) (BIO *out, const EVP_PKEY *pkey, int indent,
|
|---|
| 48 | ASN1_PCTX *pctx);
|
|---|
| 49 | int (*sig_print) (BIO *out,
|
|---|
| 50 | const X509_ALGOR *sigalg, const ASN1_STRING *sig,
|
|---|
| 51 | int indent, ASN1_PCTX *pctx);
|
|---|
| 52 | void (*pkey_free) (EVP_PKEY *pkey);
|
|---|
| 53 | int (*pkey_ctrl) (EVP_PKEY *pkey, int op, long arg1, void *arg2);
|
|---|
| 54 | /* Legacy functions for old PEM */
|
|---|
| 55 | int (*old_priv_decode) (EVP_PKEY *pkey,
|
|---|
| 56 | const unsigned char **pder, int derlen);
|
|---|
| 57 | int (*old_priv_encode) (const EVP_PKEY *pkey, unsigned char **pder);
|
|---|
| 58 | /* Custom ASN1 signature verification */
|
|---|
| 59 | int (*item_verify) (EVP_MD_CTX *ctx, const ASN1_ITEM *it, const void *data,
|
|---|
| 60 | const X509_ALGOR *a, const ASN1_BIT_STRING *sig,
|
|---|
| 61 | EVP_PKEY *pkey);
|
|---|
| 62 | int (*item_sign) (EVP_MD_CTX *ctx, const ASN1_ITEM *it, const void *data,
|
|---|
| 63 | X509_ALGOR *alg1, X509_ALGOR *alg2,
|
|---|
| 64 | ASN1_BIT_STRING *sig);
|
|---|
| 65 | int (*siginf_set) (X509_SIG_INFO *siginf, const X509_ALGOR *alg,
|
|---|
| 66 | const ASN1_STRING *sig);
|
|---|
| 67 | /* Check */
|
|---|
| 68 | int (*pkey_check) (const EVP_PKEY *pk);
|
|---|
| 69 | int (*pkey_public_check) (const EVP_PKEY *pk);
|
|---|
| 70 | int (*pkey_param_check) (const EVP_PKEY *pk);
|
|---|
| 71 | /* Get/set raw private/public key data */
|
|---|
| 72 | int (*set_priv_key) (EVP_PKEY *pk, const unsigned char *priv, size_t len);
|
|---|
| 73 | int (*set_pub_key) (EVP_PKEY *pk, const unsigned char *pub, size_t len);
|
|---|
| 74 | int (*get_priv_key) (const EVP_PKEY *pk, unsigned char *priv, size_t *len);
|
|---|
| 75 | int (*get_pub_key) (const EVP_PKEY *pk, unsigned char *pub, size_t *len);
|
|---|
| 76 |
|
|---|
| 77 | /* Exports and imports to / from providers */
|
|---|
| 78 | size_t (*dirty_cnt) (const EVP_PKEY *pk);
|
|---|
| 79 | int (*export_to) (const EVP_PKEY *pk, void *to_keydata,
|
|---|
| 80 | OSSL_FUNC_keymgmt_import_fn *importer,
|
|---|
| 81 | OSSL_LIB_CTX *libctx, const char *propq);
|
|---|
| 82 | OSSL_CALLBACK *import_from;
|
|---|
| 83 | int (*copy) (EVP_PKEY *to, EVP_PKEY *from);
|
|---|
| 84 |
|
|---|
| 85 | int (*priv_decode_ex) (EVP_PKEY *pk,
|
|---|
| 86 | const PKCS8_PRIV_KEY_INFO *p8inf,
|
|---|
| 87 | OSSL_LIB_CTX *libctx,
|
|---|
| 88 | const char *propq);
|
|---|
| 89 | } /* EVP_PKEY_ASN1_METHOD */ ;
|
|---|
| 90 |
|
|---|
| 91 | DEFINE_STACK_OF_CONST(EVP_PKEY_ASN1_METHOD)
|
|---|
| 92 |
|
|---|
| 93 | extern const EVP_PKEY_ASN1_METHOD ossl_dh_asn1_meth;
|
|---|
| 94 | extern const EVP_PKEY_ASN1_METHOD ossl_dhx_asn1_meth;
|
|---|
| 95 | extern const EVP_PKEY_ASN1_METHOD ossl_dsa_asn1_meths[5];
|
|---|
| 96 | extern const EVP_PKEY_ASN1_METHOD ossl_eckey_asn1_meth;
|
|---|
| 97 | extern const EVP_PKEY_ASN1_METHOD ossl_ecx25519_asn1_meth;
|
|---|
| 98 | extern const EVP_PKEY_ASN1_METHOD ossl_ecx448_asn1_meth;
|
|---|
| 99 | extern const EVP_PKEY_ASN1_METHOD ossl_ed25519_asn1_meth;
|
|---|
| 100 | extern const EVP_PKEY_ASN1_METHOD ossl_ed448_asn1_meth;
|
|---|
| 101 | extern const EVP_PKEY_ASN1_METHOD ossl_sm2_asn1_meth;
|
|---|
| 102 |
|
|---|
| 103 | extern const EVP_PKEY_ASN1_METHOD ossl_rsa_asn1_meths[2];
|
|---|
| 104 | extern const EVP_PKEY_ASN1_METHOD ossl_rsa_pss_asn1_meth;
|
|---|
| 105 |
|
|---|
| 106 | /*
|
|---|
| 107 | * These are used internally in the ASN1_OBJECT to keep track of whether the
|
|---|
| 108 | * names and data need to be free()ed
|
|---|
| 109 | */
|
|---|
| 110 | # define ASN1_OBJECT_FLAG_DYNAMIC 0x01/* internal use */
|
|---|
| 111 | # define ASN1_OBJECT_FLAG_CRITICAL 0x02/* critical x509v3 object id */
|
|---|
| 112 | # define ASN1_OBJECT_FLAG_DYNAMIC_STRINGS 0x04/* internal use */
|
|---|
| 113 | # define ASN1_OBJECT_FLAG_DYNAMIC_DATA 0x08/* internal use */
|
|---|
| 114 | struct asn1_object_st {
|
|---|
| 115 | const char *sn, *ln;
|
|---|
| 116 | int nid;
|
|---|
| 117 | int length;
|
|---|
| 118 | const unsigned char *data; /* data remains const after init */
|
|---|
| 119 | int flags; /* Should we free this one */
|
|---|
| 120 | };
|
|---|
| 121 |
|
|---|
| 122 | /* ASN1 print context structure */
|
|---|
| 123 |
|
|---|
| 124 | struct asn1_pctx_st {
|
|---|
| 125 | unsigned long flags;
|
|---|
| 126 | unsigned long nm_flags;
|
|---|
| 127 | unsigned long cert_flags;
|
|---|
| 128 | unsigned long oid_flags;
|
|---|
| 129 | unsigned long str_flags;
|
|---|
| 130 | } /* ASN1_PCTX */ ;
|
|---|
| 131 |
|
|---|
| 132 | /* ASN1 type functions */
|
|---|
| 133 |
|
|---|
| 134 | int ossl_asn1_type_set_octetstring_int(ASN1_TYPE *a, long num,
|
|---|
| 135 | unsigned char *data, int len);
|
|---|
| 136 | int ossl_asn1_type_get_octetstring_int(const ASN1_TYPE *a, long *num,
|
|---|
| 137 | unsigned char *data, int max_len);
|
|---|
| 138 |
|
|---|
| 139 | int ossl_x509_algor_new_from_md(X509_ALGOR **palg, const EVP_MD *md);
|
|---|
| 140 | const EVP_MD *ossl_x509_algor_get_md(X509_ALGOR *alg);
|
|---|
| 141 | X509_ALGOR *ossl_x509_algor_mgf1_decode(X509_ALGOR *alg);
|
|---|
| 142 | int ossl_x509_algor_md_to_mgf1(X509_ALGOR **palg, const EVP_MD *mgf1md);
|
|---|
| 143 | int ossl_asn1_time_print_ex(BIO *bp, const ASN1_TIME *tm, unsigned long flags);
|
|---|
| 144 |
|
|---|
| 145 | EVP_PKEY * ossl_d2i_PrivateKey_legacy(int keytype, EVP_PKEY **a,
|
|---|
| 146 | const unsigned char **pp, long length,
|
|---|
| 147 | OSSL_LIB_CTX *libctx, const char *propq);
|
|---|
| 148 |
|
|---|
| 149 | #endif /* ndef OSSL_CRYPTO_ASN1_H */
|
|---|
