source4/auth/kerberos/kerberos.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
   7    This program is free software; you can redistribute it and/or modify
   8    it under the terms of the GNU General Public License as published by
   9    the Free Software Foundation; either version 2 of the License, or
  10    (at your option) any later version.
  11
  12    This program is distributed in the hope that it will be useful,
  13    but WITHOUT ANY WARRANTY; without even the implied warranty of
  14    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  15    GNU General Public License for more details.
  16
  17    You should have received a copy of the GNU General Public License
  18    along with this program; if not, write to the Free Software
  19    Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  20 */
  21
  22 #if defined(HAVE_KRB5)
  23
  24 struct smb_krb5_context {
  25         krb5_context krb5_context;
  26         krb5_log_facility *logf;
  27 };
  28
  29
  30 /* not really ASN.1, but RFC 1964 */
  31 #define TOK_ID_KRB_AP_REQ       "\x01\x00"
  32 #define TOK_ID_KRB_AP_REP       "\x02\x00"
  33 #define TOK_ID_KRB_ERROR        "\x03\x00"
  34 #define TOK_ID_GSS_GETMIC       "\x01\x01"
  35 #define TOK_ID_GSS_WRAP         "\x02\x01"
  36
  37 #ifdef HAVE_KRB5_KEYBLOCK_KEYVALUE
  38 #define KRB5_KEY_TYPE(k)        ((k)->keytype)
  39 #define KRB5_KEY_LENGTH(k)      ((k)->keyvalue.length)
  40 #define KRB5_KEY_DATA(k)        ((k)->keyvalue.data)
  41 #else
  42 #define KRB5_KEY_TYPE(k)        ((k)->enctype)
  43 #define KRB5_KEY_LENGTH(k)      ((k)->length)
  44 #define KRB5_KEY_DATA(k)        ((k)->contents)
  45 #endif /* HAVE_KRB5_KEYBLOCK_KEYVALUE */
  46
  47 #ifndef HAVE_KRB5_SET_REAL_TIME
  48 krb5_error_code krb5_set_real_time(krb5_context context, int32_t seconds, int32_t microseconds);
  49 #endif
  50
  51 #ifndef HAVE_KRB5_SET_DEFAULT_TGS_KTYPES
  52 krb5_error_code krb5_set_default_tgs_ktypes(krb5_context ctx, const krb5_enctype *enc);
  53 #endif
  54
  55 #if defined(HAVE_KRB5_AUTH_CON_SETKEY) && !defined(HAVE_KRB5_AUTH_CON_SETUSERUSERKEY)
  56 krb5_error_code krb5_auth_con_setuseruserkey(krb5_context context, krb5_auth_context auth_context, krb5_keyblock *keyblock);
  57 #endif
  58
  59 #ifndef HAVE_KRB5_FREE_UNPARSED_NAME
  60 void krb5_free_unparsed_name(krb5_context ctx, char *val);
  61 #endif
  62
  63 #if defined(HAVE_KRB5_PRINCIPAL_GET_COMP_STRING) && !defined(HAVE_KRB5_PRINC_COMPONENT)
  64 const krb5_data *krb5_princ_component(krb5_context context, krb5_principal principal, int i );
  65 #endif
  66
  67 /* Samba wrapper function for krb5 functionality. */
  68 void setup_kaddr( krb5_address *pkaddr, struct sockaddr *paddr);
  69 int create_kerberos_key_from_string(krb5_context context, krb5_principal host_princ, krb5_data *password, krb5_keyblock *key, krb5_enctype enctype);
  70 int create_kerberos_key_from_string_direct(krb5_context context, krb5_principal host_princ, krb5_data *password, krb5_keyblock *key, krb5_enctype enctype);
  71 krb5_const_principal get_principal_from_tkt(krb5_ticket *tkt);
  72 krb5_error_code krb5_locate_kdc(krb5_context ctx, const krb5_data *realm, struct sockaddr **addr_pp, int *naddrs, int get_masters);
  73 krb5_error_code get_kerberos_allowed_etypes(krb5_context context, krb5_enctype **enctypes);
  74 void free_kerberos_etypes(krb5_context context, krb5_enctype *enctypes);
  75 BOOL get_krb5_smb_session_key(krb5_context context, krb5_auth_context auth_context, DATA_BLOB *session_key, BOOL remote);
  76 krb5_error_code ads_krb5_mk_req(krb5_context context,
  77                                 krb5_auth_context *auth_context,
  78                                 const krb5_flags ap_req_options,
  79                                 const char *principal,
  80                                 krb5_ccache ccache,
  81                                 krb5_data *outbuf);
  82 DATA_BLOB get_auth_data_from_tkt(TALLOC_CTX *mem_ctx,
  83                                  krb5_ticket *tkt);
  84
  85 NTSTATUS ads_verify_ticket(TALLOC_CTX *mem_ctx,
  86                            krb5_context context,
  87                            krb5_auth_context auth_context,
  88                            const char *realm, const char *service,
  89                            const DATA_BLOB *ticket,
  90                            char **principal, DATA_BLOB *auth_data,
  91                            DATA_BLOB *ap_rep,
  92                            krb5_keyblock *keyblock);
  93 int kerberos_kinit_password_cc(krb5_context ctx, krb5_ccache cc,
  94                                const char *principal, const char *password,
  95                                time_t *expire_time, time_t *kdc_time);
  96 krb5_principal kerberos_fetch_salt_princ_for_host_princ(krb5_context context,
  97                                                         krb5_principal host_princ,
  98                                                         int enctype);
  99 void kerberos_set_creds_enctype(krb5_creds *pcreds, int enctype);
 100 BOOL kerberos_compatible_enctypes(krb5_context context, krb5_enctype enctype1, krb5_enctype enctype2);
 101 void kerberos_free_data_contents(krb5_context context, krb5_data *pdata);
 102 krb5_error_code smb_krb5_kt_free_entry(krb5_context context, krb5_keytab_entry *kt_entry);
 103 char *smb_get_krb5_error_message(krb5_context context, krb5_error_code code, TALLOC_CTX *mem_ctx);
 104 NTSTATUS kinit_to_ccache(TALLOC_CTX *parent_ctx,
 105                           struct cli_credentials *credentials,
 106                           struct smb_krb5_context *smb_krb5_context,
 107                           krb5_ccache *ccache,
 108                           const char **ccache_name);
 109 krb5_error_code smb_krb5_init_context(TALLOC_CTX *parent_ctx,
 110                                       struct smb_krb5_context **smb_krb5_context);
 111 #endif /* HAVE_KRB5 */
 112