jpayne@69: /* -*- mode: c; c-basic-offset: 4; indent-tabs-mode: nil -*- */ jpayne@69: /* jpayne@69: * Copyright 1990, 1991, 2016 by the Massachusetts Institute of Technology. jpayne@69: * All Rights Reserved. jpayne@69: * jpayne@69: * Export of this software from the United States of America may jpayne@69: * require a specific license from the United States Government. jpayne@69: * It is the responsibility of any person or organization contemplating jpayne@69: * export to obtain such a license before exporting. jpayne@69: * jpayne@69: * WITHIN THAT CONSTRAINT, permission to use, copy, modify, and jpayne@69: * distribute this software and its documentation for any purpose and jpayne@69: * without fee is hereby granted, provided that the above copyright jpayne@69: * notice appear in all copies and that both that copyright notice and jpayne@69: * this permission notice appear in supporting documentation, and that jpayne@69: * the name of M.I.T. not be used in advertising or publicity pertaining jpayne@69: * to distribution of the software without specific, written prior jpayne@69: * permission. Furthermore if you modify this software you must label jpayne@69: * your software as modified software and not distribute it in such a jpayne@69: * fashion that it might be confused with the original M.I.T. software. jpayne@69: * M.I.T. makes no representations about the suitability of jpayne@69: * this software for any purpose. It is provided "as is" without express jpayne@69: * or implied warranty. jpayne@69: */ jpayne@69: /* jpayne@69: * Copyright (C) 1998 by the FundsXpress, INC. jpayne@69: * jpayne@69: * All rights reserved. jpayne@69: * jpayne@69: * Export of this software from the United States of America may require jpayne@69: * a specific license from the United States Government. It is the jpayne@69: * responsibility of any person or organization contemplating export to jpayne@69: * obtain such a license before exporting. jpayne@69: * jpayne@69: * WITHIN THAT CONSTRAINT, permission to use, copy, modify, and jpayne@69: * distribute this software and its documentation for any purpose and jpayne@69: * without fee is hereby granted, provided that the above copyright jpayne@69: * notice appear in all copies and that both that copyright notice and jpayne@69: * this permission notice appear in supporting documentation, and that jpayne@69: * the name of FundsXpress. not be used in advertising or publicity pertaining jpayne@69: * to distribution of the software without specific, written prior jpayne@69: * permission. FundsXpress makes no representations about the suitability of jpayne@69: * this software for any purpose. It is provided "as is" without express jpayne@69: * or implied warranty. jpayne@69: * jpayne@69: * THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR jpayne@69: * IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED jpayne@69: * WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE. jpayne@69: */ jpayne@69: /* jpayne@69: * Copyright 2009 Sun Microsystems, Inc. All rights reserved. jpayne@69: * Use is subject to license terms. jpayne@69: */ jpayne@69: jpayne@69: /* KDC Database interface definitions */ jpayne@69: jpayne@69: /* This API is not considered as stable as the main krb5 API. jpayne@69: * jpayne@69: * - We may make arbitrary incompatible changes between feature jpayne@69: * releases (e.g. from 1.7 to 1.8). jpayne@69: * - We will make some effort to avoid making incompatible changes for jpayne@69: * bugfix releases, but will make them if necessary. jpayne@69: */ jpayne@69: jpayne@69: #ifndef KRB5_KDB5__ jpayne@69: #define KRB5_KDB5__ jpayne@69: jpayne@69: #include jpayne@69: jpayne@69: /* This version will be incremented when incompatible changes are made to the jpayne@69: * KDB API, and will be kept in sync with the libkdb major version. */ jpayne@69: #define KRB5_KDB_API_VERSION 10 jpayne@69: jpayne@69: /* Salt types */ jpayne@69: #define KRB5_KDB_SALTTYPE_NORMAL 0 jpayne@69: /* #define KRB5_KDB_SALTTYPE_V4 1 */ jpayne@69: #define KRB5_KDB_SALTTYPE_NOREALM 2 jpayne@69: #define KRB5_KDB_SALTTYPE_ONLYREALM 3 jpayne@69: #define KRB5_KDB_SALTTYPE_SPECIAL 4 jpayne@69: /* #define KRB5_KDB_SALTTYPE_AFS3 5 */ jpayne@69: #define KRB5_KDB_SALTTYPE_CERTHASH 6 jpayne@69: jpayne@69: /* Attributes */ jpayne@69: #define KRB5_KDB_DISALLOW_POSTDATED 0x00000001 jpayne@69: #define KRB5_KDB_DISALLOW_FORWARDABLE 0x00000002 jpayne@69: #define KRB5_KDB_DISALLOW_TGT_BASED 0x00000004 jpayne@69: #define KRB5_KDB_DISALLOW_RENEWABLE 0x00000008 jpayne@69: #define KRB5_KDB_DISALLOW_PROXIABLE 0x00000010 jpayne@69: #define KRB5_KDB_DISALLOW_DUP_SKEY 0x00000020 jpayne@69: #define KRB5_KDB_DISALLOW_ALL_TIX 0x00000040 jpayne@69: #define KRB5_KDB_REQUIRES_PRE_AUTH 0x00000080 jpayne@69: #define KRB5_KDB_REQUIRES_HW_AUTH 0x00000100 jpayne@69: #define KRB5_KDB_REQUIRES_PWCHANGE 0x00000200 jpayne@69: #define KRB5_KDB_DISALLOW_SVR 0x00001000 jpayne@69: #define KRB5_KDB_PWCHANGE_SERVICE 0x00002000 jpayne@69: #define KRB5_KDB_SUPPORT_DESMD5 0x00004000 jpayne@69: #define KRB5_KDB_NEW_PRINC 0x00008000 jpayne@69: #define KRB5_KDB_OK_AS_DELEGATE 0x00100000 jpayne@69: #define KRB5_KDB_OK_TO_AUTH_AS_DELEGATE 0x00200000 /* S4U2Self OK */ jpayne@69: #define KRB5_KDB_NO_AUTH_DATA_REQUIRED 0x00400000 jpayne@69: #define KRB5_KDB_LOCKDOWN_KEYS 0x00800000 jpayne@69: jpayne@69: /* Creation flags */ jpayne@69: #define KRB5_KDB_CREATE_BTREE 0x00000001 jpayne@69: #define KRB5_KDB_CREATE_HASH 0x00000002 jpayne@69: jpayne@69: /* Entry get flags */ jpayne@69: /* Okay to generate a referral on lookup */ jpayne@69: #define KRB5_KDB_FLAG_REFERRAL_OK 0x00000010 jpayne@69: /* Client principal lookup (client referrals only) */ jpayne@69: #define KRB5_KDB_FLAG_CLIENT 0x00000040 jpayne@69: /* Map cross-realm principals */ jpayne@69: #define KRB5_KDB_FLAG_MAP_PRINCIPALS 0x00000080 jpayne@69: /* Protocol transition */ jpayne@69: #define KRB5_KDB_FLAG_PROTOCOL_TRANSITION 0x00000100 jpayne@69: /* Constrained delegation */ jpayne@69: #define KRB5_KDB_FLAG_CONSTRAINED_DELEGATION 0x00000200 jpayne@69: /* User-to-user */ jpayne@69: #define KRB5_KDB_FLAG_USER_TO_USER 0x00000800 jpayne@69: /* Cross-realm */ jpayne@69: #define KRB5_KDB_FLAG_CROSS_REALM 0x00001000 jpayne@69: /* Issuing referral */ jpayne@69: #define KRB5_KDB_FLAG_ISSUING_REFERRAL 0x00004000 jpayne@69: jpayne@69: jpayne@69: #define KRB5_KDB_FLAGS_S4U ( KRB5_KDB_FLAG_PROTOCOL_TRANSITION | \ jpayne@69: KRB5_KDB_FLAG_CONSTRAINED_DELEGATION ) jpayne@69: jpayne@69: /* KDB iteration flags */ jpayne@69: #define KRB5_DB_ITER_WRITE 0x00000001 jpayne@69: #define KRB5_DB_ITER_REV 0x00000002 jpayne@69: #define KRB5_DB_ITER_RECURSE 0x00000004 jpayne@69: jpayne@69: /* String attribute names recognized by krb5 */ jpayne@69: #define KRB5_KDB_SK_SESSION_ENCTYPES "session_enctypes" jpayne@69: #define KRB5_KDB_SK_REQUIRE_AUTH "require_auth" jpayne@69: jpayne@69: #if !defined(_WIN32) jpayne@69: jpayne@69: /* jpayne@69: * Note --- these structures cannot be modified without changing the jpayne@69: * database version number in libkdb.a, but should be expandable by jpayne@69: * adding new tl_data types. jpayne@69: */ jpayne@69: typedef struct _krb5_tl_data { jpayne@69: struct _krb5_tl_data* tl_data_next; /* NOT saved */ jpayne@69: krb5_int16 tl_data_type; jpayne@69: krb5_ui_2 tl_data_length; jpayne@69: krb5_octet * tl_data_contents; jpayne@69: } krb5_tl_data; jpayne@69: jpayne@69: /* String attributes (currently stored inside tl-data) map C string keys to jpayne@69: * values. They can be set via kadmin and consumed by KDC plugins. */ jpayne@69: typedef struct krb5_string_attr_st { jpayne@69: char *key; jpayne@69: char *value; jpayne@69: } krb5_string_attr; jpayne@69: jpayne@69: /* jpayne@69: * If this ever changes up the version number and make the arrays be as jpayne@69: * big as necessary. jpayne@69: * jpayne@69: * Currently the first type is the enctype and the second is the salt type. jpayne@69: */ jpayne@69: typedef struct _krb5_key_data { jpayne@69: krb5_int16 key_data_ver; /* Version */ jpayne@69: krb5_ui_2 key_data_kvno; /* Key Version */ jpayne@69: krb5_int16 key_data_type[2]; /* Array of types */ jpayne@69: krb5_ui_2 key_data_length[2]; /* Array of lengths */ jpayne@69: krb5_octet * key_data_contents[2]; /* Array of pointers */ jpayne@69: } krb5_key_data; jpayne@69: jpayne@69: #define KRB5_KDB_V1_KEY_DATA_ARRAY 2 /* # of array elements */ jpayne@69: jpayne@69: typedef struct _krb5_keysalt { jpayne@69: krb5_int16 type; jpayne@69: krb5_data data; /* Length, data */ jpayne@69: } krb5_keysalt; jpayne@69: jpayne@69: /* jpayne@69: * A principal database entry. Extensions to this structure currently use the jpayne@69: * tl_data list. The e_data and e_length fields are not used by any calling jpayne@69: * code except kdb5_util dump and load, which marshal and unmarshal the array jpayne@69: * in the dump record. KDB modules may use these fields internally as long as jpayne@69: * they set e_length appropriately (non-zero if the data should be marshalled jpayne@69: * across dump and load, zero if not) and handle null e_data values in jpayne@69: * caller-constructed principal entries. jpayne@69: */ jpayne@69: typedef struct _krb5_db_entry_new { jpayne@69: krb5_magic magic; /* NOT saved */ jpayne@69: krb5_ui_2 len; jpayne@69: krb5_ui_4 mask; /* members currently changed/set */ jpayne@69: krb5_flags attributes; jpayne@69: krb5_deltat max_life; jpayne@69: krb5_deltat max_renewable_life; jpayne@69: krb5_timestamp expiration; /* When the client expires */ jpayne@69: krb5_timestamp pw_expiration; /* When its passwd expires */ jpayne@69: krb5_timestamp last_success; /* Last successful passwd */ jpayne@69: krb5_timestamp last_failed; /* Last failed passwd attempt */ jpayne@69: krb5_kvno fail_auth_count; /* # of failed passwd attempt */ jpayne@69: krb5_int16 n_tl_data; jpayne@69: krb5_int16 n_key_data; jpayne@69: krb5_ui_2 e_length; /* Length of extra data */ jpayne@69: krb5_octet * e_data; /* Extra data to be saved */ jpayne@69: jpayne@69: krb5_principal princ; /* Length, data */ jpayne@69: krb5_tl_data * tl_data; /* Linked list */ jpayne@69: jpayne@69: /* key_data must be sorted by kvno in descending order. */ jpayne@69: krb5_key_data * key_data; /* Array */ jpayne@69: } krb5_db_entry; jpayne@69: jpayne@69: typedef struct _osa_policy_ent_t { jpayne@69: int version; jpayne@69: char *name; jpayne@69: krb5_ui_4 pw_min_life; jpayne@69: krb5_ui_4 pw_max_life; jpayne@69: krb5_ui_4 pw_min_length; jpayne@69: krb5_ui_4 pw_min_classes; jpayne@69: krb5_ui_4 pw_history_num; jpayne@69: krb5_ui_4 policy_refcnt; /* no longer used */ jpayne@69: /* Only valid if version > 1 */ jpayne@69: krb5_ui_4 pw_max_fail; /* pwdMaxFailure */ jpayne@69: krb5_ui_4 pw_failcnt_interval; /* pwdFailureCountInterval */ jpayne@69: krb5_ui_4 pw_lockout_duration; /* pwdLockoutDuration */ jpayne@69: /* Only valid if version > 2 */ jpayne@69: krb5_ui_4 attributes; jpayne@69: krb5_ui_4 max_life; jpayne@69: krb5_ui_4 max_renewable_life; jpayne@69: char * allowed_keysalts; jpayne@69: krb5_int16 n_tl_data; jpayne@69: krb5_tl_data * tl_data; jpayne@69: } osa_policy_ent_rec, *osa_policy_ent_t; jpayne@69: jpayne@69: typedef void (*osa_adb_iter_policy_func) (void *, osa_policy_ent_t); jpayne@69: jpayne@69: typedef struct __krb5_key_salt_tuple { jpayne@69: krb5_enctype ks_enctype; jpayne@69: krb5_int32 ks_salttype; jpayne@69: } krb5_key_salt_tuple; jpayne@69: jpayne@69: #define KRB5_KDB_MAGIC_NUMBER 0xdbdbdbdb jpayne@69: #define KRB5_KDB_V1_BASE_LENGTH 38 jpayne@69: jpayne@69: #define KRB5_KDB_MAX_ALLOWED_KS_LEN 512 jpayne@69: jpayne@69: #define KRB5_TL_LAST_PWD_CHANGE 0x0001 jpayne@69: #define KRB5_TL_MOD_PRINC 0x0002 jpayne@69: #define KRB5_TL_KADM_DATA 0x0003 jpayne@69: #define KRB5_TL_KADM5_E_DATA 0x0004 jpayne@69: #define KRB5_TL_RB1_CHALLENGE 0x0005 jpayne@69: #ifdef SECURID jpayne@69: #define KRB5_TL_SECURID_STATE 0x0006 jpayne@69: #endif /* SECURID */ jpayne@69: #define KRB5_TL_USER_CERTIFICATE 0x0007 jpayne@69: #define KRB5_TL_MKVNO 0x0008 jpayne@69: #define KRB5_TL_ACTKVNO 0x0009 jpayne@69: #define KRB5_TL_MKEY_AUX 0x000a jpayne@69: jpayne@69: /* String attributes may not always be represented in tl-data. kadmin clients jpayne@69: * must use the get_strings and set_string RPCs. */ jpayne@69: #define KRB5_TL_STRING_ATTRS 0x000b jpayne@69: jpayne@69: #define KRB5_TL_PAC_LOGON_INFO 0x0100 /* NDR encoded validation info */ jpayne@69: #define KRB5_TL_SERVER_REFERRAL 0x0200 /* ASN.1 encoded ServerReferralInfo */ jpayne@69: #define KRB5_TL_SVR_REFERRAL_DATA 0x0300 /* ASN.1 encoded PA-SVR-REFERRAL-DATA */ jpayne@69: #define KRB5_TL_CONSTRAINED_DELEGATION_ACL 0x0400 /* Each entry is a permitted SPN */ jpayne@69: #define KRB5_TL_LM_KEY 0x0500 /* LM OWF */ jpayne@69: #define KRB5_TL_X509_SUBJECT_ISSUER_NAME 0x0600 /* IssuerDNSubjectDN */ jpayne@69: #define KRB5_TL_LAST_ADMIN_UNLOCK 0x0700 /* Timestamp of admin unlock */ jpayne@69: jpayne@69: #define KRB5_TL_DB_ARGS 0x7fff jpayne@69: jpayne@69: /* version number for KRB5_TL_ACTKVNO data */ jpayne@69: #define KRB5_TL_ACTKVNO_VER 1 jpayne@69: jpayne@69: /* version number for KRB5_TL_MKEY_AUX data */ jpayne@69: #define KRB5_TL_MKEY_AUX_VER 1 jpayne@69: jpayne@69: typedef struct _krb5_actkvno_node { jpayne@69: struct _krb5_actkvno_node *next; jpayne@69: krb5_kvno act_kvno; jpayne@69: krb5_timestamp act_time; jpayne@69: } krb5_actkvno_node; jpayne@69: jpayne@69: typedef struct _krb5_mkey_aux_node { jpayne@69: struct _krb5_mkey_aux_node *next; jpayne@69: krb5_kvno mkey_kvno; /* kvno of mkey protecting the latest_mkey */ jpayne@69: krb5_key_data latest_mkey; /* most recent mkey */ jpayne@69: } krb5_mkey_aux_node; jpayne@69: jpayne@69: typedef struct _krb5_keylist_node { jpayne@69: krb5_keyblock keyblock; jpayne@69: krb5_kvno kvno; jpayne@69: struct _krb5_keylist_node *next; jpayne@69: } krb5_keylist_node; jpayne@69: jpayne@69: /* jpayne@69: * Determines the number of failed KDC requests before DISALLOW_ALL_TIX is set jpayne@69: * on the principal. jpayne@69: */ jpayne@69: #define KRB5_MAX_FAIL_COUNT 5 jpayne@69: jpayne@69: /* XXX depends on knowledge of krb5_parse_name() formats */ jpayne@69: #define KRB5_KDB_M_NAME "K/M" /* Kerberos/Master */ jpayne@69: jpayne@69: /* prompts used by default when reading the KDC password from the keyboard. */ jpayne@69: #define KRB5_KDC_MKEY_1 "Enter KDC database master key" jpayne@69: #define KRB5_KDC_MKEY_2 "Re-enter KDC database master key to verify" jpayne@69: jpayne@69: jpayne@69: extern char *krb5_mkey_pwd_prompt1; jpayne@69: extern char *krb5_mkey_pwd_prompt2; jpayne@69: jpayne@69: /* jpayne@69: * These macros specify the encoding of data within the database. jpayne@69: * jpayne@69: * Data encoding is little-endian. jpayne@69: */ jpayne@69: #ifdef _KRB5_INT_H jpayne@69: #include "k5-platform.h" jpayne@69: #define krb5_kdb_decode_int16(cp, i16) \ jpayne@69: *((krb5_int16 *) &(i16)) = load_16_le(cp) jpayne@69: #define krb5_kdb_decode_int32(cp, i32) \ jpayne@69: *((krb5_int32 *) &(i32)) = load_32_le(cp) jpayne@69: #define krb5_kdb_encode_int16(i16, cp) store_16_le(i16, cp) jpayne@69: #define krb5_kdb_encode_int32(i32, cp) store_32_le(i32, cp) jpayne@69: #endif /* _KRB5_INT_H */ jpayne@69: jpayne@69: #define KRB5_KDB_OPEN_RW 0 jpayne@69: #define KRB5_KDB_OPEN_RO 1 jpayne@69: jpayne@69: #ifndef KRB5_KDB_SRV_TYPE_KDC jpayne@69: #define KRB5_KDB_SRV_TYPE_KDC 0x0100 jpayne@69: #endif jpayne@69: jpayne@69: #ifndef KRB5_KDB_SRV_TYPE_ADMIN jpayne@69: #define KRB5_KDB_SRV_TYPE_ADMIN 0x0200 jpayne@69: #endif jpayne@69: jpayne@69: /* 0x0300 was KRB5_KDB_SRV_TYPE_PASSWD but it is no longer used. */ jpayne@69: jpayne@69: #ifndef KRB5_KDB_SRV_TYPE_OTHER jpayne@69: #define KRB5_KDB_SRV_TYPE_OTHER 0x0400 jpayne@69: #endif jpayne@69: jpayne@69: #define KRB5_KDB_OPT_SET_DB_NAME 0 jpayne@69: #define KRB5_KDB_OPT_SET_LOCK_MODE 1 jpayne@69: jpayne@69: #define KRB5_DB_LOCKMODE_SHARED 0x0001 jpayne@69: #define KRB5_DB_LOCKMODE_EXCLUSIVE 0x0002 jpayne@69: #define KRB5_DB_LOCKMODE_PERMANENT 0x0008 jpayne@69: jpayne@69: /* libkdb.spec */ jpayne@69: krb5_error_code krb5_db_setup_lib_handle(krb5_context kcontext); jpayne@69: krb5_error_code krb5_db_open( krb5_context kcontext, char **db_args, int mode ); jpayne@69: krb5_error_code krb5_db_init ( krb5_context kcontext ); jpayne@69: krb5_error_code krb5_db_create ( krb5_context kcontext, char **db_args ); jpayne@69: krb5_error_code krb5_db_inited ( krb5_context kcontext ); jpayne@69: krb5_error_code kdb5_db_create ( krb5_context kcontext, char **db_args ); jpayne@69: krb5_error_code krb5_db_fini ( krb5_context kcontext ); jpayne@69: const char * krb5_db_errcode2string ( krb5_context kcontext, long err_code ); jpayne@69: krb5_error_code krb5_db_destroy ( krb5_context kcontext, char **db_args ); jpayne@69: krb5_error_code krb5_db_promote ( krb5_context kcontext, char **db_args ); jpayne@69: krb5_error_code krb5_db_get_age ( krb5_context kcontext, char *db_name, time_t *t ); jpayne@69: krb5_error_code krb5_db_lock ( krb5_context kcontext, int lock_mode ); jpayne@69: krb5_error_code krb5_db_unlock ( krb5_context kcontext ); jpayne@69: krb5_error_code krb5_db_get_principal ( krb5_context kcontext, jpayne@69: krb5_const_principal search_for, jpayne@69: unsigned int flags, jpayne@69: krb5_db_entry **entry ); jpayne@69: void krb5_db_free_principal ( krb5_context kcontext, krb5_db_entry *entry ); jpayne@69: krb5_error_code krb5_db_put_principal ( krb5_context kcontext, jpayne@69: krb5_db_entry *entry ); jpayne@69: krb5_error_code krb5_db_delete_principal ( krb5_context kcontext, jpayne@69: krb5_principal search_for ); jpayne@69: krb5_error_code krb5_db_rename_principal ( krb5_context kcontext, jpayne@69: krb5_principal source, jpayne@69: krb5_principal target ); jpayne@69: jpayne@69: /* jpayne@69: * Iterate over principals in the KDB. If the callback may write to the DB, jpayne@69: * the caller must get an exclusive lock with krb5_db_lock before iterating, jpayne@69: * and release it with krb5_db_unlock after iterating. jpayne@69: */ jpayne@69: krb5_error_code krb5_db_iterate ( krb5_context kcontext, jpayne@69: char *match_entry, jpayne@69: int (*func) (krb5_pointer, krb5_db_entry *), jpayne@69: krb5_pointer func_arg, krb5_flags iterflags ); jpayne@69: jpayne@69: jpayne@69: krb5_error_code krb5_db_store_master_key ( krb5_context kcontext, jpayne@69: char *keyfile, jpayne@69: krb5_principal mname, jpayne@69: krb5_kvno kvno, jpayne@69: krb5_keyblock *key, jpayne@69: char *master_pwd); jpayne@69: krb5_error_code krb5_db_store_master_key_list ( krb5_context kcontext, jpayne@69: char *keyfile, jpayne@69: krb5_principal mname, jpayne@69: char *master_pwd); jpayne@69: krb5_error_code krb5_db_fetch_mkey ( krb5_context context, jpayne@69: krb5_principal mname, jpayne@69: krb5_enctype etype, jpayne@69: krb5_boolean fromkeyboard, jpayne@69: krb5_boolean twice, jpayne@69: char *db_args, jpayne@69: krb5_kvno *kvno, jpayne@69: krb5_data *salt, jpayne@69: krb5_keyblock *key); jpayne@69: krb5_error_code jpayne@69: krb5_db_fetch_mkey_list( krb5_context context, jpayne@69: krb5_principal mname, jpayne@69: const krb5_keyblock * mkey ); jpayne@69: jpayne@69: krb5_error_code jpayne@69: krb5_dbe_find_enctype( krb5_context kcontext, jpayne@69: krb5_db_entry *dbentp, jpayne@69: krb5_int32 ktype, jpayne@69: krb5_int32 stype, jpayne@69: krb5_int32 kvno, jpayne@69: krb5_key_data **kdatap); jpayne@69: jpayne@69: jpayne@69: krb5_error_code krb5_dbe_search_enctype ( krb5_context kcontext, jpayne@69: krb5_db_entry *dbentp, jpayne@69: krb5_int32 *start, jpayne@69: krb5_int32 ktype, jpayne@69: krb5_int32 stype, jpayne@69: krb5_int32 kvno, jpayne@69: krb5_key_data **kdatap); jpayne@69: jpayne@69: krb5_error_code jpayne@69: krb5_db_setup_mkey_name ( krb5_context context, jpayne@69: const char *keyname, jpayne@69: const char *realm, jpayne@69: char **fullname, jpayne@69: krb5_principal *principal); jpayne@69: jpayne@69: /** jpayne@69: * Decrypts the key given in @@a key_data. If @a mkey is specified, that jpayne@69: * master key is used. If @a mkey is NULL, then all master keys are tried. jpayne@69: */ jpayne@69: krb5_error_code jpayne@69: krb5_dbe_decrypt_key_data( krb5_context context, jpayne@69: const krb5_keyblock * mkey, jpayne@69: const krb5_key_data * key_data, jpayne@69: krb5_keyblock * dbkey, jpayne@69: krb5_keysalt * keysalt); jpayne@69: jpayne@69: krb5_error_code jpayne@69: krb5_dbe_encrypt_key_data( krb5_context context, jpayne@69: const krb5_keyblock * mkey, jpayne@69: const krb5_keyblock * dbkey, jpayne@69: const krb5_keysalt * keysalt, jpayne@69: int keyver, jpayne@69: krb5_key_data * key_data); jpayne@69: jpayne@69: krb5_error_code jpayne@69: krb5_dbe_fetch_act_key_list(krb5_context context, jpayne@69: krb5_principal princ, jpayne@69: krb5_actkvno_node **act_key_list); jpayne@69: jpayne@69: krb5_error_code jpayne@69: krb5_dbe_find_act_mkey( krb5_context context, jpayne@69: krb5_actkvno_node * act_mkey_list, jpayne@69: krb5_kvno * act_kvno, jpayne@69: krb5_keyblock ** act_mkey); jpayne@69: jpayne@69: krb5_error_code jpayne@69: krb5_dbe_find_mkey( krb5_context context, jpayne@69: krb5_db_entry * entry, jpayne@69: krb5_keyblock ** mkey); jpayne@69: jpayne@69: /* Set *mkvno to mkvno in entry tl_data, or 0 if not present. */ jpayne@69: krb5_error_code jpayne@69: krb5_dbe_lookup_mkvno( krb5_context context, jpayne@69: krb5_db_entry * entry, jpayne@69: krb5_kvno * mkvno); jpayne@69: jpayne@69: krb5_keylist_node * jpayne@69: krb5_db_mkey_list_alias( krb5_context kcontext ); jpayne@69: jpayne@69: /* Set *mkvno to mkvno in entry tl_data, or minimum value from mkey_list. */ jpayne@69: krb5_error_code jpayne@69: krb5_dbe_get_mkvno( krb5_context context, jpayne@69: krb5_db_entry * entry, jpayne@69: krb5_kvno * mkvno); jpayne@69: jpayne@69: krb5_error_code jpayne@69: krb5_dbe_lookup_mod_princ_data( krb5_context context, jpayne@69: krb5_db_entry * entry, jpayne@69: krb5_timestamp * mod_time, jpayne@69: krb5_principal * mod_princ); jpayne@69: jpayne@69: krb5_error_code jpayne@69: krb5_dbe_lookup_mkey_aux( krb5_context context, jpayne@69: krb5_db_entry * entry, jpayne@69: krb5_mkey_aux_node ** mkey_aux_data_list); jpayne@69: krb5_error_code jpayne@69: krb5_dbe_update_mkvno( krb5_context context, jpayne@69: krb5_db_entry * entry, jpayne@69: krb5_kvno mkvno); jpayne@69: jpayne@69: krb5_error_code jpayne@69: krb5_dbe_lookup_actkvno( krb5_context context, jpayne@69: krb5_db_entry * entry, jpayne@69: krb5_actkvno_node ** actkvno_list); jpayne@69: jpayne@69: krb5_error_code jpayne@69: krb5_dbe_update_mkey_aux( krb5_context context, jpayne@69: krb5_db_entry * entry, jpayne@69: krb5_mkey_aux_node * mkey_aux_data_list); jpayne@69: jpayne@69: krb5_error_code jpayne@69: krb5_dbe_update_actkvno(krb5_context context, jpayne@69: krb5_db_entry * entry, jpayne@69: const krb5_actkvno_node *actkvno_list); jpayne@69: jpayne@69: krb5_error_code jpayne@69: krb5_dbe_update_last_pwd_change( krb5_context context, jpayne@69: krb5_db_entry * entry, jpayne@69: krb5_timestamp stamp); jpayne@69: jpayne@69: krb5_error_code jpayne@69: krb5_dbe_update_last_admin_unlock( krb5_context context, jpayne@69: krb5_db_entry * entry, jpayne@69: krb5_timestamp stamp); jpayne@69: jpayne@69: krb5_error_code jpayne@69: krb5_dbe_lookup_tl_data( krb5_context context, jpayne@69: krb5_db_entry * entry, jpayne@69: krb5_tl_data * ret_tl_data); jpayne@69: jpayne@69: krb5_error_code jpayne@69: krb5_dbe_create_key_data( krb5_context context, jpayne@69: krb5_db_entry * entry); jpayne@69: jpayne@69: jpayne@69: krb5_error_code jpayne@69: krb5_dbe_update_mod_princ_data( krb5_context context, jpayne@69: krb5_db_entry * entry, jpayne@69: krb5_timestamp mod_date, jpayne@69: krb5_const_principal mod_princ); jpayne@69: jpayne@69: /* jpayne@69: * These are wrappers around realloc() and free(). Applications and KDB jpayne@69: * modules can use them when manipulating principal and policy entries to jpayne@69: * ensure that they allocate and free memory in a manner compatible with the jpayne@69: * library. Using libkrb5 or libkbd5 functions to construct values (such as jpayne@69: * krb5_copy_principal() to construct the princ field of a krb5_db_entry) is jpayne@69: * also safe. On Unix platforms, just using malloc() and free() is safe as jpayne@69: * long as the application or module does not use a malloc replacement. jpayne@69: */ jpayne@69: void *krb5_db_alloc( krb5_context kcontext, jpayne@69: void *ptr, jpayne@69: size_t size ); jpayne@69: void krb5_db_free( krb5_context kcontext, jpayne@69: void *ptr); jpayne@69: jpayne@69: jpayne@69: krb5_error_code jpayne@69: krb5_dbe_lookup_last_pwd_change( krb5_context context, jpayne@69: krb5_db_entry * entry, jpayne@69: krb5_timestamp * stamp); jpayne@69: jpayne@69: krb5_error_code jpayne@69: krb5_dbe_lookup_last_admin_unlock( krb5_context context, jpayne@69: krb5_db_entry * entry, jpayne@69: krb5_timestamp * stamp); jpayne@69: jpayne@69: /* Retrieve the set of string attributes in entry, in no particular order. jpayne@69: * Free *strings_out with krb5_dbe_free_strings when done. */ jpayne@69: krb5_error_code jpayne@69: krb5_dbe_get_strings(krb5_context context, krb5_db_entry *entry, jpayne@69: krb5_string_attr **strings_out, int *count_out); jpayne@69: jpayne@69: /* Retrieve a single string attribute from entry, or NULL if there is no jpayne@69: * attribute for key. Free *value_out with krb5_dbe_free_string when done. */ jpayne@69: krb5_error_code jpayne@69: krb5_dbe_get_string(krb5_context context, krb5_db_entry *entry, jpayne@69: const char *key, char **value_out); jpayne@69: jpayne@69: /* Change or add a string attribute in entry, or delete it if value is NULL. */ jpayne@69: krb5_error_code jpayne@69: krb5_dbe_set_string(krb5_context context, krb5_db_entry *entry, jpayne@69: const char *key, const char *value); jpayne@69: jpayne@69: krb5_error_code jpayne@69: krb5_dbe_delete_tl_data( krb5_context context, jpayne@69: krb5_db_entry * entry, jpayne@69: krb5_int16 tl_data_type); jpayne@69: jpayne@69: krb5_error_code jpayne@69: krb5_db_update_tl_data(krb5_context context, jpayne@69: krb5_int16 * n_tl_datap, jpayne@69: krb5_tl_data **tl_datap, jpayne@69: krb5_tl_data * new_tl_data); jpayne@69: jpayne@69: krb5_error_code jpayne@69: krb5_dbe_update_tl_data( krb5_context context, jpayne@69: krb5_db_entry * entry, jpayne@69: krb5_tl_data * new_tl_data); jpayne@69: jpayne@69: /* Compute the salt for a key data entry given the corresponding principal. */ jpayne@69: krb5_error_code jpayne@69: krb5_dbe_compute_salt(krb5_context context, const krb5_key_data *key, jpayne@69: krb5_const_principal princ, krb5_int16 *salttype_out, jpayne@69: krb5_data **salt_out); jpayne@69: jpayne@69: /* jpayne@69: * Modify the key data of entry to explicitly store salt values using the jpayne@69: * KRB5_KDB_SALTTYPE_SPECIAL salt type. jpayne@69: */ jpayne@69: krb5_error_code jpayne@69: krb5_dbe_specialize_salt(krb5_context context, krb5_db_entry *entry); jpayne@69: jpayne@69: krb5_error_code jpayne@69: krb5_dbe_cpw( krb5_context kcontext, jpayne@69: krb5_keyblock * master_key, jpayne@69: krb5_key_salt_tuple * ks_tuple, jpayne@69: int ks_tuple_count, jpayne@69: char * passwd, jpayne@69: int new_kvno, jpayne@69: krb5_boolean keepold, jpayne@69: krb5_db_entry * db_entry); jpayne@69: jpayne@69: jpayne@69: krb5_error_code jpayne@69: krb5_dbe_ark( krb5_context context, jpayne@69: krb5_keyblock * master_key, jpayne@69: krb5_key_salt_tuple * ks_tuple, jpayne@69: int ks_tuple_count, jpayne@69: krb5_db_entry * db_entry); jpayne@69: jpayne@69: krb5_error_code jpayne@69: krb5_dbe_crk( krb5_context context, jpayne@69: krb5_keyblock * master_key, jpayne@69: krb5_key_salt_tuple * ks_tuple, jpayne@69: int ks_tuple_count, jpayne@69: krb5_boolean keepold, jpayne@69: krb5_db_entry * db_entry); jpayne@69: jpayne@69: krb5_error_code jpayne@69: krb5_dbe_apw( krb5_context context, jpayne@69: krb5_keyblock * master_key, jpayne@69: krb5_key_salt_tuple * ks_tuple, jpayne@69: int ks_tuple_count, jpayne@69: char * passwd, jpayne@69: krb5_db_entry * db_entry); jpayne@69: jpayne@69: int jpayne@69: krb5_db_get_key_data_kvno( krb5_context context, jpayne@69: int count, jpayne@69: krb5_key_data * data); jpayne@69: jpayne@69: krb5_error_code krb5_db_check_transited_realms(krb5_context kcontext, jpayne@69: const krb5_data *tr_contents, jpayne@69: const krb5_data *client_realm, jpayne@69: const krb5_data *server_realm); jpayne@69: jpayne@69: krb5_error_code krb5_db_check_policy_as(krb5_context kcontext, jpayne@69: krb5_kdc_req *request, jpayne@69: krb5_db_entry *client, jpayne@69: krb5_db_entry *server, jpayne@69: krb5_timestamp kdc_time, jpayne@69: const char **status, jpayne@69: krb5_pa_data ***e_data); jpayne@69: jpayne@69: krb5_error_code krb5_db_check_policy_tgs(krb5_context kcontext, jpayne@69: krb5_kdc_req *request, jpayne@69: krb5_db_entry *server, jpayne@69: krb5_ticket *ticket, jpayne@69: const char **status, jpayne@69: krb5_pa_data ***e_data); jpayne@69: jpayne@69: void krb5_db_audit_as_req(krb5_context kcontext, krb5_kdc_req *request, jpayne@69: const krb5_address *local_addr, jpayne@69: const krb5_address *remote_addr, jpayne@69: krb5_db_entry *client, krb5_db_entry *server, jpayne@69: krb5_timestamp authtime, krb5_error_code error_code); jpayne@69: jpayne@69: void krb5_db_refresh_config(krb5_context kcontext); jpayne@69: jpayne@69: krb5_error_code krb5_db_check_allowed_to_delegate(krb5_context kcontext, jpayne@69: krb5_const_principal client, jpayne@69: const krb5_db_entry *server, jpayne@69: krb5_const_principal proxy); jpayne@69: jpayne@69: krb5_error_code krb5_db_get_s4u_x509_principal(krb5_context kcontext, jpayne@69: const krb5_data *client_cert, jpayne@69: krb5_const_principal in_princ, jpayne@69: unsigned int flags, jpayne@69: krb5_db_entry **entry); jpayne@69: jpayne@69: krb5_error_code krb5_db_allowed_to_delegate_from(krb5_context context, jpayne@69: krb5_const_principal client, jpayne@69: krb5_const_principal server, jpayne@69: krb5_pac server_pac, jpayne@69: const krb5_db_entry *proxy); jpayne@69: jpayne@69: /** jpayne@69: * Sort an array of @a krb5_key_data keys in descending order by their kvno. jpayne@69: * Key data order within a kvno is preserved. jpayne@69: * jpayne@69: * @param key_data jpayne@69: * The @a krb5_key_data array to sort. This is sorted in place so the jpayne@69: * array will be modified. jpayne@69: * @param key_data_length jpayne@69: * The length of @a key_data. jpayne@69: */ jpayne@69: void jpayne@69: krb5_dbe_sort_key_data(krb5_key_data *key_data, size_t key_data_length); jpayne@69: jpayne@69: krb5_error_code jpayne@69: krb5_db_issue_pac(krb5_context context, unsigned int flags, jpayne@69: krb5_db_entry *client, krb5_keyblock *replaced_reply_key, jpayne@69: krb5_db_entry *server, krb5_db_entry *krbtgt, jpayne@69: krb5_timestamp authtime, krb5_pac old_pac, krb5_pac new_pac, jpayne@69: krb5_data ***auth_indicators); jpayne@69: jpayne@69: /* default functions. Should not be directly called */ jpayne@69: /* jpayne@69: * Default functions prototype jpayne@69: */ jpayne@69: jpayne@69: krb5_error_code jpayne@69: krb5_dbe_def_search_enctype( krb5_context kcontext, jpayne@69: krb5_db_entry *dbentp, jpayne@69: krb5_int32 *start, jpayne@69: krb5_int32 ktype, jpayne@69: krb5_int32 stype, jpayne@69: krb5_int32 kvno, jpayne@69: krb5_key_data **kdatap); jpayne@69: jpayne@69: krb5_error_code jpayne@69: krb5_def_store_mkey_list( krb5_context context, jpayne@69: char *keyfile, jpayne@69: krb5_principal mname, jpayne@69: krb5_keylist_node *keylist, jpayne@69: char *master_pwd); jpayne@69: jpayne@69: krb5_error_code jpayne@69: krb5_db_def_fetch_mkey( krb5_context context, jpayne@69: krb5_principal mname, jpayne@69: krb5_keyblock *key, jpayne@69: krb5_kvno *kvno, jpayne@69: char *db_args); jpayne@69: jpayne@69: krb5_error_code jpayne@69: krb5_def_fetch_mkey_list( krb5_context context, jpayne@69: krb5_principal mprinc, jpayne@69: const krb5_keyblock *mkey, jpayne@69: krb5_keylist_node **mkeys_list); jpayne@69: jpayne@69: krb5_error_code jpayne@69: krb5_dbe_def_cpw( krb5_context context, jpayne@69: krb5_keyblock * master_key, jpayne@69: krb5_key_salt_tuple * ks_tuple, jpayne@69: int ks_tuple_count, jpayne@69: char * passwd, jpayne@69: int new_kvno, jpayne@69: krb5_boolean keepold, jpayne@69: krb5_db_entry * db_entry); jpayne@69: jpayne@69: krb5_error_code jpayne@69: krb5_dbe_def_decrypt_key_data( krb5_context context, jpayne@69: const krb5_keyblock * mkey, jpayne@69: const krb5_key_data * key_data, jpayne@69: krb5_keyblock * dbkey, jpayne@69: krb5_keysalt * keysalt); jpayne@69: jpayne@69: krb5_error_code jpayne@69: krb5_dbe_def_encrypt_key_data( krb5_context context, jpayne@69: const krb5_keyblock * mkey, jpayne@69: const krb5_keyblock * dbkey, jpayne@69: const krb5_keysalt * keysalt, jpayne@69: int keyver, jpayne@69: krb5_key_data * key_data); jpayne@69: jpayne@69: krb5_error_code jpayne@69: krb5_db_def_rename_principal( krb5_context kcontext, jpayne@69: krb5_const_principal source, jpayne@69: krb5_const_principal target); jpayne@69: jpayne@69: krb5_error_code jpayne@69: krb5_db_create_policy( krb5_context kcontext, jpayne@69: osa_policy_ent_t policy); jpayne@69: jpayne@69: krb5_error_code jpayne@69: krb5_db_get_policy ( krb5_context kcontext, jpayne@69: char *name, jpayne@69: osa_policy_ent_t *policy ); jpayne@69: jpayne@69: krb5_error_code jpayne@69: krb5_db_put_policy( krb5_context kcontext, jpayne@69: osa_policy_ent_t policy); jpayne@69: jpayne@69: krb5_error_code jpayne@69: krb5_db_iter_policy( krb5_context kcontext, jpayne@69: char *match_entry, jpayne@69: osa_adb_iter_policy_func func, jpayne@69: void *data); jpayne@69: jpayne@69: krb5_error_code jpayne@69: krb5_db_delete_policy( krb5_context kcontext, jpayne@69: char *policy); jpayne@69: jpayne@69: void jpayne@69: krb5_db_free_policy( krb5_context kcontext, jpayne@69: osa_policy_ent_t policy); jpayne@69: jpayne@69: jpayne@69: krb5_error_code jpayne@69: krb5_db_set_context(krb5_context, void *db_context); jpayne@69: jpayne@69: krb5_error_code jpayne@69: krb5_db_get_context(krb5_context, void **db_context); jpayne@69: jpayne@69: void jpayne@69: krb5_dbe_free_key_data_contents(krb5_context, krb5_key_data *); jpayne@69: jpayne@69: void jpayne@69: krb5_dbe_free_key_list(krb5_context, krb5_keylist_node *); jpayne@69: jpayne@69: void jpayne@69: krb5_dbe_free_actkvno_list(krb5_context, krb5_actkvno_node *); jpayne@69: jpayne@69: void jpayne@69: krb5_dbe_free_mkey_aux_list(krb5_context, krb5_mkey_aux_node *); jpayne@69: jpayne@69: void jpayne@69: krb5_dbe_free_tl_data(krb5_context, krb5_tl_data *); jpayne@69: jpayne@69: void jpayne@69: krb5_dbe_free_strings(krb5_context, krb5_string_attr *, int count); jpayne@69: jpayne@69: void jpayne@69: krb5_dbe_free_string(krb5_context, char *); jpayne@69: jpayne@69: /* jpayne@69: * Register the KDB keytab type, allowing "KDB:" to be used as a keytab name. jpayne@69: * For this type to work, the context used for keytab operations must have an jpayne@69: * associated database handle (via krb5_db_open()). jpayne@69: */ jpayne@69: krb5_error_code krb5_db_register_keytab(krb5_context context); jpayne@69: jpayne@69: #define KRB5_KDB_DEF_FLAGS 0 jpayne@69: jpayne@69: #define KDB_MAX_DB_NAME 128 jpayne@69: #define KDB_REALM_SECTION "realms" jpayne@69: #define KDB_MODULE_POINTER "database_module" jpayne@69: #define KDB_MODULE_DEF_SECTION "dbdefaults" jpayne@69: #define KDB_MODULE_SECTION "dbmodules" jpayne@69: #define KDB_LIB_POINTER "db_library" jpayne@69: #define KDB_DATABASE_CONF_FILE DEFAULT_SECURE_PROFILE_PATH jpayne@69: #define KDB_DATABASE_ENV_PROF KDC_PROFILE_ENV jpayne@69: jpayne@69: #define KRB5_KDB_OPEN_RW 0 jpayne@69: #define KRB5_KDB_OPEN_RO 1 jpayne@69: jpayne@69: #define KRB5_KDB_OPT_SET_DB_NAME 0 jpayne@69: #define KRB5_KDB_OPT_SET_LOCK_MODE 1 jpayne@69: jpayne@69: /* jpayne@69: * This number indicates the date of the last incompatible change to the DAL. jpayne@69: * The maj_ver field of the module's vtable structure must match this version. jpayne@69: */ jpayne@69: #define KRB5_KDB_DAL_MAJOR_VERSION 9 jpayne@69: jpayne@69: /* jpayne@69: * Note the following when converting a module to DAL version 9: jpayne@69: * jpayne@69: * - get_authdata_info() and sign_authdata() have been removed, and issue_pac() jpayne@69: * has been added. jpayne@69: * jpayne@69: * - check_allowed_to_delegate() must handle a null proxy argument, returning jpayne@69: * success if server has any authorized delegation targets in the traditional jpayne@69: * scheme. jpayne@69: * jpayne@69: * - allowed_to_delegate_from() accepts a krb5_pac parameter (in place jpayne@69: * server_ad_info) for the impersonator's PAC. jpayne@69: * jpayne@69: * - check_allowed_to_delegate() and allowed_to_delegate_from() must return jpayne@69: * KRB5KDC_ERR_BADOPTION on authorization failure. jpayne@69: * jpayne@69: * - the KRB5_KDB_FLAG_ISSUE_PAC and KRB5_FLAG_CLIENT_REFERRALS_ONLY flags have jpayne@69: * been combined into KRB5_KDB_FLAG_CLIENT. jpayne@69: * jpayne@69: * - the KRB5_KDB_FLAG_CANONICALIZE flag has been renamed to jpayne@69: * KRB5_KDB_FLAG_REFERRAL_OK, and is only passed to get_principal() when a jpayne@69: * realm referral is allowed (AS client and TGS server lookups, when the jpayne@69: * CANONICALIZE option is requested or, for AS requests, when the client is jpayne@69: * an enterprise principal). As of DAL version 8 the KDB module should jpayne@69: * always canonicalize aliases within a realm; the KDC will decide whether to jpayne@69: * use the original or canonical principal. jpayne@69: */ jpayne@69: jpayne@69: /* jpayne@69: * A krb5_context can hold one database object. Modules should use jpayne@69: * krb5_db_set_context and krb5_db_get_context to store state associated with jpayne@69: * the database object. jpayne@69: * jpayne@69: * Some module functions are mandatory for KDC operation; others are optional jpayne@69: * or apply only to administrative operations. If a function is optional, a jpayne@69: * module can leave the function pointer as NULL. Alternatively, modules can jpayne@69: * return KRB5_PLUGIN_OP_NOTSUPP when asked to perform an inapplicable action. jpayne@69: * jpayne@69: * Some module functions have default implementations which will call back into jpayne@69: * the vtable interface. Leave these functions as NULL to use the default jpayne@69: * implementations. jpayne@69: * jpayne@69: * The documentation in these comments describes the DAL as it is currently jpayne@69: * implemented and used, not as it should be. So if anything seems off, that jpayne@69: * probably means the current state of things is off. jpayne@69: * jpayne@69: * Modules must allocate memory for principal entries, policy entries, and jpayne@69: * other structures using an allocator compatible with malloc() as seen by jpayne@69: * libkdb5 and libkrb5. Modules may link against libkdb5 and call jpayne@69: * krb5_db_alloc() to be certain that the same malloc implementation is used. jpayne@69: */ jpayne@69: jpayne@69: typedef struct _kdb_vftabl { jpayne@69: short int maj_ver; jpayne@69: short int min_ver; jpayne@69: jpayne@69: /* jpayne@69: * Mandatory: Invoked after the module library is loaded, when the first DB jpayne@69: * using the module is opened, across all contexts. jpayne@69: */ jpayne@69: krb5_error_code (*init_library)(void); jpayne@69: jpayne@69: /* jpayne@69: * Mandatory: Invoked before the module library is unloaded, after the last jpayne@69: * DB using the module is closed, across all contexts. jpayne@69: */ jpayne@69: krb5_error_code (*fini_library)(void); jpayne@69: jpayne@69: /* jpayne@69: * Mandatory: Initialize a database object. Profile settings should be jpayne@69: * read from conf_section inside KDB_MODULE_SECTION. db_args communicates jpayne@69: * command-line arguments for module-specific flags. mode will be one of jpayne@69: * KRB5_KDB_OPEN_{RW,RO} or'd with one of jpayne@69: * KRB5_KDB_SRV_TYPE_{KDC,ADMIN,PASSWD,OTHER}. jpayne@69: */ jpayne@69: krb5_error_code (*init_module)(krb5_context kcontext, char *conf_section, jpayne@69: char **db_args, int mode); jpayne@69: jpayne@69: /* jpayne@69: * Mandatory: Finalize the database object contained in a context. Free jpayne@69: * any state contained in the db_context pointer and null it out. jpayne@69: */ jpayne@69: krb5_error_code (*fini_module)(krb5_context kcontext); jpayne@69: jpayne@69: /* jpayne@69: * Optional: Initialize a database object while creating the underlying jpayne@69: * database. conf_section and db_args have the same meaning as in jpayne@69: * init_module. This function may return an error if the database already jpayne@69: * exists. Used by kdb5_util create. jpayne@69: * jpayne@69: * If db_args contains the value "temporary", the module should create an jpayne@69: * exclusively locked side copy of the database suitable for loading in a jpayne@69: * propagation from primary to replica. This side copy will later be jpayne@69: * promoted with promote_db, allowing complete updates of the DB with no jpayne@69: * loss in read availability. If the module cannot comply with this jpayne@69: * architecture, it should return an error. jpayne@69: */ jpayne@69: krb5_error_code (*create)(krb5_context kcontext, char *conf_section, jpayne@69: char **db_args); jpayne@69: jpayne@69: /* jpayne@69: * Optional: Destroy a database. conf_section and db_args have the same jpayne@69: * meaning as in init_module. Used by kdb5_util destroy. In current jpayne@69: * usage, the database is destroyed while open, so the module should handle jpayne@69: * that. jpayne@69: */ jpayne@69: krb5_error_code (*destroy)(krb5_context kcontext, char *conf_section, jpayne@69: char **db_args); jpayne@69: jpayne@69: /* jpayne@69: * Deprecated: No longer used as of krb5 1.10; can be removed in the next jpayne@69: * DAL revision. Modules should leave as NULL. jpayne@69: */ jpayne@69: krb5_error_code (*get_age)(krb5_context kcontext, char *db_name, jpayne@69: time_t *age); jpayne@69: jpayne@69: /* jpayne@69: * Optional: Lock the database, with semantics depending on the mode jpayne@69: * argument: jpayne@69: * jpayne@69: * KRB5_DB_LOCKMODE_SHARED: Lock may coexist with other shared locks. jpayne@69: * KRB5_DB_LOCKMODE_EXCLUSIVE: Lock may not coexist with other locks. jpayne@69: * KRB5_DB_LOCKMODE_PERMANENT: Exclusive lock surviving process exit. jpayne@69: * jpayne@69: * Used by the "kadmin lock" command, incremental propagation, and jpayne@69: * kdb5_util dump. Incremental propagation support requires shared locks jpayne@69: * to operate. kdb5_util dump will continue unlocked if the module returns jpayne@69: * KRB5_PLUGIN_OP_NOTSUPP. jpayne@69: */ jpayne@69: krb5_error_code (*lock)(krb5_context kcontext, int mode); jpayne@69: jpayne@69: /* Optional: Release a lock created with db_lock. */ jpayne@69: krb5_error_code (*unlock)(krb5_context kcontext); jpayne@69: jpayne@69: /* jpayne@69: * Mandatory: Set *entry to an allocated entry for the principal jpayne@69: * search_for. If the principal is not found, return KRB5_KDB_NOENTRY. jpayne@69: * jpayne@69: * The meaning of flags are as follows: jpayne@69: * jpayne@69: * KRB5_KDB_FLAG_REFERRAL_OK: Set by the KDC when looking up entries for an jpayne@69: * AS client with canonicalization requested or for an enterprise jpayne@69: * principal, or for a TGS request server with canonicalization jpayne@69: * requested. Determines whether the module should return out-of-realm jpayne@69: * referrals. jpayne@69: * jpayne@69: * KRB5_KDB_FLAG_CLIENT: Set by the KDC when looking up a client principal jpayne@69: * during an AS or TGS request. Affects how the module should return jpayne@69: * out-of-realm referrals. jpayne@69: * jpayne@69: * KRB5_KDB_FLAG_MAP_PRINCIPALS: Set by the KDC when looking up the client jpayne@69: * entry during TGS requests, except for S4U TGS requests and requests jpayne@69: * where the server entry has the KRB5_KDB_NO_AUTH_DATA_REQUIRED jpayne@69: * attribute. Indicates that the module should map foreign principals jpayne@69: * to local principals if it supports doing so. jpayne@69: * jpayne@69: * KRB5_KDB_FLAG_PROTOCOL_TRANSITION: Set by the KDC when looking up the jpayne@69: * client entry during an S4U2Self TGS request. This affects the PAC jpayne@69: * information which should be included when authorization data is jpayne@69: * generated; see the Microsoft S4U specification for details. jpayne@69: * jpayne@69: * KRB5_KDB_FLAG_CONSTRAINED_DELEGATION: Set by the KDC when looking up the jpayne@69: * client entry during an S4U2Proxy TGS request. Also affects PAC jpayne@69: * generation. jpayne@69: * jpayne@69: * KRB5_KDB_FLAG_CROSS_REALM: Set by the KDC after looking up a server jpayne@69: * entry during a TGS request, if the header ticket was issued by a jpayne@69: * different realm. jpayne@69: * jpayne@69: * KRB5_KDB_FLAG_ISSUING_REFERRAL: Set by the KDC after looking up a server jpayne@69: * entry during a TGS request, if the requested server principal is not jpayne@69: * part of the realm being served, and a referral or alternate TGT will jpayne@69: * be issued instead. jpayne@69: * jpayne@69: * A module may return an in-realm alias by setting (*entry)->princ to the jpayne@69: * canonical name. The KDC will decide based on the request whether to use jpayne@69: * the requested name or the canonical name in the issued ticket. jpayne@69: * jpayne@69: * A module can return a referral to another realm if flags contains jpayne@69: * KRB5_KDB_FLAG_REFERRAL_OK. If KRB5_KDB_FLAG_CLIENT is also set, the jpayne@69: * module should return a referral by simply filling in an out-of-realm jpayne@69: * name in (*entry)->princ and setting all other fields to NULL. jpayne@69: * Otherwise, the module should return the entry for the cross-realm TGS of jpayne@69: * the referred-to realm. jpayne@69: */ jpayne@69: krb5_error_code (*get_principal)(krb5_context kcontext, jpayne@69: krb5_const_principal search_for, jpayne@69: unsigned int flags, jpayne@69: krb5_db_entry **entry); jpayne@69: jpayne@69: /* jpayne@69: * Optional: Create or modify a principal entry. db_args communicates jpayne@69: * command-line arguments for module-specific flags. jpayne@69: * jpayne@69: * The mask field of an entry indicates the changed fields. Mask values jpayne@69: * are defined in kadmin's admin.h header. If KADM5_PRINCIPAL is set in jpayne@69: * the mask, the entry is new; otherwise it already exists. All fields of jpayne@69: * an entry are expected to contain correct values, regardless of whether jpayne@69: * they are specified in the mask, so it is acceptable for a module to jpayne@69: * ignore the mask and update the entire entry. jpayne@69: */ jpayne@69: krb5_error_code (*put_principal)(krb5_context kcontext, jpayne@69: krb5_db_entry *entry, char **db_args); jpayne@69: jpayne@69: /* jpayne@69: * Optional: Delete the entry for the principal search_for. If the jpayne@69: * principal did not exist, return KRB5_KDB_NOENTRY. jpayne@69: */ jpayne@69: krb5_error_code (*delete_principal)(krb5_context kcontext, jpayne@69: krb5_const_principal search_for); jpayne@69: jpayne@69: /* jpayne@69: * Optional with default: Rename a principal. If the source principal does jpayne@69: * not exist, return KRB5_KDB_NOENTRY. If the target exists, return an jpayne@69: * error. jpayne@69: * jpayne@69: * NOTE: If the module chooses to implement a custom function for renaming jpayne@69: * a principal instead of using the default, then rename operations will jpayne@69: * fail if iprop logging is enabled. jpayne@69: */ jpayne@69: krb5_error_code (*rename_principal)(krb5_context kcontext, jpayne@69: krb5_const_principal source, jpayne@69: krb5_const_principal target); jpayne@69: jpayne@69: /* jpayne@69: * Optional: For each principal entry in the database, invoke func with the jpayne@69: * arguments func_arg and the entry data. If match_entry is specified, the jpayne@69: * module may narrow the iteration to principal names matching that regular jpayne@69: * expression; a module may alternatively ignore match_entry. jpayne@69: */ jpayne@69: krb5_error_code (*iterate)(krb5_context kcontext, jpayne@69: char *match_entry, jpayne@69: int (*func)(krb5_pointer, krb5_db_entry *), jpayne@69: krb5_pointer func_arg, krb5_flags iterflags); jpayne@69: jpayne@69: /* jpayne@69: * Optional: Create a password policy entry. Return an error if the policy jpayne@69: * already exists. jpayne@69: */ jpayne@69: krb5_error_code (*create_policy)(krb5_context kcontext, jpayne@69: osa_policy_ent_t policy); jpayne@69: jpayne@69: /* jpayne@69: * Optional: Set *policy to the policy entry of the specified name. If the jpayne@69: * entry does not exist, return KRB5_KDB_NOENTRY. jpayne@69: */ jpayne@69: krb5_error_code (*get_policy)(krb5_context kcontext, char *name, jpayne@69: osa_policy_ent_t *policy); jpayne@69: jpayne@69: /* jpayne@69: * Optional: Modify an existing password policy entry to match the values jpayne@69: * in policy. Return an error if the policy does not already exist. jpayne@69: */ jpayne@69: krb5_error_code (*put_policy)(krb5_context kcontext, jpayne@69: osa_policy_ent_t policy); jpayne@69: jpayne@69: /* jpayne@69: * Optional: For each password policy entry in the database, invoke func jpayne@69: * with the arguments data and the entry data. If match_entry is jpayne@69: * specified, the module may narrow the iteration to policy names matching jpayne@69: * that regular expression; a module may alternatively ignore match_entry. jpayne@69: */ jpayne@69: krb5_error_code (*iter_policy)(krb5_context kcontext, char *match_entry, jpayne@69: osa_adb_iter_policy_func func, jpayne@69: void *data); jpayne@69: jpayne@69: /* jpayne@69: * Optional: Delete the password policy entry with the name policy. Return jpayne@69: * an error if the entry does not exist. jpayne@69: */ jpayne@69: krb5_error_code (*delete_policy)(krb5_context kcontext, char *policy); jpayne@69: jpayne@69: /* jpayne@69: * Optional with default: Retrieve a master keyblock from the stash file jpayne@69: * db_args, filling in *key and *kvno. mname is the name of the master jpayne@69: * principal for the realm. jpayne@69: * jpayne@69: * The default implementation reads the master keyblock from a keytab or jpayne@69: * old-format stash file. jpayne@69: */ jpayne@69: krb5_error_code (*fetch_master_key)(krb5_context kcontext, jpayne@69: krb5_principal mname, jpayne@69: krb5_keyblock *key, krb5_kvno *kvno, jpayne@69: char *db_args); jpayne@69: jpayne@69: /* jpayne@69: * Optional with default: Given a keyblock for some version of the jpayne@69: * database's master key, fetch the decrypted master key values from the jpayne@69: * database and store the list into *mkeys_list. The caller will free jpayne@69: * *mkeys_list using a libkdb5 function which uses the standard free() jpayne@69: * function, so the module must not use a custom allocator. jpayne@69: * jpayne@69: * The caller may not know the version number of the master key it has, in jpayne@69: * which case it will pass IGNORE_VNO. jpayne@69: * jpayne@69: * The default implementation ignores kvno and tries the key against the jpayne@69: * current master key data and all KRB5_TL_MKEY_AUX values, which contain jpayne@69: * copies of the master keys encrypted with old master keys. jpayne@69: */ jpayne@69: krb5_error_code (*fetch_master_key_list)(krb5_context kcontext, jpayne@69: krb5_principal mname, jpayne@69: const krb5_keyblock *key, jpayne@69: krb5_keylist_node **mkeys_list); jpayne@69: jpayne@69: /* jpayne@69: * Optional with default: Save a list of master keyblocks, obtained from jpayne@69: * fetch_master_key_list, into the stash file db_arg. The caller will set jpayne@69: * master_pwd to NULL, so the module should just ignore it. mname is the jpayne@69: * name of the master principal for the realm. jpayne@69: * jpayne@69: * The default implementation saves the list of master keys in a jpayne@69: * keytab-format file. jpayne@69: */ jpayne@69: krb5_error_code (*store_master_key_list)(krb5_context kcontext, jpayne@69: char *db_arg, jpayne@69: krb5_principal mname, jpayne@69: krb5_keylist_node *keylist, jpayne@69: char *master_pwd); jpayne@69: jpayne@69: /* jpayne@69: * Optional with default: Starting at position *start, scan the key data of jpayne@69: * a database entry for a key matching the enctype ktype, the salt type jpayne@69: * stype, and the version kvno. Store the resulting key into *kdatap and jpayne@69: * set *start to the position after the key found. If ktype is negative, jpayne@69: * match any enctype. If stype is negative, match any salt type. If kvno jpayne@69: * is zero or negative, find the most recent key version satisfying the jpayne@69: * other constraints. jpayne@69: */ jpayne@69: krb5_error_code (*dbe_search_enctype)(krb5_context kcontext, jpayne@69: krb5_db_entry *dbentp, jpayne@69: krb5_int32 *start, krb5_int32 ktype, jpayne@69: krb5_int32 stype, krb5_int32 kvno, jpayne@69: krb5_key_data **kdatap); jpayne@69: jpayne@69: jpayne@69: /* jpayne@69: * Optional with default: Change the key data for db_entry to include keys jpayne@69: * derived from the password passwd in each of the specified key-salt jpayne@69: * types, at version new_kvno. Discard the old key data if keepold is not jpayne@69: * set. jpayne@69: * jpayne@69: * The default implementation uses the keyblock master_key to encrypt each jpayne@69: * new key, via the function encrypt_key_data. jpayne@69: */ jpayne@69: krb5_error_code (*change_pwd)(krb5_context context, jpayne@69: krb5_keyblock *master_key, jpayne@69: krb5_key_salt_tuple *ks_tuple, jpayne@69: int ks_tuple_count, char *passwd, jpayne@69: int new_kvno, krb5_boolean keepold, jpayne@69: krb5_db_entry *db_entry); jpayne@69: jpayne@69: /* jpayne@69: * Optional: Promote a temporary database to be the live one. context must jpayne@69: * be initialized with an exclusively locked database created with the jpayne@69: * "temporary" db_arg. On success, the database object contained in jpayne@69: * context will be finalized. jpayne@69: * jpayne@69: * This method is used by kdb5_util load to replace the live database with jpayne@69: * minimal loss of read availability. jpayne@69: */ jpayne@69: krb5_error_code (*promote_db)(krb5_context context, char *conf_section, jpayne@69: char **db_args); jpayne@69: jpayne@69: /* jpayne@69: * Optional with default: Decrypt the key in key_data with master keyblock jpayne@69: * mkey, placing the result into dbkey. Copy the salt from key_data, if jpayne@69: * any, into keysalt. Either dbkey or keysalt may be left unmodified on jpayne@69: * successful return if key_data does not contain key or salt information. jpayne@69: * jpayne@69: * The default implementation expects the encrypted key (in krb5_c_encrypt jpayne@69: * format) to be stored in key_data_contents[0], with length given by jpayne@69: * key_data_length[0]. If key_data_ver is 2, it expects the salt to be jpayne@69: * stored, unencrypted, in key_data_contents[1], with length given by jpayne@69: * key_data_length[1]. jpayne@69: */ jpayne@69: krb5_error_code (*decrypt_key_data)(krb5_context kcontext, jpayne@69: const krb5_keyblock *mkey, jpayne@69: const krb5_key_data *key_data, jpayne@69: krb5_keyblock *dbkey, jpayne@69: krb5_keysalt *keysalt); jpayne@69: jpayne@69: /* jpayne@69: * Optional with default: Encrypt dbkey with master keyblock mkey, placing jpayne@69: * the result into key_data along with keysalt. jpayne@69: * jpayne@69: * The default implementation stores the encrypted key (in krb5_c_encrypt jpayne@69: * format) in key_data_contents[0] and the length in key_data_length[0]. jpayne@69: * If keysalt is specified, it sets key_data_ver to 2, and stores the salt jpayne@69: * in key_data_contents[1] and its length in key_data_length[1]. If jpayne@69: * keysalt is not specified, key_data_ver is set to 1. jpayne@69: */ jpayne@69: krb5_error_code (*encrypt_key_data)(krb5_context kcontext, jpayne@69: const krb5_keyblock *mkey, jpayne@69: const krb5_keyblock *dbkey, jpayne@69: const krb5_keysalt *keysalt, jpayne@69: int keyver, krb5_key_data *key_data); jpayne@69: jpayne@69: /* jpayne@69: * Optional: Perform a policy check on a cross-realm ticket's transited jpayne@69: * field. Return 0 if the check authoritatively succeeds, jpayne@69: * KRB5_PLUGIN_NO_HANDLE to use the core transited-checking mechanisms, or jpayne@69: * another error (other than KRB5_PLUGIN_OP_NOTSUPP) if the check fails. jpayne@69: */ jpayne@69: krb5_error_code (*check_transited_realms)(krb5_context kcontext, jpayne@69: const krb5_data *tr_contents, jpayne@69: const krb5_data *client_realm, jpayne@69: const krb5_data *server_realm); jpayne@69: jpayne@69: /* jpayne@69: * Optional: Perform a policy check on an AS request, in addition to the jpayne@69: * standard policy checks. Return 0 if the AS request is allowed. If the jpayne@69: * AS request is not allowed: jpayne@69: * - Place a short string literal into *status. jpayne@69: * - If desired, place data into e_data. Any data placed here will be jpayne@69: * freed by the caller using the standard free function. jpayne@69: * - Return an appropriate error (such as KRB5KDC_ERR_POLICY). jpayne@69: */ jpayne@69: krb5_error_code (*check_policy_as)(krb5_context kcontext, jpayne@69: krb5_kdc_req *request, jpayne@69: krb5_db_entry *client, jpayne@69: krb5_db_entry *server, jpayne@69: krb5_timestamp kdc_time, jpayne@69: const char **status, jpayne@69: krb5_pa_data ***e_data); jpayne@69: jpayne@69: /* jpayne@69: * Optional: Perform a policy check on a TGS request, in addition to the jpayne@69: * standard policy checks. Return 0 if the TGS request is allowed. If the jpayne@69: * TGS request is not allowed: jpayne@69: * - Place a short string literal into *status. jpayne@69: * - If desired, place data into e_data. Any data placed here will be jpayne@69: * freed by the caller using the standard free function. jpayne@69: * - Return an appropriate error (such as KRB5KDC_ERR_POLICY). jpayne@69: * The input parameter ticket contains the TGT used in the TGS request. jpayne@69: */ jpayne@69: krb5_error_code (*check_policy_tgs)(krb5_context kcontext, jpayne@69: krb5_kdc_req *request, jpayne@69: krb5_db_entry *server, jpayne@69: krb5_ticket *ticket, jpayne@69: const char **status, jpayne@69: krb5_pa_data ***e_data); jpayne@69: jpayne@69: /* jpayne@69: * Optional: This method informs the module of a successful or unsuccessful jpayne@69: * AS request. jpayne@69: */ jpayne@69: void (*audit_as_req)(krb5_context kcontext, krb5_kdc_req *request, jpayne@69: const krb5_address *local_addr, jpayne@69: const krb5_address *remote_addr, jpayne@69: krb5_db_entry *client, krb5_db_entry *server, jpayne@69: krb5_timestamp authtime, krb5_error_code error_code); jpayne@69: jpayne@69: /* Note: there is currently no method for auditing TGS requests. */ jpayne@69: jpayne@69: /* jpayne@69: * Optional: This method informs the module of a request to reload jpayne@69: * configuration or other state (that is, the KDC received a SIGHUP). jpayne@69: */ jpayne@69: void (*refresh_config)(krb5_context kcontext); jpayne@69: jpayne@69: /* jpayne@69: * Optional: Perform a policy check on server being allowed to obtain jpayne@69: * tickets from client to proxy. If proxy is NULL, check if server has any jpayne@69: * authorized delegation targets (client will also be NULL in this case). jpayne@69: * (Note that proxy is the target of the delegation, not the delegating jpayne@69: * service; the term "proxy" is from the viewpoint of the delegating jpayne@69: * service asking another service to perform some of its work in the jpayne@69: * authentication context of the client. This terminology comes from the jpayne@69: * Microsoft S4U protocol documentation.) Return 0 if policy allows jpayne@69: * delegation to the specified target (or to any target if proxy is NULL), jpayne@69: * or KRB5KDC_ERR_BADOPTION if not. If this method is not implemented, all jpayne@69: * S4U2Proxy delegation requests will be rejected. jpayne@69: */ jpayne@69: krb5_error_code (*check_allowed_to_delegate)(krb5_context context, jpayne@69: krb5_const_principal client, jpayne@69: const krb5_db_entry *server, jpayne@69: krb5_const_principal proxy); jpayne@69: jpayne@69: /* jpayne@69: * Optional: Free the e_data pointer of a database entry. If this method jpayne@69: * is not implemented, the e_data pointer in principal entries will be jpayne@69: * freed with free() as seen by libkdb5. jpayne@69: */ jpayne@69: void (*free_principal_e_data)(krb5_context kcontext, krb5_octet *e_data); jpayne@69: jpayne@69: /* jpayne@69: * Optional: get a client principal entry based on an X.509 certificate. jpayne@69: * jpayne@69: * If flags include KRB5_KDB_FLAG_REFERRAL_OK, the certificate was jpayne@69: * presented in an AS request. princ->realm indicates the request realm, jpayne@69: * but the data components should be ignored. The module can return an jpayne@69: * out-of-realm client referral as it would for get_principal(). jpayne@69: * jpayne@69: * Otherwise, princ is from a TGS request. If it contains data components jpayne@69: * (and not just a realm), the module should verify that it is the same as jpayne@69: * the lookup result for client_cert. The module should not return a jpayne@69: * referral. jpayne@69: */ jpayne@69: krb5_error_code (*get_s4u_x509_principal)(krb5_context kcontext, jpayne@69: const krb5_data *client_cert, jpayne@69: krb5_const_principal princ, jpayne@69: unsigned int flags, jpayne@69: krb5_db_entry **entry_out); jpayne@69: jpayne@69: /* jpayne@69: * Optional: Perform a policy check on server being allowed to obtain jpayne@69: * tickets from client to proxy. This method is similar to jpayne@69: * check_allowed_to_delegate, but it operates on the target server DB entry jpayne@69: * (called "proxy" here as in Microsoft's protocol documentation) rather jpayne@69: * than the intermediate server entry. server_pac is the verified PAC from jpayne@69: * the authdata of the intermediate server. Return 0 if policy allows the jpayne@69: * delegation, or KRB5KDC_ERR_BADOPTION if not. jpayne@69: * jpayne@69: * This method is called for S4U2Proxy requests and implements the jpayne@69: * resource-based constrained delegation variant, which can support jpayne@69: * cross-realm delegation. If this method is not implemented or if it jpayne@69: * returns a policy error, the KDC will fall back to jpayne@69: * check_allowed_to_delegate if the intermediate and target servers are in jpayne@69: * the same realm and the evidence ticket is forwardable. jpayne@69: */ jpayne@69: krb5_error_code (*allowed_to_delegate_from)(krb5_context context, jpayne@69: krb5_const_principal client, jpayne@69: krb5_const_principal server, jpayne@69: krb5_pac server_pac, jpayne@69: const krb5_db_entry *proxy); jpayne@69: jpayne@69: /* jpayne@69: * Optional: Add buffers to new_pac using krb5_pac_add_buffer() before it jpayne@69: * is signed. jpayne@69: * jpayne@69: * The caller will handle the following buffer types, so do not copy or add jpayne@69: * them: jpayne@69: * jpayne@69: * KRB5_PAC_SERVER_CHECKSUM jpayne@69: * KRB5_PAC_PRIVSVR_CHECKSUM jpayne@69: * KRB5_PAC_TICKET_CHECKSUM jpayne@69: * KRB5_PAC_CLIENT_INFO jpayne@69: * KRB5_PAC_DELEGATION_INFO jpayne@69: * jpayne@69: * For TGS requests, old_pac is the PAC of the header ticket, except when jpayne@69: * KRB5_KDB_FLAG_CONTRAINED_DELEGATION is present in flags, in which case jpayne@69: * it is the PAC of the second ticket. If jpayne@69: * KRB5_KDB_FLAG_PROTOCOL_TRANSITION is present in flags and client is not jpayne@69: * NULL, old_pac is the PAC of the requesting service, not the subject of jpayne@69: * the S4U2Self request, and its buffers should not be copied into new_pac. jpayne@69: * The signatures and PAC_CLIENT_INFO of old_pac have been verified by the jpayne@69: * caller. jpayne@69: * jpayne@69: * If replaced_reply_key is not null, the request is an AS request and the jpayne@69: * reply key was replaced by a preauth mechanism such as PKINIT, meaning jpayne@69: * the Kerberos password or long-term key was not used. The module may use jpayne@69: * this key to encrypt a PAC_CREDENTIALS_INFO buffer containing credentials jpayne@69: * (such as an NTLM hash) that the client would ordinarily derive from the jpayne@69: * Kerberos password or long-term key. jpayne@69: * jpayne@69: * server is the database entry of the server the ticket will be issued to, jpayne@69: * which may be a referral TGS. jpayne@69: * jpayne@69: * signing_krbtgt is the database entry of the krbtgt principal used to jpayne@69: * verify old_pac (or null if old_pac is null). If jpayne@69: * KRB5_KDB_FLAG_CROSS_REALM is present in flags, this entry will be an jpayne@69: * incoming cross-realm TGS, and the PAC fields should undergo appropriate jpayne@69: * filtering based on the trust level of the cross-realm relationship. jpayne@69: * jpayne@69: * auth_indicators points to NULL or a null-terminated list of krb5_data jpayne@69: * pointers, each containing an authentication indicator (RFC 8129). The jpayne@69: * method may modify this list, or free it and replace *auth_indicators jpayne@69: * with NULL, to change which auth indicators will be included in the jpayne@69: * ticket. jpayne@69: */ jpayne@69: krb5_error_code (*issue_pac)(krb5_context context, unsigned int flags, jpayne@69: krb5_db_entry *client, jpayne@69: krb5_keyblock *replaced_reply_key, jpayne@69: krb5_db_entry *server, jpayne@69: krb5_db_entry *signing_krbtgt, jpayne@69: krb5_timestamp authtime, krb5_pac old_pac, jpayne@69: krb5_pac new_pac, jpayne@69: krb5_data ***auth_indicators); jpayne@69: jpayne@69: /* End of minor version 0 for major version 9. */ jpayne@69: } kdb_vftabl; jpayne@69: jpayne@69: #endif /* !defined(_WIN32) */ jpayne@69: jpayne@69: #endif /* KRB5_KDB5__ */