djm@openbsd.org | b52ec0b | 2019-12-13 19:09:10 +0000 | [diff] [blame] | 1 | /* $OpenBSD: sshkey.h,v 1.41 2019/12/13 19:09:10 djm Exp $ */ |
Damien Miller | 8668706 | 2014-07-02 15:28:02 +1000 | [diff] [blame] | 2 | |
| 3 | /* |
| 4 | * Copyright (c) 2000, 2001 Markus Friedl. All rights reserved. |
| 5 | * |
| 6 | * Redistribution and use in source and binary forms, with or without |
| 7 | * modification, are permitted provided that the following conditions |
| 8 | * are met: |
| 9 | * 1. Redistributions of source code must retain the above copyright |
| 10 | * notice, this list of conditions and the following disclaimer. |
| 11 | * 2. Redistributions in binary form must reproduce the above copyright |
| 12 | * notice, this list of conditions and the following disclaimer in the |
| 13 | * documentation and/or other materials provided with the distribution. |
| 14 | * |
| 15 | * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR |
| 16 | * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES |
| 17 | * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. |
| 18 | * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, |
| 19 | * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT |
| 20 | * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, |
| 21 | * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY |
| 22 | * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT |
| 23 | * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF |
| 24 | * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. |
| 25 | */ |
| 26 | #ifndef SSHKEY_H |
| 27 | #define SSHKEY_H |
| 28 | |
| 29 | #include <sys/types.h> |
| 30 | |
| 31 | #ifdef WITH_OPENSSL |
| 32 | #include <openssl/rsa.h> |
| 33 | #include <openssl/dsa.h> |
Damien Miller | f093569 | 2014-08-20 11:06:50 +1000 | [diff] [blame] | 34 | # ifdef OPENSSL_HAS_ECC |
| 35 | # include <openssl/ec.h> |
djm@openbsd.org | 93f0210 | 2019-01-20 22:51:37 +0000 | [diff] [blame] | 36 | # include <openssl/ecdsa.h> |
Damien Miller | f093569 | 2014-08-20 11:06:50 +1000 | [diff] [blame] | 37 | # else /* OPENSSL_HAS_ECC */ |
| 38 | # define EC_KEY void |
| 39 | # define EC_GROUP void |
| 40 | # define EC_POINT void |
| 41 | # endif /* OPENSSL_HAS_ECC */ |
| 42 | #else /* WITH_OPENSSL */ |
djm@openbsd.org | 482d23b | 2018-09-13 02:08:33 +0000 | [diff] [blame] | 43 | # define BIGNUM void |
Damien Miller | f093569 | 2014-08-20 11:06:50 +1000 | [diff] [blame] | 44 | # define RSA void |
| 45 | # define DSA void |
| 46 | # define EC_KEY void |
| 47 | # define EC_GROUP void |
| 48 | # define EC_POINT void |
Damien Miller | 8668706 | 2014-07-02 15:28:02 +1000 | [diff] [blame] | 49 | #endif /* WITH_OPENSSL */ |
| 50 | |
djm@openbsd.org | bd636f4 | 2017-05-07 23:15:59 +0000 | [diff] [blame] | 51 | #define SSH_RSA_MINIMUM_MODULUS_SIZE 1024 |
Damien Miller | 8668706 | 2014-07-02 15:28:02 +1000 | [diff] [blame] | 52 | #define SSH_KEY_MAX_SIGN_DATA_SIZE (1 << 20) |
| 53 | |
djm@openbsd.org | b52ec0b | 2019-12-13 19:09:10 +0000 | [diff] [blame] | 54 | /* Version of protocol expected from ssh-sk-helper */ |
| 55 | #define SSH_SK_HELPER_VERSION 1 |
| 56 | |
Damien Miller | 8668706 | 2014-07-02 15:28:02 +1000 | [diff] [blame] | 57 | struct sshbuf; |
| 58 | |
| 59 | /* Key types */ |
| 60 | enum sshkey_types { |
Damien Miller | 8668706 | 2014-07-02 15:28:02 +1000 | [diff] [blame] | 61 | KEY_RSA, |
| 62 | KEY_DSA, |
| 63 | KEY_ECDSA, |
| 64 | KEY_ED25519, |
| 65 | KEY_RSA_CERT, |
| 66 | KEY_DSA_CERT, |
| 67 | KEY_ECDSA_CERT, |
| 68 | KEY_ED25519_CERT, |
markus@openbsd.org | 1b11ea7 | 2018-02-23 15:58:37 +0000 | [diff] [blame] | 69 | KEY_XMSS, |
| 70 | KEY_XMSS_CERT, |
djm@openbsd.org | 02bb076 | 2019-10-31 21:15:14 +0000 | [diff] [blame] | 71 | KEY_ECDSA_SK, |
| 72 | KEY_ECDSA_SK_CERT, |
markus@openbsd.org | 7c096c4 | 2019-11-12 19:29:24 +0000 | [diff] [blame] | 73 | KEY_ED25519_SK, |
| 74 | KEY_ED25519_SK_CERT, |
Damien Miller | 8668706 | 2014-07-02 15:28:02 +1000 | [diff] [blame] | 75 | KEY_UNSPEC |
| 76 | }; |
| 77 | |
djm@openbsd.org | 56d1c83 | 2014-12-21 22:27:55 +0000 | [diff] [blame] | 78 | /* Default fingerprint hash */ |
| 79 | #define SSH_FP_HASH_DEFAULT SSH_DIGEST_SHA256 |
Damien Miller | 8668706 | 2014-07-02 15:28:02 +1000 | [diff] [blame] | 80 | |
| 81 | /* Fingerprint representation formats */ |
| 82 | enum sshkey_fp_rep { |
djm@openbsd.org | 56d1c83 | 2014-12-21 22:27:55 +0000 | [diff] [blame] | 83 | SSH_FP_DEFAULT = 0, |
Damien Miller | 8668706 | 2014-07-02 15:28:02 +1000 | [diff] [blame] | 84 | SSH_FP_HEX, |
djm@openbsd.org | 56d1c83 | 2014-12-21 22:27:55 +0000 | [diff] [blame] | 85 | SSH_FP_BASE64, |
Damien Miller | 8668706 | 2014-07-02 15:28:02 +1000 | [diff] [blame] | 86 | SSH_FP_BUBBLEBABBLE, |
| 87 | SSH_FP_RANDOMART |
| 88 | }; |
| 89 | |
markus@openbsd.org | 1b11ea7 | 2018-02-23 15:58:37 +0000 | [diff] [blame] | 90 | /* Private key serialisation formats, used on the wire */ |
| 91 | enum sshkey_serialize_rep { |
| 92 | SSHKEY_SERIALIZE_DEFAULT = 0, |
markus@openbsd.org | bf21992 | 2019-11-13 07:53:10 +0000 | [diff] [blame] | 93 | SSHKEY_SERIALIZE_STATE = 1, /* only state is serialized */ |
| 94 | SSHKEY_SERIALIZE_FULL = 2, /* include keys for saving to disk */ |
| 95 | SSHKEY_SERIALIZE_SHIELD = 3, /* everything, for encrypting in ram */ |
| 96 | SSHKEY_SERIALIZE_INFO = 254, /* minimal information */ |
markus@openbsd.org | 1b11ea7 | 2018-02-23 15:58:37 +0000 | [diff] [blame] | 97 | }; |
| 98 | |
djm@openbsd.org | eb0d8e7 | 2019-07-15 13:16:29 +0000 | [diff] [blame] | 99 | /* Private key disk formats */ |
| 100 | enum sshkey_private_format { |
| 101 | SSHKEY_PRIVATE_OPENSSH = 0, |
| 102 | SSHKEY_PRIVATE_PEM = 1, |
| 103 | SSHKEY_PRIVATE_PKCS8 = 2, |
| 104 | }; |
| 105 | |
Damien Miller | 8668706 | 2014-07-02 15:28:02 +1000 | [diff] [blame] | 106 | /* key is stored in external hardware */ |
| 107 | #define SSHKEY_FLAG_EXT 0x0001 |
| 108 | |
| 109 | #define SSHKEY_CERT_MAX_PRINCIPALS 256 |
| 110 | /* XXX opaquify? */ |
| 111 | struct sshkey_cert { |
| 112 | struct sshbuf *certblob; /* Kept around for use on wire */ |
| 113 | u_int type; /* SSH2_CERT_TYPE_USER or SSH2_CERT_TYPE_HOST */ |
| 114 | u_int64_t serial; |
| 115 | char *key_id; |
| 116 | u_int nprincipals; |
| 117 | char **principals; |
| 118 | u_int64_t valid_after, valid_before; |
| 119 | struct sshbuf *critical; |
| 120 | struct sshbuf *extensions; |
| 121 | struct sshkey *signature_key; |
djm@openbsd.org | a70fd4a | 2018-09-12 01:31:30 +0000 | [diff] [blame] | 122 | char *signature_type; |
Damien Miller | 8668706 | 2014-07-02 15:28:02 +1000 | [diff] [blame] | 123 | }; |
| 124 | |
| 125 | /* XXX opaquify? */ |
| 126 | struct sshkey { |
| 127 | int type; |
| 128 | int flags; |
djm@openbsd.org | 02bb076 | 2019-10-31 21:15:14 +0000 | [diff] [blame] | 129 | /* KEY_RSA */ |
Damien Miller | 8668706 | 2014-07-02 15:28:02 +1000 | [diff] [blame] | 130 | RSA *rsa; |
djm@openbsd.org | 02bb076 | 2019-10-31 21:15:14 +0000 | [diff] [blame] | 131 | /* KEY_DSA */ |
Damien Miller | 8668706 | 2014-07-02 15:28:02 +1000 | [diff] [blame] | 132 | DSA *dsa; |
djm@openbsd.org | 02bb076 | 2019-10-31 21:15:14 +0000 | [diff] [blame] | 133 | /* KEY_ECDSA and KEY_ECDSA_SK */ |
Damien Miller | 8668706 | 2014-07-02 15:28:02 +1000 | [diff] [blame] | 134 | int ecdsa_nid; /* NID of curve */ |
| 135 | EC_KEY *ecdsa; |
markus@openbsd.org | 2c55744 | 2019-11-12 19:33:08 +0000 | [diff] [blame] | 136 | /* KEY_ED25519 and KEY_ED25519_SK */ |
Damien Miller | 8668706 | 2014-07-02 15:28:02 +1000 | [diff] [blame] | 137 | u_char *ed25519_sk; |
| 138 | u_char *ed25519_pk; |
djm@openbsd.org | 02bb076 | 2019-10-31 21:15:14 +0000 | [diff] [blame] | 139 | /* KEY_XMSS */ |
markus@openbsd.org | 1b11ea7 | 2018-02-23 15:58:37 +0000 | [diff] [blame] | 140 | char *xmss_name; |
| 141 | char *xmss_filename; /* for state file updates */ |
| 142 | void *xmss_state; /* depends on xmss_name, opaque */ |
| 143 | u_char *xmss_sk; |
| 144 | u_char *xmss_pk; |
markus@openbsd.org | 2c55744 | 2019-11-12 19:33:08 +0000 | [diff] [blame] | 145 | /* KEY_ECDSA_SK and KEY_ED25519_SK */ |
djm@openbsd.org | 02bb076 | 2019-10-31 21:15:14 +0000 | [diff] [blame] | 146 | char *sk_application; |
| 147 | uint8_t sk_flags; |
| 148 | struct sshbuf *sk_key_handle; |
| 149 | struct sshbuf *sk_reserved; |
| 150 | /* Certificates */ |
Damien Miller | 8668706 | 2014-07-02 15:28:02 +1000 | [diff] [blame] | 151 | struct sshkey_cert *cert; |
djm@openbsd.org | 02bb076 | 2019-10-31 21:15:14 +0000 | [diff] [blame] | 152 | /* Private key shielding */ |
djm@openbsd.org | 4f7a56d | 2019-06-21 04:21:04 +0000 | [diff] [blame] | 153 | u_char *shielded_private; |
| 154 | size_t shielded_len; |
| 155 | u_char *shield_prekey; |
| 156 | size_t shield_prekey_len; |
Damien Miller | 8668706 | 2014-07-02 15:28:02 +1000 | [diff] [blame] | 157 | }; |
| 158 | |
| 159 | #define ED25519_SK_SZ crypto_sign_ed25519_SECRETKEYBYTES |
| 160 | #define ED25519_PK_SZ crypto_sign_ed25519_PUBLICKEYBYTES |
| 161 | |
djm@openbsd.org | b7e74ea | 2019-11-25 00:51:37 +0000 | [diff] [blame] | 162 | /* Additional fields contained in signature */ |
| 163 | struct sshkey_sig_details { |
| 164 | uint32_t sk_counter; /* U2F signature counter */ |
| 165 | uint8_t sk_flags; /* U2F signature flags; see ssh-sk.h */ |
| 166 | }; |
| 167 | |
Damien Miller | 8668706 | 2014-07-02 15:28:02 +1000 | [diff] [blame] | 168 | struct sshkey *sshkey_new(int); |
Damien Miller | 8668706 | 2014-07-02 15:28:02 +1000 | [diff] [blame] | 169 | void sshkey_free(struct sshkey *); |
Damien Miller | 8668706 | 2014-07-02 15:28:02 +1000 | [diff] [blame] | 170 | int sshkey_equal_public(const struct sshkey *, |
| 171 | const struct sshkey *); |
| 172 | int sshkey_equal(const struct sshkey *, const struct sshkey *); |
| 173 | char *sshkey_fingerprint(const struct sshkey *, |
djm@openbsd.org | 56d1c83 | 2014-12-21 22:27:55 +0000 | [diff] [blame] | 174 | int, enum sshkey_fp_rep); |
Damien Miller | 8668706 | 2014-07-02 15:28:02 +1000 | [diff] [blame] | 175 | int sshkey_fingerprint_raw(const struct sshkey *k, |
djm@openbsd.org | 56d1c83 | 2014-12-21 22:27:55 +0000 | [diff] [blame] | 176 | int, u_char **retp, size_t *lenp); |
Damien Miller | 8668706 | 2014-07-02 15:28:02 +1000 | [diff] [blame] | 177 | const char *sshkey_type(const struct sshkey *); |
| 178 | const char *sshkey_cert_type(const struct sshkey *); |
djm@openbsd.org | 6026f48 | 2017-06-13 11:22:15 +0000 | [diff] [blame] | 179 | int sshkey_format_text(const struct sshkey *, struct sshbuf *); |
Damien Miller | 8668706 | 2014-07-02 15:28:02 +1000 | [diff] [blame] | 180 | int sshkey_write(const struct sshkey *, FILE *); |
| 181 | int sshkey_read(struct sshkey *, char **); |
| 182 | u_int sshkey_size(const struct sshkey *); |
| 183 | |
| 184 | int sshkey_generate(int type, u_int bits, struct sshkey **keyp); |
| 185 | int sshkey_from_private(const struct sshkey *, struct sshkey **); |
djm@openbsd.org | 4f7a56d | 2019-06-21 04:21:04 +0000 | [diff] [blame] | 186 | |
| 187 | int sshkey_is_shielded(struct sshkey *); |
| 188 | int sshkey_shield_private(struct sshkey *); |
| 189 | int sshkey_unshield_private(struct sshkey *); |
| 190 | |
Damien Miller | 8668706 | 2014-07-02 15:28:02 +1000 | [diff] [blame] | 191 | int sshkey_type_from_name(const char *); |
| 192 | int sshkey_is_cert(const struct sshkey *); |
markus@openbsd.org | 2c55744 | 2019-11-12 19:33:08 +0000 | [diff] [blame] | 193 | int sshkey_is_sk(const struct sshkey *); |
Damien Miller | 8668706 | 2014-07-02 15:28:02 +1000 | [diff] [blame] | 194 | int sshkey_type_is_cert(int); |
| 195 | int sshkey_type_plain(int); |
djm@openbsd.org | c28fc62 | 2015-07-03 03:43:18 +0000 | [diff] [blame] | 196 | int sshkey_to_certified(struct sshkey *); |
Damien Miller | 8668706 | 2014-07-02 15:28:02 +1000 | [diff] [blame] | 197 | int sshkey_drop_cert(struct sshkey *); |
Damien Miller | 8668706 | 2014-07-02 15:28:02 +1000 | [diff] [blame] | 198 | int sshkey_cert_copy(const struct sshkey *, struct sshkey *); |
| 199 | int sshkey_cert_check_authority(const struct sshkey *, int, int, |
| 200 | const char *, const char **); |
djm@openbsd.org | 499cf36 | 2015-11-19 01:08:55 +0000 | [diff] [blame] | 201 | size_t sshkey_format_cert_validity(const struct sshkey_cert *, |
| 202 | char *, size_t) __attribute__((__bounded__(__string__, 2, 3))); |
djm@openbsd.org | ba9e788 | 2018-09-12 01:32:54 +0000 | [diff] [blame] | 203 | int sshkey_check_cert_sigtype(const struct sshkey *, const char *); |
Damien Miller | 8668706 | 2014-07-02 15:28:02 +1000 | [diff] [blame] | 204 | |
djm@openbsd.org | 9a14c64 | 2019-10-31 21:23:19 +0000 | [diff] [blame] | 205 | int sshkey_certify(struct sshkey *, struct sshkey *, |
| 206 | const char *, const char *); |
djm@openbsd.org | a98339e | 2017-06-28 01:09:22 +0000 | [diff] [blame] | 207 | /* Variant allowing use of a custom signature function (e.g. for ssh-agent) */ |
djm@openbsd.org | 4f7a56d | 2019-06-21 04:21:04 +0000 | [diff] [blame] | 208 | typedef int sshkey_certify_signer(struct sshkey *, u_char **, size_t *, |
djm@openbsd.org | 9a14c64 | 2019-10-31 21:23:19 +0000 | [diff] [blame] | 209 | const u_char *, size_t, const char *, const char *, u_int, void *); |
djm@openbsd.org | a98339e | 2017-06-28 01:09:22 +0000 | [diff] [blame] | 210 | int sshkey_certify_custom(struct sshkey *, struct sshkey *, const char *, |
djm@openbsd.org | 9a14c64 | 2019-10-31 21:23:19 +0000 | [diff] [blame] | 211 | const char *, sshkey_certify_signer *, void *); |
djm@openbsd.org | a98339e | 2017-06-28 01:09:22 +0000 | [diff] [blame] | 212 | |
Damien Miller | 8668706 | 2014-07-02 15:28:02 +1000 | [diff] [blame] | 213 | int sshkey_ecdsa_nid_from_name(const char *); |
| 214 | int sshkey_curve_name_to_nid(const char *); |
| 215 | const char * sshkey_curve_nid_to_name(int); |
| 216 | u_int sshkey_curve_nid_to_bits(int); |
| 217 | int sshkey_ecdsa_bits_to_nid(int); |
| 218 | int sshkey_ecdsa_key_to_nid(EC_KEY *); |
| 219 | int sshkey_ec_nid_to_hash_alg(int nid); |
| 220 | int sshkey_ec_validate_public(const EC_GROUP *, const EC_POINT *); |
| 221 | int sshkey_ec_validate_private(const EC_KEY *); |
| 222 | const char *sshkey_ssh_name(const struct sshkey *); |
| 223 | const char *sshkey_ssh_name_plain(const struct sshkey *); |
djm@openbsd.org | 1f729f0 | 2015-01-13 07:39:19 +0000 | [diff] [blame] | 224 | int sshkey_names_valid2(const char *, int); |
djm@openbsd.org | 183ba55 | 2017-03-10 04:07:20 +0000 | [diff] [blame] | 225 | char *sshkey_alg_list(int, int, int, char); |
Damien Miller | 8668706 | 2014-07-02 15:28:02 +1000 | [diff] [blame] | 226 | |
| 227 | int sshkey_from_blob(const u_char *, size_t, struct sshkey **); |
djm@openbsd.org | 60b1825 | 2015-01-26 02:59:11 +0000 | [diff] [blame] | 228 | int sshkey_fromb(struct sshbuf *, struct sshkey **); |
| 229 | int sshkey_froms(struct sshbuf *, struct sshkey **); |
Damien Miller | 8668706 | 2014-07-02 15:28:02 +1000 | [diff] [blame] | 230 | int sshkey_to_blob(const struct sshkey *, u_char **, size_t *); |
djm@openbsd.org | d80fbe4 | 2015-05-21 04:55:51 +0000 | [diff] [blame] | 231 | int sshkey_to_base64(const struct sshkey *, char **); |
djm@openbsd.org | 60b1825 | 2015-01-26 02:59:11 +0000 | [diff] [blame] | 232 | int sshkey_putb(const struct sshkey *, struct sshbuf *); |
| 233 | int sshkey_puts(const struct sshkey *, struct sshbuf *); |
markus@openbsd.org | 1b11ea7 | 2018-02-23 15:58:37 +0000 | [diff] [blame] | 234 | int sshkey_puts_opts(const struct sshkey *, struct sshbuf *, |
| 235 | enum sshkey_serialize_rep); |
Damien Miller | 8668706 | 2014-07-02 15:28:02 +1000 | [diff] [blame] | 236 | int sshkey_plain_to_blob(const struct sshkey *, u_char **, size_t *); |
djm@openbsd.org | 60b1825 | 2015-01-26 02:59:11 +0000 | [diff] [blame] | 237 | int sshkey_putb_plain(const struct sshkey *, struct sshbuf *); |
Damien Miller | 8668706 | 2014-07-02 15:28:02 +1000 | [diff] [blame] | 238 | |
djm@openbsd.org | 4f7a56d | 2019-06-21 04:21:04 +0000 | [diff] [blame] | 239 | int sshkey_sign(struct sshkey *, u_char **, size_t *, |
djm@openbsd.org | 9a14c64 | 2019-10-31 21:23:19 +0000 | [diff] [blame] | 240 | const u_char *, size_t, const char *, const char *, u_int); |
Damien Miller | 8668706 | 2014-07-02 15:28:02 +1000 | [diff] [blame] | 241 | int sshkey_verify(const struct sshkey *, const u_char *, size_t, |
djm@openbsd.org | b7e74ea | 2019-11-25 00:51:37 +0000 | [diff] [blame] | 242 | const u_char *, size_t, const char *, u_int, struct sshkey_sig_details **); |
djm@openbsd.org | 4ba0d54 | 2018-07-03 11:39:54 +0000 | [diff] [blame] | 243 | int sshkey_check_sigtype(const u_char *, size_t, const char *); |
djm@openbsd.org | b4d4eda | 2018-07-03 13:20:25 +0000 | [diff] [blame] | 244 | const char *sshkey_sigalg_by_name(const char *); |
djm@openbsd.org | f8df041 | 2019-09-03 08:31:20 +0000 | [diff] [blame] | 245 | int sshkey_get_sigtype(const u_char *, size_t, char **); |
Damien Miller | 8668706 | 2014-07-02 15:28:02 +1000 | [diff] [blame] | 246 | |
| 247 | /* for debug */ |
| 248 | void sshkey_dump_ec_point(const EC_GROUP *, const EC_POINT *); |
| 249 | void sshkey_dump_ec_key(const EC_KEY *); |
| 250 | |
| 251 | /* private key parsing and serialisation */ |
djm@openbsd.org | 4f7a56d | 2019-06-21 04:21:04 +0000 | [diff] [blame] | 252 | int sshkey_private_serialize(struct sshkey *key, struct sshbuf *buf); |
| 253 | int sshkey_private_serialize_opt(struct sshkey *key, struct sshbuf *buf, |
markus@openbsd.org | 1b11ea7 | 2018-02-23 15:58:37 +0000 | [diff] [blame] | 254 | enum sshkey_serialize_rep); |
Damien Miller | 8668706 | 2014-07-02 15:28:02 +1000 | [diff] [blame] | 255 | int sshkey_private_deserialize(struct sshbuf *buf, struct sshkey **keyp); |
| 256 | |
| 257 | /* private key file format parsing and serialisation */ |
| 258 | int sshkey_private_to_fileblob(struct sshkey *key, struct sshbuf *blob, |
| 259 | const char *passphrase, const char *comment, |
djm@openbsd.org | eb0d8e7 | 2019-07-15 13:16:29 +0000 | [diff] [blame] | 260 | int format, const char *openssh_format_cipher, int openssh_format_rounds); |
Damien Miller | 8668706 | 2014-07-02 15:28:02 +1000 | [diff] [blame] | 261 | int sshkey_parse_private_fileblob(struct sshbuf *buffer, |
tim@openbsd.org | 3c019a9 | 2015-09-13 14:39:16 +0000 | [diff] [blame] | 262 | const char *passphrase, struct sshkey **keyp, char **commentp); |
Damien Miller | 8668706 | 2014-07-02 15:28:02 +1000 | [diff] [blame] | 263 | int sshkey_parse_private_fileblob_type(struct sshbuf *blob, int type, |
| 264 | const char *passphrase, struct sshkey **keyp, char **commentp); |
| 265 | |
djm@openbsd.org | 83fa3a0 | 2017-07-01 13:50:45 +0000 | [diff] [blame] | 266 | /* XXX should be internal, but used by ssh-keygen */ |
djm@openbsd.org | 482d23b | 2018-09-13 02:08:33 +0000 | [diff] [blame] | 267 | int ssh_rsa_complete_crt_parameters(struct sshkey *, const BIGNUM *); |
djm@openbsd.org | 83fa3a0 | 2017-07-01 13:50:45 +0000 | [diff] [blame] | 268 | |
markus@openbsd.org | 1b11ea7 | 2018-02-23 15:58:37 +0000 | [diff] [blame] | 269 | /* stateful keys (e.g. XMSS) */ |
Darren Tucker | 1323f12 | 2018-02-27 08:41:25 +1100 | [diff] [blame] | 270 | #ifdef NO_ATTRIBUTE_ON_PROTOTYPE_ARGS |
| 271 | typedef void sshkey_printfn(const char *, ...); |
| 272 | #else |
markus@openbsd.org | 1b11ea7 | 2018-02-23 15:58:37 +0000 | [diff] [blame] | 273 | typedef void sshkey_printfn(const char *, ...) __attribute__((format(printf, 1, 2))); |
Darren Tucker | 1323f12 | 2018-02-27 08:41:25 +1100 | [diff] [blame] | 274 | #endif |
markus@openbsd.org | 1b11ea7 | 2018-02-23 15:58:37 +0000 | [diff] [blame] | 275 | int sshkey_set_filename(struct sshkey *, const char *); |
| 276 | int sshkey_enable_maxsign(struct sshkey *, u_int32_t); |
| 277 | u_int32_t sshkey_signatures_left(const struct sshkey *); |
| 278 | int sshkey_forward_state(const struct sshkey *, u_int32_t, sshkey_printfn *); |
djm@openbsd.org | 4f7a56d | 2019-06-21 04:21:04 +0000 | [diff] [blame] | 279 | int sshkey_private_serialize_maxsign(struct sshkey *key, struct sshbuf *buf, |
markus@openbsd.org | 1b11ea7 | 2018-02-23 15:58:37 +0000 | [diff] [blame] | 280 | u_int32_t maxsign, sshkey_printfn *pr); |
| 281 | |
djm@openbsd.org | b7e74ea | 2019-11-25 00:51:37 +0000 | [diff] [blame] | 282 | void sshkey_sig_details_free(struct sshkey_sig_details *); |
| 283 | |
Damien Miller | 8668706 | 2014-07-02 15:28:02 +1000 | [diff] [blame] | 284 | #ifdef SSHKEY_INTERNAL |
markus@openbsd.org | 76c9fbb | 2015-12-04 16:41:28 +0000 | [diff] [blame] | 285 | int ssh_rsa_sign(const struct sshkey *key, |
| 286 | u_char **sigp, size_t *lenp, const u_char *data, size_t datalen, |
| 287 | const char *ident); |
Damien Miller | 8668706 | 2014-07-02 15:28:02 +1000 | [diff] [blame] | 288 | int ssh_rsa_verify(const struct sshkey *key, |
djm@openbsd.org | 04c7e28 | 2017-12-18 02:25:15 +0000 | [diff] [blame] | 289 | const u_char *sig, size_t siglen, const u_char *data, size_t datalen, |
| 290 | const char *alg); |
Damien Miller | 8668706 | 2014-07-02 15:28:02 +1000 | [diff] [blame] | 291 | int ssh_dss_sign(const struct sshkey *key, u_char **sigp, size_t *lenp, |
| 292 | const u_char *data, size_t datalen, u_int compat); |
| 293 | int ssh_dss_verify(const struct sshkey *key, |
| 294 | const u_char *signature, size_t signaturelen, |
| 295 | const u_char *data, size_t datalen, u_int compat); |
| 296 | int ssh_ecdsa_sign(const struct sshkey *key, u_char **sigp, size_t *lenp, |
| 297 | const u_char *data, size_t datalen, u_int compat); |
| 298 | int ssh_ecdsa_verify(const struct sshkey *key, |
| 299 | const u_char *signature, size_t signaturelen, |
| 300 | const u_char *data, size_t datalen, u_int compat); |
djm@openbsd.org | 02bb076 | 2019-10-31 21:15:14 +0000 | [diff] [blame] | 301 | int ssh_ecdsa_sk_verify(const struct sshkey *key, |
| 302 | const u_char *signature, size_t signaturelen, |
djm@openbsd.org | b7e74ea | 2019-11-25 00:51:37 +0000 | [diff] [blame] | 303 | const u_char *data, size_t datalen, u_int compat, |
| 304 | struct sshkey_sig_details **detailsp); |
Damien Miller | 8668706 | 2014-07-02 15:28:02 +1000 | [diff] [blame] | 305 | int ssh_ed25519_sign(const struct sshkey *key, u_char **sigp, size_t *lenp, |
| 306 | const u_char *data, size_t datalen, u_int compat); |
| 307 | int ssh_ed25519_verify(const struct sshkey *key, |
| 308 | const u_char *signature, size_t signaturelen, |
| 309 | const u_char *data, size_t datalen, u_int compat); |
markus@openbsd.org | 7c096c4 | 2019-11-12 19:29:24 +0000 | [diff] [blame] | 310 | int ssh_ed25519_sk_verify(const struct sshkey *key, |
| 311 | const u_char *signature, size_t signaturelen, |
djm@openbsd.org | b7e74ea | 2019-11-25 00:51:37 +0000 | [diff] [blame] | 312 | const u_char *data, size_t datalen, u_int compat, |
| 313 | struct sshkey_sig_details **detailsp); |
markus@openbsd.org | 1b11ea7 | 2018-02-23 15:58:37 +0000 | [diff] [blame] | 314 | int ssh_xmss_sign(const struct sshkey *key, u_char **sigp, size_t *lenp, |
| 315 | const u_char *data, size_t datalen, u_int compat); |
| 316 | int ssh_xmss_verify(const struct sshkey *key, |
| 317 | const u_char *signature, size_t signaturelen, |
| 318 | const u_char *data, size_t datalen, u_int compat); |
Damien Miller | 8668706 | 2014-07-02 15:28:02 +1000 | [diff] [blame] | 319 | #endif |
| 320 | |
Damien Miller | f093569 | 2014-08-20 11:06:50 +1000 | [diff] [blame] | 321 | #if !defined(WITH_OPENSSL) |
| 322 | # undef RSA |
| 323 | # undef DSA |
| 324 | # undef EC_KEY |
| 325 | # undef EC_GROUP |
| 326 | # undef EC_POINT |
| 327 | #elif !defined(OPENSSL_HAS_ECC) |
| 328 | # undef EC_KEY |
| 329 | # undef EC_GROUP |
| 330 | # undef EC_POINT |
| 331 | #endif |
Damien Miller | 8668706 | 2014-07-02 15:28:02 +1000 | [diff] [blame] | 332 | |
| 333 | #endif /* SSHKEY_H */ |