1 /* -*- mode: c; c-basic-offset: 4; indent-tabs-mode: nil -*- */ 2 /* lib/krb5/krb/fast.h */ 3 /* 4 * Copyright (C) 2009 by the Massachusetts Institute of Technology. 5 * All rights reserved. 6 * 7 * Export of this software from the United States of America may 8 * require a specific license from the United States Government. 9 * It is the responsibility of any person or organization contemplating 10 * export to obtain such a license before exporting. 11 * 12 * WITHIN THAT CONSTRAINT, permission to use, copy, modify, and 13 * distribute this software and its documentation for any purpose and 14 * without fee is hereby granted, provided that the above copyright 15 * notice appear in all copies and that both that copyright notice and 16 * this permission notice appear in supporting documentation, and that 17 * the name of M.I.T. not be used in advertising or publicity pertaining 18 * to distribution of the software without specific, written prior 19 * permission. Furthermore if you modify this software you must label 20 * your software as modified software and not distribute it in such a 21 * fashion that it might be confused with the original M.I.T. software. 22 * M.I.T. makes no representations about the suitability of 23 * this software for any purpose. It is provided "as is" without express 24 * or implied warranty. 25 */ 26 27 #ifndef KRB_FAST_H 28 29 #define KRB_FAST_H 30 31 #include <k5-int.h> 32 33 struct krb5int_fast_request_state { 34 krb5_kdc_req fast_outer_request; 35 krb5_keyblock *armor_key; /*non-null means fast is in use*/ 36 krb5_fast_armor *armor; 37 krb5_ui_4 fast_state_flags; 38 krb5_ui_4 fast_options; 39 krb5_int32 nonce; 40 }; 41 42 #define KRB5INT_FAST_DO_FAST (1l<<0) /* Perform FAST */ 43 #define KRB5INT_FAST_ARMOR_AVAIL (1l<<1) 44 45 krb5_error_code 46 krb5int_fast_prep_req_body(krb5_context context, 47 struct krb5int_fast_request_state *state, 48 krb5_kdc_req *request, 49 krb5_data **encoded_req_body); 50 51 typedef krb5_error_code (*kdc_req_encoder_proc)(const krb5_kdc_req *, 52 krb5_data **); 53 54 krb5_error_code 55 krb5int_fast_prep_req(krb5_context context, 56 struct krb5int_fast_request_state *state, 57 krb5_kdc_req *request, 58 const krb5_data *to_be_checksummed, 59 kdc_req_encoder_proc encoder, 60 krb5_data **encoded_request); 61 62 krb5_error_code 63 krb5int_fast_process_error(krb5_context context, 64 struct krb5int_fast_request_state *state, 65 krb5_error **err_replyptr, 66 krb5_pa_data ***out_padata, 67 krb5_boolean *retry); 68 69 krb5_error_code 70 krb5int_fast_process_response(krb5_context context, 71 struct krb5int_fast_request_state *state, 72 krb5_kdc_rep *resp, 73 krb5_keyblock **strengthen_key); 74 75 krb5_error_code 76 krb5int_fast_make_state(krb5_context context, 77 struct krb5int_fast_request_state **state); 78 79 void 80 krb5int_fast_free_state(krb5_context context, 81 struct krb5int_fast_request_state *state); 82 83 krb5_error_code 84 krb5int_fast_as_armor(krb5_context context, 85 struct krb5int_fast_request_state *state, 86 krb5_get_init_creds_opt *opt, krb5_kdc_req *request); 87 88 krb5_error_code 89 krb5int_fast_reply_key(krb5_context context, 90 const krb5_keyblock *strengthen_key, 91 const krb5_keyblock *existing_key, krb5_keyblock *output_key); 92 93 94 krb5_error_code 95 krb5int_fast_verify_nego(krb5_context context, 96 struct krb5int_fast_request_state *state, 97 krb5_kdc_rep *rep, krb5_data *request, 98 krb5_keyblock *decrypting_key, 99 krb5_boolean *fast_avail); 100 101 krb5_boolean 102 k5_upgrade_to_fast_p(krb5_context context, 103 struct krb5int_fast_request_state *state, 104 krb5_pa_data **padata); 105 106 krb5_error_code 107 krb5int_fast_tgs_armor(krb5_context context, 108 struct krb5int_fast_request_state *state, 109 krb5_keyblock *subkey, 110 krb5_keyblock *session_key, 111 krb5_ccache ccache, 112 krb5_data *target_realm); 113 114 #endif 115