include/openssl/ocsp.h

   1 /*
   2  * Copyright 2000-2020 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 OPENSSL_OCSP_H
  11 # define OPENSSL_OCSP_H
  12 # pragma once
  13
  14 # include <openssl/macros.h>
  15 # ifndef OPENSSL_NO_DEPRECATED_3_0
  16 #  define HEADER_OCSP_H
  17 # endif
  18
  19 # include <openssl/opensslconf.h>
  20
  21 /*
  22  * These definitions are outside the OPENSSL_NO_OCSP guard because although for
  23  * historical reasons they have OCSP_* names, they can actually be used
  24  * independently of OCSP. E.g. see RFC5280
  25  */
  26 /*-
  27  *   CRLReason ::= ENUMERATED {
  28  *        unspecified             (0),
  29  *        keyCompromise           (1),
  30  *        cACompromise            (2),
  31  *        affiliationChanged      (3),
  32  *        superseded              (4),
  33  *        cessationOfOperation    (5),
  34  *        certificateHold         (6),
  35  *        -- value 7 is not used
  36  *        removeFromCRL           (8),
  37  *        privilegeWithdrawn      (9),
  38  *        aACompromise           (10) }
  39  */
  40 # define OCSP_REVOKED_STATUS_NOSTATUS                -1
  41 # define OCSP_REVOKED_STATUS_UNSPECIFIED             0
  42 # define OCSP_REVOKED_STATUS_KEYCOMPROMISE           1
  43 # define OCSP_REVOKED_STATUS_CACOMPROMISE            2
  44 # define OCSP_REVOKED_STATUS_AFFILIATIONCHANGED      3
  45 # define OCSP_REVOKED_STATUS_SUPERSEDED              4
  46 # define OCSP_REVOKED_STATUS_CESSATIONOFOPERATION    5
  47 # define OCSP_REVOKED_STATUS_CERTIFICATEHOLD         6
  48 # define OCSP_REVOKED_STATUS_REMOVEFROMCRL           8
  49 # define OCSP_REVOKED_STATUS_PRIVILEGEWITHDRAWN      9
  50 # define OCSP_REVOKED_STATUS_AACOMPROMISE            10
  51
  52 /*
  53  * These definitions are outside the OPENSSL_NO_OCSP guard because although for
  54  * historical reasons they have OCSP_* names, they are used for the HTTP client.
  55  */
  56 # include <openssl/asn1.h>
  57 /* The following functions are used only internally */
  58 OCSP_REQ_CTX *OCSP_REQ_CTX_new(BIO *wbio, BIO *rbio,
  59                                int method_GET, int maxline,
  60                                unsigned long max_resp_len, int timeout,
  61                                const char *expected_content_type,
  62                                int expect_asn1);
  63 void OCSP_REQ_CTX_free(OCSP_REQ_CTX *rctx);
  64 int OCSP_REQ_CTX_http(OCSP_REQ_CTX *rctx,
  65                       const char *server, const char *port, const char *path);
  66 int OCSP_REQ_CTX_add1_header(OCSP_REQ_CTX *rctx,
  67                              const char *name, const char *value);
  68 int OCSP_REQ_CTX_i2d(OCSP_REQ_CTX *rctx, const char *content_type,
  69                      const ASN1_ITEM *it, ASN1_VALUE *req);
  70 int OCSP_REQ_CTX_nbio(OCSP_REQ_CTX *rctx);
  71 # ifndef OPENSSL_NO_SOCK
  72 ASN1_VALUE *OCSP_REQ_CTX_nbio_d2i(OCSP_REQ_CTX *rctx, const ASN1_ITEM *it);
  73 # endif
  74 BIO *OCSP_REQ_CTX_get0_mem_bio(OCSP_REQ_CTX *rctx);
  75 void OCSP_set_max_response_length(OCSP_REQ_CTX *rctx, unsigned long len);
  76 /* End of functions used only internally */
  77
  78
  79 # ifndef OPENSSL_NO_OCSP
  80
  81 #  include <openssl/x509.h>
  82 #  include <openssl/x509v3.h>
  83 #  include <openssl/safestack.h>
  84 #  include <openssl/ocsperr.h>
  85
  86 #  ifdef __cplusplus
  87 extern "C" {
  88 #  endif
  89
  90 /* Various flags and values */
  91
  92 #  define OCSP_DEFAULT_NONCE_LENGTH       16
  93
  94 #  define OCSP_NOCERTS                    0x1
  95 #  define OCSP_NOINTERN                   0x2
  96 #  define OCSP_NOSIGS                     0x4
  97 #  define OCSP_NOCHAIN                    0x8
  98 #  define OCSP_NOVERIFY                   0x10
  99 #  define OCSP_NOEXPLICIT                 0x20
 100 #  define OCSP_NOCASIGN                   0x40
 101 #  define OCSP_NODELEGATED                0x80
 102 #  define OCSP_NOCHECKS                   0x100
 103 #  define OCSP_TRUSTOTHER                 0x200
 104 #  define OCSP_RESPID_KEY                 0x400
 105 #  define OCSP_NOTIME                     0x800
 106
 107 typedef struct ocsp_cert_id_st OCSP_CERTID;
 108
 109 DEFINE_STACK_OF(OCSP_CERTID)
 110
 111 typedef struct ocsp_one_request_st OCSP_ONEREQ;
 112
 113 DEFINE_STACK_OF(OCSP_ONEREQ)
 114
 115 typedef struct ocsp_req_info_st OCSP_REQINFO;
 116 typedef struct ocsp_signature_st OCSP_SIGNATURE;
 117 typedef struct ocsp_request_st OCSP_REQUEST;
 118
 119 #  define OCSP_RESPONSE_STATUS_SUCCESSFUL           0
 120 #  define OCSP_RESPONSE_STATUS_MALFORMEDREQUEST     1
 121 #  define OCSP_RESPONSE_STATUS_INTERNALERROR        2
 122 #  define OCSP_RESPONSE_STATUS_TRYLATER             3
 123 #  define OCSP_RESPONSE_STATUS_SIGREQUIRED          5
 124 #  define OCSP_RESPONSE_STATUS_UNAUTHORIZED         6
 125
 126 typedef struct ocsp_resp_bytes_st OCSP_RESPBYTES;
 127
 128 #  define V_OCSP_RESPID_NAME 0
 129 #  define V_OCSP_RESPID_KEY  1
 130
 131 DEFINE_STACK_OF(OCSP_RESPID)
 132
 133 typedef struct ocsp_revoked_info_st OCSP_REVOKEDINFO;
 134
 135 #  define V_OCSP_CERTSTATUS_GOOD    0
 136 #  define V_OCSP_CERTSTATUS_REVOKED 1
 137 #  define V_OCSP_CERTSTATUS_UNKNOWN 2
 138
 139 typedef struct ocsp_cert_status_st OCSP_CERTSTATUS;
 140 typedef struct ocsp_single_response_st OCSP_SINGLERESP;
 141
 142 DEFINE_STACK_OF(OCSP_SINGLERESP)
 143
 144 typedef struct ocsp_response_data_st OCSP_RESPDATA;
 145
 146 typedef struct ocsp_basic_response_st OCSP_BASICRESP;
 147
 148 typedef struct ocsp_crl_id_st OCSP_CRLID;
 149 typedef struct ocsp_service_locator_st OCSP_SERVICELOC;
 150
 151 #  define PEM_STRING_OCSP_REQUEST "OCSP REQUEST"
 152 #  define PEM_STRING_OCSP_RESPONSE "OCSP RESPONSE"
 153
 154 #  define d2i_OCSP_REQUEST_bio(bp,p) ASN1_d2i_bio_of(OCSP_REQUEST,OCSP_REQUEST_new,d2i_OCSP_REQUEST,bp,p)
 155
 156 #  define d2i_OCSP_RESPONSE_bio(bp,p) ASN1_d2i_bio_of(OCSP_RESPONSE,OCSP_RESPONSE_new,d2i_OCSP_RESPONSE,bp,p)
 157
 158 #  define PEM_read_bio_OCSP_REQUEST(bp,x,cb) (OCSP_REQUEST *)PEM_ASN1_read_bio( \
 159      (char *(*)())d2i_OCSP_REQUEST,PEM_STRING_OCSP_REQUEST, \
 160      bp,(char **)(x),cb,NULL)
 161
 162 #  define PEM_read_bio_OCSP_RESPONSE(bp,x,cb) (OCSP_RESPONSE *)PEM_ASN1_read_bio(\
 163      (char *(*)())d2i_OCSP_RESPONSE,PEM_STRING_OCSP_RESPONSE, \
 164      bp,(char **)(x),cb,NULL)
 165
 166 #  define PEM_write_bio_OCSP_REQUEST(bp,o) \
 167     PEM_ASN1_write_bio((int (*)())i2d_OCSP_REQUEST,PEM_STRING_OCSP_REQUEST,\
 168                         bp,(char *)(o), NULL,NULL,0,NULL,NULL)
 169
 170 #  define PEM_write_bio_OCSP_RESPONSE(bp,o) \
 171     PEM_ASN1_write_bio((int (*)())i2d_OCSP_RESPONSE,PEM_STRING_OCSP_RESPONSE,\
 172                         bp,(char *)(o), NULL,NULL,0,NULL,NULL)
 173
 174 #  define i2d_OCSP_RESPONSE_bio(bp,o) ASN1_i2d_bio_of(OCSP_RESPONSE,i2d_OCSP_RESPONSE,bp,o)
 175
 176 #  define i2d_OCSP_REQUEST_bio(bp,o) ASN1_i2d_bio_of(OCSP_REQUEST,i2d_OCSP_REQUEST,bp,o)
 177
 178 #  define ASN1_BIT_STRING_digest(data,type,md,len) \
 179         ASN1_item_digest(ASN1_ITEM_rptr(ASN1_BIT_STRING),type,data,md,len)
 180
 181 #  define OCSP_CERTSTATUS_dup(cs)\
 182                 (OCSP_CERTSTATUS*)ASN1_dup((int(*)())i2d_OCSP_CERTSTATUS,\
 183                 (char *(*)())d2i_OCSP_CERTSTATUS,(char *)(cs))
 184
 185 DECLARE_ASN1_DUP_FUNCTION(OCSP_CERTID)
 186
 187 OCSP_RESPONSE *OCSP_sendreq_bio(BIO *b, const char *path, OCSP_REQUEST *req);
 188 OCSP_REQ_CTX *OCSP_sendreq_new(BIO *io, const char *path, OCSP_REQUEST *req,
 189                                int maxline);
 190 #  ifndef OPENSSL_NO_SOCK
 191 int OCSP_sendreq_nbio(OCSP_RESPONSE **presp, OCSP_REQ_CTX *rctx);
 192 #  endif
 193
 194 /* TODO: remove this (documented but) meanwhile obsolete function? */
 195 int OCSP_REQ_CTX_set1_req(OCSP_REQ_CTX *rctx, const OCSP_REQUEST *req);
 196
 197 OCSP_CERTID *OCSP_cert_to_id(const EVP_MD *dgst, const X509 *subject,
 198                              const X509 *issuer);
 199
 200 OCSP_CERTID *OCSP_cert_id_new(const EVP_MD *dgst,
 201                               const X509_NAME *issuerName,
 202                               const ASN1_BIT_STRING *issuerKey,
 203                               const ASN1_INTEGER *serialNumber);
 204
 205 OCSP_ONEREQ *OCSP_request_add0_id(OCSP_REQUEST *req, OCSP_CERTID *cid);
 206
 207 int OCSP_request_add1_nonce(OCSP_REQUEST *req, unsigned char *val, int len);
 208 int OCSP_basic_add1_nonce(OCSP_BASICRESP *resp, unsigned char *val, int len);
 209 int OCSP_check_nonce(OCSP_REQUEST *req, OCSP_BASICRESP *bs);
 210 int OCSP_copy_nonce(OCSP_BASICRESP *resp, OCSP_REQUEST *req);
 211
 212 int OCSP_request_set1_name(OCSP_REQUEST *req, X509_NAME *nm);
 213 int OCSP_request_add1_cert(OCSP_REQUEST *req, X509 *cert);
 214
 215 int OCSP_request_sign(OCSP_REQUEST *req,
 216                       X509 *signer,
 217                       EVP_PKEY *key,
 218                       const EVP_MD *dgst,
 219                       STACK_OF(X509) *certs, unsigned long flags);
 220
 221 int OCSP_response_status(OCSP_RESPONSE *resp);
 222 OCSP_BASICRESP *OCSP_response_get1_basic(OCSP_RESPONSE *resp);
 223
 224 const ASN1_OCTET_STRING *OCSP_resp_get0_signature(const OCSP_BASICRESP *bs);
 225 const X509_ALGOR *OCSP_resp_get0_tbs_sigalg(const OCSP_BASICRESP *bs);
 226 const OCSP_RESPDATA *OCSP_resp_get0_respdata(const OCSP_BASICRESP *bs);
 227 int OCSP_resp_get0_signer(OCSP_BASICRESP *bs, X509 **signer,
 228                           STACK_OF(X509) *extra_certs);
 229
 230 int OCSP_resp_count(OCSP_BASICRESP *bs);
 231 OCSP_SINGLERESP *OCSP_resp_get0(OCSP_BASICRESP *bs, int idx);
 232 const ASN1_GENERALIZEDTIME *OCSP_resp_get0_produced_at(const OCSP_BASICRESP* bs);
 233 const STACK_OF(X509) *OCSP_resp_get0_certs(const OCSP_BASICRESP *bs);
 234 int OCSP_resp_get0_id(const OCSP_BASICRESP *bs,
 235                       const ASN1_OCTET_STRING **pid,
 236                       const X509_NAME **pname);
 237 int OCSP_resp_get1_id(const OCSP_BASICRESP *bs,
 238                       ASN1_OCTET_STRING **pid,
 239                       X509_NAME **pname);
 240
 241 int OCSP_resp_find(OCSP_BASICRESP *bs, OCSP_CERTID *id, int last);
 242 int OCSP_single_get0_status(OCSP_SINGLERESP *single, int *reason,
 243                             ASN1_GENERALIZEDTIME **revtime,
 244                             ASN1_GENERALIZEDTIME **thisupd,
 245                             ASN1_GENERALIZEDTIME **nextupd);
 246 int OCSP_resp_find_status(OCSP_BASICRESP *bs, OCSP_CERTID *id, int *status,
 247                           int *reason,
 248                           ASN1_GENERALIZEDTIME **revtime,
 249                           ASN1_GENERALIZEDTIME **thisupd,
 250                           ASN1_GENERALIZEDTIME **nextupd);
 251 int OCSP_check_validity(ASN1_GENERALIZEDTIME *thisupd,
 252                         ASN1_GENERALIZEDTIME *nextupd, long sec, long maxsec);
 253
 254 int OCSP_request_verify(OCSP_REQUEST *req, STACK_OF(X509) *certs,
 255                         X509_STORE *store, unsigned long flags);
 256
 257 #  define OCSP_parse_url OSSL_HTTP_parse_url /* for backward compatibility */
 258
 259 int OCSP_id_issuer_cmp(const OCSP_CERTID *a, const OCSP_CERTID *b);
 260 int OCSP_id_cmp(const OCSP_CERTID *a, const OCSP_CERTID *b);
 261
 262 int OCSP_request_onereq_count(OCSP_REQUEST *req);
 263 OCSP_ONEREQ *OCSP_request_onereq_get0(OCSP_REQUEST *req, int i);
 264 OCSP_CERTID *OCSP_onereq_get0_id(OCSP_ONEREQ *one);
 265 int OCSP_id_get0_info(ASN1_OCTET_STRING **piNameHash, ASN1_OBJECT **pmd,
 266                       ASN1_OCTET_STRING **pikeyHash,
 267                       ASN1_INTEGER **pserial, OCSP_CERTID *cid);
 268 int OCSP_request_is_signed(OCSP_REQUEST *req);
 269 OCSP_RESPONSE *OCSP_response_create(int status, OCSP_BASICRESP *bs);
 270 OCSP_SINGLERESP *OCSP_basic_add1_status(OCSP_BASICRESP *rsp,
 271                                         OCSP_CERTID *cid,
 272                                         int status, int reason,
 273                                         ASN1_TIME *revtime,
 274                                         ASN1_TIME *thisupd,
 275                                         ASN1_TIME *nextupd);
 276 int OCSP_basic_add1_cert(OCSP_BASICRESP *resp, X509 *cert);
 277 int OCSP_basic_sign(OCSP_BASICRESP *brsp,
 278                     X509 *signer, EVP_PKEY *key, const EVP_MD *dgst,
 279                     STACK_OF(X509) *certs, unsigned long flags);
 280 int OCSP_basic_sign_ctx(OCSP_BASICRESP *brsp,
 281                         X509 *signer, EVP_MD_CTX *ctx,
 282                         STACK_OF(X509) *certs, unsigned long flags);
 283 int OCSP_RESPID_set_by_name(OCSP_RESPID *respid, X509 *cert);
 284 int OCSP_RESPID_set_by_key(OCSP_RESPID *respid, X509 *cert);
 285 int OCSP_RESPID_match(OCSP_RESPID *respid, X509 *cert);
 286
 287 X509_EXTENSION *OCSP_crlID_new(const char *url, long *n, char *tim);
 288
 289 X509_EXTENSION *OCSP_accept_responses_new(char **oids);
 290
 291 X509_EXTENSION *OCSP_archive_cutoff_new(char *tim);
 292
 293 X509_EXTENSION *OCSP_url_svcloc_new(X509_NAME *issuer, const char **urls);
 294
 295 int OCSP_REQUEST_get_ext_count(OCSP_REQUEST *x);
 296 int OCSP_REQUEST_get_ext_by_NID(OCSP_REQUEST *x, int nid, int lastpos);
 297 int OCSP_REQUEST_get_ext_by_OBJ(OCSP_REQUEST *x, const ASN1_OBJECT *obj,
 298                                 int lastpos);
 299 int OCSP_REQUEST_get_ext_by_critical(OCSP_REQUEST *x, int crit, int lastpos);
 300 X509_EXTENSION *OCSP_REQUEST_get_ext(OCSP_REQUEST *x, int loc);
 301 X509_EXTENSION *OCSP_REQUEST_delete_ext(OCSP_REQUEST *x, int loc);
 302 void *OCSP_REQUEST_get1_ext_d2i(OCSP_REQUEST *x, int nid, int *crit,
 303                                 int *idx);
 304 int OCSP_REQUEST_add1_ext_i2d(OCSP_REQUEST *x, int nid, void *value, int crit,
 305                               unsigned long flags);
 306 int OCSP_REQUEST_add_ext(OCSP_REQUEST *x, X509_EXTENSION *ex, int loc);
 307
 308 int OCSP_ONEREQ_get_ext_count(OCSP_ONEREQ *x);
 309 int OCSP_ONEREQ_get_ext_by_NID(OCSP_ONEREQ *x, int nid, int lastpos);
 310 int OCSP_ONEREQ_get_ext_by_OBJ(OCSP_ONEREQ *x, const ASN1_OBJECT *obj, int lastpos);
 311 int OCSP_ONEREQ_get_ext_by_critical(OCSP_ONEREQ *x, int crit, int lastpos);
 312 X509_EXTENSION *OCSP_ONEREQ_get_ext(OCSP_ONEREQ *x, int loc);
 313 X509_EXTENSION *OCSP_ONEREQ_delete_ext(OCSP_ONEREQ *x, int loc);
 314 void *OCSP_ONEREQ_get1_ext_d2i(OCSP_ONEREQ *x, int nid, int *crit, int *idx);
 315 int OCSP_ONEREQ_add1_ext_i2d(OCSP_ONEREQ *x, int nid, void *value, int crit,
 316                              unsigned long flags);
 317 int OCSP_ONEREQ_add_ext(OCSP_ONEREQ *x, X509_EXTENSION *ex, int loc);
 318
 319 int OCSP_BASICRESP_get_ext_count(OCSP_BASICRESP *x);
 320 int OCSP_BASICRESP_get_ext_by_NID(OCSP_BASICRESP *x, int nid, int lastpos);
 321 int OCSP_BASICRESP_get_ext_by_OBJ(OCSP_BASICRESP *x, const ASN1_OBJECT *obj,
 322                                   int lastpos);
 323 int OCSP_BASICRESP_get_ext_by_critical(OCSP_BASICRESP *x, int crit,
 324                                        int lastpos);
 325 X509_EXTENSION *OCSP_BASICRESP_get_ext(OCSP_BASICRESP *x, int loc);
 326 X509_EXTENSION *OCSP_BASICRESP_delete_ext(OCSP_BASICRESP *x, int loc);
 327 void *OCSP_BASICRESP_get1_ext_d2i(OCSP_BASICRESP *x, int nid, int *crit,
 328                                   int *idx);
 329 int OCSP_BASICRESP_add1_ext_i2d(OCSP_BASICRESP *x, int nid, void *value,
 330                                 int crit, unsigned long flags);
 331 int OCSP_BASICRESP_add_ext(OCSP_BASICRESP *x, X509_EXTENSION *ex, int loc);
 332
 333 int OCSP_SINGLERESP_get_ext_count(OCSP_SINGLERESP *x);
 334 int OCSP_SINGLERESP_get_ext_by_NID(OCSP_SINGLERESP *x, int nid, int lastpos);
 335 int OCSP_SINGLERESP_get_ext_by_OBJ(OCSP_SINGLERESP *x, const ASN1_OBJECT *obj,
 336                                    int lastpos);
 337 int OCSP_SINGLERESP_get_ext_by_critical(OCSP_SINGLERESP *x, int crit,
 338                                         int lastpos);
 339 X509_EXTENSION *OCSP_SINGLERESP_get_ext(OCSP_SINGLERESP *x, int loc);
 340 X509_EXTENSION *OCSP_SINGLERESP_delete_ext(OCSP_SINGLERESP *x, int loc);
 341 void *OCSP_SINGLERESP_get1_ext_d2i(OCSP_SINGLERESP *x, int nid, int *crit,
 342                                    int *idx);
 343 int OCSP_SINGLERESP_add1_ext_i2d(OCSP_SINGLERESP *x, int nid, void *value,
 344                                  int crit, unsigned long flags);
 345 int OCSP_SINGLERESP_add_ext(OCSP_SINGLERESP *x, X509_EXTENSION *ex, int loc);
 346 const OCSP_CERTID *OCSP_SINGLERESP_get0_id(const OCSP_SINGLERESP *x);
 347
 348 DECLARE_ASN1_FUNCTIONS(OCSP_SINGLERESP)
 349 DECLARE_ASN1_FUNCTIONS(OCSP_CERTSTATUS)
 350 DECLARE_ASN1_FUNCTIONS(OCSP_REVOKEDINFO)
 351 DECLARE_ASN1_FUNCTIONS(OCSP_BASICRESP)
 352 DECLARE_ASN1_FUNCTIONS(OCSP_RESPDATA)
 353 DECLARE_ASN1_FUNCTIONS(OCSP_RESPID)
 354 DECLARE_ASN1_FUNCTIONS(OCSP_RESPONSE)
 355 DECLARE_ASN1_FUNCTIONS(OCSP_RESPBYTES)
 356 DECLARE_ASN1_FUNCTIONS(OCSP_ONEREQ)
 357 DECLARE_ASN1_FUNCTIONS(OCSP_CERTID)
 358 DECLARE_ASN1_FUNCTIONS(OCSP_REQUEST)
 359 DECLARE_ASN1_FUNCTIONS(OCSP_SIGNATURE)
 360 DECLARE_ASN1_FUNCTIONS(OCSP_REQINFO)
 361 DECLARE_ASN1_FUNCTIONS(OCSP_CRLID)
 362 DECLARE_ASN1_FUNCTIONS(OCSP_SERVICELOC)
 363
 364 const char *OCSP_response_status_str(long s);
 365 const char *OCSP_cert_status_str(long s);
 366 const char *OCSP_crl_reason_str(long s);
 367
 368 int OCSP_REQUEST_print(BIO *bp, OCSP_REQUEST *a, unsigned long flags);
 369 int OCSP_RESPONSE_print(BIO *bp, OCSP_RESPONSE *o, unsigned long flags);
 370
 371 int OCSP_basic_verify(OCSP_BASICRESP *bs, STACK_OF(X509) *certs,
 372                       X509_STORE *st, unsigned long flags);
 373
 374
 375 #  ifdef  __cplusplus
 376 }
 377 #  endif
 378 # endif /* !defined OPENSSL_NO_OCSP */
 379 #endif