2 * Copyright (c) 2012 Damien Miller <djm@mindrot.org>
4 * Permission to use, copy, modify, and distribute this software for any
5 * purpose with or without fee is hereby granted, provided that the above
6 * copyright notice and this permission notice appear in all copies.
8 * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
9 * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
10 * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
11 * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
12 * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
13 * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
14 * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
17 /* $OpenBSD: krl.h,v 1.10 2023/07/17 04:01:10 djm Exp $ */
22 /* Functions to manage key revocation lists */
24 #define KRL_MAGIC "SSHKRL\n\0"
25 #define KRL_FORMAT_VERSION 1
27 /* KRL section types */
28 #define KRL_SECTION_CERTIFICATES 1
29 #define KRL_SECTION_EXPLICIT_KEY 2
30 #define KRL_SECTION_FINGERPRINT_SHA1 3
31 #define KRL_SECTION_SIGNATURE 4
32 #define KRL_SECTION_FINGERPRINT_SHA256 5
33 #define KRL_SECTION_EXTENSION 255
35 /* KRL_SECTION_CERTIFICATES subsection types */
36 #define KRL_SECTION_CERT_SERIAL_LIST 0x20
37 #define KRL_SECTION_CERT_SERIAL_RANGE 0x21
38 #define KRL_SECTION_CERT_SERIAL_BITMAP 0x22
39 #define KRL_SECTION_CERT_KEY_ID 0x23
40 #define KRL_SECTION_CERT_EXTENSION 0x39
46 struct ssh_krl
*ssh_krl_init(void);
47 void ssh_krl_free(struct ssh_krl
*krl
);
48 void ssh_krl_set_version(struct ssh_krl
*krl
, u_int64_t version
);
49 int ssh_krl_set_comment(struct ssh_krl
*krl
, const char *comment
);
50 int ssh_krl_revoke_cert_by_serial(struct ssh_krl
*krl
,
51 const struct sshkey
*ca_key
, u_int64_t serial
);
52 int ssh_krl_revoke_cert_by_serial_range(struct ssh_krl
*krl
,
53 const struct sshkey
*ca_key
, u_int64_t lo
, u_int64_t hi
);
54 int ssh_krl_revoke_cert_by_key_id(struct ssh_krl
*krl
,
55 const struct sshkey
*ca_key
, const char *key_id
);
56 int ssh_krl_revoke_key_explicit(struct ssh_krl
*krl
, const struct sshkey
*key
);
57 int ssh_krl_revoke_key_sha1(struct ssh_krl
*krl
, const u_char
*p
, size_t len
);
58 int ssh_krl_revoke_key_sha256(struct ssh_krl
*krl
, const u_char
*p
, size_t len
);
59 int ssh_krl_revoke_key(struct ssh_krl
*krl
, const struct sshkey
*key
);
60 int ssh_krl_to_blob(struct ssh_krl
*krl
, struct sshbuf
*buf
);
61 int ssh_krl_from_blob(struct sshbuf
*buf
, struct ssh_krl
**krlp
);
62 int ssh_krl_check_key(struct ssh_krl
*krl
, const struct sshkey
*key
);
63 int ssh_krl_file_contains_key(const char *path
, const struct sshkey
*key
);
64 int krl_dump(struct ssh_krl
*krl
, FILE *f
);