Skip to content

Latest commit

 

History

History
99 lines (74 loc) · 3.71 KB

ossl_cmp_pkisi_get_status.pod

File metadata and controls

99 lines (74 loc) · 3.71 KB
Raw

NAME

ossl_cmp_certresponse_get1_cert, ossl_cmp_pkisi_get_status, ossl_cmp_PKIStatus_to_string, ossl_cmp_pkisi_get0_statusString, ossl_cmp_pkisi_get_pkifailureinfo, ossl_cmp_pkisi_check_pkifailureinfo - functions for managing PKI status information

SYNOPSIS

#include "cmp.h"

# define OSSL_CMP_PKIFAILUREINFO_badAlg 0 # define OSSL_CMP_PKIFAILUREINFO_badMessageCheck 1 # define OSSL_CMP_PKIFAILUREINFO_badRequest 2 # define OSSL_CMP_PKIFAILUREINFO_badTime 3 # define OSSL_CMP_PKIFAILUREINFO_badCertId 4 # define OSSL_CMP_PKIFAILUREINFO_badDataFormat 5 # define OSSL_CMP_PKIFAILUREINFO_wrongAuthority 6 # define OSSL_CMP_PKIFAILUREINFO_incorrectData 7 # define OSSL_CMP_PKIFAILUREINFO_missingTimeStamp 8 # define OSSL_CMP_PKIFAILUREINFO_badPOP 9 # define OSSL_CMP_PKIFAILUREINFO_certRevoked 10 # define OSSL_CMP_PKIFAILUREINFO_certConfirmed 11 # define OSSL_CMP_PKIFAILUREINFO_wrongIntegrity 12 # define OSSL_CMP_PKIFAILUREINFO_badRecipientNonce 13 # define OSSL_CMP_PKIFAILUREINFO_timeNotAvailable 14 # define OSSL_CMP_PKIFAILUREINFO_unacceptedPolicy 15 # define OSSL_CMP_PKIFAILUREINFO_unacceptedExtension 16 # define OSSL_CMP_PKIFAILUREINFO_addInfoNotAvailable 17 # define OSSL_CMP_PKIFAILUREINFO_badSenderNonce 18 # define OSSL_CMP_PKIFAILUREINFO_badCertTemplate 19 # define OSSL_CMP_PKIFAILUREINFO_signerNotTrusted 20 # define OSSL_CMP_PKIFAILUREINFO_transactionIdInUse 21 # define OSSL_CMP_PKIFAILUREINFO_unsupportedVersion 22 # define OSSL_CMP_PKIFAILUREINFO_notAuthorized 23 # define OSSL_CMP_PKIFAILUREINFO_systemUnavail 24 # define OSSL_CMP_PKIFAILUREINFO_systemFailure 25 # define OSSL_CMP_PKIFAILUREINFO_duplicateCertReq 26 # define OSSL_CMP_PKIFAILUREINFO_MAX 26

X509 *ossl_cmp_certresponse_get1_cert(const OSSL_CMP_CTX *ctx,
                                      const OSSL_CMP_CERTRESPONSE *crep);
int ossl_cmp_pkisi_get_status(const OSSL_CMP_PKISI *si);
const char *ossl_cmp_PKIStatus_to_string(int status);
OSSL_CMP_PKIFREETEXT *ossl_cmp_pkisi_get0_statusString(const OSSL_CMP_PKISI *si);
int ossl_cmp_pkisi_get_pkifailureinfo(const OSSL_CMP_PKISI *si);
int ossl_cmp_pkisi_check_pkifailureinfo(const OSSL_CMP_PKISI *si, int index);

DESCRIPTION

ossl_cmp_certresponse_get1_cert() returns a pointer to a copy of the newly enrolled certificate from the given certResponse crep, or NULL on error. Uses data from ctx, which in case of indirect POPO includes the private key.

ossl_cmp_pkisi_get_status() returns the PKIStatus of si, or -1 on error.

ossl_cmp_PKIStatus_to_string() returns a human-readable string representing the PKIStatus values as specified in RFC 4210, Appendix F.

ossl_cmp_pkisi_get0_statusString() returns a direct pointer to the statusString field contained in si.

ossl_cmp_pkisi_get_pkifailureinfo() returns the PKIFailureInfo bits of si, encoded as integer, or -1 on error.

ossl_cmp_pkisi_check_pkifailureinfo() returns the state of the bit (0 or 1) with index index in the PKIFailureInfo of the si, or -1 on error.

NOTES

CMP is defined in RFC 4210 (and CRMF in RFC 4211).

RETURN VALUES

See the individual functions above.

SEE ALSO

OSSL_CMP_CTX_new(3), ossl_cmp_certreq_new(3)

HISTORY

The OpenSSL CMP support was added in OpenSSL 3.0.

COPYRIGHT

Copyright 2007-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.