crypto/openssh/key.h

   1 /* $OpenBSD: key.h,v 1.42 2014/06/24 01:13:21 djm 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 "sshkey.h"
  30
  31 typedef struct sshkey Key;
  32
  33 #define types sshkey_types
  34 #define fp_type sshkey_fp_type
  35 #define fp_rep sshkey_fp_rep
  36
  37 #ifndef SSH_KEY_NO_DEFINE
  38 #define key_new                 sshkey_new
  39 #define key_free                sshkey_free
  40 #define key_equal_public        sshkey_equal_public
  41 #define key_equal               sshkey_equal
  42 #define key_fingerprint         sshkey_fingerprint
  43 #define key_type                sshkey_type
  44 #define key_cert_type           sshkey_cert_type
  45 #define key_ssh_name            sshkey_ssh_name
  46 #define key_ssh_name_plain      sshkey_ssh_name_plain
  47 #define key_type_from_name      sshkey_type_from_name
  48 #define key_ecdsa_nid_from_name sshkey_ecdsa_nid_from_name
  49 #define key_type_is_cert        sshkey_type_is_cert
  50 #define key_size                sshkey_size
  51 #define key_ecdsa_bits_to_nid   sshkey_ecdsa_bits_to_nid
  52 #define key_ecdsa_key_to_nid    sshkey_ecdsa_key_to_nid
  53 #define key_names_valid2        sshkey_names_valid2
  54 #define key_is_cert             sshkey_is_cert
  55 #define key_type_plain          sshkey_type_plain
  56 #define key_cert_is_legacy      sshkey_cert_is_legacy
  57 #define key_curve_name_to_nid   sshkey_curve_name_to_nid
  58 #define key_curve_nid_to_bits   sshkey_curve_nid_to_bits
  59 #define key_curve_nid_to_name   sshkey_curve_nid_to_name
  60 #define key_ec_nid_to_hash_alg  sshkey_ec_nid_to_hash_alg
  61 #define key_dump_ec_point       sshkey_dump_ec_point
  62 #define key_dump_ec_key         sshkey_dump_ec_key
  63 #define key_fingerprint         sshkey_fingerprint
  64 #endif
  65
  66 void     key_add_private(Key *);
  67 Key     *key_new_private(int);
  68 void     key_free(Key *);
  69 Key     *key_demote(const Key *);
  70 u_char  *key_fingerprint_raw(const Key *, enum fp_type, u_int *);
  71 int      key_write(const Key *, FILE *);
  72 int      key_read(Key *, char **);
  73
  74 Key     *key_generate(int, u_int);
  75 Key     *key_from_private(const Key *);
  76 int      key_to_certified(Key *, int);
  77 int      key_drop_cert(Key *);
  78 int      key_certify(Key *, Key *);
  79 void     key_cert_copy(const Key *, Key *);
  80 int      key_cert_check_authority(const Key *, int, int, const char *,
  81             const char **);
  82 char    *key_alg_list(int, int);
  83
  84 #if defined(WITH_OPENSSL) && defined(OPENSSL_HAS_ECC)
  85 int      key_ec_validate_public(const EC_GROUP *, const EC_POINT *);
  86 int      key_ec_validate_private(const EC_KEY *);
  87 #endif /* defined(WITH_OPENSSL) && defined(OPENSSL_HAS_ECC) */
  88
  89 Key     *key_from_blob(const u_char *, u_int);
  90 int      key_to_blob(const Key *, u_char **, u_int *);
  91
  92 int      key_sign(const Key *, u_char **, u_int *, const u_char *, u_int);
  93 int      key_verify(const Key *, const u_char *, u_int, const u_char *, u_int);
  94
  95 void     key_private_serialize(const Key *, struct sshbuf *);
  96 Key     *key_private_deserialize(struct sshbuf *);
  97
  98 /* authfile.c */
  99 int      key_save_private(Key *, const char *, const char *, const char *,
 100     int, const char *, int);
 101 int      key_load_file(int, const char *, struct sshbuf *);
 102 Key     *key_load_cert(const char *);
 103 Key     *key_load_public(const char *, char **);
 104 Key     *key_load_private(const char *, const char *, char **);
 105 Key     *key_load_private_cert(int, const char *, const char *, int *);
 106 Key     *key_load_private_type(int, const char *, const char *, char **, int *);
 107 Key     *key_load_private_pem(int, int, const char *, char **);
 108 int      key_perm_ok(int, const char *);
 109 int      key_in_file(Key *, const char *, int);
 110
 111 #endif