include/crypto/public_key.h

   1 /* Asymmetric public-key algorithm definitions
   2  *
   3  * See Documentation/crypto/asymmetric-keys.txt
   4  *
   5  * Copyright (C) 2012 Red Hat, Inc. All Rights Reserved.
   6  * Written by David Howells (dhowells@redhat.com)
   7  *
   8  * This program is free software; you can redistribute it and/or
   9  * modify it under the terms of the GNU General Public Licence
  10  * as published by the Free Software Foundation; either version
  11  * 2 of the Licence, or (at your option) any later version.
  12  */
  13
  14 #ifndef _LINUX_PUBLIC_KEY_H
  15 #define _LINUX_PUBLIC_KEY_H
  16
  17 #include <linux/mpi.h>
  18
  19 enum pkey_algo {
  20         PKEY_ALGO_DSA,
  21         PKEY_ALGO_RSA,
  22         PKEY_ALGO__LAST
  23 };
  24
  25 extern const char *const pkey_algo_name[PKEY_ALGO__LAST];
  26 extern const struct public_key_algorithm *pkey_algo[PKEY_ALGO__LAST];
  27
  28 enum pkey_hash_algo {
  29         PKEY_HASH_MD4,
  30         PKEY_HASH_MD5,
  31         PKEY_HASH_SHA1,
  32         PKEY_HASH_RIPE_MD_160,
  33         PKEY_HASH_SHA256,
  34         PKEY_HASH_SHA384,
  35         PKEY_HASH_SHA512,
  36         PKEY_HASH_SHA224,
  37         PKEY_HASH__LAST
  38 };
  39
  40 extern const char *const pkey_hash_algo_name[PKEY_HASH__LAST];
  41
  42 enum pkey_id_type {
  43         PKEY_ID_PGP,            /* OpenPGP generated key ID */
  44         PKEY_ID_X509,           /* X.509 arbitrary subjectKeyIdentifier */
  45         PKEY_ID_TYPE__LAST
  46 };
  47
  48 extern const char *const pkey_id_type_name[PKEY_ID_TYPE__LAST];
  49
  50 /*
  51  * Cryptographic data for the public-key subtype of the asymmetric key type.
  52  *
  53  * Note that this may include private part of the key as well as the public
  54  * part.
  55  */
  56 struct public_key {
  57         const struct public_key_algorithm *algo;
  58         u8      capabilities;
  59 #define PKEY_CAN_ENCRYPT        0x01
  60 #define PKEY_CAN_DECRYPT        0x02
  61 #define PKEY_CAN_SIGN           0x04
  62 #define PKEY_CAN_VERIFY         0x08
  63         enum pkey_id_type id_type : 8;
  64         union {
  65                 MPI     mpi[5];
  66                 struct {
  67                         MPI     p;      /* DSA prime */
  68                         MPI     q;      /* DSA group order */
  69                         MPI     g;      /* DSA group generator */
  70                         MPI     y;      /* DSA public-key value = g^x mod p */
  71                         MPI     x;      /* DSA secret exponent (if present) */
  72                 } dsa;
  73                 struct {
  74                         MPI     n;      /* RSA public modulus */
  75                         MPI     e;      /* RSA public encryption exponent */
  76                         MPI     d;      /* RSA secret encryption exponent (if present) */
  77                         MPI     p;      /* RSA secret prime (if present) */
  78                         MPI     q;      /* RSA secret prime (if present) */
  79                 } rsa;
  80         };
  81 };
  82
  83 extern void public_key_destroy(void *payload);
  84
  85 /*
  86  * Public key cryptography signature data
  87  */
  88 struct public_key_signature {
  89         u8 *digest;
  90         u8 digest_size;                 /* Number of bytes in digest */
  91         u8 nr_mpi;                      /* Occupancy of mpi[] */
  92         enum pkey_hash_algo pkey_hash_algo : 8;
  93         union {
  94                 MPI mpi[2];
  95                 struct {
  96                         MPI s;          /* m^d mod n */
  97                 } rsa;
  98                 struct {
  99                         MPI r;
 100                         MPI s;
 101                 } dsa;
 102         };
 103 };
 104
 105 struct key;
 106 extern int verify_signature(const struct key *key,
 107                             const struct public_key_signature *sig);
 108
 109 #endif /* _LINUX_PUBLIC_KEY_H */