5 OSSL_CMP_SRV_process_request,
6 OSSL_CMP_CTX_server_perform,
9 OSSL_CMP_SRV_cert_request_cb_t,
11 OSSL_CMP_SRV_certConf_cb_t,
12 OSSL_CMP_SRV_genm_cb_t,
13 OSSL_CMP_SRV_error_cb_t,
14 OSSL_CMP_SRV_pollReq_cb_t,
15 OSSL_CMP_SRV_CTX_init,
16 OSSL_CMP_SRV_CTX_get0_cmp_ctx,
17 OSSL_CMP_SRV_CTX_get0_custom_ctx,
18 OSSL_CMP_SRV_CTX_set_send_unprotected_errors,
19 OSSL_CMP_SRV_CTX_set_accept_unprotected,
20 OSSL_CMP_SRV_CTX_set_accept_raverified,
21 OSSL_CMP_SRV_CTX_set_grant_implicit_confirm
22 - generic functions to set up and control a CMP server
26 #include <openssl/cmp.h>
28 OSSL_CMP_MSG *OSSL_CMP_SRV_process_request(OSSL_CMP_SRV_CTX *srv_ctx,
29 const OSSL_CMP_MSG *req);
30 OSSL_CMP_MSG *OSSL_CMP_CTX_server_perform(OSSL_CMP_CTX *client_ctx,
31 const OSSL_CMP_MSG *req);
32 OSSL_CMP_SRV_CTX *OSSL_CMP_SRV_CTX_new(OSSL_LIB_CTX *libctx, const char *propq);
33 void OSSL_CMP_SRV_CTX_free(OSSL_CMP_SRV_CTX *srv_ctx);
35 typedef OSSL_CMP_PKISI *(*OSSL_CMP_SRV_cert_request_cb_t)(
36 OSSL_CMP_SRV_CTX *srv_ctx,
37 const OSSL_CMP_MSG *req,
39 const OSSL_CRMF_MSG *crm,
40 const X509_REQ *p10cr,
42 STACK_OF(X509) **chainOut,
43 STACK_OF(X509) **caPubs);
44 typedef OSSL_CMP_PKISI *(*OSSL_CMP_SRV_rr_cb_t)(OSSL_CMP_SRV_CTX *srv_ctx,
45 const OSSL_CMP_MSG *req,
46 const X509_NAME *issuer,
47 const ASN1_INTEGER *serial);
48 typedef int (*OSSL_CMP_SRV_genm_cb_t)(OSSL_CMP_SRV_CTX *srv_ctx,
49 const OSSL_CMP_MSG *req,
50 STACK_OF(OSSL_CMP_ITAV) *in,
51 STACK_OF(OSSL_CMP_ITAV) **out);
52 typedef void (*OSSL_CMP_SRV_error_cb_t)(OSSL_CMP_SRV_CTX *srv_ctx,
53 const OSSL_CMP_MSG *req,
54 const OSSL_CMP_PKISI *statusInfo,
55 const ASN1_INTEGER *errorCode,
56 const OSSL_CMP_PKIFREETEXT *errorDetails);
57 typedef int (*OSSL_CMP_SRV_certConf_cb_t)(OSSL_CMP_SRV_CTX *srv_ctx,
58 const OSSL_CMP_MSG *req,
60 const ASN1_OCTET_STRING *certHash,
61 const OSSL_CMP_PKISI *si);
62 typedef int (*OSSL_CMP_SRV_pollReq_cb_t)(OSSL_CMP_SRV_CTX *srv_ctx,
63 const OSSL_CMP_MSG *req,
65 OSSL_CMP_MSG **certReq,
66 int64_t *check_after);
67 int OSSL_CMP_SRV_CTX_init(OSSL_CMP_SRV_CTX *srv_ctx, void *custom_ctx,
68 OSSL_CMP_SRV_cert_request_cb_t process_cert_request,
69 OSSL_CMP_SRV_rr_cb_t process_rr,
70 OSSL_CMP_SRV_genm_cb_t process_genm,
71 OSSL_CMP_SRV_error_cb_t process_error,
72 OSSL_CMP_SRV_certConf_cb_t process_certConf,
73 OSSL_CMP_SRV_pollReq_cb_t process_pollReq);
75 OSSL_CMP_CTX *OSSL_CMP_SRV_CTX_get0_cmp_ctx(const OSSL_CMP_SRV_CTX *srv_ctx);
76 void *OSSL_CMP_SRV_CTX_get0_custom_ctx(const OSSL_CMP_SRV_CTX *srv_ctx);
78 int OSSL_CMP_SRV_CTX_set_send_unprotected_errors(OSSL_CMP_SRV_CTX *srv_ctx,
80 int OSSL_CMP_SRV_CTX_set_accept_unprotected(OSSL_CMP_SRV_CTX *srv_ctx, int val);
81 int OSSL_CMP_SRV_CTX_set_accept_raverified(OSSL_CMP_SRV_CTX *srv_ctx, int val);
82 int OSSL_CMP_SRV_CTX_set_grant_implicit_confirm(OSSL_CMP_SRV_CTX *srv_ctx,
87 OSSL_CMP_SRV_process_request() implements the generic aspects of a CMP server.
88 Its arguments are the B<OSSL_CMP_SRV_CTX> I<srv_ctx> and the CMP request message
89 I<req>. It does the typical generic checks on I<req>, calls
90 the respective callback function (if present) for more specific processing,
91 and then assembles a result message, which may be a CMP error message.
93 OSSL_CMP_CTX_server_perform() is an interface to
94 B<OSSL_CMP_SRV_process_request()> that can be used by a CMP client
95 in the same way as B<OSSL_CMP_MSG_http_perform()>.
96 The B<OSSL_CMP_SRV_CTX> must be set as I<transfer_cb_arg> of I<client_ctx>.
98 OSSL_CMP_SRV_CTX_new() creates and initializes an B<OSSL_CMP_SRV_CTX> structure
99 associated with the library context I<libctx> and property query string
100 I<propq>, both of which may be NULL to select the defaults.
102 OSSL_CMP_SRV_CTX_free() deletes the given I<srv_ctx>.
104 OSSL_CMP_SRV_CTX_init() sets in the given I<srv_ctx> a custom server context
105 pointer as well as callback functions performing the specific processing of CMP
106 certificate requests, revocation requests, certificate confirmation requests,
107 general messages, error messages, and poll requests.
108 All arguments except I<srv_ctx> may be NULL.
109 If a callback for some message type is not given this means that the respective
110 type of CMP message is not supported by the server.
112 OSSL_CMP_SRV_CTX_get0_cmp_ctx() returns the B<OSSL_CMP_CTX> from the I<srv_ctx>.
114 OSSL_CMP_SRV_CTX_get0_custom_ctx() returns the custom server context from
115 I<srv_ctx> that has been set using B<OSSL_CMP_SRV_CTX_init()>.
117 OSSL_CMP_SRV_CTX_set_send_unprotected_errors() enables sending error messages
118 and other forms of negative responses unprotected.
120 OSSL_CMP_SRV_CTX_set_accept_unprotected() enables acceptance of requests
121 without protection of with invalid protection.
123 OSSL_CMP_SRV_CTX_set_accept_raverified() enables acceptance of ir/cr/kur
124 messages with POPO 'RAVerified'.
126 OSSL_CMP_SRV_CTX_set_grant_implicit_confirm() enables granting implicit
127 confirmation of newly enrolled certificates if requested.
131 CMP is defined in RFC 4210 (and CRMF in RFC 4211).
133 So far the CMP server implementation is limited to one request per CMP message
134 (and consequently to at most one response component per CMP message).
138 OSSL_CMP_SRV_CTX_new() returns a B<OSSL_CMP_SRV_CTX> structure on success,
141 OSSL_CMP_SRV_CTX_free() does not return a value.
143 OSSL_CMP_SRV_CTX_get0_cmp_ctx() returns a B<OSSL_CMP_CTX> structure on success,
146 OSSL_CMP_SRV_CTX_get0_custom_ctx() returns the custom server context
147 that has been set using B<OSSL_CMP_SRV_CTX_init()>.
149 All other functions return 1 on success, 0 on error.
153 The OpenSSL CMP support was added in OpenSSL 3.0.
157 Copyright 2007-2020 The OpenSSL Project Authors. All Rights Reserved.
159 Licensed under the Apache License 2.0 (the "License"). You may not use
160 this file except in compliance with the License. You can obtain a copy
161 in the file LICENSE in the source distribution or at
162 L<https://www.openssl.org/source/license.html>.