2013-12-07 00:24:01 +00:00
|
|
|
/* $OpenBSD: key.h,v 1.40 2013/12/06 13:39:49 markus Exp $ */
|
2001-01-29 07:39:26 +00:00
|
|
|
|
2000-09-16 02:29:08 +00:00
|
|
|
/*
|
2001-07-04 03:32:30 +00:00
|
|
|
* Copyright (c) 2000, 2001 Markus Friedl. All rights reserved.
|
2000-09-16 02:29:08 +00:00
|
|
|
*
|
|
|
|
* Redistribution and use in source and binary forms, with or without
|
|
|
|
* modification, are permitted provided that the following conditions
|
|
|
|
* are met:
|
|
|
|
* 1. Redistributions of source code must retain the above copyright
|
|
|
|
* notice, this list of conditions and the following disclaimer.
|
|
|
|
* 2. Redistributions in binary form must reproduce the above copyright
|
|
|
|
* notice, this list of conditions and the following disclaimer in the
|
|
|
|
* documentation and/or other materials provided with the distribution.
|
|
|
|
*
|
|
|
|
* THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
|
|
|
|
* IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
|
|
|
|
* OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
|
|
|
|
* IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
|
|
|
|
* INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
|
|
|
|
* NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
|
|
|
|
* DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
|
|
|
|
* THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
|
|
|
|
* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
|
|
|
|
* THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
|
|
|
*/
|
2000-03-26 03:04:51 +00:00
|
|
|
#ifndef KEY_H
|
|
|
|
#define KEY_H
|
|
|
|
|
2010-02-26 20:55:05 +00:00
|
|
|
#include "buffer.h"
|
2001-01-22 05:34:40 +00:00
|
|
|
#include <openssl/rsa.h>
|
|
|
|
#include <openssl/dsa.h>
|
2010-09-10 01:39:26 +00:00
|
|
|
#ifdef OPENSSL_HAS_ECC
|
2010-08-31 12:41:14 +00:00
|
|
|
#include <openssl/ec.h>
|
2010-09-10 01:39:26 +00:00
|
|
|
#endif
|
2001-01-22 05:34:40 +00:00
|
|
|
|
2000-03-26 03:04:51 +00:00
|
|
|
typedef struct Key Key;
|
|
|
|
enum types {
|
2000-11-13 11:57:25 +00:00
|
|
|
KEY_RSA1,
|
2000-03-26 03:04:51 +00:00
|
|
|
KEY_RSA,
|
|
|
|
KEY_DSA,
|
2010-08-31 12:41:14 +00:00
|
|
|
KEY_ECDSA,
|
2013-12-07 00:24:01 +00:00
|
|
|
KEY_ED25519,
|
2010-02-26 20:55:05 +00:00
|
|
|
KEY_RSA_CERT,
|
|
|
|
KEY_DSA_CERT,
|
2010-08-31 12:41:14 +00:00
|
|
|
KEY_ECDSA_CERT,
|
2013-12-07 00:24:01 +00:00
|
|
|
KEY_ED25519_CERT,
|
2010-04-16 05:56:21 +00:00
|
|
|
KEY_RSA_CERT_V00,
|
|
|
|
KEY_DSA_CERT_V00,
|
2000-11-13 11:57:25 +00:00
|
|
|
KEY_UNSPEC
|
2000-03-26 03:04:51 +00:00
|
|
|
};
|
2001-03-11 20:03:44 +00:00
|
|
|
enum fp_type {
|
|
|
|
SSH_FP_SHA1,
|
2012-06-20 11:51:11 +00:00
|
|
|
SSH_FP_MD5,
|
|
|
|
SSH_FP_SHA256
|
2001-03-11 20:03:44 +00:00
|
|
|
};
|
|
|
|
enum fp_rep {
|
|
|
|
SSH_FP_HEX,
|
- grunk@cvs.openbsd.org 2008/06/11 21:01:35
[ssh_config.5 key.h readconf.c readconf.h ssh-keygen.1 ssh-keygen.c key.c
sshconnect.c]
Introduce SSH Fingerprint ASCII Visualization, a technique inspired by the
graphical hash visualization schemes known as "random art", and by
Dan Kaminsky's musings on the subject during a BlackOp talk at the
23C3 in Berlin.
Scientific publication (original paper):
"Hash Visualization: a New Technique to improve Real-World Security",
Perrig A. and Song D., 1999, International Workshop on Cryptographic
Techniques and E-Commerce (CrypTEC '99)
http://sparrow.ece.cmu.edu/~adrian/projects/validation/validation.pdf
The algorithm used here is a worm crawling over a discrete plane,
leaving a trace (augmenting the field) everywhere it goes.
Movement is taken from dgst_raw 2bit-wise. Bumping into walls
makes the respective movement vector be ignored for this turn,
thus switching to the other color of the chessboard.
Graphs are not unambiguous for now, because circles in graphs can be
walked in either direction.
discussions with several people,
help, corrections and ok markus@ djm@
2008-06-12 18:40:35 +00:00
|
|
|
SSH_FP_BUBBLEBABBLE,
|
|
|
|
SSH_FP_RANDOMART
|
2001-03-11 20:03:44 +00:00
|
|
|
};
|
2001-07-04 04:52:03 +00:00
|
|
|
|
|
|
|
/* key is stored in external hardware */
|
|
|
|
#define KEY_FLAG_EXT 0x0001
|
|
|
|
|
2010-02-26 20:55:05 +00:00
|
|
|
#define CERT_MAX_PRINCIPALS 256
|
|
|
|
struct KeyCert {
|
|
|
|
Buffer certblob; /* Kept around for use on wire */
|
|
|
|
u_int type; /* SSH2_CERT_TYPE_USER or SSH2_CERT_TYPE_HOST */
|
2010-04-16 05:56:21 +00:00
|
|
|
u_int64_t serial;
|
2010-02-26 20:55:05 +00:00
|
|
|
char *key_id;
|
|
|
|
u_int nprincipals;
|
|
|
|
char **principals;
|
|
|
|
u_int64_t valid_after, valid_before;
|
2010-04-16 05:56:21 +00:00
|
|
|
Buffer critical;
|
|
|
|
Buffer extensions;
|
2010-02-26 20:55:05 +00:00
|
|
|
Key *signature_key;
|
|
|
|
};
|
|
|
|
|
2000-03-26 03:04:51 +00:00
|
|
|
struct Key {
|
2001-07-04 04:52:03 +00:00
|
|
|
int type;
|
|
|
|
int flags;
|
2000-03-26 03:04:51 +00:00
|
|
|
RSA *rsa;
|
|
|
|
DSA *dsa;
|
2010-08-31 12:41:14 +00:00
|
|
|
int ecdsa_nid; /* NID of curve */
|
2010-09-10 01:39:26 +00:00
|
|
|
#ifdef OPENSSL_HAS_ECC
|
2010-08-31 12:41:14 +00:00
|
|
|
EC_KEY *ecdsa;
|
2010-09-10 01:39:26 +00:00
|
|
|
#else
|
|
|
|
void *ecdsa;
|
|
|
|
#endif
|
2010-02-26 20:55:05 +00:00
|
|
|
struct KeyCert *cert;
|
2013-12-07 00:24:01 +00:00
|
|
|
u_char *ed25519_sk;
|
|
|
|
u_char *ed25519_pk;
|
2000-03-26 03:04:51 +00:00
|
|
|
};
|
|
|
|
|
2013-12-07 00:24:01 +00:00
|
|
|
#define ED25519_SK_SZ crypto_sign_ed25519_SECRETKEYBYTES
|
|
|
|
#define ED25519_PK_SZ crypto_sign_ed25519_PUBLICKEYBYTES
|
|
|
|
|
2003-11-17 10:18:23 +00:00
|
|
|
Key *key_new(int);
|
2010-02-26 20:55:05 +00:00
|
|
|
void key_add_private(Key *);
|
2003-11-17 10:18:23 +00:00
|
|
|
Key *key_new_private(int);
|
|
|
|
void key_free(Key *);
|
|
|
|
Key *key_demote(const Key *);
|
2010-02-26 20:55:05 +00:00
|
|
|
int key_equal_public(const Key *, const Key *);
|
2003-11-17 10:18:23 +00:00
|
|
|
int key_equal(const Key *, const Key *);
|
2013-06-01 21:41:51 +00:00
|
|
|
char *key_fingerprint(const Key *, enum fp_type, enum fp_rep);
|
2013-01-18 00:44:04 +00:00
|
|
|
u_char *key_fingerprint_raw(const Key *, enum fp_type, u_int *);
|
2003-11-17 10:18:23 +00:00
|
|
|
const char *key_type(const Key *);
|
2010-03-21 18:58:24 +00:00
|
|
|
const char *key_cert_type(const Key *);
|
2003-11-17 10:18:23 +00:00
|
|
|
int key_write(const Key *, FILE *);
|
|
|
|
int key_read(Key *, char **);
|
|
|
|
u_int key_size(const Key *);
|
2000-11-13 11:57:25 +00:00
|
|
|
|
2001-07-04 04:02:36 +00:00
|
|
|
Key *key_generate(int, u_int);
|
2003-11-17 10:18:23 +00:00
|
|
|
Key *key_from_private(const Key *);
|
2001-07-04 04:46:56 +00:00
|
|
|
int key_type_from_name(char *);
|
2010-02-26 20:55:05 +00:00
|
|
|
int key_is_cert(const Key *);
|
2013-10-30 11:19:47 +00:00
|
|
|
int key_type_is_cert(int);
|
2010-02-26 20:55:05 +00:00
|
|
|
int key_type_plain(int);
|
2010-04-16 05:56:21 +00:00
|
|
|
int key_to_certified(Key *, int);
|
2010-02-26 20:55:05 +00:00
|
|
|
int key_drop_cert(Key *);
|
|
|
|
int key_certify(Key *, Key *);
|
|
|
|
void key_cert_copy(const Key *, struct Key *);
|
|
|
|
int key_cert_check_authority(const Key *, int, int, const char *,
|
|
|
|
const char **);
|
2013-01-18 00:44:04 +00:00
|
|
|
int key_cert_is_legacy(const Key *);
|
2000-11-13 11:57:25 +00:00
|
|
|
|
2010-08-31 12:41:14 +00:00
|
|
|
int key_ecdsa_nid_from_name(const char *);
|
|
|
|
int key_curve_name_to_nid(const char *);
|
2013-04-23 09:24:32 +00:00
|
|
|
const char *key_curve_nid_to_name(int);
|
2010-09-10 01:23:34 +00:00
|
|
|
u_int key_curve_nid_to_bits(int);
|
2010-08-31 12:41:14 +00:00
|
|
|
int key_ecdsa_bits_to_nid(int);
|
2010-09-10 01:39:26 +00:00
|
|
|
#ifdef OPENSSL_HAS_ECC
|
2010-11-04 23:19:49 +00:00
|
|
|
int key_ecdsa_key_to_nid(EC_KEY *);
|
2013-04-23 09:24:32 +00:00
|
|
|
const EVP_MD *key_ec_nid_to_evpmd(int nid);
|
2010-08-31 12:41:14 +00:00
|
|
|
int key_ec_validate_public(const EC_GROUP *, const EC_POINT *);
|
|
|
|
int key_ec_validate_private(const EC_KEY *);
|
2010-09-10 01:39:26 +00:00
|
|
|
#endif
|
2013-12-07 00:24:01 +00:00
|
|
|
char *key_alg_list(int, int);
|
2010-08-31 12:41:14 +00:00
|
|
|
|
2003-11-17 10:18:23 +00:00
|
|
|
Key *key_from_blob(const u_char *, u_int);
|
|
|
|
int key_to_blob(const Key *, u_char **, u_int *);
|
|
|
|
const char *key_ssh_name(const Key *);
|
2010-08-31 12:41:14 +00:00
|
|
|
const char *key_ssh_name_plain(const Key *);
|
2003-11-17 10:18:23 +00:00
|
|
|
int key_names_valid2(const char *);
|
2000-11-13 11:57:25 +00:00
|
|
|
|
2003-11-17 10:18:23 +00:00
|
|
|
int key_sign(const Key *, u_char **, u_int *, const u_char *, u_int);
|
|
|
|
int key_verify(const Key *, const u_char *, u_int, const u_char *, u_int);
|
2000-03-26 03:04:51 +00:00
|
|
|
|
2003-11-17 10:18:23 +00:00
|
|
|
int ssh_dss_sign(const Key *, u_char **, u_int *, const u_char *, u_int);
|
|
|
|
int ssh_dss_verify(const Key *, const u_char *, u_int, const u_char *, u_int);
|
2010-08-31 12:41:14 +00:00
|
|
|
int ssh_ecdsa_sign(const Key *, u_char **, u_int *, const u_char *, u_int);
|
|
|
|
int ssh_ecdsa_verify(const Key *, const u_char *, u_int, const u_char *, u_int);
|
2003-11-17 10:18:23 +00:00
|
|
|
int ssh_rsa_sign(const Key *, u_char **, u_int *, const u_char *, u_int);
|
|
|
|
int ssh_rsa_verify(const Key *, const u_char *, u_int, const u_char *, u_int);
|
2013-12-07 00:24:01 +00:00
|
|
|
int ssh_ed25519_sign(const Key *, u_char **, u_int *, const u_char *, u_int);
|
|
|
|
int ssh_ed25519_verify(const Key *, const u_char *, u_int, const u_char *, u_int);
|
2003-02-24 01:01:40 +00:00
|
|
|
|
2010-09-10 01:39:26 +00:00
|
|
|
#if defined(OPENSSL_HAS_ECC) && (defined(DEBUG_KEXECDH) || defined(DEBUG_PK))
|
2010-08-31 12:41:14 +00:00
|
|
|
void key_dump_ec_point(const EC_GROUP *, const EC_POINT *);
|
|
|
|
void key_dump_ec_key(const EC_KEY *);
|
|
|
|
#endif
|
|
|
|
|
2013-12-06 23:40:26 +00:00
|
|
|
void key_private_serialize(const Key *, Buffer *);
|
|
|
|
Key *key_private_deserialize(Buffer *);
|
|
|
|
|
2000-03-26 03:04:51 +00:00
|
|
|
#endif
|