source3/include/krb5_protos.h

   1 /*
   2    Unix SMB/CIFS implementation.
   3    simple kerberos5 routines for active directory
   4    Copyright (C) Andrew Tridgell 2001
   5    Copyright (C) Luke Howard 2002-2003
   6    Copyright (C) Andrew Bartlett <abartlet@samba.org> 2005
   7    Copyright (C) Guenther Deschner 2005-2009
   8
   9    This program is free software; you can redistribute it and/or modify
  10    it under the terms of the GNU General Public License as published by
  11    the Free Software Foundation; either version 3 of the License, or
  12    (at your option) any later version.
  13
  14    This program is distributed in the hope that it will be useful,
  15    but WITHOUT ANY WARRANTY; without even the implied warranty of
  16    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  17    GNU General Public License for more details.
  18
  19    You should have received a copy of the GNU General Public License
  20    along with this program.  If not, see <http://www.gnu.org/licenses/>.
  21 */
  22
  23 #ifndef _INCLUDE_KRB5_PROTOS_H_
  24 #define _INCLUDE_KRB5_PROTOS_H_
  25
  26 struct PAC_DATA;
  27 struct PAC_SIGNATURE_DATA;
  28
  29 /* work around broken krb5.h on sles9 */
  30 #ifdef SIZEOF_LONG
  31 #undef SIZEOF_LONG
  32 #endif
  33
  34
  35 #if defined(HAVE_KRB5)
  36 krb5_error_code smb_krb5_parse_name(krb5_context context,
  37                                 const char *name, /* in unix charset */
  38                                 krb5_principal *principal);
  39
  40 krb5_error_code smb_krb5_unparse_name(TALLOC_CTX *mem_ctx,
  41                                       krb5_context context,
  42                                       krb5_const_principal principal,
  43                                       char **unix_name);
  44
  45 #ifndef HAVE_KRB5_SET_REAL_TIME
  46 krb5_error_code krb5_set_real_time(krb5_context context, int32_t seconds, int32_t microseconds);
  47 #endif
  48
  49 krb5_error_code krb5_set_default_tgs_ktypes(krb5_context ctx, const krb5_enctype *enc);
  50
  51 #if defined(HAVE_KRB5_AUTH_CON_SETKEY) && !defined(HAVE_KRB5_AUTH_CON_SETUSERUSERKEY)
  52 krb5_error_code krb5_auth_con_setuseruserkey(krb5_context context, krb5_auth_context auth_context, krb5_keyblock *keyblock);
  53 #endif
  54
  55 #ifndef HAVE_KRB5_FREE_UNPARSED_NAME
  56 void krb5_free_unparsed_name(krb5_context ctx, char *val);
  57 #endif
  58
  59 /* Stub out initialize_krb5_error_table since it is not present in all
  60  * Kerberos implementations. If it's not present, it's not necessary to
  61  * call it.
  62  */
  63 #ifndef HAVE_INITIALIZE_KRB5_ERROR_TABLE
  64 #define initialize_krb5_error_table()
  65 #endif
  66
  67 /* The following definitions come from libsmb/clikrb5.c  */
  68
  69 /* Samba wrapper function for krb5 functionality. */
  70 bool setup_kaddr( krb5_address *pkaddr, struct sockaddr_storage *paddr);
  71 int create_kerberos_key_from_string(krb5_context context, krb5_principal host_princ, krb5_data *password, krb5_keyblock *key, krb5_enctype enctype, bool no_salt);
  72 bool get_auth_data_from_tkt(TALLOC_CTX *mem_ctx, DATA_BLOB *auth_data, krb5_ticket *tkt);
  73 krb5_const_principal get_principal_from_tkt(krb5_ticket *tkt);
  74 krb5_error_code smb_krb5_locate_kdc(krb5_context ctx, const krb5_data *realm, struct sockaddr **addr_pp, int *naddrs, int get_masters);
  75 #if defined(HAVE_KRB5_LOCATE_KDC)
  76 krb5_error_code krb5_locate_kdc(krb5_context ctx, const krb5_data *realm, struct sockaddr **addr_pp, int *naddrs, int get_masters);
  77 #endif
  78 krb5_error_code get_kerberos_allowed_etypes(krb5_context context, krb5_enctype **enctypes);
  79 bool get_krb5_smb_session_key(TALLOC_CTX *mem_ctx,
  80                               krb5_context context,
  81                               krb5_auth_context auth_context,
  82                               DATA_BLOB *session_key, bool remote);
  83 krb5_error_code smb_krb5_kt_free_entry(krb5_context context, krb5_keytab_entry *kt_entry);
  84 krb5_principal kerberos_fetch_salt_princ_for_host_princ(krb5_context context, krb5_principal host_princ, int enctype);
  85 void kerberos_set_creds_enctype(krb5_creds *pcreds, int enctype);
  86 bool kerberos_compatible_enctypes(krb5_context context, krb5_enctype enctype1, krb5_enctype enctype2);
  87 void kerberos_free_data_contents(krb5_context context, krb5_data *pdata);
  88 NTSTATUS decode_pac_data(TALLOC_CTX *mem_ctx,
  89                          DATA_BLOB *pac_data_blob,
  90                          krb5_context context,
  91                          krb5_keyblock *service_keyblock,
  92                          krb5_const_principal client_principal,
  93                          time_t tgs_authtime,
  94                          struct PAC_DATA **pac_data_out);
  95 void smb_krb5_checksum_from_pac_sig(krb5_checksum *cksum,
  96                                     struct PAC_SIGNATURE_DATA *sig);
  97 krb5_error_code smb_krb5_verify_checksum(krb5_context context,
  98                                          const krb5_keyblock *keyblock,
  99                                          krb5_keyusage usage,
 100                                          krb5_checksum *cksum,
 101                                          uint8 *data,
 102                                          size_t length);
 103 time_t get_authtime_from_tkt(krb5_ticket *tkt);
 104 krb5_error_code smb_krb5_get_keyinfo_from_ap_req(krb5_context context,
 105                                                  const krb5_data *inbuf,
 106                                                  krb5_kvno *kvno,
 107                                                  krb5_enctype *enctype);
 108 krb5_error_code krb5_rd_req_return_keyblock_from_keytab(krb5_context context,
 109                                                         krb5_auth_context *auth_context,
 110                                                         const krb5_data *inbuf,
 111                                                         krb5_const_principal server,
 112                                                         krb5_keytab keytab,
 113                                                         krb5_flags *ap_req_options,
 114                                                         krb5_ticket **ticket,
 115                                                         krb5_keyblock **keyblock);
 116 krb5_error_code smb_krb5_parse_name_norealm(krb5_context context,
 117                                             const char *name,
 118                                             krb5_principal *principal);
 119 bool smb_krb5_principal_compare_any_realm(krb5_context context,
 120                                           krb5_const_principal princ1,
 121                                           krb5_const_principal princ2);
 122 krb5_error_code smb_krb5_renew_ticket(const char *ccache_string, const char *client_string, const char *service_string, time_t *expire_time);
 123 krb5_error_code kpasswd_err_to_krb5_err(krb5_error_code res_code);
 124 krb5_error_code smb_krb5_gen_netbios_krb5_address(smb_krb5_addresses **kerb_addr);
 125 krb5_error_code smb_krb5_free_addresses(krb5_context context, smb_krb5_addresses *addr);
 126 NTSTATUS krb5_to_nt_status(krb5_error_code kerberos_error);
 127 krb5_error_code nt_status_to_krb5(NTSTATUS nt_status);
 128 void smb_krb5_free_error(krb5_context context, krb5_error *krberror);
 129 krb5_error_code handle_krberror_packet(krb5_context context,
 130                                          krb5_data *packet);
 131
 132 void smb_krb5_get_init_creds_opt_free(krb5_context context,
 133                                     krb5_get_init_creds_opt *opt);
 134 krb5_error_code smb_krb5_get_init_creds_opt_alloc(krb5_context context,
 135                                     krb5_get_init_creds_opt **opt);
 136 krb5_error_code smb_krb5_mk_error(krb5_context context,
 137                                         krb5_error_code error_code,
 138                                         const krb5_principal server,
 139                                         krb5_data *reply);
 140 krb5_enctype smb_get_enctype_from_kt_entry(krb5_keytab_entry *kt_entry);
 141 krb5_error_code smb_krb5_enctype_to_string(krb5_context context,
 142                                             krb5_enctype enctype,
 143                                             char **etype_s);
 144 krb5_error_code smb_krb5_open_keytab(krb5_context context,
 145                                       const char *keytab_name,
 146                                       bool write_access,
 147                                       krb5_keytab *keytab);
 148 krb5_error_code smb_krb5_keytab_name(TALLOC_CTX *mem_ctx,
 149                                      krb5_context context,
 150                                      krb5_keytab keytab,
 151                                      const char **keytab_name);
 152 krb5_error_code smb_krb5_get_credentials(krb5_context context,
 153                                          krb5_ccache ccache,
 154                                          krb5_principal me,
 155                                          krb5_principal server,
 156                                          krb5_principal impersonate_princ,
 157                                          krb5_creds **out_creds);
 158 krb5_error_code smb_krb5_get_creds(const char *server_s,
 159                                    time_t time_offset,
 160                                    const char *cc,
 161                                    const char *impersonate_princ_s,
 162                                    krb5_creds **creds_p);
 163 char *smb_krb5_principal_get_realm(krb5_context context,
 164                                    krb5_principal principal);
 165
 166
 167 #endif /* HAVE_KRB5 */
 168
 169 int cli_krb5_get_ticket(TALLOC_CTX *mem_ctx,
 170                         const char *principal, time_t time_offset,
 171                         DATA_BLOB *ticket, DATA_BLOB *session_key_krb5,
 172                         uint32_t extra_ap_opts, const char *ccname,
 173                         time_t *tgs_expire,
 174                         const char *impersonate_princ_s);
 175
 176 bool unwrap_edata_ntstatus(TALLOC_CTX *mem_ctx,
 177                            DATA_BLOB *edata,
 178                            DATA_BLOB *edata_out);
 179 bool unwrap_pac(TALLOC_CTX *mem_ctx, DATA_BLOB *auth_data, DATA_BLOB *unwrapped_pac_data);
 180
 181 #endif /* _INCLUDE_KRB5_PROTOS_H_ */