kdc/kdc_locl.h

   1 /*
   2  * Copyright (c) 1997-2005 Kungliga Tekniska Högskolan
   3  * (Royal Institute of Technology, Stockholm, Sweden).
   4  * All rights reserved.
   5  *
   6  * Redistribution and use in source and binary forms, with or without
   7  * modification, are permitted provided that the following conditions
   8  * are met:
   9  *
  10  * 1. Redistributions of source code must retain the above copyright
  11  *    notice, this list of conditions and the following disclaimer.
  12  *
  13  * 2. Redistributions in binary form must reproduce the above copyright
  14  *    notice, this list of conditions and the following disclaimer in the
  15  *    documentation and/or other materials provided with the distribution.
  16  *
  17  * 3. Neither the name of the Institute nor the names of its contributors
  18  *    may be used to endorse or promote products derived from this software
  19  *    without specific prior written permission.
  20  *
  21  * THIS SOFTWARE IS PROVIDED BY THE INSTITUTE AND CONTRIBUTORS ``AS IS'' AND
  22  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  23  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  24  * ARE DISCLAIMED.  IN NO EVENT SHALL THE INSTITUTE OR CONTRIBUTORS BE LIABLE
  25  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  26  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  27  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  28  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  29  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  30  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  31  * SUCH DAMAGE.
  32  */
  33
  34 /*
  35  * $Id$
  36  */
  37
  38 #ifndef __KDC_LOCL_H__
  39 #define __KDC_LOCL_H__
  40
  41 #include "headers.h"
  42
  43 typedef struct pk_client_params pk_client_params;
  44 typedef struct gss_client_params gss_client_params;
  45
  46 #include <kdc-private.h>
  47
  48 #define FAST_EXPIRATION_TIME (3 * 60)
  49
  50 /* KFE == KDC_FIND_ETYPE */
  51 #define KFE_IS_TGS      0x1
  52 #define KFE_IS_PREAUTH  0x2
  53 #define KFE_USE_CLIENT  0x4
  54
  55 #define heim_pcontext krb5_context
  56 #define heim_pconfig krb5_kdc_configuration *
  57 #include <heimbase-svc.h>
  58
  59 #define KDC_AUDIT_EATWHITE      HEIM_SVC_AUDIT_EATWHITE
  60 #define KDC_AUDIT_VIS           HEIM_SVC_AUDIT_VIS
  61 #define KDC_AUDIT_VISLAST       HEIM_SVC_AUDIT_VISLAST
  62
  63 struct kdc_request_desc {
  64     HEIM_SVC_REQUEST_DESC_COMMON_ELEMENTS;
  65 };
  66
  67 struct kdc_patypes;
  68
  69 struct krb5_kdc_configuration {
  70     KRB5_KDC_CONFIGURATION_COMMON_ELEMENTS;
  71
  72     int num_kdc_processes;
  73
  74     size_t max_datagram_reply_length;
  75
  76     time_t kdc_warn_pwexpire; /* time before expiration to print a warning */
  77
  78     unsigned int require_preauth : 1; /* require preauth for all principals */
  79     unsigned int encode_as_rep_as_tgs_rep : 1; /* bug compatibility */
  80
  81     /*
  82      * Windows 2019 (and earlier versions) always sends the salt
  83      * and Samba has testsuites that check this behaviour, so a
  84      * Samba AD DC will set this flag to match the AS-REP packet
  85      * exactly.
  86      */
  87     unsigned int force_include_pa_etype_salt : 1;
  88
  89     unsigned int tgt_use_strongest_session_key : 1;
  90     unsigned int preauth_use_strongest_session_key : 1;
  91     unsigned int svc_use_strongest_session_key : 1;
  92     unsigned int use_strongest_server_key : 1;
  93
  94     unsigned int check_ticket_addresses : 1;
  95     unsigned int warn_ticket_addresses : 1;
  96     unsigned int allow_null_ticket_addresses : 1;
  97     unsigned int allow_anonymous : 1;
  98     unsigned int historical_anon_realm : 1;
  99     unsigned int strict_nametypes : 1;
 100     enum krb5_kdc_trpolicy trpolicy;
 101
 102     unsigned int require_pac : 1;
 103     unsigned int disable_pac : 1;
 104     unsigned int enable_fast : 1;
 105     unsigned int enable_armored_pa_enc_timestamp : 1;
 106     unsigned int enable_unarmored_pa_enc_timestamp : 1;
 107
 108     unsigned int enable_pkinit : 1;
 109     unsigned int pkinit_princ_in_cert : 1;
 110     const char *pkinit_kdc_identity;
 111     const char *pkinit_kdc_anchors;
 112     const char *pkinit_kdc_friendly_name;
 113     const char *pkinit_kdc_ocsp_file;
 114     char **pkinit_kdc_cert_pool;
 115     char **pkinit_kdc_revoke;
 116     int pkinit_dh_min_bits;
 117     unsigned int pkinit_require_binding : 1;
 118     unsigned int pkinit_allow_proxy_certs : 1;
 119     unsigned int synthetic_clients : 1;
 120     unsigned int pkinit_max_life_from_cert_extension : 1;
 121     krb5_timestamp pkinit_max_life_from_cert;
 122     krb5_timestamp pkinit_max_life_bound;
 123     krb5_timestamp synthetic_clients_max_life;
 124     krb5_timestamp synthetic_clients_max_renew;
 125
 126     int digests_allowed;
 127     unsigned int enable_digest : 1;
 128
 129     unsigned int enable_kx509 : 1;
 130
 131     unsigned int enable_gss_preauth : 1;
 132     unsigned int enable_gss_auth_data : 1;
 133     gss_OID_set gss_mechanisms_allowed;
 134     gss_OID_set gss_cross_realm_mechanisms_allowed;
 135
 136 };
 137
 138 struct astgs_request_desc {
 139     HEIM_SVC_REQUEST_DESC_COMMON_ELEMENTS;
 140
 141     /* AS-REQ or TGS-REQ */
 142     KDC_REQ req;
 143
 144     /* AS-REP or TGS-REP */
 145     KDC_REP rep;
 146     EncTicketPart et;
 147     EncKDCRepPart ek;
 148
 149     /* client principal (AS) or TGT/S4U principal (TGS) */
 150     krb5_principal client_princ;
 151     hdb_entry *client;
 152     HDB *clientdb;
 153     krb5_principal canon_client_princ;
 154
 155     /* server principal */
 156     krb5_principal server_princ;
 157     HDB *serverdb;
 158     hdb_entry *server;
 159
 160     /* presented ticket in TGS-REQ (unused by AS) */
 161     krb5_principal krbtgt_princ;
 162     hdb_entry *krbtgt;
 163     HDB *krbtgtdb;
 164     krb5_ticket *ticket;
 165
 166     krb5_keyblock reply_key;
 167
 168     krb5_pac pac;
 169     uint64_t pac_attributes;
 170
 171     /* Only AS */
 172     const struct kdc_patypes *pa_used;
 173
 174     /* PA methods can affect both the reply key and the session key (pkinit) */
 175     krb5_enctype sessionetype;
 176     krb5_keyblock session_key;
 177
 178     krb5_timestamp pa_endtime;
 179     krb5_timestamp pa_max_life;
 180
 181     krb5_keyblock strengthen_key;
 182     const Key *ticket_key;
 183
 184     /* only valid for tgs-req */
 185     unsigned int rk_is_subkey : 1;
 186     unsigned int fast_asserted : 1;
 187     unsigned int explicit_armor_present : 1;
 188
 189     krb5_crypto armor_crypto;
 190     hdb_entry *armor_server;
 191     HDB *armor_serverdb;
 192     krb5_ticket *armor_ticket;
 193     Key *armor_key;
 194
 195     hdb_entry *explicit_armor_client;
 196     HDB *explicit_armor_clientdb;
 197     krb5_pac explicit_armor_pac;
 198
 199     KDCFastState fast;
 200 };
 201
 202 typedef struct kx509_req_context_desc {
 203     HEIM_SVC_REQUEST_DESC_COMMON_ELEMENTS;
 204
 205     struct Kx509Request req;
 206     Kx509CSRPlus csr_plus;
 207     krb5_auth_context ac;
 208     const char *realm; /* XXX Confusion: is this crealm or srealm? */
 209     krb5_keyblock *key;
 210     hx509_request csr;
 211     krb5_times ticket_times;
 212     unsigned int send_chain:1;          /* Client expects a full chain */
 213     unsigned int have_csr:1;            /* Client sent a CSR */
 214 } *kx509_req_context;
 215
 216 #undef heim_pconfig
 217 #undef heim_pcontext
 218
 219 extern sig_atomic_t exit_flag;
 220 extern size_t max_request_udp;
 221 extern size_t max_request_tcp;
 222 extern const char *request_log;
 223 extern const char *port_str;
 224 extern krb5_addresses explicit_addresses;
 225
 226 extern int enable_http;
 227
 228 extern int detach_from_console;
 229 extern int daemon_child;
 230 extern int do_bonjour;
 231
 232 extern int testing_flag;
 233
 234 extern const struct units _kdc_digestunits[];
 235
 236 #define KDC_LOG_FILE            "kdc.log"
 237
 238 extern struct timeval _kdc_now;
 239 #define kdc_time (_kdc_now.tv_sec)
 240
 241 extern char *runas_string;
 242 extern char *chroot_string;
 243
 244 void
 245 start_kdc(krb5_context context, krb5_kdc_configuration *config, const char *argv0);
 246
 247 krb5_kdc_configuration *
 248 configure(krb5_context context, int argc, char **argv, int *optidx);
 249
 250 #ifdef __APPLE__
 251 void bonjour_announce(krb5_context, krb5_kdc_configuration *);
 252 #endif
 253
 254 /* no-copy setters */
 255
 256 #undef _KDC_REQUEST_GET_ACCESSOR
 257 #undef _KDC_REQUEST_SET_ACCESSOR
 258
 259 #undef _KDC_REQUEST_GET_ACCESSOR_PTR
 260 #undef _KDC_REQUEST_SET_ACCESSOR_PTR
 261 #define _KDC_REQUEST_SET_ACCESSOR_PTR(R, T, t, f)           \
 262     void                                                    \
 263     _kdc_request_set_ ## f ## _nocopy(R r, T *v);
 264
 265 #undef _KDC_REQUEST_GET_ACCESSOR_STRUCT
 266 #undef _KDC_REQUEST_SET_ACCESSOR_STRUCT
 267 #define _KDC_REQUEST_SET_ACCESSOR_STRUCT(R, T, t, f)        \
 268     void                                                    \
 269     _kdc_request_set_ ## f ## _nocopy(R r, T *v);
 270
 271 #undef HEIMDAL_KDC_KDC_ACCESSORS_H
 272 #include "kdc-accessors.h"
 273
 274 #endif /* __KDC_LOCL_H__ */