Botan 3.13.0
Crypto and TLS for C&
certstor_sql.cpp
Go to the documentation of this file.
1/*
2* Certificate Store in SQL
3* (C) 2016 Kai Michaelis, Rohde & Schwarz Cybersecurity
4* (C) 2018 Jack Lloyd
5*
6* Botan is released under the Simplified BSD License (see license.txt)
7*/
8
9#include <botan/certstor_sql.h>
10
11#include <botan/asn1_obj.h>
12#include <botan/asn1_time.h>
13#include <botan/assert.h>
14#include <botan/ber_dec.h>
15#include <botan/data_src.h>
16#include <botan/pk_keys.h>
17#include <botan/pkcs8.h>
18#include <botan/pkix_types.h>
19#include <botan/internal/fmt.h>
20
21namespace Botan {
22
24 std::string_view passwd,
26 std::string_view table_prefix) :
27 m_rng(rng),
28 m_database(std::move(db)),
29 m_db_cert_table(fmt("{}certificates", table_prefix)),
30 m_db_keys_table(fmt("{}keys", table_prefix)),
31 m_db_crls_table(fmt("{}revoked", table_prefix)),
32 m_password(passwd) {
33 using DB = SQL_Database;
34 const auto blob = DB::Column_Type::Blob;
35 const auto integer = DB::Column_Type::Integer;
36
37 BOTAN_ARG_CHECK(m_database->is_valid_table_name(m_db_cert_table), "Invalid table name");
38 BOTAN_ARG_CHECK(m_database->is_valid_table_name(m_db_keys_table), "Invalid table name");
39 BOTAN_ARG_CHECK(m_database->is_valid_table_name(m_db_crls_table), "Invalid table name");
40
41 m_database->create_table(DB::Table_Schema(m_db_cert_table,
42 {
43 DB::Column("fingerprint", blob).primary_key(),
44 DB::Column("subject_dn", blob),
45 DB::Column("key_id", blob),
46 DB::Column("priv_fingerprint", blob),
47 DB::Column("certificate", blob).not_null(),
48 })
49 .if_not_exists());
50
51 m_database->create_table(DB::Table_Schema(m_db_keys_table,
52 {
53 DB::Column("fingerprint", blob).primary_key(),
54 DB::Column("key", blob).not_null(),
55 })
56 .if_not_exists());
57
58 m_database->create_table(DB::Table_Schema(m_db_crls_table,
59 {
60 DB::Column("fingerprint", blob).primary_key(),
61 DB::Column("reason", integer).not_null(),
62 DB::Column("time", integer),
63 })
64 .if_not_exists());
65}
66
67// Certificate handling
68std::optional<X509_Certificate> Certificate_Store_In_SQL::find_cert(const X509_DN& subject_dn,
69 const std::vector<uint8_t>& key_id) const {
70 std::shared_ptr<SQL_Database::Statement> stmt;
71
72 const std::vector<uint8_t> dn_encoding = subject_dn.BER_encode();
73
74 if(key_id.empty()) {
75 stmt = m_database->select("certificate", m_db_cert_table, "subject_dn = ?1", 1);
76 stmt->bind(1, dn_encoding);
77 } else {
78 stmt =
79 m_database->select("certificate", m_db_cert_table, "subject_dn = ?1 AND (key_id IS NULL OR key_id = ?2)", 1);
80 stmt->bind(1, dn_encoding);
81 stmt->bind(2, key_id);
82 }
83
84 while(stmt->step()) {
85 return X509_Certificate(stmt->get_blob(0));
86 }
87
88 return std::optional<X509_Certificate>();
89}
90
91std::vector<X509_Certificate> Certificate_Store_In_SQL::find_all_certs(const X509_DN& subject_dn,
92 const std::vector<uint8_t>& key_id) const {
93 std::vector<X509_Certificate> certs;
94
95 std::shared_ptr<SQL_Database::Statement> stmt;
96
97 const std::vector<uint8_t> dn_encoding = subject_dn.BER_encode();
98
99 if(key_id.empty()) {
100 stmt = m_database->select("certificate", m_db_cert_table, "subject_dn = ?1");
101 stmt->bind(1, dn_encoding);
102 } else {
103 stmt = m_database->select("certificate", m_db_cert_table, "subject_dn = ?1 AND (key_id IS NULL OR key_id = ?2)");
104 stmt->bind(1, dn_encoding);
105 stmt->bind(2, key_id);
106 }
107
108 while(stmt->step()) {
109 certs.push_back(X509_Certificate(stmt->get_blob(0)));
110 }
111
112 return certs;
113}
114
116 const std::vector<uint8_t>& /*key_hash*/) const {
117 throw Not_Implemented("Certificate_Store_In_SQL::find_cert_by_pubkey_sha1");
118}
119
121 const std::vector<uint8_t>& /*subject_hash*/) const {
122 throw Not_Implemented("Certificate_Store_In_SQL::find_cert_by_raw_subject_dn_sha256");
123}
124
126 const X509_DN& /*issuer_dn*/, std::span<const uint8_t> /*serial_number*/) const {
127 throw Not_Implemented("Certificate_Store_In_SQL::find_cert_by_issuer_dn_and_serial_number");
128}
129
130std::optional<X509_CRL> Certificate_Store_In_SQL::find_crl_for(const X509_Certificate& subject) const {
131 const auto all_crls = generate_crls();
132
133 for(const auto& crl : all_crls) {
134 if(!crl.get_revoked().empty() && crl.issuer_dn() == subject.issuer_dn()) {
135 return crl;
136 }
137 }
138
139 return std::optional<X509_CRL>();
140}
141
142std::vector<X509_DN> Certificate_Store_In_SQL::all_subjects() const {
143 std::vector<X509_DN> ret;
144 auto stmt = m_database->select("subject_dn", m_db_cert_table);
145
146 while(stmt->step()) {
147 BER_Decoder dec(stmt->get_blob(0), BER_Decoder::Limits::DER());
148 X509_DN dn;
149
150 dn.decode_from(dec);
151
152 ret.push_back(dn);
153 }
154
155 return ret;
156}
157
159 const std::vector<uint8_t> dn_encoding = cert.subject_dn().BER_encode();
160 const std::vector<uint8_t> cert_encoding = cert.BER_encode();
161
162 auto stmt =
163 m_database->upsert(m_db_cert_table, {"fingerprint", "subject_dn", "key_id", "priv_fingerprint", "certificate"});
164
165 stmt->bind(1, cert.fingerprint("SHA-256"));
166 stmt->bind(2, dn_encoding);
167 stmt->bind(3, cert.subject_key_id());
168 stmt->bind(4, std::vector<uint8_t>());
169 stmt->bind(5, cert_encoding);
170 stmt->spin();
171
172 return true;
173}
174
176 auto stmt = m_database->select("1", m_db_cert_table, "fingerprint = ?1");
177 stmt->bind(1, cert.fingerprint("SHA-256"));
178 return stmt->step();
179}
180
182 if(!find_cert(cert.subject_dn(), cert.subject_key_id())) {
183 return false;
184 }
185
186 auto stmt = m_database->new_statement(fmt("DELETE FROM {} WHERE fingerprint = ?1", m_db_cert_table));
187
188 stmt->bind(1, cert.fingerprint("SHA-256"));
189 stmt->spin();
190
191 return true;
192}
193
194// Private key handling
195std::shared_ptr<const Private_Key> Certificate_Store_In_SQL::find_key(const X509_Certificate& cert) const {
196 auto stmt =
197 m_database->new_statement(fmt("SELECT key FROM {} JOIN {} ON {}.fingerprint = {}.priv_fingerprint "
198 "WHERE {}.fingerprint = ?1",
199 m_db_keys_table,
200 m_db_cert_table,
201 m_db_keys_table,
202 m_db_cert_table,
203 m_db_cert_table));
204 stmt->bind(1, cert.fingerprint("SHA-256"));
205
206 std::shared_ptr<const Private_Key> key;
207 while(stmt->step()) {
208 DataSource_Memory src(stmt->get_blob(0));
209 key = PKCS8::load_key(src, m_password);
210 }
211
212 return key;
213}
214
215std::vector<X509_Certificate> Certificate_Store_In_SQL::find_certs_for_key(const Private_Key& key) const {
216 auto fprint = key.fingerprint_private("SHA-256");
217 auto stmt = m_database->select("certificate", m_db_cert_table, "priv_fingerprint = ?1");
218
219 stmt->bind(1, fprint);
220
221 std::vector<X509_Certificate> certs;
222 while(stmt->step()) {
223 certs.push_back(X509_Certificate(stmt->get_blob(0)));
224 }
225
226 return certs;
227}
228
230 insert_cert(cert);
231
232 if(find_key(cert)) {
233 return false;
234 }
235
236 auto pkcs8 = PKCS8::BER_encode(key, m_rng, m_password);
237 auto fprint = key.fingerprint_private("SHA-256");
238
239 auto stmt1 = m_database->upsert(m_db_keys_table, {"fingerprint", "key"});
240
241 stmt1->bind(1, fprint);
242 stmt1->bind(2, pkcs8.data(), pkcs8.size());
243 stmt1->spin();
244
245 auto stmt2 =
246 m_database->new_statement(fmt("UPDATE {} SET priv_fingerprint = ?1 WHERE fingerprint = ?2", m_db_cert_table));
247
248 stmt2->bind(1, fprint);
249 stmt2->bind(2, cert.fingerprint("SHA-256"));
250 stmt2->spin();
251
252 return true;
253}
254
256 auto fprint = key.fingerprint_private("SHA-256");
257 auto stmt = m_database->new_statement(fmt("DELETE FROM {} WHERE fingerprint = ?1", m_db_keys_table));
258
259 stmt->bind(1, fprint);
260 stmt->spin();
261}
262
263// Revocation
265 // TODO(Botan4) require that time be valid
266 insert_cert(cert);
267
268 auto stmt1 = m_database->upsert(m_db_crls_table, {"fingerprint", "reason", "time"});
269
270 stmt1->bind(1, cert.fingerprint("SHA-256"));
271 stmt1->bind(2, static_cast<uint32_t>(code));
272
273 if(time.time_is_set()) {
274 stmt1->bind(3, time.to_std_timepoint());
275 } else {
276 stmt1->bind_null(3);
277 }
278
279 stmt1->spin();
280}
281
282// Revocation
284 insert_cert(cert);
285
286 auto stmt1 = m_database->upsert(m_db_crls_table, {"fingerprint", "reason", "time"});
287
288 stmt1->bind(1, cert.fingerprint("SHA-256"));
289 stmt1->bind(2, static_cast<uint32_t>(code));
290 stmt1->bind_null(3);
291
292 stmt1->spin();
293}
294
296 auto stmt = m_database->new_statement(fmt("DELETE FROM {} WHERE fingerprint = ?1", m_db_crls_table));
297
298 stmt->bind(1, cert.fingerprint("SHA-256"));
299 stmt->spin();
300}
301
302std::vector<X509_CRL> Certificate_Store_In_SQL::generate_crls() const {
303 auto stmt =
304 m_database->new_statement(fmt("SELECT certificate,reason,time FROM {} JOIN {} ON {}.fingerprint = "
305 "{}.fingerprint",
306 m_db_crls_table,
307 m_db_cert_table,
308 m_db_cert_table,
309 m_db_crls_table));
310
311 std::map<X509_DN, std::vector<CRL_Entry>> crls;
312 while(stmt->step()) {
313 auto cert = X509_Certificate(stmt->get_blob(0));
314 auto code = static_cast<CRL_Code>(stmt->get_size_t(1));
315 auto ent = CRL_Entry(cert, code);
316
317 auto i = crls.find(cert.issuer_dn());
318 if(i == crls.end()) {
319 crls.insert(std::make_pair(cert.issuer_dn(), std::vector<CRL_Entry>({ent})));
320 } else {
321 i->second.push_back(ent);
322 }
323 }
324
325 const X509_Time t(std::chrono::system_clock::now());
326
327 std::vector<X509_CRL> ret;
328 ret.reserve(crls.size());
329
330 for(const auto& p : crls) {
331 ret.push_back(X509_CRL(p.first, t, t, p.second));
332 }
333
334 return ret;
335}
336
337} // namespace Botan
#define BOTAN_ARG_CHECK(expr, msg)
Definition assert.h:33
std::vector< uint8_t > BER_encode() const
Definition asn1_obj.cpp:21
std::chrono::system_clock::time_point to_std_timepoint() const
Returns a STL timepoint object.
bool time_is_set() const
Return if the time has been set somehow.
static Limits DER()
Definition ber_dec.h:42
std::optional< X509_Certificate > find_cert_by_issuer_dn_and_serial_number(const X509_DN &issuer_dn, std::span< const uint8_t > serial_number) const override
std::vector< X509_DN > all_subjects() const override
bool insert_cert(const X509_Certificate &cert)
std::vector< X509_Certificate > find_all_certs(const X509_DN &subject_dn, const std::vector< uint8_t > &key_id) const override
std::optional< X509_Certificate > find_cert_by_raw_subject_dn_sha256(const std::vector< uint8_t > &subject_hash) const override
bool contains(const X509_Certificate &cert) const override
void revoke_cert(const X509_Certificate &cert, CRL_Code reason, const X509_Time &time)
Marks "cert" as revoked starting from "time".
std::optional< X509_CRL > find_crl_for(const X509_Certificate &issuer) const override
Certificate_Store_In_SQL(std::shared_ptr< SQL_Database > db, std::string_view passwd, RandomNumberGenerator &rng, std::string_view table_prefix="")
std::vector< X509_Certificate > find_certs_for_key(const Private_Key &key) const
Returns all certificates for private key "key".
void affirm_cert(const X509_Certificate &cert)
Reverses the revocation for "cert".
bool remove_cert(const X509_Certificate &cert)
std::shared_ptr< const Private_Key > find_key(const X509_Certificate &cert) const
Returns the private key for "cert" or an empty shared_ptr if none was found.
std::optional< X509_Certificate > find_cert(const X509_DN &subject_dn, const std::vector< uint8_t > &key_id) const override
void remove_key(const Private_Key &key)
Removes "key" from the store.
bool insert_key(const X509_Certificate &cert, const Private_Key &key)
std::optional< X509_Certificate > find_cert_by_pubkey_sha1(const std::vector< uint8_t > &key_hash) const override
std::vector< X509_CRL > generate_crls() const
std::string fingerprint_private(std::string_view alg) const
Definition pk_keys.cpp:101
std::string fingerprint(std::string_view hash_name="SHA-1") const
Definition x509cert.cpp:792
const X509_DN & subject_dn() const
Definition x509cert.cpp:460
const std::vector< uint8_t > & subject_key_id() const
Definition x509cert.cpp:436
const X509_DN & issuer_dn() const
Definition x509cert.cpp:456
void decode_from(BER_Decoder &from) override
Definition x509_dn.cpp:408
std::vector< uint8_t > BER_encode(const Private_Key &key, RandomNumberGenerator &rng, std::string_view pass, std::chrono::milliseconds msec, std::string_view pbe_algo)
Definition pkcs8.cpp:167
std::unique_ptr< Private_Key > load_key(DataSource &source, const std::function< std::string()> &get_pass)
Definition pkcs8.cpp:319
ASN1_Time X509_Time
Definition asn1_obj.h:27
std::string fmt(std::string_view format, const T &... args)
Definition fmt.h:53