Botan 3.14.1
Crypto and TLS for C&
Botan::Cert_Extension::Authority_Information_Access Class Referencefinal

#include <x509_ext.h>

Inheritance diagram for Botan::Cert_Extension::Authority_Information_Access:
Botan::Certificate_Extension

Classes

class  AccessDescription

Public Member Functions

const std::vector< AccessDescription > & access_descriptions () const
void add_access_description (AccessDescription ad)
 Authority_Information_Access ()=default
 Authority_Information_Access (const std::vector< std::string > &ocsp_responders, const std::vector< std::string > &ca_issuers=std::vector< std::string >())
 Authority_Information_Access (std::string_view ocsp, const std::vector< std::string > &ca_issuers=std::vector< std::string >())
 Authority_Information_Access (std::vector< AccessDescription > access_descriptions)
 Authority_Information_Access (std::vector< URI > ocsp_responders, std::vector< URI > ca_issuers=std::vector< URI >())
const std::vector< URI > & ca_issuer_uris () const
std::vector< std::string > ca_issuers () const
std::unique_ptr< Certificate_Extension > copy () const override
std::string ocsp_responder () const
const std::vector< URI > & ocsp_responder_uris () const
std::vector< std::string > ocsp_responders () const
OID oid_of () const override
virtual void validate (const X509_Certificate &subject, const std::optional< X509_Certificate > &issuer, const std::vector< X509_Certificate > &cert_path, std::vector< std::set< Certificate_Status_Code > > &cert_status, size_t pos) const

Static Public Member Functions

static OID static_oid ()

Detailed Description

Authority Information Access Extension

Definition at line 375 of file x509_ext.h.

Constructor & Destructor Documentation

◆ Authority_Information_Access() [1/5]

Botan::Cert_Extension::Authority_Information_Access::Authority_Information_Access ( )
default

◆ Authority_Information_Access() [2/5]

Botan::Cert_Extension::Authority_Information_Access::Authority_Information_Access ( std::string_view ocsp,
const std::vector< std::string > & ca_issuers = std::vector<std::string>() )
explicit

Definition at line 974 of file x509_ext.cpp.

975 :
976 m_ca_issuers(parse_aia_uris(ca_issuers, "AuthorityInformationAccess CA issuers")) {
977 if(!ocsp.empty()) {
978 if(auto parsed = URI::from_string(ocsp)) {
979 m_ocsp_responders.push_back(std::move(*parsed));
980 } else {
981 throw Invalid_Argument("Invalid URI in AuthorityInformationAccess OCSP responder");
982 }
983 }
984 m_access_descriptions = uri_access_descriptions(m_ocsp_responders, m_ca_issuers);
985}
std::vector< std::string > ca_issuers() const
static std::optional< URI > from_string(std::string_view raw)
Definition uri.cpp:163

References ca_issuers().

◆ Authority_Information_Access() [3/5]

Botan::Cert_Extension::Authority_Information_Access::Authority_Information_Access ( const std::vector< std::string > & ocsp_responders,
const std::vector< std::string > & ca_issuers = std::vector<std::string>() )
explicit

Definition at line 987 of file x509_ext.cpp.

988 :
989 m_ocsp_responders(parse_aia_uris(ocsp_responders, "AuthorityInformationAccess OCSP responders")),
990 m_ca_issuers(parse_aia_uris(ca_issuers, "AuthorityInformationAccess CA issuers")),
991 m_access_descriptions(uri_access_descriptions(m_ocsp_responders, m_ca_issuers)) {}
std::vector< std::string > ocsp_responders() const
Definition x509_ext.cpp:999

References Authority_Information_Access(), ca_issuers(), and ocsp_responders().

◆ Authority_Information_Access() [4/5]

Botan::Cert_Extension::Authority_Information_Access::Authority_Information_Access ( std::vector< URI > ocsp_responders,
std::vector< URI > ca_issuers = std::vector<URI>() )
explicit

Definition at line 993 of file x509_ext.cpp.

994 :
995 m_ocsp_responders(std::move(ocsp_responders)),
996 m_ca_issuers(std::move(ca_issuers)),
997 m_access_descriptions(uri_access_descriptions(m_ocsp_responders, m_ca_issuers)) {}

References ca_issuers(), and ocsp_responders().

◆ Authority_Information_Access() [5/5]

Botan::Cert_Extension::Authority_Information_Access::Authority_Information_Access ( std::vector< AccessDescription > access_descriptions)
explicit

Construct an AIA from raw AccessDescriptions, allowing the caller to emit access methods beyond id-ad-ocsp / id-ad-caIssuers and access locations beyond URIs. The typed URI accessors (ocsp_responder_uris, ca_issuer_uris) are also populated from any URI-form entries whose accessMethod is id-ad-ocsp or id-ad-caIssuers so the two views stay consistent.

Definition at line 1073 of file x509_ext.cpp.

1073 :
1074 m_access_descriptions(std::move(access_descriptions)) {
1075 for(const auto& ad : m_access_descriptions) {
1076 validate_access_description(ad);
1077 populate_uri_view_from_access_description(ad, m_ocsp_responders, m_ca_issuers);
1078 }
1079}
const std::vector< AccessDescription > & access_descriptions() const
Definition x509_ext.h:471

References access_descriptions().

Member Function Documentation

◆ access_descriptions()

const std::vector< AccessDescription > & Botan::Cert_Extension::Authority_Information_Access::access_descriptions ( ) const
inline

The full set of AccessDescriptions, including access methods that are not id-ad-ocsp or id-ad-caIssuers and access locations that are not URIs

Definition at line 471 of file x509_ext.h.

471{ return m_access_descriptions; }

Referenced by Authority_Information_Access(), and Authority_Information_Access().

◆ add_access_description()

void Botan::Cert_Extension::Authority_Information_Access::add_access_description ( AccessDescription ad)

Append a single AccessDescription. URI-form id-ad-ocsp / id-ad-caIssuers entries also populate the corresponding typed URI accessor list.

Definition at line 1081 of file x509_ext.cpp.

1081 {
1082 validate_access_description(ad);
1083 populate_uri_view_from_access_description(ad, m_ocsp_responders, m_ca_issuers);
1084 m_access_descriptions.push_back(std::move(ad));
1085}

Referenced by Authority_Information_Access().

◆ ca_issuer_uris()

const std::vector< URI > & Botan::Cert_Extension::Authority_Information_Access::ca_issuer_uris ( ) const
inline

Definition at line 479 of file x509_ext.h.

479{ return m_ca_issuers; }

References ca_issuer_uris().

Referenced by ca_issuer_uris().

◆ ca_issuers()

std::vector< std::string > Botan::Cert_Extension::Authority_Information_Access::ca_issuers ( ) const

Definition at line 1087 of file x509_ext.cpp.

1087 {
1088 std::vector<std::string> out;
1089 out.reserve(m_ca_issuers.size());
1090 for(const auto& uri : m_ca_issuers) {
1091 out.push_back(uri.original_input());
1092 }
1093 return out;
1094}

Referenced by Authority_Information_Access(), Authority_Information_Access(), Authority_Information_Access(), and Authority_Information_Access().

◆ copy()

std::unique_ptr< Certificate_Extension > Botan::Cert_Extension::Authority_Information_Access::copy ( ) const
overridevirtual

Make a copy of this extension

Returns
copy of this

Implements Botan::Certificate_Extension.

Definition at line 1008 of file x509_ext.cpp.

1008 {
1009 return std::make_unique<Authority_Information_Access>(*this);
1010}

◆ ocsp_responder()

std::string Botan::Cert_Extension::Authority_Information_Access::ocsp_responder ( ) const
inline

Definition at line 456 of file x509_ext.h.

456 {
457 if(m_ocsp_responders.empty()) {
458 return {};
459 }
460 return m_ocsp_responders[0].original_input();
461 }

References BOTAN_DEPRECATED, and ocsp_responder().

Referenced by ocsp_responder().

◆ ocsp_responder_uris()

const std::vector< URI > & Botan::Cert_Extension::Authority_Information_Access::ocsp_responder_uris ( ) const
inline

Definition at line 465 of file x509_ext.h.

465{ return m_ocsp_responders; }

References ocsp_responder_uris().

Referenced by ocsp_responder_uris().

◆ ocsp_responders()

std::vector< std::string > Botan::Cert_Extension::Authority_Information_Access::ocsp_responders ( ) const

Definition at line 999 of file x509_ext.cpp.

999 {
1000 std::vector<std::string> out;
1001 out.reserve(m_ocsp_responders.size());
1002 for(const auto& uri : m_ocsp_responders) {
1003 out.push_back(uri.original_input());
1004 }
1005 return out;
1006}

Referenced by Authority_Information_Access(), Authority_Information_Access(), and Authority_Information_Access().

◆ oid_of()

OID Botan::Cert_Extension::Authority_Information_Access::oid_of ( ) const
inlineoverridevirtual

Return object identifier for this extension

Returns
OID representing this extension

Implements Botan::Certificate_Extension.

Definition at line 475 of file x509_ext.h.

References static_oid().

◆ static_oid()

OID Botan::Cert_Extension::Authority_Information_Access::static_oid ( )
inlinestatic

Definition at line 473 of file x509_ext.h.

473{ return OID({1, 3, 6, 1, 5, 5, 7, 1, 1}); }

Referenced by oid_of().

◆ validate()

void Botan::Certificate_Extension::validate ( const X509_Certificate & subject,
const std::optional< X509_Certificate > & issuer,
const std::vector< X509_Certificate > & cert_path,
std::vector< std::set< Certificate_Status_Code > > & cert_status,
size_t pos ) const
virtualinherited

Callback visited during path validation.

An extension can implement this callback to inspect the path during path validation.

If an error occurs during validation of this extension, an appropriate status code shall be added to cert_status.

Parameters
subjectSubject certificate that contains this extension
issuerIssuer certificate. nullopt for certificates with no available issuer (e.g. non self-signed trust anchors).
cert_pathCertificate path which is currently validated
cert_statusCertificate validation status codes for subject certificate
posPosition of subject certificate in cert_path

Reimplemented in Botan::Cert_Extension::ASBlocks, Botan::Cert_Extension::Certificate_Policies, Botan::Cert_Extension::IPAddressBlocks, Botan::Cert_Extension::Name_Constraints, Botan::Cert_Extension::NoRevocationAvailable, Botan::Cert_Extension::OCSP_NoCheck, Botan::Cert_Extension::TNAuthList, and Botan::Cert_Extension::Unknown_Extension.

Definition at line 171 of file x509_ext.cpp.

175 {}

Referenced by is_appropriate_context().


The documentation for this class was generated from the following files: