src/libstrongswan/plugins/sshkey/sshkey_builder.h

   1 /*
   2  * Copyright (C) 2013-2014 Tobias Brunner
   3  *
   4  * Copyright (C) secunet Security Networks AG
   5  *
   6  * This program is free software; you can redistribute it and/or modify it
   7  * under the terms of the GNU General Public License as published by the
   8  * Free Software Foundation; either version 2 of the License, or (at your
   9  * option) any later version.  See <http://www.fsf.org/copyleft/gpl.txt>.
  10  *
  11  * This program is distributed in the hope that it will be useful, but
  12  * WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
  13  * or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
  14  * for more details.
  15  */
  16
  17 /**
  18  * @defgroup sshkey_public_key sshkey_public_key
  19  * @{ @ingroup sshkey_p
  20  */
  21
  22 #ifndef SSHKEY_BUILDER_H_
  23 #define SSHKEY_BUILDER_H_
  24
  25 #include <credentials/builder.h>
  26 #include <credentials/keys/public_key.h>
  27
  28 typedef struct sshkey_public_key_t sshkey_public_key_t;
  29
  30 /**
  31  * Public key implementation supporting RFC 4253/RFC 5656 decoding.
  32  */
  33 struct sshkey_public_key_t {
  34
  35         /**
  36          * Implements public_key_t interface.
  37          */
  38         public_key_t interface;
  39 };
  40
  41 /**
  42  * Load a public key in RFC 4253 format.
  43  *
  44  * Takes a BUILD_BLOB_SSHKEY to parse the public key.
  45  *
  46  * @param type          type of the key, must be KEY_ANY
  47  * @param args          builder_part_t argument list
  48  * @return                      built key, NULL on failure
  49  */
  50 sshkey_public_key_t *sshkey_public_key_load(key_type_t type, va_list args);
  51
  52 /**
  53  * Load a public key in RFC 4253 format as certificate.
  54  *
  55  * Takes a BUILD_FROM_FILE and BUILD_SUBJECT argument.
  56  *
  57  * @param type          type of the certificate, must be CERT_TRUSTED_PUBKEY
  58  * @param args          builder_part_t argument list
  59  * @return                      built certificate, NULL on failure
  60  */
  61 certificate_t *sshkey_certificate_load(certificate_type_t type, va_list args);
  62
  63 #endif /** SSHKEY_BUILDER_H_ @}*/