mirror of
https://github.com/openssl/openssl.git
synced 2024-12-27 06:21:43 +08:00
15eb7b6875
Reviewed-by: Todd Short <todd.short@me.com> Reviewed-by: Tomas Mraz <tomas@openssl.org> (Merged from https://github.com/openssl/openssl/pull/24013)
168 lines
6.1 KiB
Plaintext
168 lines
6.1 KiB
Plaintext
=pod
|
|
|
|
=head1 NAME
|
|
|
|
OSSL_CMP_MSG_get0_header,
|
|
OSSL_CMP_MSG_get_bodytype,
|
|
OSSL_CMP_MSG_get0_certreq_publickey,
|
|
OSSL_CMP_MSG_update_transactionID,
|
|
OSSL_CMP_MSG_update_recipNonce,
|
|
OSSL_CMP_CTX_setup_CRM,
|
|
OSSL_CMP_MSG_read,
|
|
OSSL_CMP_MSG_write,
|
|
d2i_OSSL_CMP_MSG_bio,
|
|
i2d_OSSL_CMP_MSG_bio
|
|
- function(s) manipulating CMP messages
|
|
|
|
=head1 SYNOPSIS
|
|
|
|
#include <openssl/cmp.h>
|
|
|
|
OSSL_CMP_PKIHEADER *OSSL_CMP_MSG_get0_header(const OSSL_CMP_MSG *msg);
|
|
int OSSL_CMP_MSG_get_bodytype(const OSSL_CMP_MSG *msg);
|
|
X509_PUBKEY *OSSL_CMP_MSG_get0_certreq_publickey(const OSSL_CMP_MSG *msg);
|
|
int OSSL_CMP_MSG_update_transactionID(OSSL_CMP_CTX *ctx, OSSL_CMP_MSG *msg);
|
|
int OSSL_CMP_MSG_update_recipNonce(OSSL_CMP_CTX *ctx, OSSL_CMP_MSG *msg);
|
|
OSSL_CRMF_MSG *OSSL_CMP_CTX_setup_CRM(OSSL_CMP_CTX *ctx, int for_KUR, int rid);
|
|
OSSL_CMP_MSG *OSSL_CMP_MSG_read(const char *file, OSSL_LIB_CTX *libctx, const char *propq);
|
|
int OSSL_CMP_MSG_write(const char *file, const OSSL_CMP_MSG *msg);
|
|
OSSL_CMP_MSG *d2i_OSSL_CMP_MSG_bio(BIO *bio, OSSL_CMP_MSG **msg);
|
|
int i2d_OSSL_CMP_MSG_bio(BIO *bio, const OSSL_CMP_MSG *msg);
|
|
|
|
=head1 DESCRIPTION
|
|
|
|
OSSL_CMP_MSG_get0_header() returns the header of the given CMP message.
|
|
|
|
OSSL_CMP_MSG_get_bodytype() returns the body type of the given CMP message.
|
|
|
|
OSSL_CMP_MSG_get0_certreq_publickey() expects that I<msg> is a certificate request
|
|
message and returns the public key in its certificate template if present.
|
|
|
|
OSSL_CMP_MSG_update_transactionID() updates the transactionID field
|
|
in the header of the given message according to the CMP_CTX.
|
|
If I<ctx> does not contain a transaction ID, a fresh one is created before.
|
|
The message gets re-protected (if protecting requests is required).
|
|
|
|
OSSL_CMP_MSG_update_recipNonce() updates the recipNonce field
|
|
in the header of the given message according to the CMP_CTX.
|
|
The message gets re-protected (if protecting requests is required).
|
|
|
|
OSSL_CMP_CTX_setup_CRM() creates a CRMF certificate request message
|
|
from various information provided in the CMP context argument I<ctx>
|
|
for inclusion in a CMP request message based on details contained in I<ctx>.
|
|
The I<rid> argument defines the request identifier to use, which typically is 0.
|
|
|
|
The subject DN included in the certificate template is
|
|
the first available value of these:
|
|
|
|
=over 4
|
|
|
|
=item any subject name in I<ctx> set via L<OSSL_CMP_CTX_set1_subjectName(3)> -
|
|
if it is the NULL-DN (i.e., any empty sequence of RDNs), no subject is included,
|
|
|
|
=item the subject field of any PKCS#10 CSR set in I<ctx>
|
|
via L<OSSL_CMP_CTX_set1_p10CSR(3)>,
|
|
|
|
=item the subject field of any reference certificate given in I<ctx>
|
|
(see L<OSSL_CMP_CTX_set1_oldCert(3)>), but only if I<for_KUR> is nonzero
|
|
or the I<ctx> does not include a Subject Alternative Name.
|
|
|
|
=back
|
|
|
|
The public key included is the first available value of these:
|
|
|
|
=over 4
|
|
|
|
=item the public key derived from any key set via L<OSSL_CMP_CTX_set0_newPkey(3)>,
|
|
|
|
=item the public key of any PKCS#10 CSR given in I<ctx>,
|
|
|
|
=item the public key of any reference certificate given in I<ctx>
|
|
(see L<OSSL_CMP_CTX_set1_oldCert(3)>),
|
|
|
|
=item the public key derived from any client's private key
|
|
set via L<OSSL_CMP_CTX_set1_pkey(3)>.
|
|
|
|
=back
|
|
|
|
The set of X.509 extensions to include is computed as follows.
|
|
If a PKCS#10 CSR is present in I<ctx>, default extensions are taken from there,
|
|
otherwise the empty set is taken as the initial value.
|
|
If there is a reference certificate in I<ctx> and contains Subject Alternative
|
|
Names (SANs) and B<OSSL_CMP_OPT_SUBJECTALTNAME_NODEFAULT> is not set,
|
|
these override any SANs from the PKCS#10 CSR.
|
|
The extensions are further augmented or overridden by any extensions with the
|
|
same OIDs included in the I<ctx> via L<OSSL_CMP_CTX_set0_reqExtensions(3)>.
|
|
The SANs are further overridden by any SANs included in I<ctx> via
|
|
L<OSSL_CMP_CTX_push1_subjectAltName(3)>.
|
|
Finally, policies are overridden by any policies included in I<ctx> via
|
|
L<OSSL_CMP_CTX_push0_policy(3)>.
|
|
|
|
OSSL_CMP_CTX_setup_CRM() also sets the sets the regToken control B<oldCertID>
|
|
for KUR messages using the issuer name and serial number of the reference
|
|
certificate, if present.
|
|
|
|
OSSL_CMP_MSG_read() loads a DER-encoded OSSL_CMP_MSG from I<file>.
|
|
|
|
OSSL_CMP_MSG_write() stores the given OSSL_CMP_MSG to I<file> in DER encoding.
|
|
|
|
d2i_OSSL_CMP_MSG_bio() parses an ASN.1-encoded OSSL_CMP_MSG from the BIO I<bio>.
|
|
It assigns a pointer to the new structure to I<*msg> if I<msg> is not NULL.
|
|
|
|
i2d_OSSL_CMP_MSG_bio() writes the OSSL_CMP_MSG I<msg> in ASN.1 encoding
|
|
to BIO I<bio>.
|
|
|
|
=head1 NOTES
|
|
|
|
CMP is defined in RFC 4210.
|
|
|
|
=head1 RETURN VALUES
|
|
|
|
OSSL_CMP_MSG_get0_header() returns the intended pointer value as described above
|
|
or NULL if the respective entry does not exist and on error.
|
|
|
|
OSSL_CMP_MSG_get_bodytype() returns the body type or -1 on error.
|
|
|
|
OSSL_CMP_MSG_get0_certreq_publickey() returns a public key or NULL on error.
|
|
|
|
OSSL_CMP_CTX_setup_CRM() returns a pointer to a B<OSSL_CRMF_MSG> on success,
|
|
NULL on error.
|
|
|
|
d2i_OSSL_CMP_MSG_bio() returns the parsed message or NULL on error.
|
|
|
|
OSSL_CMP_MSG_read() and d2i_OSSL_CMP_MSG_bio()
|
|
return the parsed CMP message or NULL on error.
|
|
|
|
OSSL_CMP_MSG_write() returns the number of bytes successfully encoded or a
|
|
negative value if an error occurs.
|
|
|
|
i2d_OSSL_CMP_MSG_bio(), OSSL_CMP_MSG_update_transactionID(),
|
|
and OSSL_CMP_MSG_update_recipNonce()
|
|
return 1 on success, 0 on error.
|
|
|
|
=head1 SEE ALSO
|
|
|
|
L<OSSL_CMP_CTX_set1_subjectName(3)>, L<OSSL_CMP_CTX_set1_p10CSR(3)>,
|
|
L<OSSL_CMP_CTX_set1_oldCert(3)>, L<OSSL_CMP_CTX_set0_newPkey(3)>,
|
|
L<OSSL_CMP_CTX_set1_pkey(3)>, L<OSSL_CMP_CTX_set0_reqExtensions(3)>,
|
|
L<OSSL_CMP_CTX_push1_subjectAltName(3)>, L<OSSL_CMP_CTX_push0_policy(3)>
|
|
|
|
=head1 HISTORY
|
|
|
|
The OpenSSL CMP support was added in OpenSSL 3.0.
|
|
|
|
OSSL_CMP_MSG_update_recipNonce() was added in OpenSSL 3.0.9.
|
|
|
|
OSSL_CMP_MSG_get0_certreq_publickey() was added in OpenSSL 3.3.
|
|
|
|
=head1 COPYRIGHT
|
|
|
|
Copyright 2007-2024 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
|