mirror of
https://github.com/openssl/openssl.git
synced 2025-01-24 13:55:42 +08:00
113 lines
4.3 KiB
Plaintext
113 lines
4.3 KiB
Plaintext
=pod
|
|
|
|
=head1 NAME
|
|
|
|
ossl_cmp_mock_srv_new,
|
|
ossl_cmp_mock_srv_free,
|
|
ossl_cmp_mock_srv_set1_refCert,
|
|
ossl_cmp_mock_srv_set1_certOut,
|
|
ossl_cmp_mock_srv_set1_chainOut,
|
|
ossl_cmp_mock_srv_set1_caPubsOut,
|
|
ossl_cmp_mock_srv_set1_newWithNew,
|
|
ossl_cmp_mock_srv_set1_newWithOld,
|
|
ossl_cmp_mock_srv_set1_oldWithNew,
|
|
ossl_cmp_mock_srv_set_statusInfo,
|
|
ossl_cmp_mock_srv_set_sendError,
|
|
ossl_cmp_mock_srv_set_pollCount,
|
|
ossl_cmp_mock_srv_set_checkAfterTime
|
|
- functions used for testing with CMP mock server
|
|
|
|
=head1 SYNOPSIS
|
|
|
|
#include "apps/cmp_mock_srv.h"
|
|
|
|
OSSL_CMP_SRV_CTX *ossl_cmp_mock_srv_new(OSSL_LIB_CTX *libctx, const char *propq);
|
|
void ossl_cmp_mock_srv_free(OSSL_CMP_SRV_CTX *srv_ctx);
|
|
|
|
int ossl_cmp_mock_srv_set1_refCert(OSSL_CMP_SRV_CTX *ctx, const X509 *cert);
|
|
int ossl_cmp_mock_srv_set1_certOut(OSSL_CMP_SRV_CTX *ctx, const X509 *cert);
|
|
int ossl_cmp_mock_srv_set1_chainOut(OSSL_CMP_SRV_CTX *srv_ctx,
|
|
const STACK_OF(X509) *chain);
|
|
int ossl_cmp_mock_srv_set1_caPubsOut(OSSL_CMP_SRV_CTX *srv_ctx,
|
|
const STACK_OF(X509) *caPubs);
|
|
int ossl_cmp_mock_srv_set1_newWithNew(OSSL_CMP_SRV_CTX *ctx, const X509 *cert);
|
|
int ossl_cmp_mock_srv_set1_newWithOld(OSSL_CMP_SRV_CTX *ctx, const X509 *cert);
|
|
int ossl_cmp_mock_srv_set1_oldWithNew(OSSL_CMP_SRV_CTX *ctx, const X509 *cert);
|
|
int ossl_cmp_mock_srv_set_statusInfo(OSSL_CMP_SRV_CTX *srv_ctx, int status,
|
|
int fail_info, const char *text);
|
|
int ossl_cmp_mock_srv_set_sendError(OSSL_CMP_SRV_CTX *srv_ctx, int bodytype);
|
|
int ossl_cmp_mock_srv_set_pollCount(OSSL_CMP_SRV_CTX *srv_ctx, int count);
|
|
int ossl_cmp_mock_srv_set_checkAfterTime(OSSL_CMP_SRV_CTX *srv_ctx, int sec);
|
|
|
|
=head1 DESCRIPTION
|
|
|
|
ossl_cmp_mock_srv_new() allocates the contexts for the CMP mock server
|
|
associated with the library context I<libctx> and property query string
|
|
I<propq>, both of which may be NULL to select the defaults.
|
|
|
|
ossl_cmp_mock_srv_free() deallocates the contexts for the CMP mock server.
|
|
|
|
ossl_cmp_mock_srv_set1_refCert() sets the reference certificate (or NULL)
|
|
to be expected for rr messages and for any oldCertID included in kur messages.
|
|
|
|
ossl_cmp_mock_srv_set1_certOut() sets the certificate (or NULL)
|
|
to be returned in cp/ip/kup messages.
|
|
Note that on each certificate request the mock server does not produce
|
|
a fresh certificate but just returns the same pre-existing certificate.
|
|
|
|
ossl_cmp_mock_srv_set1_chainOut() sets the certificate chain (or NULL)
|
|
to be added to the extraCerts in a cp/ip/kup message.
|
|
It should be useful for the validation of the certificate given via
|
|
ossl_cmp_mock_srv_set1_certOut().
|
|
|
|
ossl_cmp_mock_srv_set1_caPubsOut() sets list of certificates (or NULL) to be
|
|
returned in the caPubs field an ip message and in a genp of infoType caCerts.
|
|
|
|
ossl_cmp_mock_srv_set1_newWithNew() sets the value (which may be NULL)
|
|
of the newWithNew field to be returned in a genp of infoType rootCaKeyUpdate.
|
|
|
|
ossl_cmp_mock_srv_set1_newWithOld() sets the value (which may be NULL)
|
|
of the newWithOld field to be returned in a genp of infoType rootCaKeyUpdate.
|
|
|
|
ossl_cmp_mock_srv_set1_oldWithNew() sets the value (which may be NULL)
|
|
of the oldWithNew field to be returned in a genp of infoType rootCaKeyUpdate.
|
|
|
|
ossl_cmp_mock_srv_set_statusInfo() sets the status info to be returned.
|
|
|
|
ossl_cmp_mock_srv_set_sendError() enables enforcement of error responses
|
|
for requests of the given I<bodytype>, or for all requests if I<bodytype> is 1.
|
|
A I<bodytype> of -1 can be used to disable this feature, which is the default.
|
|
|
|
ossl_cmp_mock_srv_set_pollCount() sets the number of polls before cert response.
|
|
|
|
ossl_cmp_mock_srv_set_checkAfterTime() sets the number of seconds
|
|
the client should wait for the next poll.
|
|
|
|
=head1 NOTES
|
|
|
|
CMP is defined in RFC 4210 (and CRMF in RFC 4211).
|
|
|
|
=head1 RETURN VALUES
|
|
|
|
ossl_cmp_mock_srv() returns a B<OSSL_CMP_SRV_CTX> structure on success,
|
|
NULL on error.
|
|
|
|
ossl_cmp_mock_srv_free() does not return a value.
|
|
|
|
All other functions return 1 on success, 0 on error.
|
|
|
|
=head1 HISTORY
|
|
|
|
The OpenSSL CMP support was added in OpenSSL 3.0.
|
|
|
|
=head1 COPYRIGHT
|
|
|
|
Copyright 2007-2023 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
|
|
L<https://www.openssl.org/source/license.html>.
|
|
|
|
=cut
|