lib/x509asn1.h

   1 #ifndef HEADER_CURL_X509ASN1_H
   2 #define HEADER_CURL_X509ASN1_H
   3
   4 /***************************************************************************
   5  *                                  _   _ ____  _
   6  *  Project                     ___| | | |  _ \| |
   7  *                             / __| | | | |_) | |
   8  *                            | (__| |_| |  _ <| |___
   9  *                             \___|\___/|_| \_\_____|
  10  *
  11  * Copyright (C) 1998 - 2016, Daniel Stenberg, <daniel@haxx.se>, et al.
  12  *
  13  * This software is licensed as described in the file COPYING, which
  14  * you should have received as part of this distribution. The terms
  15  * are also available at https://curl.haxx.se/docs/copyright.html.
  16  *
  17  * You may opt to use, copy, modify, merge, publish, distribute and/or sell
  18  * copies of the Software, and permit persons to whom the Software is
  19  * furnished to do so, under the terms of the COPYING file.
  20  *
  21  * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
  22  * KIND, either express or implied.
  23  *
  24  ***************************************************************************/
  25
  26 #include "curl_setup.h"
  27
  28 #if defined(USE_GSKIT) || defined(USE_NSS) || defined(USE_GNUTLS) || \
  29     defined(USE_CYASSL) || defined(USE_SCHANNEL)
  30
  31 #include "urldata.h"
  32
  33 /*
  34  * Constants.
  35  */
  36
  37 /* Largest supported ASN.1 structure. */
  38 #define CURL_ASN1_MAX                   ((size_t) 0x40000)      /* 256K */
  39
  40 /* ASN.1 classes. */
  41 #define CURL_ASN1_UNIVERSAL             0
  42 #define CURL_ASN1_APPLICATION           1
  43 #define CURL_ASN1_CONTEXT_SPECIFIC      2
  44 #define CURL_ASN1_PRIVATE               3
  45
  46 /* ASN.1 types. */
  47 #define CURL_ASN1_BOOLEAN               1
  48 #define CURL_ASN1_INTEGER               2
  49 #define CURL_ASN1_BIT_STRING            3
  50 #define CURL_ASN1_OCTET_STRING          4
  51 #define CURL_ASN1_NULL                  5
  52 #define CURL_ASN1_OBJECT_IDENTIFIER     6
  53 #define CURL_ASN1_OBJECT_DESCRIPTOR     7
  54 #define CURL_ASN1_INSTANCE_OF           8
  55 #define CURL_ASN1_REAL                  9
  56 #define CURL_ASN1_ENUMERATED            10
  57 #define CURL_ASN1_EMBEDDED              11
  58 #define CURL_ASN1_UTF8_STRING           12
  59 #define CURL_ASN1_RELATIVE_OID          13
  60 #define CURL_ASN1_SEQUENCE              16
  61 #define CURL_ASN1_SET                   17
  62 #define CURL_ASN1_NUMERIC_STRING        18
  63 #define CURL_ASN1_PRINTABLE_STRING      19
  64 #define CURL_ASN1_TELETEX_STRING        20
  65 #define CURL_ASN1_VIDEOTEX_STRING       21
  66 #define CURL_ASN1_IA5_STRING            22
  67 #define CURL_ASN1_UTC_TIME              23
  68 #define CURL_ASN1_GENERALIZED_TIME      24
  69 #define CURL_ASN1_GRAPHIC_STRING        25
  70 #define CURL_ASN1_VISIBLE_STRING        26
  71 #define CURL_ASN1_GENERAL_STRING        27
  72 #define CURL_ASN1_UNIVERSAL_STRING      28
  73 #define CURL_ASN1_CHARACTER_STRING      29
  74 #define CURL_ASN1_BMP_STRING            30
  75
  76
  77 /*
  78  * Types.
  79  */
  80
  81 /* ASN.1 parsed element. */
  82 typedef struct {
  83   const char *  header;         /* Pointer to header byte. */
  84   const char *  beg;            /* Pointer to element data. */
  85   const char *  end;            /* Pointer to 1st byte after element. */
  86   unsigned char class;          /* ASN.1 element class. */
  87   unsigned char tag;            /* ASN.1 element tag. */
  88   bool          constructed;    /* Element is constructed. */
  89 }  curl_asn1Element;
  90
  91
  92 /* ASN.1 OID table entry. */
  93 typedef struct {
  94   const char *  numoid;         /* Dotted-numeric OID. */
  95   const char *  textoid;        /* OID name. */
  96 }  curl_OID;
  97
  98
  99 /* X509 certificate: RFC 5280. */
 100 typedef struct {
 101   curl_asn1Element      certificate;
 102   curl_asn1Element      version;
 103   curl_asn1Element      serialNumber;
 104   curl_asn1Element      signatureAlgorithm;
 105   curl_asn1Element      signature;
 106   curl_asn1Element      issuer;
 107   curl_asn1Element      notBefore;
 108   curl_asn1Element      notAfter;
 109   curl_asn1Element      subject;
 110   curl_asn1Element      subjectPublicKeyInfo;
 111   curl_asn1Element      subjectPublicKeyAlgorithm;
 112   curl_asn1Element      subjectPublicKey;
 113   curl_asn1Element      issuerUniqueID;
 114   curl_asn1Element      subjectUniqueID;
 115   curl_asn1Element      extensions;
 116 }  curl_X509certificate;
 117
 118
 119 /*
 120  * Prototypes.
 121  */
 122
 123 const char *Curl_getASN1Element(curl_asn1Element *elem,
 124                                  const char *beg, const char *end);
 125 const char *Curl_ASN1tostr(curl_asn1Element *elem, int type);
 126 const char *Curl_DNtostr(curl_asn1Element *dn);
 127 int Curl_parseX509(curl_X509certificate *cert,
 128                    const char *beg, const char *end);
 129 CURLcode Curl_extract_certinfo(struct connectdata *conn, int certnum,
 130                                const char *beg, const char *end);
 131 CURLcode Curl_verifyhost(struct connectdata *conn,
 132                          const char *beg, const char *end);
 133 #endif /* USE_GSKIT or USE_NSS or USE_GNUTLS or USE_CYASSL or USE_SCHANNEL */
 134 #endif /* HEADER_CURL_X509ASN1_H */