Botan 3.11.0
Crypto and TLS for C&
Botan::CRL_Entry Class Referencefinal

#include <x509_crl.h>

Inheritance diagram for Botan::CRL_Entry:
Botan::ASN1_Object

Public Member Functions

std::vector< uint8_t > BER_encode () const
 CRL_Entry ()=default
BOTAN_FUTURE_EXPLICIT CRL_Entry (const X509_Certificate &cert, CRL_Code reason=CRL_Code::Unspecified)
void decode_from (BER_Decoder &from) override
void encode_into (DER_Encoder &to) const override
const X509_Timeexpire_time () const
const Extensionsextensions () const
CRL_Code reason_code () const
const std::vector< uint8_t > & serial_number () const

Friends

class X509_CRL

Detailed Description

This class represents CRL entries

Definition at line 29 of file x509_crl.h.

Constructor & Destructor Documentation

◆ CRL_Entry() [1/2]

Botan::CRL_Entry::CRL_Entry ( )
default

Create uninitialized CRL_Entry object

References BOTAN_FUTURE_EXPLICIT, CRL_Entry(), and Botan::Unspecified.

Referenced by CRL_Entry().

◆ CRL_Entry() [2/2]

Botan::CRL_Entry::CRL_Entry ( const X509_Certificate & cert,
CRL_Code reason = CRL_Code::Unspecified )

Construct an CRL entry.

Parameters
certthe certificate to revoke
reasonthe reason code to set in the entry

Definition at line 30 of file crl_ent.cpp.

30 {
31 m_data = std::make_shared<CRL_Entry_Data>();
32 m_data->m_serial = cert.serial_number();
33 m_data->m_time = X509_Time(std::chrono::system_clock::now());
34 m_data->m_reason = why;
35
36 if(why != CRL_Code::Unspecified) {
37 m_data->m_extensions.add(std::make_unique<Cert_Extension::CRL_ReasonCode>(why));
38 }
39}
ASN1_Time X509_Time
Definition asn1_obj.h:23

References Botan::X509_Certificate::serial_number(), and Botan::Unspecified.

Member Function Documentation

◆ BER_encode()

std::vector< uint8_t > Botan::ASN1_Object::BER_encode ( ) const
inherited

Return the encoding of this object. This is a convenience method when just one object needs to be serialized. Use DER_Encoder for complicated encodings.

Definition at line 20 of file asn1_obj.cpp.

20 {
21 std::vector<uint8_t> output;
22 DER_Encoder der(output);
23 this->encode_into(der);
24 return output;
25}
virtual void encode_into(DER_Encoder &to) const =0

References encode_into().

Referenced by decode_from(), Botan::Certificate_Store_In_SQL::find_all_certs(), Botan::Certificate_Store_In_SQL::find_cert(), Botan::Certificate_Store_Windows::find_cert_by_issuer_dn_and_serial_number(), Botan::X509_Certificate::fingerprint(), Botan::Certificate_Store_In_SQL::insert_cert(), Botan::X509_Object::PEM_encode(), Botan::PSS_Params::PSS_Params(), and Botan::Certificate_Store_In_SQL::revoke_cert().

◆ decode_from()

void Botan::CRL_Entry::decode_from ( BER_Decoder & from)
overridevirtual

Decode whatever this object is from from

Parameters
fromthe BER_Decoder that will be read from

Implements Botan::ASN1_Object.

Definition at line 108 of file crl_ent.cpp.

108 {
109 auto data = std::make_unique<CRL_Entry_Data>();
110
111 BER_Decoder entry = source.start_sequence();
112
113 data->m_serial = decode_serial_number(entry.get_next_object());
114
115 entry.decode(data->m_time);
116
117 if(entry.more_items()) {
118 entry.decode(data->m_extensions);
119 if(const auto* ext = data->m_extensions.get_extension_object_as<Cert_Extension::CRL_ReasonCode>()) {
120 data->m_reason = ext->get_reason();
121 } else {
122 data->m_reason = CRL_Code::Unspecified;
123 }
124 }
125
126 entry.end_cons();
127
128 m_data = std::move(data);
129}

References Botan::BER_Decoder::decode(), Botan::BER_Decoder::end_cons(), Botan::BER_Decoder::get_next_object(), Botan::BER_Decoder::more_items(), Botan::BER_Decoder::start_sequence(), and Botan::Unspecified.

◆ encode_into()

void Botan::CRL_Entry::encode_into ( DER_Encoder & to) const
overridevirtual

Encode whatever this object is into to

Parameters
tothe DER_Encoder that will be written to

Implements Botan::ASN1_Object.

Definition at line 67 of file crl_ent.cpp.

67 {
68 der.start_sequence()
70 .encode(expire_time())
71 .start_sequence()
72 .encode(extensions())
73 .end_cons()
74 .end_cons();
75}
static BigInt from_bytes(std::span< const uint8_t > bytes)
Definition bigint.cpp:83
const X509_Time & expire_time() const
Definition crl_ent.cpp:143
const std::vector< uint8_t > & serial_number() const
Definition crl_ent.cpp:139
const Extensions & extensions() const
Definition crl_ent.cpp:151

References Botan::DER_Encoder::encode(), Botan::DER_Encoder::end_cons(), expire_time(), extensions(), Botan::BigInt::from_bytes(), serial_number(), and Botan::DER_Encoder::start_sequence().

◆ expire_time()

const X509_Time & Botan::CRL_Entry::expire_time ( ) const

Get the revocation date of the certificate associated with this entry

Returns
certificate's revocation date

Definition at line 143 of file crl_ent.cpp.

143 {
144 return data().m_time;
145}

Referenced by botan_x509_crl_entry_revocation_date(), encode_into(), and Botan::operator==().

◆ extensions()

const Extensions & Botan::CRL_Entry::extensions ( ) const

Get the extensions on this CRL entry

Definition at line 151 of file crl_ent.cpp.

151 {
152 return data().m_extensions;
153}

Referenced by encode_into().

◆ reason_code()

CRL_Code Botan::CRL_Entry::reason_code ( ) const

Get the entries reason code

Returns
reason code

Definition at line 147 of file crl_ent.cpp.

147 {
148 return data().m_reason;
149}

Referenced by botan_x509_crl_entry_reason(), and Botan::operator==().

◆ serial_number()

const std::vector< uint8_t > & Botan::CRL_Entry::serial_number ( ) const

Get the serial number of the certificate associated with this entry.

Returns
certificate's serial number

Definition at line 139 of file crl_ent.cpp.

139 {
140 return data().m_serial;
141}

Referenced by botan_x509_crl_entry_serial_number(), botan_x509_crl_entry_view_serial_number(), encode_into(), and Botan::operator==().

◆ X509_CRL

friend class X509_CRL
friend

Definition at line 70 of file x509_crl.h.

References X509_CRL.

Referenced by X509_CRL.


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