mirror of
https://github.com/samba-team/samba.git
synced 2024-12-25 23:21:54 +03:00
a800baece7
HEIMDAL kerberos offers already tracing via a logging facility through smb_krb5_init_context(). MIT kerberos offers to register a callback via krb5_set_trace_callback with which tracing information can be routed to a common logging facility. This is now integrated into smb_krb5_init_context_basic() offering the same functionality for both kerberos fragrances. Signed-off-by: Swen Schillig <swen@linux.ibm.com> Reviewed-by: Andrew Bartlett <abartlet@samba.org> Reviewed-by: Christof Schmitt <cs@samba.org>
412 lines
13 KiB
C
412 lines
13 KiB
C
/*
|
|
Unix SMB/CIFS implementation.
|
|
simple kerberos5 routines for active directory
|
|
Copyright (C) Andrew Tridgell 2001
|
|
Copyright (C) Luke Howard 2002-2003
|
|
Copyright (C) Andrew Bartlett <abartlet@samba.org> 2005
|
|
Copyright (C) Guenther Deschner 2005-2009
|
|
|
|
This program is free software; you can redistribute it and/or modify
|
|
it under the terms of the GNU General Public License as published by
|
|
the Free Software Foundation; either version 3 of the License, or
|
|
(at your option) any later version.
|
|
|
|
This program is distributed in the hope that it will be useful,
|
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
GNU General Public License for more details.
|
|
|
|
You should have received a copy of the GNU General Public License
|
|
along with this program. If not, see <http://www.gnu.org/licenses/>.
|
|
*/
|
|
|
|
#ifndef _KRB5_SAMBA_H
|
|
#define _KRB5_SAMBA_H
|
|
|
|
#ifdef HAVE_KRB5
|
|
|
|
#define KRB5_PRIVATE 1 /* this file uses PRIVATE interfaces! */
|
|
/* this file uses DEPRECATED interfaces! */
|
|
|
|
#ifdef KRB5_DEPRECATED
|
|
#undef KRB5_DEPRECATED
|
|
#endif
|
|
|
|
#if defined(HAVE_KRB5_DEPRECATED_WITH_IDENTIFIER)
|
|
#define KRB5_DEPRECATED 1
|
|
#else
|
|
#define KRB5_DEPRECATED
|
|
#endif
|
|
|
|
#include "system/kerberos.h"
|
|
#include "system/network.h"
|
|
|
|
#ifndef KRB5_ADDR_NETBIOS
|
|
#define KRB5_ADDR_NETBIOS 0x14
|
|
#endif
|
|
|
|
#ifndef KRB5KRB_ERR_RESPONSE_TOO_BIG
|
|
#define KRB5KRB_ERR_RESPONSE_TOO_BIG (-1765328332L)
|
|
#endif
|
|
|
|
/* Heimdal uses a slightly different name */
|
|
#if defined(HAVE_ENCTYPE_ARCFOUR_HMAC_MD5) && !defined(HAVE_ENCTYPE_ARCFOUR_HMAC)
|
|
#define ENCTYPE_ARCFOUR_HMAC ENCTYPE_ARCFOUR_HMAC_MD5
|
|
#endif
|
|
#if defined(HAVE_ENCTYPE_ARCFOUR_HMAC_MD5_56) && !defined(HAVE_ENCTYPE_ARCFOUR_HMAC_EXP)
|
|
#define ENCTYPE_ARCFOUR_HMAC_EXP ENCTYPE_ARCFOUR_HMAC_MD5_56
|
|
#endif
|
|
|
|
/* The older versions of heimdal that don't have this
|
|
define don't seem to use it anyway. I'm told they
|
|
always use a subkey */
|
|
#ifndef HAVE_AP_OPTS_USE_SUBKEY
|
|
#define AP_OPTS_USE_SUBKEY 0
|
|
#endif
|
|
|
|
#ifndef KRB5_PW_SALT
|
|
#define KRB5_PW_SALT 3
|
|
#endif
|
|
|
|
/* CKSUMTYPE_HMAC_MD5 in Heimdal
|
|
CKSUMTYPE_HMAC_MD5_ARCFOUR in MIT */
|
|
#if defined(CKSUMTYPE_HMAC_MD5_ARCFOUR) && !defined(CKSUMTYPE_HMAC_MD5)
|
|
#define CKSUMTYPE_HMAC_MD5 CKSUMTYPE_HMAC_MD5_ARCFOUR
|
|
#endif
|
|
|
|
/*
|
|
* CKSUMTYPE_HMAC_SHA1_96_AES_* in Heimdal
|
|
* CKSUMTYPE_HMAC_SHA1_96_AES* in MIT
|
|
*/
|
|
#if defined(CKSUMTYPE_HMAC_SHA1_96_AES128) && !defined(CKSUMTYPE_HMAC_SHA1_96_AES_128)
|
|
#define CKSUMTYPE_HMAC_SHA1_96_AES_128 CKSUMTYPE_HMAC_SHA1_96_AES128
|
|
#endif
|
|
#if defined(CKSUMTYPE_HMAC_SHA1_96_AES256) && !defined(CKSUMTYPE_HMAC_SHA1_96_AES_256)
|
|
#define CKSUMTYPE_HMAC_SHA1_96_AES_256 CKSUMTYPE_HMAC_SHA1_96_AES256
|
|
#endif
|
|
|
|
/*
|
|
* KRB5_KU_OTHER_ENCRYPTED in Heimdal
|
|
* KRB5_KEYUSAGE_APP_DATA_ENCRYPT in MIT
|
|
*/
|
|
#if defined(KRB5_KEYUSAGE_APP_DATA_ENCRYPT) && !defined(KRB5_KU_OTHER_ENCRYPTED)
|
|
#define KRB5_KU_OTHER_ENCRYPTED KRB5_KEYUSAGE_APP_DATA_ENCRYPT
|
|
#endif
|
|
|
|
typedef struct {
|
|
#if defined(HAVE_MAGIC_IN_KRB5_ADDRESS) && defined(HAVE_ADDRTYPE_IN_KRB5_ADDRESS) /* MIT */
|
|
krb5_address **addrs;
|
|
#elif defined(HAVE_KRB5_ADDRESSES) /* Heimdal */
|
|
krb5_addresses *addrs;
|
|
#else
|
|
#error UNKNOWN_KRB5_ADDRESS_TYPE
|
|
#endif /* defined(HAVE_MAGIC_IN_KRB5_ADDRESS) && defined(HAVE_ADDRTYPE_IN_KRB5_ADDRESS) */
|
|
} smb_krb5_addresses;
|
|
|
|
#ifdef HAVE_KRB5_KEYTAB_ENTRY_KEY /* MIT */
|
|
#define KRB5_KT_KEY(k) (&(k)->key)
|
|
#elif defined(HAVE_KRB5_KEYTAB_ENTRY_KEYBLOCK) /* Heimdal */
|
|
#define KRB5_KT_KEY(k) (&(k)->keyblock)
|
|
#else
|
|
#error krb5_keytab_entry has no key or keyblock member
|
|
#endif /* HAVE_KRB5_KEYTAB_ENTRY_KEY */
|
|
|
|
/* work around broken krb5.h on sles9 */
|
|
#ifdef SIZEOF_LONG
|
|
#undef SIZEOF_LONG
|
|
#endif
|
|
|
|
#ifdef HAVE_KRB5_KEYBLOCK_KEYVALUE /* Heimdal */
|
|
#define KRB5_KEY_TYPE(k) ((k)->keytype)
|
|
#define KRB5_KEY_LENGTH(k) ((k)->keyvalue.length)
|
|
#define KRB5_KEY_DATA(k) ((k)->keyvalue.data)
|
|
#define KRB5_KEY_DATA_CAST void
|
|
#else /* MIT */
|
|
#define KRB5_KEY_TYPE(k) ((k)->enctype)
|
|
#define KRB5_KEY_LENGTH(k) ((k)->length)
|
|
#define KRB5_KEY_DATA(k) ((k)->contents)
|
|
#define KRB5_KEY_DATA_CAST krb5_octet
|
|
#endif /* HAVE_KRB5_KEYBLOCK_KEYVALUE */
|
|
|
|
#ifdef HAVE_E_DATA_POINTER_IN_KRB5_ERROR /* Heimdal */
|
|
#define KRB5_ERROR_CODE(k) ((k)->error_code)
|
|
#else /* MIT */
|
|
#define KRB5_ERROR_CODE(k) ((k)->error)
|
|
#endif /* HAVE_E_DATA_POINTER_IN_KRB5_ERROR */
|
|
|
|
krb5_error_code smb_krb5_parse_name(krb5_context context,
|
|
const char *name, /* in unix charset */
|
|
krb5_principal *principal);
|
|
|
|
krb5_error_code smb_krb5_unparse_name(TALLOC_CTX *mem_ctx,
|
|
krb5_context context,
|
|
krb5_const_principal principal,
|
|
char **unix_name);
|
|
|
|
krb5_error_code smb_krb5_init_context_common(krb5_context *_krb5_context);
|
|
|
|
krb5_error_code krb5_set_default_tgs_ktypes(krb5_context ctx, const krb5_enctype *enc);
|
|
|
|
#if defined(HAVE_KRB5_AUTH_CON_SETKEY) && !defined(HAVE_KRB5_AUTH_CON_SETUSERUSERKEY)
|
|
krb5_error_code krb5_auth_con_setuseruserkey(krb5_context context, krb5_auth_context auth_context, krb5_keyblock *keyblock);
|
|
#endif
|
|
|
|
#ifndef HAVE_KRB5_FREE_UNPARSED_NAME
|
|
void krb5_free_unparsed_name(krb5_context ctx, char *val);
|
|
#endif
|
|
|
|
/* Stub out initialize_krb5_error_table since it is not present in all
|
|
* Kerberos implementations. If it's not present, it's not necessary to
|
|
* call it.
|
|
*/
|
|
#ifndef HAVE_INITIALIZE_KRB5_ERROR_TABLE
|
|
#define initialize_krb5_error_table()
|
|
#endif
|
|
|
|
/* Samba wrapper functions for krb5 functionality. */
|
|
bool smb_krb5_sockaddr_to_kaddr(struct sockaddr_storage *paddr,
|
|
krb5_address *pkaddr);
|
|
|
|
krb5_error_code smb_krb5_mk_error(krb5_context context,
|
|
krb5_error_code error_code,
|
|
const char *e_text,
|
|
krb5_data *e_data,
|
|
const krb5_principal client,
|
|
const krb5_principal server,
|
|
krb5_data *enc_err);
|
|
|
|
krb5_error_code smb_krb5_get_allowed_etypes(krb5_context context,
|
|
krb5_enctype **enctypes);
|
|
|
|
bool smb_krb5_get_smb_session_key(TALLOC_CTX *mem_ctx,
|
|
krb5_context context,
|
|
krb5_auth_context auth_context,
|
|
DATA_BLOB *session_key,
|
|
bool remote);
|
|
|
|
krb5_error_code smb_krb5_kt_free_entry(krb5_context context, krb5_keytab_entry *kt_entry);
|
|
void smb_krb5_free_data_contents(krb5_context context, krb5_data *pdata);
|
|
krb5_error_code smb_krb5_renew_ticket(const char *ccache_string, const char *client_string, const char *service_string, time_t *expire_time);
|
|
krb5_error_code smb_krb5_gen_netbios_krb5_address(smb_krb5_addresses **kerb_addr,
|
|
const char *netbios_name);
|
|
krb5_error_code smb_krb5_free_addresses(krb5_context context, smb_krb5_addresses *addr);
|
|
krb5_enctype smb_krb5_kt_get_enctype_from_entry(krb5_keytab_entry *kt_entry);
|
|
|
|
krb5_error_code smb_krb5_enctype_to_string(krb5_context context,
|
|
krb5_enctype enctype,
|
|
char **etype_s);
|
|
krb5_error_code smb_krb5_kt_open_relative(krb5_context context,
|
|
const char *keytab_name_req,
|
|
bool write_access,
|
|
krb5_keytab *keytab);
|
|
krb5_error_code smb_krb5_kt_open(krb5_context context,
|
|
const char *keytab_name,
|
|
bool write_access,
|
|
krb5_keytab *keytab);
|
|
krb5_error_code smb_krb5_kt_get_name(TALLOC_CTX *mem_ctx,
|
|
krb5_context context,
|
|
krb5_keytab keytab,
|
|
const char **keytab_name);
|
|
krb5_error_code smb_krb5_kt_seek_and_delete_old_entries(krb5_context context,
|
|
krb5_keytab keytab,
|
|
krb5_kvno kvno,
|
|
krb5_enctype enctype,
|
|
const char *princ_s,
|
|
krb5_principal princ,
|
|
bool flush,
|
|
bool keep_old_entries);
|
|
krb5_error_code smb_krb5_kt_add_entry(krb5_context context,
|
|
krb5_keytab keytab,
|
|
krb5_kvno kvno,
|
|
const char *princ_s,
|
|
const char *salt_principal,
|
|
krb5_enctype enctype,
|
|
krb5_data *password,
|
|
bool no_salt,
|
|
bool keep_old_entries);
|
|
|
|
krb5_error_code smb_krb5_get_credentials(krb5_context context,
|
|
krb5_ccache ccache,
|
|
krb5_principal me,
|
|
krb5_principal server,
|
|
krb5_principal impersonate_princ,
|
|
krb5_creds **out_creds);
|
|
krb5_error_code smb_krb5_keyblock_init_contents(krb5_context context,
|
|
krb5_enctype enctype,
|
|
const void *data,
|
|
size_t length,
|
|
krb5_keyblock *key);
|
|
krb5_error_code smb_krb5_kinit_keyblock_ccache(krb5_context ctx,
|
|
krb5_ccache cc,
|
|
krb5_principal principal,
|
|
krb5_keyblock *keyblock,
|
|
const char *target_service,
|
|
krb5_get_init_creds_opt *krb_options,
|
|
time_t *expire_time,
|
|
time_t *kdc_time);
|
|
krb5_error_code smb_krb5_kinit_password_ccache(krb5_context ctx,
|
|
krb5_ccache cc,
|
|
krb5_principal principal,
|
|
const char *password,
|
|
const char *target_service,
|
|
krb5_get_init_creds_opt *krb_options,
|
|
time_t *expire_time,
|
|
time_t *kdc_time);
|
|
#ifdef SAMBA4_USES_HEIMDAL
|
|
krb5_error_code smb_krb5_kinit_s4u2_ccache(krb5_context ctx,
|
|
krb5_ccache store_cc,
|
|
krb5_principal init_principal,
|
|
const char *init_password,
|
|
krb5_principal impersonate_principal,
|
|
const char *self_service,
|
|
const char *target_service,
|
|
krb5_get_init_creds_opt *krb_options,
|
|
time_t *expire_time,
|
|
time_t *kdc_time);
|
|
#endif
|
|
|
|
#if defined(HAVE_KRB5_MAKE_PRINCIPAL)
|
|
#define smb_krb5_make_principal krb5_make_principal
|
|
#elif defined(HAVE_KRB5_BUILD_PRINCIPAL_ALLOC_VA)
|
|
krb5_error_code smb_krb5_make_principal(krb5_context context,
|
|
krb5_principal *principal,
|
|
const char *realm, ...);
|
|
#else
|
|
#error krb5_make_principal not available
|
|
#endif
|
|
|
|
#if defined(HAVE_KRB5_CC_GET_LIFETIME)
|
|
#define smb_krb5_cc_get_lifetime krb5_cc_get_lifetime
|
|
#elif defined(HAVE_KRB5_CC_RETRIEVE_CRED)
|
|
krb5_error_code smb_krb5_cc_get_lifetime(krb5_context context,
|
|
krb5_ccache id,
|
|
time_t *t);
|
|
#else
|
|
#error krb5_cc_get_lifetime not available
|
|
#endif
|
|
|
|
#if defined(HAVE_KRB5_FREE_CHECKSUM_CONTENTS)
|
|
#define smb_krb5_free_checksum_contents krb5_free_checksum_contents
|
|
#elif defined (HAVE_FREE_CHECKSUM)
|
|
void smb_krb5_free_checksum_contents(krb5_context ctx, krb5_checksum *cksum);
|
|
#else
|
|
#error krb5_free_checksum_contents/free_Checksum is not vailable
|
|
#endif
|
|
|
|
krb5_error_code smb_krb5_make_pac_checksum(TALLOC_CTX *mem_ctx,
|
|
DATA_BLOB *pac_data,
|
|
krb5_context context,
|
|
const krb5_keyblock *keyblock,
|
|
uint32_t *sig_type,
|
|
DATA_BLOB *sig_blob);
|
|
|
|
char *smb_krb5_principal_get_realm(TALLOC_CTX *mem_ctx,
|
|
krb5_context context,
|
|
krb5_const_principal principal);
|
|
|
|
void smb_krb5_principal_set_type(krb5_context context,
|
|
krb5_principal principal,
|
|
int type);
|
|
|
|
krb5_error_code smb_krb5_principal_set_realm(krb5_context context,
|
|
krb5_principal principal,
|
|
const char *realm);
|
|
|
|
char *smb_krb5_get_realm_from_hostname(TALLOC_CTX *mem_ctx,
|
|
const char *hostname,
|
|
const char *client_realm);
|
|
|
|
char *smb_get_krb5_error_message(krb5_context context,
|
|
krb5_error_code code,
|
|
TALLOC_CTX *mem_ctx);
|
|
|
|
krb5_error_code kt_copy(krb5_context context,
|
|
const char *from,
|
|
const char *to);
|
|
krb5_error_code kt_copy_one_principal(krb5_context context,
|
|
const char *from,
|
|
const char *to,
|
|
const char *principal,
|
|
krb5_kvno kvno,
|
|
const krb5_enctype *enctypes);
|
|
|
|
#if defined(HAVE_KRB5_KT_COMPARE)
|
|
#define smb_krb5_kt_compare krb5_kt_compare
|
|
#else
|
|
krb5_boolean smb_krb5_kt_compare(krb5_context context,
|
|
krb5_keytab_entry *entry,
|
|
krb5_const_principal principal,
|
|
krb5_kvno vno,
|
|
krb5_enctype enctype);
|
|
#endif
|
|
|
|
const krb5_enctype *samba_all_enctypes(void);
|
|
|
|
uint32_t kerberos_enctype_to_bitmap(krb5_enctype enc_type_enum);
|
|
krb5_enctype ms_suptype_to_ietf_enctype(uint32_t enctype_bitmap);
|
|
krb5_error_code ms_suptypes_to_ietf_enctypes(TALLOC_CTX *mem_ctx,
|
|
uint32_t enctype_bitmap,
|
|
krb5_enctype **enctypes);
|
|
int smb_krb5_get_pw_salt(krb5_context context,
|
|
krb5_const_principal host_princ,
|
|
krb5_data *psalt);
|
|
int smb_krb5_salt_principal(const char *realm,
|
|
const char *sAMAccountName,
|
|
const char *userPrincipalName,
|
|
uint32_t uac_flags,
|
|
TALLOC_CTX *mem_ctx,
|
|
char **_salt_principal);
|
|
int smb_krb5_salt_principal2data(krb5_context context,
|
|
const char *salt_principal,
|
|
TALLOC_CTX *mem_ctx,
|
|
char **_salt_data);
|
|
|
|
int smb_krb5_create_key_from_string(krb5_context context,
|
|
krb5_const_principal host_princ,
|
|
krb5_data *salt,
|
|
krb5_data *password,
|
|
krb5_enctype enctype,
|
|
krb5_keyblock *key);
|
|
|
|
krb5_boolean smb_krb5_get_allowed_weak_crypto(krb5_context context);
|
|
|
|
#ifndef krb5_princ_size
|
|
#if defined(HAVE_KRB5_PRINCIPAL_GET_NUM_COMP)
|
|
#define krb5_princ_size krb5_principal_get_num_comp
|
|
#else
|
|
#error krb5_princ_size unavailable
|
|
#endif
|
|
#endif
|
|
|
|
char *smb_krb5_principal_get_comp_string(TALLOC_CTX *mem_ctx,
|
|
krb5_context context,
|
|
krb5_const_principal principal,
|
|
unsigned int component);
|
|
|
|
krb5_error_code smb_krb5_copy_data_contents(krb5_data *p,
|
|
const void *data,
|
|
size_t len);
|
|
|
|
int smb_krb5_principal_get_type(krb5_context context,
|
|
krb5_const_principal principal);
|
|
|
|
#if !defined(HAVE_KRB5_WARNX)
|
|
krb5_error_code krb5_warnx(krb5_context context, const char *fmt, ...);
|
|
#endif
|
|
|
|
krb5_error_code smb_krb5_cc_copy_creds(krb5_context context,
|
|
krb5_ccache incc, krb5_ccache outcc);
|
|
|
|
#endif /* HAVE_KRB5 */
|
|
|
|
int ads_krb5_cli_get_ticket(TALLOC_CTX *mem_ctx,
|
|
const char *principal,
|
|
time_t time_offset,
|
|
DATA_BLOB *ticket,
|
|
DATA_BLOB *session_key_krb5,
|
|
uint32_t extra_ap_opts, const char *ccname,
|
|
time_t *tgs_expire,
|
|
const char *impersonate_princ_s);
|
|
|
|
#endif /* _KRB5_SAMBA_H */
|