1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
|
/* Copyright (C) 2021 CZ.NIC, z.s.p.o. <knot-dns@labs.nic.cz>
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program. If not, see <https://www.gnu.org/licenses/>.
*/
#pragma once
#include <time.h>
#include "contrib/time.h"
#include "contrib/ucw/lists.h"
#include "libknot/db/db_lmdb.h"
#include "libknot/dname.h"
#include "knot/dnssec/kasp/policy.h"
#include "knot/journal/knot_lmdb.h"
typedef struct kasp_db kasp_db_t;
typedef enum { // the enum values MUST match those from keyclass_t !!
KASPDB_SERIAL_MASTER = 0x5,
KASPDB_SERIAL_LASTSIGNED = 0x6,
} kaspdb_serial_t;
/*!
* \brief For given zone, list all keys (their IDs) belonging to it.
*
* \param db KASP db
* \param zone_name name of the zone in question
* \param dst output if KNOT_EOK: ptrlist of keys' params
*
* \return KNOT_E* (KNOT_ENOENT if no keys)
*/
int kasp_db_list_keys(knot_lmdb_db_t *db, const knot_dname_t *zone_name, list_t *dst);
/*!
* \brief Obtain the algorithm of a key.
*
* \param db KASP db.
* \param zone_name name of the zone
* \param key_id ID of the key in question
*
* \retval KNOT_E* if error
* \return >0 The algorithm of the key.
*/
int kasp_db_get_key_algorithm(knot_lmdb_db_t *db, const knot_dname_t *zone_name,
const char *key_id);
/*!
* \brief Remove a key from zone. Delete the key if no zone has it anymore.
*
* \param db KASP db
* \param zone_name zone to be removed from
* \param key_id ID of key to be removed
* \param still_used output if KNOT_EOK: is the key still in use by other zones?
*
* \return KNOT_E*
*/
int kasp_db_delete_key(knot_lmdb_db_t *db, const knot_dname_t *zone_name, const char *key_id, bool *still_used);
/*!
* \brief Remove all zone's keys from DB, including nsec3param
*
* \param db KASP db
* \param zone_name zone to be removed
*
* \return KNOT_E*
*/
int kasp_db_delete_all(knot_lmdb_db_t *db, const knot_dname_t *zone_name);
/*!
* \brief Selectively delete zones from the database.
*
* \param db KASP database.
* \param keep_zone Filtering callback.
* \param cb_data Data passed to callback function.
*
* \return KNOT_E*
*/
int kasp_db_sweep(knot_lmdb_db_t *db, sweep_cb keep_zone, void *cb_data);
/*!
* \brief List all zones that have at least one key in KASP db.
*
* \param db KASP database.
* \param zones Output: ptrlist with zone names.
*
* \return KNOT_E*
*/
int kasp_db_list_zones(knot_lmdb_db_t *db, list_t *zones);
/*!
* \brief Add a key to the DB (possibly overwrite) and link it to a zone.
*
* Stores new key with given params into KASP db. If a key with the same ID had been present
* in KASP db already, its params get silently overwritten by those new params.
* Moreover, the key ID is linked to the zone.
*
* \param db KASP db
* \param zone_name name of the zone the new key shall belong to
* \param params key params, incl. ID
*
* \return KNOT_E*
*/
int kasp_db_add_key(knot_lmdb_db_t *db, const knot_dname_t *zone_name, const key_params_t *params);
/*!
* \brief Link a key from another zone.
*
* \param db KASP db
* \param zone_from name of the zone the key belongs to
* \param zone_to name of the zone the key shall belong to as well
* \param key_id ID of the key in question
*
* \return KNOT_E*
*/
int kasp_db_share_key(knot_lmdb_db_t *db, const knot_dname_t *zone_from,
const knot_dname_t *zone_to, const char *key_id);
/*!
* \brief Store NSEC3 salt for given zone (possibly overwrites old salt).
*
* \param db KASP db
* \param zone_name zone name
* \param nsec3salt new NSEC3 salt
* \param salt_created timestamp when the salt was created
*
* \return KNOT_E*
*/
int kasp_db_store_nsec3salt(knot_lmdb_db_t *db, const knot_dname_t *zone_name,
const dnssec_binary_t *nsec3salt, knot_time_t salt_created);
/*!
* \brief Load NSEC3 salt for given zone.
*
* \param db KASP db
* \param zone_name zone name
* \param nsec3salt output if KNOT_EOK: the zone's NSEC3 salt
* \param salt_created output if KNOT_EOK: timestamp when the salt was created
*
* \return KNOT_E* (KNOT_ENOENT if not stored before)
*/
int kasp_db_load_nsec3salt(knot_lmdb_db_t *db, const knot_dname_t *zone_name,
dnssec_binary_t *nsec3salt, knot_time_t *salt_created);
/*!
* \brief Store SOA serial number of master or last signed serial.
*
* \param db KASP db
* \param zone_name zone name
* \param serial_type kind of serial to be stored
* \param serial new serial to be stored
*
* \return KNOT_E*
*/
int kasp_db_store_serial(knot_lmdb_db_t *db, const knot_dname_t *zone_name,
kaspdb_serial_t serial_type, uint32_t serial);
/*!
* \brief Load saved SOA serial number of master or last signed serial.
*
* \param db KASP db
* \param zone_name zone name
* \param serial_type kind of serial to be loaded
* \param serial output if KNOT_EOK: desired serial number
*
* \return KNOT_E* (KNOT_ENOENT if not stored before)
*/
int kasp_db_load_serial(knot_lmdb_db_t *db, const knot_dname_t *zone_name,
kaspdb_serial_t serial_type, uint32_t *serial);
/*!
* \brief For given policy name, obtain last generated key.
*
* \param db KASP db
* \param policy_string a name identifying the signing policy with shared keys
* \param lp_zone out: the zone owning the last generated key
* \param lp_keyid out: the ID of the last generated key
*
* \note lp_zone and lp_keyid must be freed even when an error is returned
*
* \return KNOT_E*
*/
int kasp_db_get_policy_last(knot_lmdb_db_t *db, const char *policy_string,
knot_dname_t **lp_zone, char **lp_keyid);
/*!
* \brief For given policy name, try to reset last generated key.
*
* \param db KASP db
* \param policy_string a name identifying the signing policy with shared keys
* \param last_lp_keyid just for check: ID of the key the caller thinks is the policy-last
* \param new_lp_zone zone name of the new policy-last key
* \param new_lp_keyid ID of the new policy-last key
*
* \retval KNOT_ESEMCHECK lasp_lp_keyid does not correspond to real last key. Probably another zone
* changed policy-last key in the meantime. Re-run kasp_db_get_policy_last()
* \retval KNOT_EOK policy-last key set up successfully to given zone/ID
* \return KNOT_E* common error
*/
int kasp_db_set_policy_last(knot_lmdb_db_t *db, const char *policy_string, const char *last_lp_keyid,
const knot_dname_t *new_lp_zone, const char *new_lp_keyid);
/*!
* \brief Store pre-generated records for offline KSK usage.
*
* \param db KASP db.
* \param for_time Timestamp in future in which the RRSIG shall be used.
* \param r Records to be stored.
*
* \return KNOT_E*
*/
int kasp_db_store_offline_records(knot_lmdb_db_t *db, knot_time_t for_time, const key_records_t *r);
/*!
* \brief Load pregenerated records for offline signing.
*
* \param db KASP db.
* \param for_dname Name of the related zone.
* \param for_time Now. Closest RRSIG (timestamp equals or is closest lower).
* If zero, the first record is returned and its time is stored.
* \param next_time Out: timestamp of next saved RRSIG (for easy "iteration").
* \param r Out: offline records.
*
* \return KNOT_E*
*/
int kasp_db_load_offline_records(knot_lmdb_db_t *db, const knot_dname_t *for_dname,
knot_time_t *for_time, knot_time_t *next_time,
key_records_t *r);
/*!
* \brief Delete pregenerated records for specified time interval.
*
* \param db KASP db.
* \param zone Zone in question.
* \param from_time Lower bound of the time interval (0 = infinity).
* \param to_time Upper bound of the time interval (0 = infinity).
*
* \return KNOT_E*
*/
int kasp_db_delete_offline_records(knot_lmdb_db_t *db, const knot_dname_t *zone,
knot_time_t from_time, knot_time_t to_time);
/*!
* \brief Load saved zone-max-TTL and DNSKEY-TTL.
*
* \param db KASP db.
* \param max_ttl Out: saved zone max TTL.
* \param key_ttl Out: saved DNSKEY TTL.
*
* \retval KNOT_ENOENT If not saved yet.
* \return KNOT_E*
*/
int kasp_db_get_saved_ttls(knot_lmdb_db_t *db, const knot_dname_t *zone,
uint32_t *max_ttl, uint32_t *key_ttl);
/*!
* \brief Save current zone-max-TTL and DNSKEY-TTL.
*
* \param db KASP db.
* \param max_ttl Current zone max TTL.
* \param key_ttl Current DNSKEY TTL.
*
* \return KNOT_E*
*/
int kasp_db_set_saved_ttls(knot_lmdb_db_t *db, const knot_dname_t *zone,
uint32_t max_ttl, uint32_t key_ttl);
/*!
* \brief Initialize KASP database according to conf, if not already.
*
* \param db KASP DB to be initialized.
* \param conf COnfiguration to take options from.
*/
void kasp_db_ensure_init(knot_lmdb_db_t *db, conf_t *conf);
/*!
* \brief Backup KASP DB for one zone with keys and all metadata to backup location.
*
* \param zone Name of the zone to be backed up.
* \param db DB to backup from.
* \param backup_db DB to backup to.
*
* \return KNOT_E*
*/
int kasp_db_backup(const knot_dname_t *zone, knot_lmdb_db_t *db, knot_lmdb_db_t *backup_db);
|