1 /* $OpenBSD: key.h,v 1.27 2008/06/11 21:01:35 grunk Exp $ */
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 KEY_H
27 #define KEY_H
28 
29 #include <openssl/rsa.h>
30 #include <openssl/dsa.h>
31 
32 typedef struct Key Key;
33 enum types {
34 	KEY_RSA1,
35 	KEY_RSA,
36 	KEY_DSA,
37 	KEY_UNSPEC
38 };
39 enum fp_type {
40 	SSH_FP_SHA1,
41 	SSH_FP_MD5
42 };
43 enum fp_rep {
44 	SSH_FP_HEX,
45 	SSH_FP_BUBBLEBABBLE,
46 	SSH_FP_RANDOMART
47 };
48 
49 /* key is stored in external hardware */
50 #define KEY_FLAG_EXT		0x0001
51 
52 struct Key {
53 	int	 type;
54 	int	 flags;
55 	RSA	*rsa;
56 	DSA	*dsa;
57 };
58 
59 Key		*key_new(int);
60 Key		*key_new_private(int);
61 void		 key_free(Key *);
62 Key		*key_demote(const Key *);
63 int		 key_equal(const Key *, const Key *);
64 char		*key_fingerprint(const Key *, enum fp_type, enum fp_rep);
65 u_char		*key_fingerprint_raw(const Key *, enum fp_type, u_int *);
66 const char	*key_type(const Key *);
67 int		 key_write(const Key *, FILE *);
68 int		 key_read(Key *, char **);
69 u_int		 key_size(const Key *);
70 
71 Key	*key_generate(int, u_int);
72 Key	*key_from_private(const Key *);
73 int	 key_type_from_name(char *);
74 
75 Key		*key_from_blob(const u_char *, u_int);
76 int		 key_to_blob(const Key *, u_char **, u_int *);
77 const char	*key_ssh_name(const Key *);
78 int		 key_names_valid2(const char *);
79 
80 int	 key_sign(const Key *, u_char **, u_int *, const u_char *, u_int);
81 int	 key_verify(const Key *, const u_char *, u_int, const u_char *, u_int);
82 
83 int	 ssh_dss_sign(const Key *, u_char **, u_int *, const u_char *, u_int);
84 int	 ssh_dss_verify(const Key *, const u_char *, u_int, const u_char *, u_int);
85 int	 ssh_rsa_sign(const Key *, u_char **, u_int *, const u_char *, u_int);
86 int	 ssh_rsa_verify(const Key *, const u_char *, u_int, const u_char *, u_int);
87 
88 #endif
89