[thirdparty/openssl.git] / include / openssl / ocsp.h

/*
 * Copyright 2000-2020 The OpenSSL Project Authors. All Rights Reserved.
 *
 * Licensed under the Apache License 2.0 (the "License").  You may not use
 * this file except in compliance with the License.  You can obtain a copy
 * in the file LICENSE in the source distribution or at
 * https://www.openssl.org/source/license.html
 */

#ifndef OPENSSL_OCSP_H
# define OPENSSL_OCSP_H
# pragma once

# include <openssl/macros.h>
# ifndef OPENSSL_NO_DEPRECATED_3_0
#  define HEADER_OCSP_H
# endif

# include <openssl/opensslconf.h>

/*
 * These definitions are outside the OPENSSL_NO_OCSP guard because although for
 * historical reasons they have OCSP_* names, they can actually be used
 * independently of OCSP. E.g. see RFC5280
 */
/*-
 *   CRLReason ::= ENUMERATED {
 *        unspecified             (0),
 *        keyCompromise           (1),
 *        cACompromise            (2),
 *        affiliationChanged      (3),
 *        superseded              (4),
 *        cessationOfOperation    (5),
 *        certificateHold         (6),
 *        -- value 7 is not used
 *        removeFromCRL           (8),
 *        privilegeWithdrawn      (9),
 *        aACompromise           (10) }
 */
# define OCSP_REVOKED_STATUS_NOSTATUS                -1
# define OCSP_REVOKED_STATUS_UNSPECIFIED             0
# define OCSP_REVOKED_STATUS_KEYCOMPROMISE           1
# define OCSP_REVOKED_STATUS_CACOMPROMISE            2
# define OCSP_REVOKED_STATUS_AFFILIATIONCHANGED      3
# define OCSP_REVOKED_STATUS_SUPERSEDED              4
# define OCSP_REVOKED_STATUS_CESSATIONOFOPERATION    5
# define OCSP_REVOKED_STATUS_CERTIFICATEHOLD         6
# define OCSP_REVOKED_STATUS_REMOVEFROMCRL           8
# define OCSP_REVOKED_STATUS_PRIVILEGEWITHDRAWN      9
# define OCSP_REVOKED_STATUS_AACOMPROMISE            10

/*
 * These definitions are outside the OPENSSL_NO_OCSP guard because although for
 * historical reasons they have OCSP_* names, they are used for the HTTP client.
 */
# include <openssl/asn1.h>
/* The following functions are used only internally */
OCSP_REQ_CTX *OCSP_REQ_CTX_new(BIO *wbio, BIO *rbio,
                               int method_GET, int maxline,
                               unsigned long max_resp_len, int timeout,
                               const char *expected_content_type,
                               int expect_asn1);
void OCSP_REQ_CTX_free(OCSP_REQ_CTX *rctx);
int OCSP_REQ_CTX_http(OCSP_REQ_CTX *rctx,
                      const char *server, const char *port, const char *path);
int OCSP_REQ_CTX_add1_header(OCSP_REQ_CTX *rctx,
                             const char *name, const char *value);
int OCSP_REQ_CTX_i2d(OCSP_REQ_CTX *rctx, const char *content_type,
                     const ASN1_ITEM *it, ASN1_VALUE *req);
int OCSP_REQ_CTX_nbio(OCSP_REQ_CTX *rctx);
ASN1_VALUE *OCSP_REQ_CTX_nbio_d2i(OCSP_REQ_CTX *rctx, const ASN1_ITEM *it);
BIO *OCSP_REQ_CTX_get0_mem_bio(OCSP_REQ_CTX *rctx);
void OCSP_set_max_response_length(OCSP_REQ_CTX *rctx, unsigned long len);
/* End of functions used only internally */


# ifndef OPENSSL_NO_OCSP

#  include <openssl/x509.h>
#  include <openssl/x509v3.h>
#  include <openssl/safestack.h>
#  include <openssl/ocsperr.h>

#  ifdef __cplusplus
extern "C" {
#  endif

/* Various flags and values */

#  define OCSP_DEFAULT_NONCE_LENGTH       16

#  define OCSP_NOCERTS                    0x1
#  define OCSP_NOINTERN                   0x2
#  define OCSP_NOSIGS                     0x4
#  define OCSP_NOCHAIN                    0x8
#  define OCSP_NOVERIFY                   0x10
#  define OCSP_NOEXPLICIT                 0x20
#  define OCSP_NOCASIGN                   0x40
#  define OCSP_NODELEGATED                0x80
#  define OCSP_NOCHECKS                   0x100
#  define OCSP_TRUSTOTHER                 0x200
#  define OCSP_RESPID_KEY                 0x400
#  define OCSP_NOTIME                     0x800

typedef struct ocsp_cert_id_st OCSP_CERTID;

DEFINE_STACK_OF(OCSP_CERTID)

typedef struct ocsp_one_request_st OCSP_ONEREQ;

DEFINE_STACK_OF(OCSP_ONEREQ)

typedef struct ocsp_req_info_st OCSP_REQINFO;
typedef struct ocsp_signature_st OCSP_SIGNATURE;
typedef struct ocsp_request_st OCSP_REQUEST;

#  define OCSP_RESPONSE_STATUS_SUCCESSFUL           0
#  define OCSP_RESPONSE_STATUS_MALFORMEDREQUEST     1
#  define OCSP_RESPONSE_STATUS_INTERNALERROR        2
#  define OCSP_RESPONSE_STATUS_TRYLATER             3
#  define OCSP_RESPONSE_STATUS_SIGREQUIRED          5
#  define OCSP_RESPONSE_STATUS_UNAUTHORIZED         6

typedef struct ocsp_resp_bytes_st OCSP_RESPBYTES;

#  define V_OCSP_RESPID_NAME 0
#  define V_OCSP_RESPID_KEY  1

DEFINE_STACK_OF(OCSP_RESPID)

typedef struct ocsp_revoked_info_st OCSP_REVOKEDINFO;

#  define V_OCSP_CERTSTATUS_GOOD    0
#  define V_OCSP_CERTSTATUS_REVOKED 1
#  define V_OCSP_CERTSTATUS_UNKNOWN 2

typedef struct ocsp_cert_status_st OCSP_CERTSTATUS;
typedef struct ocsp_single_response_st OCSP_SINGLERESP;

DEFINE_STACK_OF(OCSP_SINGLERESP)

typedef struct ocsp_response_data_st OCSP_RESPDATA;

typedef struct ocsp_basic_response_st OCSP_BASICRESP;

typedef struct ocsp_crl_id_st OCSP_CRLID;
typedef struct ocsp_service_locator_st OCSP_SERVICELOC;

#  define PEM_STRING_OCSP_REQUEST "OCSP REQUEST"
#  define PEM_STRING_OCSP_RESPONSE "OCSP RESPONSE"

#  define d2i_OCSP_REQUEST_bio(bp,p) ASN1_d2i_bio_of(OCSP_REQUEST,OCSP_REQUEST_new,d2i_OCSP_REQUEST,bp,p)

#  define d2i_OCSP_RESPONSE_bio(bp,p) ASN1_d2i_bio_of(OCSP_RESPONSE,OCSP_RESPONSE_new,d2i_OCSP_RESPONSE,bp,p)

#  define PEM_read_bio_OCSP_REQUEST(bp,x,cb) (OCSP_REQUEST *)PEM_ASN1_read_bio( \
     (char *(*)())d2i_OCSP_REQUEST,PEM_STRING_OCSP_REQUEST, \
     bp,(char **)(x),cb,NULL)

#  define PEM_read_bio_OCSP_RESPONSE(bp,x,cb) (OCSP_RESPONSE *)PEM_ASN1_read_bio(\
     (char *(*)())d2i_OCSP_RESPONSE,PEM_STRING_OCSP_RESPONSE, \
     bp,(char **)(x),cb,NULL)

#  define PEM_write_bio_OCSP_REQUEST(bp,o) \
    PEM_ASN1_write_bio((int (*)())i2d_OCSP_REQUEST,PEM_STRING_OCSP_REQUEST,\
                        bp,(char *)(o), NULL,NULL,0,NULL,NULL)

#  define PEM_write_bio_OCSP_RESPONSE(bp,o) \
    PEM_ASN1_write_bio((int (*)())i2d_OCSP_RESPONSE,PEM_STRING_OCSP_RESPONSE,\
                        bp,(char *)(o), NULL,NULL,0,NULL,NULL)

#  define i2d_OCSP_RESPONSE_bio(bp,o) ASN1_i2d_bio_of(OCSP_RESPONSE,i2d_OCSP_RESPONSE,bp,o)

#  define i2d_OCSP_REQUEST_bio(bp,o) ASN1_i2d_bio_of(OCSP_REQUEST,i2d_OCSP_REQUEST,bp,o)

#  define ASN1_BIT_STRING_digest(data,type,md,len) \
        ASN1_item_digest(ASN1_ITEM_rptr(ASN1_BIT_STRING),type,data,md,len)

#  define OCSP_CERTSTATUS_dup(cs)\
                (OCSP_CERTSTATUS*)ASN1_dup((i2d_of_void *)i2d_OCSP_CERTSTATUS,\
                (d2i_of_void *)d2i_OCSP_CERTSTATUS,(char *)(cs))

DECLARE_ASN1_DUP_FUNCTION(OCSP_CERTID)

OCSP_RESPONSE *OCSP_sendreq_bio(BIO *b, const char *path, OCSP_REQUEST *req);
OCSP_REQ_CTX *OCSP_sendreq_new(BIO *io, const char *path, OCSP_REQUEST *req,
                               int maxline);
int OCSP_sendreq_nbio(OCSP_RESPONSE **presp, OCSP_REQ_CTX *rctx);

/* TODO: remove this (documented but) meanwhile obsolete function? */
int OCSP_REQ_CTX_set1_req(OCSP_REQ_CTX *rctx, const OCSP_REQUEST *req);

OCSP_CERTID *OCSP_cert_to_id(const EVP_MD *dgst, const X509 *subject,
                             const X509 *issuer);

OCSP_CERTID *OCSP_cert_id_new(const EVP_MD *dgst,
                              const X509_NAME *issuerName,
                              const ASN1_BIT_STRING *issuerKey,
                              const ASN1_INTEGER *serialNumber);

OCSP_ONEREQ *OCSP_request_add0_id(OCSP_REQUEST *req, OCSP_CERTID *cid);

int OCSP_request_add1_nonce(OCSP_REQUEST *req, unsigned char *val, int len);
int OCSP_basic_add1_nonce(OCSP_BASICRESP *resp, unsigned char *val, int len);
int OCSP_check_nonce(OCSP_REQUEST *req, OCSP_BASICRESP *bs);
int OCSP_copy_nonce(OCSP_BASICRESP *resp, OCSP_REQUEST *req);

int OCSP_request_set1_name(OCSP_REQUEST *req, const X509_NAME *nm);
int OCSP_request_add1_cert(OCSP_REQUEST *req, X509 *cert);

int OCSP_request_sign(OCSP_REQUEST *req,
                      X509 *signer,
                      EVP_PKEY *key,
                      const EVP_MD *dgst,
                      STACK_OF(X509) *certs, unsigned long flags);

int OCSP_response_status(OCSP_RESPONSE *resp);
OCSP_BASICRESP *OCSP_response_get1_basic(OCSP_RESPONSE *resp);

const ASN1_OCTET_STRING *OCSP_resp_get0_signature(const OCSP_BASICRESP *bs);
const X509_ALGOR *OCSP_resp_get0_tbs_sigalg(const OCSP_BASICRESP *bs);
const OCSP_RESPDATA *OCSP_resp_get0_respdata(const OCSP_BASICRESP *bs);
int OCSP_resp_get0_signer(OCSP_BASICRESP *bs, X509 **signer,
                          STACK_OF(X509) *extra_certs);

int OCSP_resp_count(OCSP_BASICRESP *bs);
OCSP_SINGLERESP *OCSP_resp_get0(OCSP_BASICRESP *bs, int idx);
const ASN1_GENERALIZEDTIME *OCSP_resp_get0_produced_at(const OCSP_BASICRESP* bs);
const STACK_OF(X509) *OCSP_resp_get0_certs(const OCSP_BASICRESP *bs);
int OCSP_resp_get0_id(const OCSP_BASICRESP *bs,
                      const ASN1_OCTET_STRING **pid,
                      const X509_NAME **pname);
int OCSP_resp_get1_id(const OCSP_BASICRESP *bs,
                      ASN1_OCTET_STRING **pid,
                      X509_NAME **pname);

int OCSP_resp_find(OCSP_BASICRESP *bs, OCSP_CERTID *id, int last);
int OCSP_single_get0_status(OCSP_SINGLERESP *single, int *reason,
                            ASN1_GENERALIZEDTIME **revtime,
                            ASN1_GENERALIZEDTIME **thisupd,
                            ASN1_GENERALIZEDTIME **nextupd);
int OCSP_resp_find_status(OCSP_BASICRESP *bs, OCSP_CERTID *id, int *status,
                          int *reason,
                          ASN1_GENERALIZEDTIME **revtime,
                          ASN1_GENERALIZEDTIME **thisupd,
                          ASN1_GENERALIZEDTIME **nextupd);
int OCSP_check_validity(ASN1_GENERALIZEDTIME *thisupd,
                        ASN1_GENERALIZEDTIME *nextupd, long sec, long maxsec);

int OCSP_request_verify(OCSP_REQUEST *req, STACK_OF(X509) *certs,
                        X509_STORE *store, unsigned long flags);

#  define OCSP_parse_url OSSL_HTTP_parse_url /* for backward compatibility */

int OCSP_id_issuer_cmp(const OCSP_CERTID *a, const OCSP_CERTID *b);
int OCSP_id_cmp(const OCSP_CERTID *a, const OCSP_CERTID *b);

int OCSP_request_onereq_count(OCSP_REQUEST *req);
OCSP_ONEREQ *OCSP_request_onereq_get0(OCSP_REQUEST *req, int i);
OCSP_CERTID *OCSP_onereq_get0_id(OCSP_ONEREQ *one);
int OCSP_id_get0_info(ASN1_OCTET_STRING **piNameHash, ASN1_OBJECT **pmd,
                      ASN1_OCTET_STRING **pikeyHash,
                      ASN1_INTEGER **pserial, OCSP_CERTID *cid);
int OCSP_request_is_signed(OCSP_REQUEST *req);
OCSP_RESPONSE *OCSP_response_create(int status, OCSP_BASICRESP *bs);
OCSP_SINGLERESP *OCSP_basic_add1_status(OCSP_BASICRESP *rsp,
                                        OCSP_CERTID *cid,
                                        int status, int reason,
                                        ASN1_TIME *revtime,
                                        ASN1_TIME *thisupd,
                                        ASN1_TIME *nextupd);
int OCSP_basic_add1_cert(OCSP_BASICRESP *resp, X509 *cert);
int OCSP_basic_sign(OCSP_BASICRESP *brsp,
                    X509 *signer, EVP_PKEY *key, const EVP_MD *dgst,
                    STACK_OF(X509) *certs, unsigned long flags);
int OCSP_basic_sign_ctx(OCSP_BASICRESP *brsp,
                        X509 *signer, EVP_MD_CTX *ctx,
                        STACK_OF(X509) *certs, unsigned long flags);
int OCSP_RESPID_set_by_name(OCSP_RESPID *respid, X509 *cert);
int OCSP_RESPID_set_by_key(OCSP_RESPID *respid, X509 *cert);
int OCSP_RESPID_match(OCSP_RESPID *respid, X509 *cert);

X509_EXTENSION *OCSP_crlID_new(const char *url, long *n, char *tim);

X509_EXTENSION *OCSP_accept_responses_new(char **oids);

X509_EXTENSION *OCSP_archive_cutoff_new(char *tim);

X509_EXTENSION *OCSP_url_svcloc_new(const X509_NAME *issuer, const char **urls);

int OCSP_REQUEST_get_ext_count(OCSP_REQUEST *x);
int OCSP_REQUEST_get_ext_by_NID(OCSP_REQUEST *x, int nid, int lastpos);
int OCSP_REQUEST_get_ext_by_OBJ(OCSP_REQUEST *x, const ASN1_OBJECT *obj,
                                int lastpos);
int OCSP_REQUEST_get_ext_by_critical(OCSP_REQUEST *x, int crit, int lastpos);
X509_EXTENSION *OCSP_REQUEST_get_ext(OCSP_REQUEST *x, int loc);
X509_EXTENSION *OCSP_REQUEST_delete_ext(OCSP_REQUEST *x, int loc);
void *OCSP_REQUEST_get1_ext_d2i(OCSP_REQUEST *x, int nid, int *crit,
                                int *idx);
int OCSP_REQUEST_add1_ext_i2d(OCSP_REQUEST *x, int nid, void *value, int crit,
                              unsigned long flags);
int OCSP_REQUEST_add_ext(OCSP_REQUEST *x, X509_EXTENSION *ex, int loc);

int OCSP_ONEREQ_get_ext_count(OCSP_ONEREQ *x);
int OCSP_ONEREQ_get_ext_by_NID(OCSP_ONEREQ *x, int nid, int lastpos);
int OCSP_ONEREQ_get_ext_by_OBJ(OCSP_ONEREQ *x, const ASN1_OBJECT *obj, int lastpos);
int OCSP_ONEREQ_get_ext_by_critical(OCSP_ONEREQ *x, int crit, int lastpos);
X509_EXTENSION *OCSP_ONEREQ_get_ext(OCSP_ONEREQ *x, int loc);
X509_EXTENSION *OCSP_ONEREQ_delete_ext(OCSP_ONEREQ *x, int loc);
void *OCSP_ONEREQ_get1_ext_d2i(OCSP_ONEREQ *x, int nid, int *crit, int *idx);
int OCSP_ONEREQ_add1_ext_i2d(OCSP_ONEREQ *x, int nid, void *value, int crit,
                             unsigned long flags);
int OCSP_ONEREQ_add_ext(OCSP_ONEREQ *x, X509_EXTENSION *ex, int loc);

int OCSP_BASICRESP_get_ext_count(OCSP_BASICRESP *x);
int OCSP_BASICRESP_get_ext_by_NID(OCSP_BASICRESP *x, int nid, int lastpos);
int OCSP_BASICRESP_get_ext_by_OBJ(OCSP_BASICRESP *x, const ASN1_OBJECT *obj,
                                  int lastpos);
int OCSP_BASICRESP_get_ext_by_critical(OCSP_BASICRESP *x, int crit,
                                       int lastpos);
X509_EXTENSION *OCSP_BASICRESP_get_ext(OCSP_BASICRESP *x, int loc);
X509_EXTENSION *OCSP_BASICRESP_delete_ext(OCSP_BASICRESP *x, int loc);
void *OCSP_BASICRESP_get1_ext_d2i(OCSP_BASICRESP *x, int nid, int *crit,
                                  int *idx);
int OCSP_BASICRESP_add1_ext_i2d(OCSP_BASICRESP *x, int nid, void *value,
                                int crit, unsigned long flags);
int OCSP_BASICRESP_add_ext(OCSP_BASICRESP *x, X509_EXTENSION *ex, int loc);

int OCSP_SINGLERESP_get_ext_count(OCSP_SINGLERESP *x);
int OCSP_SINGLERESP_get_ext_by_NID(OCSP_SINGLERESP *x, int nid, int lastpos);
int OCSP_SINGLERESP_get_ext_by_OBJ(OCSP_SINGLERESP *x, const ASN1_OBJECT *obj,
                                   int lastpos);
int OCSP_SINGLERESP_get_ext_by_critical(OCSP_SINGLERESP *x, int crit,
                                        int lastpos);
X509_EXTENSION *OCSP_SINGLERESP_get_ext(OCSP_SINGLERESP *x, int loc);
X509_EXTENSION *OCSP_SINGLERESP_delete_ext(OCSP_SINGLERESP *x, int loc);
void *OCSP_SINGLERESP_get1_ext_d2i(OCSP_SINGLERESP *x, int nid, int *crit,
                                   int *idx);
int OCSP_SINGLERESP_add1_ext_i2d(OCSP_SINGLERESP *x, int nid, void *value,
                                 int crit, unsigned long flags);
int OCSP_SINGLERESP_add_ext(OCSP_SINGLERESP *x, X509_EXTENSION *ex, int loc);
const OCSP_CERTID *OCSP_SINGLERESP_get0_id(const OCSP_SINGLERESP *x);

DECLARE_ASN1_FUNCTIONS(OCSP_SINGLERESP)
DECLARE_ASN1_FUNCTIONS(OCSP_CERTSTATUS)
DECLARE_ASN1_FUNCTIONS(OCSP_REVOKEDINFO)
DECLARE_ASN1_FUNCTIONS(OCSP_BASICRESP)
DECLARE_ASN1_FUNCTIONS(OCSP_RESPDATA)
DECLARE_ASN1_FUNCTIONS(OCSP_RESPID)
DECLARE_ASN1_FUNCTIONS(OCSP_RESPONSE)
DECLARE_ASN1_FUNCTIONS(OCSP_RESPBYTES)
DECLARE_ASN1_FUNCTIONS(OCSP_ONEREQ)
DECLARE_ASN1_FUNCTIONS(OCSP_CERTID)
DECLARE_ASN1_FUNCTIONS(OCSP_REQUEST)
DECLARE_ASN1_FUNCTIONS(OCSP_SIGNATURE)
DECLARE_ASN1_FUNCTIONS(OCSP_REQINFO)
DECLARE_ASN1_FUNCTIONS(OCSP_CRLID)
DECLARE_ASN1_FUNCTIONS(OCSP_SERVICELOC)

const char *OCSP_response_status_str(long s);
const char *OCSP_cert_status_str(long s);
const char *OCSP_crl_reason_str(long s);

int OCSP_REQUEST_print(BIO *bp, OCSP_REQUEST *a, unsigned long flags);
int OCSP_RESPONSE_print(BIO *bp, OCSP_RESPONSE *o, unsigned long flags);

int OCSP_basic_verify(OCSP_BASICRESP *bs, STACK_OF(X509) *certs,
                      X509_STORE *st, unsigned long flags);


#  ifdef  __cplusplus
}
#  endif
# endif /* !defined(OPENSSL_NO_OCSP) */
#endif
Commit	Line	Data
0f113f3e	1	/*
29f178bd	2	* Copyright 2000-2020 The OpenSSL Project Authors. All Rights Reserved.
eb64730b	3	*
48f4ad77	4	* Licensed under the Apache License 2.0 (the "License"). You may not use
21dcbebc RS	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
eb64730b RL	8	*/
eb64730b RL	9
ae4186b0 DMSP	10	#ifndef OPENSSL_OCSP_H
ae4186b0 DMSP	11	# define OPENSSL_OCSP_H
d86167ec DMSP	12	# pragma once
	13
	14	# include <openssl/macros.h>
936c2b9e	15	# ifndef OPENSSL_NO_DEPRECATED_3_0
d86167ec DMSP	16	# define HEADER_OCSP_H
d86167ec DMSP	17	# endif
eb64730b	18
100cc8b0	19	# include <openssl/opensslconf.h>
5951e840 MC	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),
7960dbec DDO	35	* -- value 7 is not used
	36	* removeFromCRL (8),
	37	* privilegeWithdrawn (9),
	38	* aACompromise (10) }
5951e840	39	*/
100cc8b0 DDO	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);
100cc8b0	71	ASN1_VALUE OCSP_REQ_CTX_nbio_d2i(OCSP_REQ_CTX rctx, const ASN1_ITEM *it);
100cc8b0 DDO	72	BIO OCSP_REQ_CTX_get0_mem_bio(OCSP_REQ_CTX rctx);
	73	void OCSP_set_max_response_length(OCSP_REQ_CTX *rctx, unsigned long len);
	74	/* End of functions used only internally */
5951e840 MC	75
	76
	77	# ifndef OPENSSL_NO_OCSP
	78
5951e840 MC	79	# include <openssl/x509.h>
	80	# include <openssl/x509v3.h>
	81	# include <openssl/safestack.h>
52df25cf	82	# include <openssl/ocsperr.h>
eb64730b	83
100cc8b0	84	# ifdef __cplusplus
eb64730b	85	extern "C" {
100cc8b0	86	# endif
eb64730b	87
0b33bc65 DSH	88	/* Various flags and values */
0b33bc65 DSH	89
5951e840 MC	90	# define OCSP_DEFAULT_NONCE_LENGTH 16
	91
	92	# define OCSP_NOCERTS 0x1
	93	# define OCSP_NOINTERN 0x2
	94	# define OCSP_NOSIGS 0x4
	95	# define OCSP_NOCHAIN 0x8
	96	# define OCSP_NOVERIFY 0x10
	97	# define OCSP_NOEXPLICIT 0x20
	98	# define OCSP_NOCASIGN 0x40
	99	# define OCSP_NODELEGATED 0x80
	100	# define OCSP_NOCHECKS 0x100
	101	# define OCSP_TRUSTOTHER 0x200
	102	# define OCSP_RESPID_KEY 0x400
	103	# define OCSP_NOTIME 0x800
0b33bc65	104
6ef869d7	105	typedef struct ocsp_cert_id_st OCSP_CERTID;
eb64730b	106
85885715	107	DEFINE_STACK_OF(OCSP_CERTID)
73758d43	108
6ef869d7	109	typedef struct ocsp_one_request_st OCSP_ONEREQ;
eb64730b	110
85885715	111	DEFINE_STACK_OF(OCSP_ONEREQ)
eb64730b	112
6ef869d7 DSH	113	typedef struct ocsp_req_info_st OCSP_REQINFO;
	114	typedef struct ocsp_signature_st OCSP_SIGNATURE;
	115	typedef struct ocsp_request_st OCSP_REQUEST;
	116
5951e840 MC	117	# define OCSP_RESPONSE_STATUS_SUCCESSFUL 0
	118	# define OCSP_RESPONSE_STATUS_MALFORMEDREQUEST 1
	119	# define OCSP_RESPONSE_STATUS_INTERNALERROR 2
	120	# define OCSP_RESPONSE_STATUS_TRYLATER 3
	121	# define OCSP_RESPONSE_STATUS_SIGREQUIRED 5
	122	# define OCSP_RESPONSE_STATUS_UNAUTHORIZED 6
eb64730b	123
6ef869d7 DSH	124	typedef struct ocsp_resp_bytes_st OCSP_RESPBYTES;
6ef869d7 DSH	125
5951e840 MC	126	# define V_OCSP_RESPID_NAME 0
5951e840 MC	127	# define V_OCSP_RESPID_KEY 1
67c8e7f4	128
85885715	129	DEFINE_STACK_OF(OCSP_RESPID)
67c8e7f4	130
6ef869d7	131	typedef struct ocsp_revoked_info_st OCSP_REVOKEDINFO;
eb64730b	132
5951e840 MC	133	# define V_OCSP_CERTSTATUS_GOOD 0
	134	# define V_OCSP_CERTSTATUS_REVOKED 1
	135	# define V_OCSP_CERTSTATUS_UNKNOWN 2
6ef869d7 DSH	136
	137	typedef struct ocsp_cert_status_st OCSP_CERTSTATUS;
	138	typedef struct ocsp_single_response_st OCSP_SINGLERESP;
eb64730b	139
85885715	140	DEFINE_STACK_OF(OCSP_SINGLERESP)
eb64730b	141
6ef869d7 DSH	142	typedef struct ocsp_response_data_st OCSP_RESPDATA;
	143
	144	typedef struct ocsp_basic_response_st OCSP_BASICRESP;
eb64730b	145
6ef869d7 DSH	146	typedef struct ocsp_crl_id_st OCSP_CRLID;
6ef869d7 DSH	147	typedef struct ocsp_service_locator_st OCSP_SERVICELOC;
0f113f3e	148
5951e840 MC	149	# define PEM_STRING_OCSP_REQUEST "OCSP REQUEST"
5951e840 MC	150	# define PEM_STRING_OCSP_RESPONSE "OCSP RESPONSE"
eb64730b	151
5951e840	152	# define d2i_OCSP_REQUEST_bio(bp,p) ASN1_d2i_bio_of(OCSP_REQUEST,OCSP_REQUEST_new,d2i_OCSP_REQUEST,bp,p)
eb64730b	153
5951e840	154	# define d2i_OCSP_RESPONSE_bio(bp,p) ASN1_d2i_bio_of(OCSP_RESPONSE,OCSP_RESPONSE_new,d2i_OCSP_RESPONSE,bp,p)
eb64730b	155
5951e840	156	# define PEM_read_bio_OCSP_REQUEST(bp,x,cb) (OCSP_REQUEST *)PEM_ASN1_read_bio( \
37659ea4 BE	157	(char ()())d2i_OCSP_REQUEST,PEM_STRING_OCSP_REQUEST, \
37659ea4 BE	158	bp,(char **)(x),cb,NULL)
eb64730b	159
8caab503	160	# define PEM_read_bio_OCSP_RESPONSE(bp,x,cb) (OCSP_RESPONSE *)PEM_ASN1_read_bio(\
37659ea4 BE	161	(char ()())d2i_OCSP_RESPONSE,PEM_STRING_OCSP_RESPONSE, \
37659ea4 BE	162	bp,(char **)(x),cb,NULL)
eb64730b	163
5951e840	164	# define PEM_write_bio_OCSP_REQUEST(bp,o) \
eb64730b	165	PEM_ASN1_write_bio((int (*)())i2d_OCSP_REQUEST,PEM_STRING_OCSP_REQUEST,\
37659ea4	166	bp,(char *)(o), NULL,NULL,0,NULL,NULL)
eb64730b	167
5951e840	168	# define PEM_write_bio_OCSP_RESPONSE(bp,o) \
eb64730b	169	PEM_ASN1_write_bio((int (*)())i2d_OCSP_RESPONSE,PEM_STRING_OCSP_RESPONSE,\
37659ea4	170	bp,(char *)(o), NULL,NULL,0,NULL,NULL)
eb64730b	171
5951e840	172	# define i2d_OCSP_RESPONSE_bio(bp,o) ASN1_i2d_bio_of(OCSP_RESPONSE,i2d_OCSP_RESPONSE,bp,o)
eb64730b	173
5951e840	174	# define i2d_OCSP_REQUEST_bio(bp,o) ASN1_i2d_bio_of(OCSP_REQUEST,i2d_OCSP_REQUEST,bp,o)
eb64730b	175
5951e840	176	# define ASN1_BIT_STRING_digest(data,type,md,len) \
0f113f3e	177	ASN1_item_digest(ASN1_ITEM_rptr(ASN1_BIT_STRING),type,data,md,len)
eb64730b	178
5951e840	179	# define OCSP_CERTSTATUS_dup(cs)\
8cc86b81 DDO	180	(OCSP_CERTSTATUS)ASN1_dup((i2d_of_void )i2d_OCSP_CERTSTATUS,\
8cc86b81 DDO	181	(d2i_of_void )d2i_OCSP_CERTSTATUS,(char )(cs))
eb64730b	182
9fdcc21f	183	DECLARE_ASN1_DUP_FUNCTION(OCSP_CERTID)
fb596f3b	184
c45a48c1 BL	185	OCSP_RESPONSE OCSP_sendreq_bio(BIO b, const char path, OCSP_REQUEST req);
c45a48c1 BL	186	OCSP_REQ_CTX OCSP_sendreq_new(BIO io, const char path, OCSP_REQUEST req,
0f113f3e	187	int maxline);
c1c6c0bf	188	int OCSP_sendreq_nbio(OCSP_RESPONSE *presp, OCSP_REQ_CTX rctx);
29f178bd DDO	189
	190	/* TODO: remove this (documented but) meanwhile obsolete function? */
	191	int OCSP_REQ_CTX_set1_req(OCSP_REQ_CTX rctx, const OCSP_REQUEST req);
bf0d176e	192
68c12bfc DSH	193	OCSP_CERTID OCSP_cert_to_id(const EVP_MD dgst, const X509 *subject,
68c12bfc DSH	194	const X509 *issuer);
bf0d176e	195
0f113f3e	196	OCSP_CERTID OCSP_cert_id_new(const EVP_MD dgst,
68c12bfc DSH	197	const X509_NAME *issuerName,
	198	const ASN1_BIT_STRING *issuerKey,
	199	const ASN1_INTEGER *serialNumber);
eb64730b	200
0b33bc65	201	OCSP_ONEREQ OCSP_request_add0_id(OCSP_REQUEST req, OCSP_CERTID *cid);
26e083cc	202
0b33bc65	203	int OCSP_request_add1_nonce(OCSP_REQUEST req, unsigned char val, int len);
46a58ab9	204	int OCSP_basic_add1_nonce(OCSP_BASICRESP resp, unsigned char val, int len);
0b33bc65	205	int OCSP_check_nonce(OCSP_REQUEST req, OCSP_BASICRESP bs);
26e083cc DSH	206	int OCSP_copy_nonce(OCSP_BASICRESP resp, OCSP_REQUEST req);
26e083cc DSH	207
8cc86b81	208	int OCSP_request_set1_name(OCSP_REQUEST req, const X509_NAME nm);
0b33bc65	209	int OCSP_request_add1_cert(OCSP_REQUEST req, X509 cert);
eb64730b	210
0f113f3e MC	211	int OCSP_request_sign(OCSP_REQUEST *req,
	212	X509 *signer,
	213	EVP_PKEY *key,
	214	const EVP_MD *dgst,
	215	STACK_OF(X509) *certs, unsigned long flags);
0b33bc65 DSH	216
	217	int OCSP_response_status(OCSP_RESPONSE *resp);
	218	OCSP_BASICRESP OCSP_response_get1_basic(OCSP_RESPONSE resp);
eb64730b	219
79613ea8	220	const ASN1_OCTET_STRING OCSP_resp_get0_signature(const OCSP_BASICRESP bs);
20c36721 PK	221	const X509_ALGOR OCSP_resp_get0_tbs_sigalg(const OCSP_BASICRESP bs);
20c36721 PK	222	const OCSP_RESPDATA OCSP_resp_get0_respdata(const OCSP_BASICRESP bs);
ce5886dd BK	223	int OCSP_resp_get0_signer(OCSP_BASICRESP bs, X509 *signer,
ce5886dd BK	224	STACK_OF(X509) *extra_certs);
6ef869d7	225
b5524a3a DSH	226	int OCSP_resp_count(OCSP_BASICRESP *bs);
b5524a3a DSH	227	OCSP_SINGLERESP OCSP_resp_get0(OCSP_BASICRESP bs, int idx);
79613ea8	228	const ASN1_GENERALIZEDTIME OCSP_resp_get0_produced_at(const OCSP_BASICRESP bs);
02fb7cfe DSH	229	const STACK_OF(X509) OCSP_resp_get0_certs(const OCSP_BASICRESP bs);
	230	int OCSP_resp_get0_id(const OCSP_BASICRESP *bs,
	231	const ASN1_OCTET_STRING **pid,
	232	const X509_NAME **pname);
db17e43d SS	233	int OCSP_resp_get1_id(const OCSP_BASICRESP *bs,
	234	ASN1_OCTET_STRING **pid,
	235	X509_NAME **pname);
02fb7cfe	236
b5524a3a DSH	237	int OCSP_resp_find(OCSP_BASICRESP bs, OCSP_CERTID id, int last);
b5524a3a DSH	238	int OCSP_single_get0_status(OCSP_SINGLERESP single, int reason,
0f113f3e MC	239	ASN1_GENERALIZEDTIME **revtime,
	240	ASN1_GENERALIZEDTIME **thisupd,
	241	ASN1_GENERALIZEDTIME **nextupd);
b5524a3a	242	int OCSP_resp_find_status(OCSP_BASICRESP bs, OCSP_CERTID id, int *status,
0f113f3e MC	243	int *reason,
	244	ASN1_GENERALIZEDTIME **revtime,
	245	ASN1_GENERALIZEDTIME **thisupd,
	246	ASN1_GENERALIZEDTIME **nextupd);
f1965221	247	int OCSP_check_validity(ASN1_GENERALIZEDTIME *thisupd,
0f113f3e	248	ASN1_GENERALIZEDTIME *nextupd, long sec, long maxsec);
b5524a3a	249
0f113f3e MC	250	int OCSP_request_verify(OCSP_REQUEST req, STACK_OF(X509) certs,
0f113f3e MC	251	X509_STORE *store, unsigned long flags);
eb64730b	252
29f178bd	253	# define OCSP_parse_url OSSL_HTTP_parse_url /* for backward compatibility */
67c18019	254
cc6d9261 MC	255	int OCSP_id_issuer_cmp(const OCSP_CERTID a, const OCSP_CERTID b);
cc6d9261 MC	256	int OCSP_id_cmp(const OCSP_CERTID a, const OCSP_CERTID b);
0b33bc65	257
02e4fbed DSH	258	int OCSP_request_onereq_count(OCSP_REQUEST *req);
	259	OCSP_ONEREQ OCSP_request_onereq_get0(OCSP_REQUEST req, int i);
	260	OCSP_CERTID OCSP_onereq_get0_id(OCSP_ONEREQ one);
	261	int OCSP_id_get0_info(ASN1_OCTET_STRING piNameHash, ASN1_OBJECT pmd,
0f113f3e MC	262	ASN1_OCTET_STRING **pikeyHash,
0f113f3e MC	263	ASN1_INTEGER *pserial, OCSP_CERTID cid);
fafc7f98	264	int OCSP_request_is_signed(OCSP_REQUEST *req);
2b916952	265	OCSP_RESPONSE OCSP_response_create(int status, OCSP_BASICRESP bs);
02e4fbed	266	OCSP_SINGLERESP OCSP_basic_add1_status(OCSP_BASICRESP rsp,
0f113f3e MC	267	OCSP_CERTID *cid,
	268	int status, int reason,
	269	ASN1_TIME *revtime,
	270	ASN1_TIME *thisupd,
	271	ASN1_TIME *nextupd);
02e4fbed	272	int OCSP_basic_add1_cert(OCSP_BASICRESP resp, X509 cert);
0f113f3e MC	273	int OCSP_basic_sign(OCSP_BASICRESP *brsp,
	274	X509 signer, EVP_PKEY key, const EVP_MD *dgst,
	275	STACK_OF(X509) *certs, unsigned long flags);
b4dd21a7 DC	276	int OCSP_basic_sign_ctx(OCSP_BASICRESP *brsp,
	277	X509 signer, EVP_MD_CTX ctx,
	278	STACK_OF(X509) *certs, unsigned long flags);
e12c0beb MC	279	int OCSP_RESPID_set_by_name(OCSP_RESPID respid, X509 cert);
e12c0beb MC	280	int OCSP_RESPID_set_by_key(OCSP_RESPID respid, X509 cert);
a671b3e6	281	int OCSP_RESPID_match(OCSP_RESPID respid, X509 cert);
eb64730b	282
a026fbf9	283	X509_EXTENSION OCSP_crlID_new(const char url, long n, char tim);
eb64730b RL	284
	285	X509_EXTENSION OCSP_accept_responses_new(char *oids);
	286
0f113f3e	287	X509_EXTENSION OCSP_archive_cutoff_new(char tim);
eb64730b	288
8cc86b81	289	X509_EXTENSION OCSP_url_svcloc_new(const X509_NAME issuer, const char **urls);
eb64730b	290
ec558b65 DSH	291	int OCSP_REQUEST_get_ext_count(OCSP_REQUEST *x);
ec558b65 DSH	292	int OCSP_REQUEST_get_ext_by_NID(OCSP_REQUEST *x, int nid, int lastpos);
c47ba4e9	293	int OCSP_REQUEST_get_ext_by_OBJ(OCSP_REQUEST x, const ASN1_OBJECT obj,
0f113f3e	294	int lastpos);
ec558b65 DSH	295	int OCSP_REQUEST_get_ext_by_critical(OCSP_REQUEST *x, int crit, int lastpos);
	296	X509_EXTENSION OCSP_REQUEST_get_ext(OCSP_REQUEST x, int loc);
	297	X509_EXTENSION OCSP_REQUEST_delete_ext(OCSP_REQUEST x, int loc);
0f113f3e MC	298	void OCSP_REQUEST_get1_ext_d2i(OCSP_REQUEST x, int nid, int *crit,
0f113f3e MC	299	int *idx);
ec558b65	300	int OCSP_REQUEST_add1_ext_i2d(OCSP_REQUEST x, int nid, void value, int crit,
0f113f3e	301	unsigned long flags);
ec558b65 DSH	302	int OCSP_REQUEST_add_ext(OCSP_REQUEST x, X509_EXTENSION ex, int loc);
	303
	304	int OCSP_ONEREQ_get_ext_count(OCSP_ONEREQ *x);
	305	int OCSP_ONEREQ_get_ext_by_NID(OCSP_ONEREQ *x, int nid, int lastpos);
c47ba4e9	306	int OCSP_ONEREQ_get_ext_by_OBJ(OCSP_ONEREQ x, const ASN1_OBJECT obj, int lastpos);
ec558b65 DSH	307	int OCSP_ONEREQ_get_ext_by_critical(OCSP_ONEREQ *x, int crit, int lastpos);
	308	X509_EXTENSION OCSP_ONEREQ_get_ext(OCSP_ONEREQ x, int loc);
	309	X509_EXTENSION OCSP_ONEREQ_delete_ext(OCSP_ONEREQ x, int loc);
	310	void OCSP_ONEREQ_get1_ext_d2i(OCSP_ONEREQ x, int nid, int crit, int idx);
	311	int OCSP_ONEREQ_add1_ext_i2d(OCSP_ONEREQ x, int nid, void value, int crit,
0f113f3e	312	unsigned long flags);
ec558b65 DSH	313	int OCSP_ONEREQ_add_ext(OCSP_ONEREQ x, X509_EXTENSION ex, int loc);
	314
	315	int OCSP_BASICRESP_get_ext_count(OCSP_BASICRESP *x);
	316	int OCSP_BASICRESP_get_ext_by_NID(OCSP_BASICRESP *x, int nid, int lastpos);
c47ba4e9	317	int OCSP_BASICRESP_get_ext_by_OBJ(OCSP_BASICRESP x, const ASN1_OBJECT obj,
0f113f3e MC	318	int lastpos);
	319	int OCSP_BASICRESP_get_ext_by_critical(OCSP_BASICRESP *x, int crit,
	320	int lastpos);
ec558b65 DSH	321	X509_EXTENSION OCSP_BASICRESP_get_ext(OCSP_BASICRESP x, int loc);
ec558b65 DSH	322	X509_EXTENSION OCSP_BASICRESP_delete_ext(OCSP_BASICRESP x, int loc);
0f113f3e MC	323	void OCSP_BASICRESP_get1_ext_d2i(OCSP_BASICRESP x, int nid, int *crit,
	324	int *idx);
	325	int OCSP_BASICRESP_add1_ext_i2d(OCSP_BASICRESP x, int nid, void value,
	326	int crit, unsigned long flags);
ec558b65 DSH	327	int OCSP_BASICRESP_add_ext(OCSP_BASICRESP x, X509_EXTENSION ex, int loc);
	328
	329	int OCSP_SINGLERESP_get_ext_count(OCSP_SINGLERESP *x);
	330	int OCSP_SINGLERESP_get_ext_by_NID(OCSP_SINGLERESP *x, int nid, int lastpos);
c47ba4e9	331	int OCSP_SINGLERESP_get_ext_by_OBJ(OCSP_SINGLERESP x, const ASN1_OBJECT obj,
0f113f3e MC	332	int lastpos);
	333	int OCSP_SINGLERESP_get_ext_by_critical(OCSP_SINGLERESP *x, int crit,
	334	int lastpos);
ec558b65 DSH	335	X509_EXTENSION OCSP_SINGLERESP_get_ext(OCSP_SINGLERESP x, int loc);
ec558b65 DSH	336	X509_EXTENSION OCSP_SINGLERESP_delete_ext(OCSP_SINGLERESP x, int loc);
0f113f3e MC	337	void OCSP_SINGLERESP_get1_ext_d2i(OCSP_SINGLERESP x, int nid, int *crit,
	338	int *idx);
	339	int OCSP_SINGLERESP_add1_ext_i2d(OCSP_SINGLERESP x, int nid, void value,
	340	int crit, unsigned long flags);
ec558b65	341	int OCSP_SINGLERESP_add_ext(OCSP_SINGLERESP x, X509_EXTENSION ex, int loc);
79613ea8	342	const OCSP_CERTID OCSP_SINGLERESP_get0_id(const OCSP_SINGLERESP x);
ec558b65	343
c08523d8	344	DECLARE_ASN1_FUNCTIONS(OCSP_SINGLERESP)
73e92de5 DSH	345	DECLARE_ASN1_FUNCTIONS(OCSP_CERTSTATUS)
	346	DECLARE_ASN1_FUNCTIONS(OCSP_REVOKEDINFO)
	347	DECLARE_ASN1_FUNCTIONS(OCSP_BASICRESP)
	348	DECLARE_ASN1_FUNCTIONS(OCSP_RESPDATA)
	349	DECLARE_ASN1_FUNCTIONS(OCSP_RESPID)
	350	DECLARE_ASN1_FUNCTIONS(OCSP_RESPONSE)
	351	DECLARE_ASN1_FUNCTIONS(OCSP_RESPBYTES)
	352	DECLARE_ASN1_FUNCTIONS(OCSP_ONEREQ)
	353	DECLARE_ASN1_FUNCTIONS(OCSP_CERTID)
	354	DECLARE_ASN1_FUNCTIONS(OCSP_REQUEST)
	355	DECLARE_ASN1_FUNCTIONS(OCSP_SIGNATURE)
1f47ec53	356	DECLARE_ASN1_FUNCTIONS(OCSP_REQINFO)
c08523d8	357	DECLARE_ASN1_FUNCTIONS(OCSP_CRLID)
c08523d8	358	DECLARE_ASN1_FUNCTIONS(OCSP_SERVICELOC)
eb64730b	359
ebc06fba AP	360	const char *OCSP_response_status_str(long s);
	361	const char *OCSP_cert_status_str(long s);
	362	const char *OCSP_crl_reason_str(long s);
73758d43	363
0f113f3e MC	364	int OCSP_REQUEST_print(BIO bp, OCSP_REQUEST a, unsigned long flags);
0f113f3e MC	365	int OCSP_RESPONSE_print(BIO bp, OCSP_RESPONSE o, unsigned long flags);
73e92de5	366
9b4dc830	367	int OCSP_basic_verify(OCSP_BASICRESP bs, STACK_OF(X509) certs,
0f113f3e	368	X509_STORE *st, unsigned long flags);
73e92de5	369
eb64730b	370
0cd0a820	371	# ifdef __cplusplus
eb64730b	372	}
0cd0a820	373	# endif
b5adba20	374	# endif /* !defined(OPENSSL_NO_OCSP) */
eb64730b	375	#endif