crypto/ct/ct_locl.h

   1 /*
   2  * Written by Rob Percival (robpercival@google.com) for the OpenSSL project.
   3  */
   4 /* ====================================================================
   5  * Copyright (c) 2016 The OpenSSL Project.  All rights reserved.
   6  *
   7  * Redistribution and use in source and binary forms, with or without
   8  * modification, are permitted provided that the following conditions
   9  * are met:
  10  *
  11  * 1. Redistributions of source code must retain the above copyright
  12  *    notice, this list of conditions and the following disclaimer.
  13  *
  14  * 2. Redistributions in binary form must reproduce the above copyright
  15  *    notice, this list of conditions and the following disclaimer in
  16  *    the documentation and/or other materials provided with the
  17  *    distribution.
  18  *
  19  * 3. All advertising materials mentioning features or use of this
  20  *    software must display the following acknowledgment:
  21  *    "This product includes software developed by the OpenSSL Project
  22  *    for use in the OpenSSL Toolkit. (http://www.OpenSSL.org/)"
  23  *
  24  * 4. The names "OpenSSL Toolkit" and "OpenSSL Project" must not be used to
  25  *    endorse or promote products derived from this software without
  26  *    prior written permission. For written permission, please contact
  27  *    licensing@OpenSSL.org.
  28  *
  29  * 5. Products derived from this software may not be called "OpenSSL"
  30  *    nor may "OpenSSL" appear in their names without prior written
  31  *    permission of the OpenSSL Project.
  32  *
  33  * 6. Redistributions of any form whatsoever must retain the following
  34  *    acknowledgment:
  35  *    "This product includes software developed by the OpenSSL Project
  36  *    for use in the OpenSSL Toolkit (http://www.OpenSSL.org/)"
  37  *
  38  * THIS SOFTWARE IS PROVIDED BY THE OpenSSL PROJECT ``AS IS'' AND ANY
  39  * EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  40  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
  41  * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE OpenSSL PROJECT OR
  42  * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
  43  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
  44  * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
  45  * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  46  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
  47  * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
  48  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
  49  * OF THE POSSIBILITY OF SUCH DAMAGE.
  50  * ====================================================================
  51  */
  52
  53 #ifdef OPENSSL_NO_CT
  54 # error CT is disabled.
  55 #endif
  56
  57 #include <stddef.h>
  58
  59 #include <openssl/ct.h>
  60 #include <openssl/evp.h>
  61 #include <openssl/x509.h>
  62 #include <openssl/safestack.h>
  63
  64 /*
  65  * From RFC6962: opaque SerializedSCT<1..2^16-1>; struct { SerializedSCT
  66  * sct_list <1..2^16-1>; } SignedCertificateTimestampList;
  67  */
  68 # define MAX_SCT_SIZE            65535
  69 # define MAX_SCT_LIST_SIZE       MAX_SCT_SIZE
  70
  71 /* Signed Certificate Timestamp */
  72 struct sct_st {
  73     sct_version_t version;
  74     /* If version is not SCT_VERSION_V1, this contains the encoded SCT */
  75     unsigned char *sct;
  76     size_t sct_len;
  77     /* If version is SCT_VERSION_V1, fields below contain components of the SCT */
  78     unsigned char *log_id;
  79     size_t log_id_len;
  80     /*
  81     * Note, we cannot distinguish between an unset timestamp, and one
  82     * that is set to 0.  However since CT didn't exist in 1970, no real
  83     * SCT should ever be set as such.
  84     */
  85     uint64_t timestamp;
  86     unsigned char *ext;
  87     size_t ext_len;
  88     unsigned char hash_alg;
  89     unsigned char sig_alg;
  90     unsigned char *sig;
  91     size_t sig_len;
  92     /* Log entry type */
  93     ct_log_entry_type_t entry_type;
  94 };
  95
  96 /*
  97  * Does this SCT have the minimum fields populated to be usuable?
  98  * Returns 1 if so, 0 otherwise.
  99  */
 100 int SCT_is_complete(const SCT *sct);
 101
 102 /*
 103  * Does this SCT have the signature-related fields populated?
 104  * Returns 1 if so, 0 otherwise.
 105  * This checks that the signature and hash algorithms are set to supported
 106  * values and that the signature field is set.
 107  */
 108 int SCT_signature_is_complete(const SCT *sct);
 109
 110