gss_krb5.h 9.1 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263
  1. /*
  2. * linux/include/linux/sunrpc/gss_krb5_types.h
  3. *
  4. * Adapted from MIT Kerberos 5-1.2.1 lib/include/krb5.h,
  5. * lib/gssapi/krb5/gssapiP_krb5.h, and others
  6. *
  7. * Copyright (c) 2000-2008 The Regents of the University of Michigan.
  8. * All rights reserved.
  9. *
  10. * Andy Adamson <andros@umich.edu>
  11. * Bruce Fields <bfields@umich.edu>
  12. */
  13. /*
  14. * Copyright 1995 by the Massachusetts Institute of Technology.
  15. * All Rights Reserved.
  16. *
  17. * Export of this software from the United States of America may
  18. * require a specific license from the United States Government.
  19. * It is the responsibility of any person or organization contemplating
  20. * export to obtain such a license before exporting.
  21. *
  22. * WITHIN THAT CONSTRAINT, permission to use, copy, modify, and
  23. * distribute this software and its documentation for any purpose and
  24. * without fee is hereby granted, provided that the above copyright
  25. * notice appear in all copies and that both that copyright notice and
  26. * this permission notice appear in supporting documentation, and that
  27. * the name of M.I.T. not be used in advertising or publicity pertaining
  28. * to distribution of the software without specific, written prior
  29. * permission. Furthermore if you modify this software you must label
  30. * your software as modified software and not distribute it in such a
  31. * fashion that it might be confused with the original M.I.T. software.
  32. * M.I.T. makes no representations about the suitability of
  33. * this software for any purpose. It is provided "as is" without express
  34. * or implied warranty.
  35. *
  36. */
  37. #include <linux/crypto.h>
  38. #include <linux/sunrpc/auth_gss.h>
  39. #include <linux/sunrpc/gss_err.h>
  40. #include <linux/sunrpc/gss_asn1.h>
  41. /* Length of constant used in key derivation */
  42. #define GSS_KRB5_K5CLENGTH (5)
  43. /* Maximum key length (in bytes) for the supported crypto algorithms*/
  44. #define GSS_KRB5_MAX_KEYLEN (32)
  45. /* Maximum checksum function output for the supported crypto algorithms */
  46. #define GSS_KRB5_MAX_CKSUM_LEN (20)
  47. /* Maximum blocksize for the supported crypto algorithms */
  48. #define GSS_KRB5_MAX_BLOCKSIZE (16)
  49. struct gss_krb5_enctype {
  50. const u32 etype; /* encryption (key) type */
  51. const u32 ctype; /* checksum type */
  52. const char *name; /* "friendly" name */
  53. const char *encrypt_name; /* crypto encrypt name */
  54. const char *cksum_name; /* crypto checksum name */
  55. const u16 signalg; /* signing algorithm */
  56. const u16 sealalg; /* sealing algorithm */
  57. const u32 blocksize; /* encryption blocksize */
  58. const u32 cksumlength; /* checksum length */
  59. const u32 keyed_cksum; /* is it a keyed cksum? */
  60. const u32 keybytes; /* raw key len, in bytes */
  61. const u32 keylength; /* final key len, in bytes */
  62. u32 (*encrypt) (struct crypto_blkcipher *tfm,
  63. void *iv, void *in, void *out,
  64. int length); /* encryption function */
  65. u32 (*decrypt) (struct crypto_blkcipher *tfm,
  66. void *iv, void *in, void *out,
  67. int length); /* decryption function */
  68. u32 (*mk_key) (const struct gss_krb5_enctype *gk5e,
  69. struct xdr_netobj *in,
  70. struct xdr_netobj *out); /* complete key generation */
  71. };
  72. /* krb5_ctx flags definitions */
  73. #define KRB5_CTX_FLAG_INITIATOR 0x00000001
  74. #define KRB5_CTX_FLAG_CFX 0x00000002
  75. #define KRB5_CTX_FLAG_ACCEPTOR_SUBKEY 0x00000004
  76. struct krb5_ctx {
  77. int initiate; /* 1 = initiating, 0 = accepting */
  78. u32 enctype;
  79. u32 flags;
  80. const struct gss_krb5_enctype *gk5e; /* enctype-specific info */
  81. struct crypto_blkcipher *enc;
  82. struct crypto_blkcipher *seq;
  83. struct crypto_blkcipher *acceptor_enc;
  84. struct crypto_blkcipher *initiator_enc;
  85. u8 cksum[GSS_KRB5_MAX_KEYLEN];
  86. s32 endtime;
  87. u32 seq_send;
  88. u64 seq_send64;
  89. struct xdr_netobj mech_used;
  90. u8 initiator_sign[GSS_KRB5_MAX_KEYLEN];
  91. u8 acceptor_sign[GSS_KRB5_MAX_KEYLEN];
  92. u8 initiator_seal[GSS_KRB5_MAX_KEYLEN];
  93. u8 acceptor_seal[GSS_KRB5_MAX_KEYLEN];
  94. u8 initiator_integ[GSS_KRB5_MAX_KEYLEN];
  95. u8 acceptor_integ[GSS_KRB5_MAX_KEYLEN];
  96. };
  97. extern spinlock_t krb5_seq_lock;
  98. /* The length of the Kerberos GSS token header */
  99. #define GSS_KRB5_TOK_HDR_LEN (16)
  100. #define KG_TOK_MIC_MSG 0x0101
  101. #define KG_TOK_WRAP_MSG 0x0201
  102. enum sgn_alg {
  103. SGN_ALG_DES_MAC_MD5 = 0x0000,
  104. SGN_ALG_MD2_5 = 0x0001,
  105. SGN_ALG_DES_MAC = 0x0002,
  106. SGN_ALG_3 = 0x0003, /* not published */
  107. SGN_ALG_HMAC_MD5 = 0x0011, /* microsoft w2k; no support */
  108. SGN_ALG_HMAC_SHA1_DES3_KD = 0x0004
  109. };
  110. enum seal_alg {
  111. SEAL_ALG_NONE = 0xffff,
  112. SEAL_ALG_DES = 0x0000,
  113. SEAL_ALG_1 = 0x0001, /* not published */
  114. SEAL_ALG_MICROSOFT_RC4 = 0x0010,/* microsoft w2k; no support */
  115. SEAL_ALG_DES3KD = 0x0002
  116. };
  117. #define CKSUMTYPE_CRC32 0x0001
  118. #define CKSUMTYPE_RSA_MD4 0x0002
  119. #define CKSUMTYPE_RSA_MD4_DES 0x0003
  120. #define CKSUMTYPE_DESCBC 0x0004
  121. #define CKSUMTYPE_RSA_MD5 0x0007
  122. #define CKSUMTYPE_RSA_MD5_DES 0x0008
  123. #define CKSUMTYPE_NIST_SHA 0x0009
  124. #define CKSUMTYPE_HMAC_SHA1_DES3 0x000c
  125. /* from gssapi_err_krb5.h */
  126. #define KG_CCACHE_NOMATCH (39756032L)
  127. #define KG_KEYTAB_NOMATCH (39756033L)
  128. #define KG_TGT_MISSING (39756034L)
  129. #define KG_NO_SUBKEY (39756035L)
  130. #define KG_CONTEXT_ESTABLISHED (39756036L)
  131. #define KG_BAD_SIGN_TYPE (39756037L)
  132. #define KG_BAD_LENGTH (39756038L)
  133. #define KG_CTX_INCOMPLETE (39756039L)
  134. #define KG_CONTEXT (39756040L)
  135. #define KG_CRED (39756041L)
  136. #define KG_ENC_DESC (39756042L)
  137. #define KG_BAD_SEQ (39756043L)
  138. #define KG_EMPTY_CCACHE (39756044L)
  139. #define KG_NO_CTYPES (39756045L)
  140. /* per Kerberos v5 protocol spec crypto types from the wire.
  141. * these get mapped to linux kernel crypto routines.
  142. */
  143. #define ENCTYPE_NULL 0x0000
  144. #define ENCTYPE_DES_CBC_CRC 0x0001 /* DES cbc mode with CRC-32 */
  145. #define ENCTYPE_DES_CBC_MD4 0x0002 /* DES cbc mode with RSA-MD4 */
  146. #define ENCTYPE_DES_CBC_MD5 0x0003 /* DES cbc mode with RSA-MD5 */
  147. #define ENCTYPE_DES_CBC_RAW 0x0004 /* DES cbc mode raw */
  148. /* XXX deprecated? */
  149. #define ENCTYPE_DES3_CBC_SHA 0x0005 /* DES-3 cbc mode with NIST-SHA */
  150. #define ENCTYPE_DES3_CBC_RAW 0x0006 /* DES-3 cbc mode raw */
  151. #define ENCTYPE_DES_HMAC_SHA1 0x0008
  152. #define ENCTYPE_DES3_CBC_SHA1 0x0010
  153. #define ENCTYPE_AES128_CTS_HMAC_SHA1_96 0x0011
  154. #define ENCTYPE_AES256_CTS_HMAC_SHA1_96 0x0012
  155. #define ENCTYPE_ARCFOUR_HMAC 0x0017
  156. #define ENCTYPE_ARCFOUR_HMAC_EXP 0x0018
  157. #define ENCTYPE_UNKNOWN 0x01ff
  158. /*
  159. * Constants used for key derivation
  160. */
  161. /* for 3DES */
  162. #define KG_USAGE_SEAL (22)
  163. #define KG_USAGE_SIGN (23)
  164. #define KG_USAGE_SEQ (24)
  165. /* from rfc3961 */
  166. #define KEY_USAGE_SEED_CHECKSUM (0x99)
  167. #define KEY_USAGE_SEED_ENCRYPTION (0xAA)
  168. #define KEY_USAGE_SEED_INTEGRITY (0x55)
  169. /* from rfc4121 */
  170. #define KG_USAGE_ACCEPTOR_SEAL (22)
  171. #define KG_USAGE_ACCEPTOR_SIGN (23)
  172. #define KG_USAGE_INITIATOR_SEAL (24)
  173. #define KG_USAGE_INITIATOR_SIGN (25)
  174. /*
  175. * This compile-time check verifies that we will not exceed the
  176. * slack space allotted by the client and server auth_gss code
  177. * before they call gss_wrap().
  178. */
  179. #define GSS_KRB5_MAX_SLACK_NEEDED \
  180. (GSS_KRB5_TOK_HDR_LEN /* gss token header */ \
  181. + GSS_KRB5_MAX_CKSUM_LEN /* gss token checksum */ \
  182. + GSS_KRB5_MAX_BLOCKSIZE /* confounder */ \
  183. + GSS_KRB5_MAX_BLOCKSIZE /* possible padding */ \
  184. + GSS_KRB5_TOK_HDR_LEN /* encrypted hdr in v2 token */\
  185. + GSS_KRB5_MAX_CKSUM_LEN /* encryption hmac */ \
  186. + 4 + 4 /* RPC verifier */ \
  187. + GSS_KRB5_TOK_HDR_LEN \
  188. + GSS_KRB5_MAX_CKSUM_LEN)
  189. u32
  190. make_checksum(struct krb5_ctx *kctx, char *header, int hdrlen,
  191. struct xdr_buf *body, int body_offset, u8 *cksumkey,
  192. struct xdr_netobj *cksumout);
  193. u32 gss_get_mic_kerberos(struct gss_ctx *, struct xdr_buf *,
  194. struct xdr_netobj *);
  195. u32 gss_verify_mic_kerberos(struct gss_ctx *, struct xdr_buf *,
  196. struct xdr_netobj *);
  197. u32
  198. gss_wrap_kerberos(struct gss_ctx *ctx_id, int offset,
  199. struct xdr_buf *outbuf, struct page **pages);
  200. u32
  201. gss_unwrap_kerberos(struct gss_ctx *ctx_id, int offset,
  202. struct xdr_buf *buf);
  203. u32
  204. krb5_encrypt(struct crypto_blkcipher *key,
  205. void *iv, void *in, void *out, int length);
  206. u32
  207. krb5_decrypt(struct crypto_blkcipher *key,
  208. void *iv, void *in, void *out, int length);
  209. int
  210. gss_encrypt_xdr_buf(struct crypto_blkcipher *tfm, struct xdr_buf *outbuf,
  211. int offset, struct page **pages);
  212. int
  213. gss_decrypt_xdr_buf(struct crypto_blkcipher *tfm, struct xdr_buf *inbuf,
  214. int offset);
  215. s32
  216. krb5_make_seq_num(struct crypto_blkcipher *key,
  217. int direction,
  218. u32 seqnum, unsigned char *cksum, unsigned char *buf);
  219. s32
  220. krb5_get_seq_num(struct crypto_blkcipher *key,
  221. unsigned char *cksum,
  222. unsigned char *buf, int *direction, u32 *seqnum);
  223. int
  224. xdr_extend_head(struct xdr_buf *buf, unsigned int base, unsigned int shiftlen);
  225. u32
  226. krb5_derive_key(const struct gss_krb5_enctype *gk5e,
  227. const struct xdr_netobj *inkey,
  228. struct xdr_netobj *outkey,
  229. const struct xdr_netobj *in_constant);