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