lib/krb5/context.c

   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 #include "krb5_locl.h"
  35 #include <com_err.h>
  36
  37 RCSID("$Id$");
  38
  39 #define INIT_FIELD(C, T, E, D, F)                                       \
  40     (C)->E = krb5_config_get_ ## T ## _default ((C), NULL, (D),         \
  41                                                 "libdefaults", F, NULL)
  42
  43 #define INIT_FLAG(C, O, V, D, F)                                        \
  44     do {                                                                \
  45         if (krb5_config_get_bool_default((C), NULL, (D),"libdefaults", F, NULL)) { \
  46             (C)->O |= V;                                                \
  47         }                                                               \
  48     } while(0)
  49
  50 /*
  51  * Set the list of etypes `ret_etypes' from the configuration variable
  52  * `name'
  53  */
  54
  55 static krb5_error_code
  56 set_etypes (krb5_context context,
  57             const char *name,
  58             krb5_enctype **ret_enctypes)
  59 {
  60     char **etypes_str;
  61     krb5_enctype *etypes = NULL;
  62
  63     etypes_str = krb5_config_get_strings(context, NULL, "libdefaults",
  64                                          name, NULL);
  65     if(etypes_str){
  66         int i, j, k;
  67         for(i = 0; etypes_str[i]; i++);
  68         etypes = malloc((i+1) * sizeof(*etypes));
  69         if (etypes == NULL) {
  70             krb5_config_free_strings (etypes_str);
  71             krb5_set_error_message (context, ENOMEM, N_("malloc: out of memory", ""));
  72             return ENOMEM;
  73         }
  74         for(j = 0, k = 0; j < i; j++) {
  75             krb5_enctype e;
  76             if(krb5_string_to_enctype(context, etypes_str[j], &e) != 0)
  77                 continue;
  78             if (krb5_enctype_valid(context, e) != 0)
  79                 continue;
  80             etypes[k++] = e;
  81         }
  82         etypes[k] = ETYPE_NULL;
  83         krb5_config_free_strings(etypes_str);
  84     }
  85     *ret_enctypes = etypes;
  86     return 0;
  87 }
  88
  89 /*
  90  *
  91  */
  92
  93 static krb5_error_code
  94 copy_etypes (krb5_context context,
  95              krb5_enctype *enctypes,
  96              krb5_enctype **ret_enctypes)
  97 {
  98     unsigned int i;
  99
 100     for (i = 0; enctypes[i]; i++)
 101         ;
 102     i++;
 103
 104     *ret_enctypes = malloc(sizeof(ret_enctypes[0]) * i);
 105     if (*ret_enctypes == NULL) {
 106         krb5_set_error_message(context, ENOMEM,
 107                                N_("malloc: out of memory", ""));
 108         return ENOMEM;
 109     }
 110     memcpy(*ret_enctypes, enctypes, sizeof(ret_enctypes[0]) * i);
 111     return 0;
 112 }
 113
 114
 115 /*
 116  * read variables from the configuration file and set in `context'
 117  */
 118
 119 static krb5_error_code
 120 init_context_from_config_file(krb5_context context)
 121 {
 122     krb5_error_code ret;
 123     const char * tmp;
 124     krb5_enctype *tmptypes;
 125
 126     INIT_FIELD(context, time, max_skew, 5 * 60, "clockskew");
 127     INIT_FIELD(context, time, kdc_timeout, 3, "kdc_timeout");
 128     INIT_FIELD(context, int, max_retries, 3, "max_retries");
 129
 130     INIT_FIELD(context, string, http_proxy, NULL, "http_proxy");
 131
 132     ret = set_etypes (context, "default_etypes", &tmptypes);
 133     if(ret)
 134         return ret;
 135     free(context->etypes);
 136     context->etypes = tmptypes;
 137
 138     ret = set_etypes (context, "default_etypes_des", &tmptypes);
 139     if(ret)
 140         return ret;
 141     free(context->etypes_des);
 142     context->etypes_des = tmptypes;
 143
 144     /* default keytab name */
 145     tmp = NULL;
 146     if(!issuid())
 147         tmp = getenv("KRB5_KTNAME");
 148     if(tmp != NULL)
 149         context->default_keytab = tmp;
 150     else
 151         INIT_FIELD(context, string, default_keytab,
 152                    KEYTAB_DEFAULT, "default_keytab_name");
 153
 154     INIT_FIELD(context, string, default_keytab_modify,
 155                NULL, "default_keytab_modify_name");
 156
 157     INIT_FIELD(context, string, time_fmt,
 158                "%Y-%m-%dT%H:%M:%S", "time_format");
 159
 160     INIT_FIELD(context, string, date_fmt,
 161                "%Y-%m-%d", "date_format");
 162
 163     INIT_FIELD(context, bool, log_utc,
 164                FALSE, "log_utc");
 165
 166
 167
 168     /* init dns-proxy slime */
 169     tmp = krb5_config_get_string(context, NULL, "libdefaults",
 170                                  "dns_proxy", NULL);
 171     if(tmp)
 172         roken_gethostby_setup(context->http_proxy, tmp);
 173     krb5_free_host_realm (context, context->default_realms);
 174     context->default_realms = NULL;
 175
 176     {
 177         krb5_addresses addresses;
 178         char **adr, **a;
 179
 180         krb5_set_extra_addresses(context, NULL);
 181         adr = krb5_config_get_strings(context, NULL,
 182                                       "libdefaults",
 183                                       "extra_addresses",
 184                                       NULL);
 185         memset(&addresses, 0, sizeof(addresses));
 186         for(a = adr; a && *a; a++) {
 187             ret = krb5_parse_address(context, *a, &addresses);
 188             if (ret == 0) {
 189                 krb5_add_extra_addresses(context, &addresses);
 190                 krb5_free_addresses(context, &addresses);
 191             }
 192         }
 193         krb5_config_free_strings(adr);
 194
 195         krb5_set_ignore_addresses(context, NULL);
 196         adr = krb5_config_get_strings(context, NULL,
 197                                       "libdefaults",
 198                                       "ignore_addresses",
 199                                       NULL);
 200         memset(&addresses, 0, sizeof(addresses));
 201         for(a = adr; a && *a; a++) {
 202             ret = krb5_parse_address(context, *a, &addresses);
 203             if (ret == 0) {
 204                 krb5_add_ignore_addresses(context, &addresses);
 205                 krb5_free_addresses(context, &addresses);
 206             }
 207         }
 208         krb5_config_free_strings(adr);
 209     }
 210
 211     INIT_FIELD(context, bool, scan_interfaces, TRUE, "scan_interfaces");
 212     INIT_FIELD(context, int, fcache_vno, 0, "fcache_version");
 213     /* prefer dns_lookup_kdc over srv_lookup. */
 214     INIT_FIELD(context, bool, srv_lookup, TRUE, "srv_lookup");
 215     INIT_FIELD(context, bool, srv_lookup, context->srv_lookup, "dns_lookup_kdc");
 216     INIT_FIELD(context, int, large_msg_size, 1400, "large_message_size");
 217     INIT_FLAG(context, flags, KRB5_CTX_F_DNS_CANONICALIZE_HOSTNAME, TRUE, "dns_canonicalize_hostname");
 218     INIT_FLAG(context, flags, KRB5_CTX_F_CHECK_PAC, TRUE, "check_pac");
 219     context->default_cc_name = NULL;
 220     context->default_cc_name_set = 0;
 221
 222     ret = krb5_config_get_bool_default(context, NULL, FALSE,
 223                                        "libdefaults",
 224                                        "allow_weak_crypto", NULL);
 225     if (ret) {
 226         krb5_enctype_enable(context, ETYPE_DES_CBC_CRC);
 227         krb5_enctype_enable(context, ETYPE_DES_CBC_MD4);
 228         krb5_enctype_enable(context, ETYPE_DES_CBC_MD5);
 229         krb5_enctype_enable(context, ETYPE_DES_CBC_NONE);
 230         krb5_enctype_enable(context, ETYPE_DES_CFB64_NONE);
 231         krb5_enctype_enable(context, ETYPE_DES_PCBC_NONE);
 232     }
 233
 234     return 0;
 235 }
 236
 237 static krb5_error_code
 238 cc_ops_register(krb5_context context)
 239 {
 240     context->cc_ops = NULL;
 241     context->num_cc_ops = 0;
 242
 243     krb5_cc_register(context, &krb5_acc_ops, TRUE);
 244     krb5_cc_register(context, &krb5_fcc_ops, TRUE);
 245     krb5_cc_register(context, &krb5_mcc_ops, TRUE);
 246     krb5_cc_register(context, &krb5_scc_ops, TRUE);
 247 #ifdef HAVE_KCM
 248     krb5_cc_register(context, &krb5_kcm_ops, TRUE);
 249 #endif
 250     return 0;
 251 }
 252
 253 static krb5_error_code
 254 kt_ops_register(krb5_context context)
 255 {
 256     context->num_kt_types = 0;
 257     context->kt_types     = NULL;
 258
 259     krb5_kt_register (context, &krb5_fkt_ops);
 260     krb5_kt_register (context, &krb5_wrfkt_ops);
 261     krb5_kt_register (context, &krb5_javakt_ops);
 262     krb5_kt_register (context, &krb5_mkt_ops);
 263 #ifndef HEIMDAL_SMALLER
 264     krb5_kt_register (context, &krb5_akf_ops);
 265 #endif
 266     krb5_kt_register (context, &krb5_any_ops);
 267     return 0;
 268 }
 269
 270
 271 /**
 272  * Initializes the context structure and reads the configuration file
 273  * /etc/krb5.conf. The structure should be freed by calling
 274  * krb5_free_context() when it is no longer being used.
 275  *
 276  * @param context pointer to returned context
 277  *
 278  * @return Returns 0 to indicate success.  Otherwise an errno code is
 279  * returned.  Failure means either that something bad happened during
 280  * initialization (typically ENOMEM) or that Kerberos should not be
 281  * used ENXIO.
 282  *
 283  * @ingroup krb5
 284  */
 285
 286 krb5_error_code KRB5_LIB_FUNCTION
 287 krb5_init_context(krb5_context *context)
 288 {
 289     krb5_context p;
 290     krb5_error_code ret;
 291     char **files;
 292
 293     *context = NULL;
 294
 295     /* should have a run_once */
 296     bindtextdomain(HEIMDAL_TEXTDOMAIN, HEIMDAL_LOCALEDIR);
 297
 298     p = calloc(1, sizeof(*p));
 299     if(!p)
 300         return ENOMEM;
 301
 302     p->mutex = malloc(sizeof(HEIMDAL_MUTEX));
 303     if (p->mutex == NULL) {
 304         free(p);
 305         return ENOMEM;
 306     }
 307     HEIMDAL_MUTEX_init(p->mutex);
 308
 309     p->flags |= KRB5_CTX_F_HOMEDIR_ACCESS;
 310
 311     ret = krb5_get_default_config_files(&files);
 312     if(ret)
 313         goto out;
 314     ret = krb5_set_config_files(p, files);
 315     krb5_free_config_files(files);
 316     if(ret)
 317         goto out;
 318
 319     /* init error tables */
 320     krb5_init_ets(p);
 321     cc_ops_register(p);
 322     kt_ops_register(p);
 323
 324 out:
 325     if(ret) {
 326         krb5_free_context(p);
 327         p = NULL;
 328     }
 329     *context = p;
 330     return ret;
 331 }
 332
 333 /**
 334  * Make a copy for the Kerberos 5 context, allocated krb5_contex shoud
 335  * be freed with krb5_free_context().
 336  *
 337  * @param context the Kerberos context to copy
 338  * @param out the copy of the Kerberos, set to NULL error.
 339  *
 340  * @return Returns 0 to indicate success.  Otherwise an kerberos et
 341  * error code is returned, see krb5_get_error_message().
 342  *
 343  * @ingroup krb5
 344  */
 345
 346 krb5_error_code KRB5_LIB_FUNCTION
 347 krb5_copy_context(krb5_context context, krb5_context *out)
 348 {
 349     krb5_error_code ret;
 350     krb5_context p;
 351
 352     *out = NULL;
 353
 354     p = calloc(1, sizeof(*p));
 355     if (p == NULL) {
 356         krb5_set_error_message(context, ENOMEM, N_("malloc: out of memory", ""));
 357         return ENOMEM;
 358     }
 359
 360     p->mutex = malloc(sizeof(HEIMDAL_MUTEX));
 361     if (p->mutex == NULL) {
 362         krb5_set_error_message(context, ENOMEM, N_("malloc: out of memory", ""));
 363         free(p);
 364         return ENOMEM;
 365     }
 366     HEIMDAL_MUTEX_init(p->mutex);
 367
 368
 369     if (context->default_cc_name)
 370         p->default_cc_name = strdup(context->default_cc_name);
 371     if (context->default_cc_name_env)
 372         p->default_cc_name_env = strdup(context->default_cc_name_env);
 373
 374     if (context->etypes) {
 375         ret = copy_etypes(context, context->etypes, &p->etypes);
 376         if (ret)
 377             goto out;
 378     }
 379     if (context->etypes_des) {
 380         ret = copy_etypes(context, context->etypes_des, &p->etypes_des);
 381         if (ret)
 382             goto out;
 383     }
 384
 385     if (context->default_realms) {
 386         ret = krb5_copy_host_realm(context,
 387                                    context->default_realms, &p->default_realms);
 388         if (ret)
 389             goto out;
 390     }
 391
 392     ret = _krb5_config_copy(context, context->cf, &p->cf);
 393     if (ret)
 394         goto out;
 395
 396     /* XXX should copy */
 397     krb5_init_ets(p);
 398     cc_ops_register(p);
 399     kt_ops_register(p);
 400
 401 #if 0 /* XXX */
 402     if(context->warn_dest != NULL)
 403         ;
 404 #endif
 405
 406     ret = krb5_set_extra_addresses(p, context->extra_addresses);
 407     if (ret)
 408         goto out;
 409     ret = krb5_set_extra_addresses(p, context->ignore_addresses);
 410     if (ret)
 411         goto out;
 412
 413     ret = _krb5_copy_send_to_kdc_func(p, context);
 414     if (ret)
 415         goto out;
 416
 417     *out = p;
 418
 419     return 0;
 420
 421  out:
 422     krb5_free_context(p);
 423     return ret;
 424 }
 425
 426 /**
 427  * Frees the krb5_context allocated by krb5_init_context().
 428  *
 429  * @param context context to be freed.
 430  *
 431  * @ingroup krb5
 432  */
 433
 434 void KRB5_LIB_FUNCTION
 435 krb5_free_context(krb5_context context)
 436 {
 437     if (context->default_cc_name)
 438         free(context->default_cc_name);
 439     if (context->default_cc_name_env)
 440         free(context->default_cc_name_env);
 441     free(context->etypes);
 442     free(context->etypes_des);
 443     krb5_free_host_realm (context, context->default_realms);
 444     krb5_config_file_free (context, context->cf);
 445     free_error_table (context->et_list);
 446     free(context->cc_ops);
 447     free(context->kt_types);
 448     krb5_clear_error_message(context);
 449     if(context->warn_dest != NULL)
 450         krb5_closelog(context, context->warn_dest);
 451     krb5_set_extra_addresses(context, NULL);
 452     krb5_set_ignore_addresses(context, NULL);
 453     krb5_set_send_to_kdc_func(context, NULL, NULL);
 454
 455     HEIMDAL_MUTEX_destroy(context->mutex);
 456     free(context->mutex);
 457
 458     memset(context, 0, sizeof(*context));
 459     free(context);
 460 }
 461
 462 /**
 463  * Reinit the context from a new set of filenames.
 464  *
 465  * @param context context to add configuration too.
 466  * @param filenames array of filenames, end of list is indicated with a NULL filename.
 467  *
 468  * @return Returns 0 to indicate success.  Otherwise an kerberos et
 469  * error code is returned, see krb5_get_error_message().
 470  *
 471  * @ingroup krb5
 472  */
 473
 474 krb5_error_code KRB5_LIB_FUNCTION
 475 krb5_set_config_files(krb5_context context, char **filenames)
 476 {
 477     krb5_error_code ret;
 478     krb5_config_binding *tmp = NULL;
 479     while(filenames != NULL && *filenames != NULL && **filenames != '\0') {
 480         ret = krb5_config_parse_file_multi(context, *filenames, &tmp);
 481         if(ret != 0 && ret != ENOENT && ret != EACCES) {
 482             krb5_config_file_free(context, tmp);
 483             return ret;
 484         }
 485         filenames++;
 486     }
 487 #if 0
 488     /* with this enabled and if there are no config files, Kerberos is
 489        considererd disabled */
 490     if(tmp == NULL)
 491         return ENXIO;
 492 #endif
 493     krb5_config_file_free(context, context->cf);
 494     context->cf = tmp;
 495     ret = init_context_from_config_file(context);
 496     return ret;
 497 }
 498
 499 static krb5_error_code
 500 add_file(char ***pfilenames, int *len, char *file)
 501 {
 502     char **pp = *pfilenames;
 503     int i;
 504
 505     for(i = 0; i < *len; i++) {
 506         if(strcmp(pp[i], file) == 0) {
 507             free(file);
 508             return 0;
 509         }
 510     }
 511
 512     pp = realloc(*pfilenames, (*len + 2) * sizeof(*pp));
 513     if (pp == NULL) {
 514         free(file);
 515         return ENOMEM;
 516     }
 517
 518     pp[*len] = file;
 519     pp[*len + 1] = NULL;
 520     *pfilenames = pp;
 521     *len += 1;
 522     return 0;
 523 }
 524
 525 /*
 526  *  `pq' isn't free, it's up the the caller
 527  */
 528
 529 krb5_error_code KRB5_LIB_FUNCTION
 530 krb5_prepend_config_files(const char *filelist, char **pq, char ***ret_pp)
 531 {
 532     krb5_error_code ret;
 533     const char *p, *q;
 534     char **pp;
 535     int len;
 536     char *fn;
 537
 538     pp = NULL;
 539
 540     len = 0;
 541     p = filelist;
 542     while(1) {
 543         ssize_t l;
 544         q = p;
 545         l = strsep_copy(&q, ":", NULL, 0);
 546         if(l == -1)
 547             break;
 548         fn = malloc(l + 1);
 549         if(fn == NULL) {
 550             krb5_free_config_files(pp);
 551             return ENOMEM;
 552         }
 553         (void)strsep_copy(&p, ":", fn, l + 1);
 554         ret = add_file(&pp, &len, fn);
 555         if (ret) {
 556             krb5_free_config_files(pp);
 557             return ret;
 558         }
 559     }
 560
 561     if (pq != NULL) {
 562         int i;
 563
 564         for (i = 0; pq[i] != NULL; i++) {
 565             fn = strdup(pq[i]);
 566             if (fn == NULL) {
 567                 krb5_free_config_files(pp);
 568                 return ENOMEM;
 569             }
 570             ret = add_file(&pp, &len, fn);
 571             if (ret) {
 572                 krb5_free_config_files(pp);
 573                 return ret;
 574             }
 575         }
 576     }
 577
 578     *ret_pp = pp;
 579     return 0;
 580 }
 581
 582 /**
 583  * Prepend the filename to the global configuration list.
 584  *
 585  * @param filelist a filename to add to the default list of filename
 586  * @param pfilenames return array of filenames, should be freed with krb5_free_config_files().
 587  *
 588  * @return Returns 0 to indicate success.  Otherwise an kerberos et
 589  * error code is returned, see krb5_get_error_message().
 590  *
 591  * @ingroup krb5
 592  */
 593
 594 krb5_error_code KRB5_LIB_FUNCTION
 595 krb5_prepend_config_files_default(const char *filelist, char ***pfilenames)
 596 {
 597     krb5_error_code ret;
 598     char **defpp, **pp = NULL;
 599
 600     ret = krb5_get_default_config_files(&defpp);
 601     if (ret)
 602         return ret;
 603
 604     ret = krb5_prepend_config_files(filelist, defpp, &pp);
 605     krb5_free_config_files(defpp);
 606     if (ret) {
 607         return ret;
 608     }
 609     *pfilenames = pp;
 610     return 0;
 611 }
 612
 613 /**
 614  * Get the global configuration list.
 615  *
 616  * @param pfilenames return array of filenames, should be freed with krb5_free_config_files().
 617  *
 618  * @return Returns 0 to indicate success.  Otherwise an kerberos et
 619  * error code is returned, see krb5_get_error_message().
 620  *
 621  * @ingroup krb5
 622  */
 623
 624 krb5_error_code KRB5_LIB_FUNCTION
 625 krb5_get_default_config_files(char ***pfilenames)
 626 {
 627     const char *files = NULL;
 628
 629     if (pfilenames == NULL)
 630         return EINVAL;
 631     if(!issuid())
 632         files = getenv("KRB5_CONFIG");
 633     if (files == NULL)
 634         files = krb5_config_file;
 635
 636     return krb5_prepend_config_files(files, NULL, pfilenames);
 637 }
 638
 639 /**
 640  * Free a list of configuration files.
 641  *
 642  * @param filenames list, terminated with a NULL pointer, to be
 643  * freed. NULL is an valid argument.
 644  *
 645  * @return Returns 0 to indicate success. Otherwise an kerberos et
 646  * error code is returned, see krb5_get_error_message().
 647  *
 648  * @ingroup krb5
 649  */
 650
 651 void KRB5_LIB_FUNCTION
 652 krb5_free_config_files(char **filenames)
 653 {
 654     char **p;
 655     for(p = filenames; p && *p != NULL; p++)
 656         free(*p);
 657     free(filenames);
 658 }
 659
 660 /**
 661  * Returns the list of Kerberos encryption types sorted in order of
 662  * most preferred to least preferred encryption type.  Note that some
 663  * encryption types might be disabled, so you need to check with
 664  * krb5_enctype_valid() before using the encryption type.
 665  *
 666  * @return list of enctypes, terminated with ETYPE_NULL. Its a static
 667  * array completed into the Kerberos library so the content doesn't
 668  * need to be freed.
 669  *
 670  * @ingroup krb5
 671  */
 672
 673 const krb5_enctype * KRB5_LIB_FUNCTION
 674 krb5_kerberos_enctypes(krb5_context context)
 675 {
 676     static const krb5_enctype p[] = {
 677         ETYPE_AES256_CTS_HMAC_SHA1_96,
 678         ETYPE_AES128_CTS_HMAC_SHA1_96,
 679         ETYPE_DES3_CBC_SHA1,
 680         ETYPE_DES3_CBC_MD5,
 681         ETYPE_ARCFOUR_HMAC_MD5,
 682         ETYPE_DES_CBC_MD5,
 683         ETYPE_DES_CBC_MD4,
 684         ETYPE_DES_CBC_CRC,
 685         ETYPE_NULL
 686     };
 687     return p;
 688 }
 689
 690 /*
 691  * set `etype' to a malloced list of the default enctypes
 692  */
 693
 694 static krb5_error_code
 695 default_etypes(krb5_context context, krb5_enctype **etype)
 696 {
 697     const krb5_enctype *p;
 698     krb5_enctype *e = NULL, *ep;
 699     int i, n = 0;
 700
 701     p = krb5_kerberos_enctypes(context);
 702
 703     for (i = 0; p[i] != ETYPE_NULL; i++) {
 704         if (krb5_enctype_valid(context, p[i]) != 0)
 705             continue;
 706         ep = realloc(e, (n + 2) * sizeof(*e));
 707         if (ep == NULL) {
 708             free(e);
 709             krb5_set_error_message (context, ENOMEM, N_("malloc: out of memory", ""));
 710             return ENOMEM;
 711         }
 712         e = ep;
 713         e[n] = p[i];
 714         e[n + 1] = ETYPE_NULL;
 715         n++;
 716     }
 717     *etype = e;
 718     return 0;
 719 }
 720
 721 /**
 722  * Set the default encryption types that will be use in communcation
 723  * with the KDC, clients and servers.
 724  *
 725  * @param context Kerberos 5 context.
 726  * @param etypes Encryption types, array terminated with ETYPE_NULL (0).
 727  *
 728  * @return Returns 0 to indicate success. Otherwise an kerberos et
 729  * error code is returned, see krb5_get_error_message().
 730  *
 731  * @ingroup krb5
 732  */
 733
 734 krb5_error_code KRB5_LIB_FUNCTION
 735 krb5_set_default_in_tkt_etypes(krb5_context context,
 736                                const krb5_enctype *etypes)
 737 {
 738     krb5_enctype *p = NULL;
 739     int i;
 740
 741     if(etypes) {
 742         for (i = 0; etypes[i]; ++i) {
 743             krb5_error_code ret;
 744             ret = krb5_enctype_valid(context, etypes[i]);
 745             if (ret)
 746                 return ret;
 747         }
 748         ++i;
 749         ALLOC(p, i);
 750         if(!p) {
 751             krb5_set_error_message (context, ENOMEM, N_("malloc: out of memory", ""));
 752             return ENOMEM;
 753         }
 754         memmove(p, etypes, i * sizeof(krb5_enctype));
 755     }
 756     if(context->etypes)
 757         free(context->etypes);
 758     context->etypes = p;
 759     return 0;
 760 }
 761
 762 /**
 763  * Get the default encryption types that will be use in communcation
 764  * with the KDC, clients and servers.
 765  *
 766  * @param context Kerberos 5 context.
 767  * @param etypes Encryption types, array terminated with
 768  * ETYPE_NULL(0), caller should free array with krb5_xfree():
 769  *
 770  * @return Returns 0 to indicate success. Otherwise an kerberos et
 771  * error code is returned, see krb5_get_error_message().
 772  *
 773  * @ingroup krb5
 774  */
 775
 776 krb5_error_code KRB5_LIB_FUNCTION
 777 krb5_get_default_in_tkt_etypes(krb5_context context,
 778                                krb5_enctype **etypes)
 779 {
 780     krb5_enctype *p;
 781     int i;
 782     krb5_error_code ret;
 783
 784     if(context->etypes) {
 785         for(i = 0; context->etypes[i]; i++);
 786         ++i;
 787         ALLOC(p, i);
 788         if(!p) {
 789             krb5_set_error_message (context, ENOMEM, N_("malloc: out of memory", ""));
 790             return ENOMEM;
 791         }
 792         memmove(p, context->etypes, i * sizeof(krb5_enctype));
 793     } else {
 794         ret = default_etypes(context, &p);
 795         if (ret)
 796             return ret;
 797     }
 798     *etypes = p;
 799     return 0;
 800 }
 801
 802 /**
 803  * Return the error string for the error code. The caller must not
 804  * free the string.
 805  *
 806  * @param context Kerberos 5 context.
 807  * @param code Kerberos error code.
 808  *
 809  * @return the error message matching code
 810  *
 811  * @ingroup krb5
 812  */
 813
 814 const char* KRB5_LIB_FUNCTION
 815 krb5_get_err_text(krb5_context context, krb5_error_code code)
 816 {
 817     const char *p = NULL;
 818     if(context != NULL)
 819         p = com_right(context->et_list, code);
 820     if(p == NULL)
 821         p = strerror(code);
 822     if (p == NULL)
 823         p = "Unknown error";
 824     return p;
 825 }
 826
 827 /**
 828  * Init the built-in ets in the Kerberos library.
 829  *
 830  * @param context kerberos context to add the ets too
 831  *
 832  * @ingroup krb5
 833  */
 834
 835 void KRB5_LIB_FUNCTION
 836 krb5_init_ets(krb5_context context)
 837 {
 838     if(context->et_list == NULL){
 839         krb5_add_et_list(context, initialize_krb5_error_table_r);
 840         bindtextdomain(COM_ERR_BINDDOMAIN_krb5, HEIMDAL_LOCALEDIR);
 841
 842         krb5_add_et_list(context, initialize_asn1_error_table_r);
 843         bindtextdomain(COM_ERR_BINDDOMAIN_asn1, HEIMDAL_LOCALEDIR);
 844
 845         krb5_add_et_list(context, initialize_heim_error_table_r);
 846         bindtextdomain(COM_ERR_BINDDOMAIN_heim, HEIMDAL_LOCALEDIR);
 847
 848         krb5_add_et_list(context, initialize_k524_error_table_r);
 849         bindtextdomain(COM_ERR_BINDDOMAIN_k524, HEIMDAL_LOCALEDIR);
 850
 851 #ifdef PKINIT
 852         krb5_add_et_list(context, initialize_hx_error_table_r);
 853         bindtextdomain(COM_ERR_BINDDOMAIN_hx, HEIMDAL_LOCALEDIR);
 854 #endif
 855     }
 856 }
 857
 858 /**
 859  * Make the kerberos library default to the admin KDC.
 860  *
 861  * @param context Kerberos 5 context.
 862  * @param flag boolean flag to select if the use the admin KDC or not.
 863  *
 864  * @ingroup krb5
 865  */
 866
 867 void KRB5_LIB_FUNCTION
 868 krb5_set_use_admin_kdc (krb5_context context, krb5_boolean flag)
 869 {
 870     context->use_admin_kdc = flag;
 871 }
 872
 873 /**
 874  * Make the kerberos library default to the admin KDC.
 875  *
 876  * @param context Kerberos 5 context.
 877  *
 878  * @return boolean flag to telling the context will use admin KDC as the default KDC.
 879  *
 880  * @ingroup krb5
 881  */
 882
 883 krb5_boolean KRB5_LIB_FUNCTION
 884 krb5_get_use_admin_kdc (krb5_context context)
 885 {
 886     return context->use_admin_kdc;
 887 }
 888
 889 /**
 890  * Add extra address to the address list that the library will add to
 891  * the client's address list when communicating with the KDC.
 892  *
 893  * @param context Kerberos 5 context.
 894  * @param addresses addreses to add
 895  *
 896  * @return Returns 0 to indicate success. Otherwise an kerberos et
 897  * error code is returned, see krb5_get_error_message().
 898  *
 899  * @ingroup krb5
 900  */
 901
 902 krb5_error_code KRB5_LIB_FUNCTION
 903 krb5_add_extra_addresses(krb5_context context, krb5_addresses *addresses)
 904 {
 905
 906     if(context->extra_addresses)
 907         return krb5_append_addresses(context,
 908                                      context->extra_addresses, addresses);
 909     else
 910         return krb5_set_extra_addresses(context, addresses);
 911 }
 912
 913 /**
 914  * Set extra address to the address list that the library will add to
 915  * the client's address list when communicating with the KDC.
 916  *
 917  * @param context Kerberos 5 context.
 918  * @param addresses addreses to set
 919  *
 920  * @return Returns 0 to indicate success. Otherwise an kerberos et
 921  * error code is returned, see krb5_get_error_message().
 922  *
 923  * @ingroup krb5
 924  */
 925
 926 krb5_error_code KRB5_LIB_FUNCTION
 927 krb5_set_extra_addresses(krb5_context context, const krb5_addresses *addresses)
 928 {
 929     if(context->extra_addresses)
 930         krb5_free_addresses(context, context->extra_addresses);
 931
 932     if(addresses == NULL) {
 933         if(context->extra_addresses != NULL) {
 934             free(context->extra_addresses);
 935             context->extra_addresses = NULL;
 936         }
 937         return 0;
 938     }
 939     if(context->extra_addresses == NULL) {
 940         context->extra_addresses = malloc(sizeof(*context->extra_addresses));
 941         if(context->extra_addresses == NULL) {
 942             krb5_set_error_message (context, ENOMEM, N_("malloc: out of memory", ""));
 943             return ENOMEM;
 944         }
 945     }
 946     return krb5_copy_addresses(context, addresses, context->extra_addresses);
 947 }
 948
 949 /**
 950  * Get extra address to the address list that the library will add to
 951  * the client's address list when communicating with the KDC.
 952  *
 953  * @param context Kerberos 5 context.
 954  * @param addresses addreses to set
 955  *
 956  * @return Returns 0 to indicate success. Otherwise an kerberos et
 957  * error code is returned, see krb5_get_error_message().
 958  *
 959  * @ingroup krb5
 960  */
 961
 962 krb5_error_code KRB5_LIB_FUNCTION
 963 krb5_get_extra_addresses(krb5_context context, krb5_addresses *addresses)
 964 {
 965     if(context->extra_addresses == NULL) {
 966         memset(addresses, 0, sizeof(*addresses));
 967         return 0;
 968     }
 969     return krb5_copy_addresses(context,context->extra_addresses, addresses);
 970 }
 971
 972 /**
 973  * Add extra addresses to ignore when fetching addresses from the
 974  * underlaying operating system.
 975  *
 976  * @param context Kerberos 5 context.
 977  * @param addresses addreses to ignore
 978  *
 979  * @return Returns 0 to indicate success. Otherwise an kerberos et
 980  * error code is returned, see krb5_get_error_message().
 981  *
 982  * @ingroup krb5
 983  */
 984
 985 krb5_error_code KRB5_LIB_FUNCTION
 986 krb5_add_ignore_addresses(krb5_context context, krb5_addresses *addresses)
 987 {
 988
 989     if(context->ignore_addresses)
 990         return krb5_append_addresses(context,
 991                                      context->ignore_addresses, addresses);
 992     else
 993         return krb5_set_ignore_addresses(context, addresses);
 994 }
 995
 996 /**
 997  * Set extra addresses to ignore when fetching addresses from the
 998  * underlaying operating system.
 999  *
1000  * @param context Kerberos 5 context.
1001  * @param addresses addreses to ignore
1002  *
1003  * @return Returns 0 to indicate success. Otherwise an kerberos et
1004  * error code is returned, see krb5_get_error_message().
1005  *
1006  * @ingroup krb5
1007  */
1008
1009 krb5_error_code KRB5_LIB_FUNCTION
1010 krb5_set_ignore_addresses(krb5_context context, const krb5_addresses *addresses)
1011 {
1012     if(context->ignore_addresses)
1013         krb5_free_addresses(context, context->ignore_addresses);
1014     if(addresses == NULL) {
1015         if(context->ignore_addresses != NULL) {
1016             free(context->ignore_addresses);
1017             context->ignore_addresses = NULL;
1018         }
1019         return 0;
1020     }
1021     if(context->ignore_addresses == NULL) {
1022         context->ignore_addresses = malloc(sizeof(*context->ignore_addresses));
1023         if(context->ignore_addresses == NULL) {
1024             krb5_set_error_message (context, ENOMEM, N_("malloc: out of memory", ""));
1025             return ENOMEM;
1026         }
1027     }
1028     return krb5_copy_addresses(context, addresses, context->ignore_addresses);
1029 }
1030
1031 /**
1032  * Get extra addresses to ignore when fetching addresses from the
1033  * underlaying operating system.
1034  *
1035  * @param context Kerberos 5 context.
1036  * @param addresses list addreses ignored
1037  *
1038  * @return Returns 0 to indicate success. Otherwise an kerberos et
1039  * error code is returned, see krb5_get_error_message().
1040  *
1041  * @ingroup krb5
1042  */
1043
1044 krb5_error_code KRB5_LIB_FUNCTION
1045 krb5_get_ignore_addresses(krb5_context context, krb5_addresses *addresses)
1046 {
1047     if(context->ignore_addresses == NULL) {
1048         memset(addresses, 0, sizeof(*addresses));
1049         return 0;
1050     }
1051     return krb5_copy_addresses(context, context->ignore_addresses, addresses);
1052 }
1053
1054 /**
1055  * Set version of fcache that the library should use.
1056  *
1057  * @param context Kerberos 5 context.
1058  * @param version version number.
1059  *
1060  * @return Returns 0 to indicate success. Otherwise an kerberos et
1061  * error code is returned, see krb5_get_error_message().
1062  *
1063  * @ingroup krb5
1064  */
1065
1066 krb5_error_code KRB5_LIB_FUNCTION
1067 krb5_set_fcache_version(krb5_context context, int version)
1068 {
1069     context->fcache_vno = version;
1070     return 0;
1071 }
1072
1073 /**
1074  * Get version of fcache that the library should use.
1075  *
1076  * @param context Kerberos 5 context.
1077  * @param version version number.
1078  *
1079  * @return Returns 0 to indicate success. Otherwise an kerberos et
1080  * error code is returned, see krb5_get_error_message().
1081  *
1082  * @ingroup krb5
1083  */
1084
1085 krb5_error_code KRB5_LIB_FUNCTION
1086 krb5_get_fcache_version(krb5_context context, int *version)
1087 {
1088     *version = context->fcache_vno;
1089     return 0;
1090 }
1091
1092 /**
1093  * Runtime check if the Kerberos library was complied with thread support.
1094  *
1095  * @return TRUE if the library was compiled with thread support, FALSE if not.
1096  *
1097  * @ingroup krb5
1098  */
1099
1100
1101 krb5_boolean KRB5_LIB_FUNCTION
1102 krb5_is_thread_safe(void)
1103 {
1104 #ifdef ENABLE_PTHREAD_SUPPORT
1105     return TRUE;
1106 #else
1107     return FALSE;
1108 #endif
1109 }
1110
1111 /**
1112  * Set if the library should use DNS to canonicalize hostnames.
1113  *
1114  * @param context Kerberos 5 context.
1115  * @param flag if its dns canonicalizion is used or not.
1116  *
1117  * @ingroup krb5
1118  */
1119
1120 void KRB5_LIB_FUNCTION
1121 krb5_set_dns_canonicalize_hostname (krb5_context context, krb5_boolean flag)
1122 {
1123     if (flag)
1124         context->flags |= KRB5_CTX_F_DNS_CANONICALIZE_HOSTNAME;
1125     else
1126         context->flags &= ~KRB5_CTX_F_DNS_CANONICALIZE_HOSTNAME;
1127 }
1128
1129 /**
1130  * Get if the library uses DNS to canonicalize hostnames.
1131  *
1132  * @param context Kerberos 5 context.
1133  *
1134  * @return return non zero if the library uses DNS to canonicalize hostnames.
1135  *
1136  * @ingroup krb5
1137  */
1138
1139 krb5_boolean KRB5_LIB_FUNCTION
1140 krb5_get_dns_canonicalize_hostname (krb5_context context)
1141 {
1142     return (context->flags & KRB5_CTX_F_DNS_CANONICALIZE_HOSTNAME) ? 1 : 0;
1143 }
1144
1145 /**
1146  * Get current offset in time to the KDC.
1147  *
1148  * @param context Kerberos 5 context.
1149  * @param sec seconds part of offset.
1150  * @param usec micro seconds part of offset.
1151  *
1152  * @return returns zero
1153  *
1154  * @ingroup krb5
1155  */
1156
1157 krb5_error_code KRB5_LIB_FUNCTION
1158 krb5_get_kdc_sec_offset (krb5_context context, int32_t *sec, int32_t *usec)
1159 {
1160     if (sec)
1161         *sec = context->kdc_sec_offset;
1162     if (usec)
1163         *usec = context->kdc_usec_offset;
1164     return 0;
1165 }
1166
1167 /**
1168  * Set current offset in time to the KDC.
1169  *
1170  * @param context Kerberos 5 context.
1171  * @param sec seconds part of offset.
1172  * @param usec micro seconds part of offset.
1173  *
1174  * @return returns zero
1175  *
1176  * @ingroup krb5
1177  */
1178
1179 krb5_error_code KRB5_LIB_FUNCTION
1180 krb5_set_kdc_sec_offset (krb5_context context, int32_t sec, int32_t usec)
1181 {
1182     context->kdc_sec_offset = sec;
1183     if (usec >= 0)
1184         context->kdc_usec_offset = usec;
1185     return 0;
1186 }
1187
1188 /**
1189  * Get max time skew allowed.
1190  *
1191  * @param context Kerberos 5 context.
1192  *
1193  * @return timeskew in seconds.
1194  *
1195  * @ingroup krb5
1196  */
1197
1198 time_t KRB5_LIB_FUNCTION
1199 krb5_get_max_time_skew (krb5_context context)
1200 {
1201     return context->max_skew;
1202 }
1203
1204 /**
1205  * Set max time skew allowed.
1206  *
1207  * @param context Kerberos 5 context.
1208  * @param t timeskew in seconds.
1209  *
1210  * @ingroup krb5
1211  */
1212
1213 void KRB5_LIB_FUNCTION
1214 krb5_set_max_time_skew (krb5_context context, time_t t)
1215 {
1216     context->max_skew = t;
1217 }
1218
1219 /**
1220  * Init encryption types in len, val with etypes.
1221  *
1222  * @param context Kerberos 5 context.
1223  * @param len output length of val.
1224  * @param val output array of enctypes.
1225  * @param etypes etypes to set val and len to, if NULL, use default enctypes.
1226
1227  * @return Returns 0 to indicate success. Otherwise an kerberos et
1228  * error code is returned, see krb5_get_error_message().
1229  *
1230  * @ingroup krb5
1231  */
1232
1233 krb5_error_code KRB5_LIB_FUNCTION
1234 krb5_init_etype (krb5_context context,
1235                  unsigned *len,
1236                  krb5_enctype **val,
1237                  const krb5_enctype *etypes)
1238 {
1239     unsigned int i;
1240     krb5_error_code ret;
1241     krb5_enctype *tmp = NULL;
1242
1243     ret = 0;
1244     if (etypes == NULL) {
1245         ret = krb5_get_default_in_tkt_etypes(context, &tmp);
1246         if (ret)
1247             return ret;
1248         etypes = tmp;
1249     }
1250
1251     for (i = 0; etypes[i]; ++i)
1252         ;
1253     *len = i;
1254     *val = malloc(i * sizeof(**val));
1255     if (i != 0 && *val == NULL) {
1256         ret = ENOMEM;
1257         krb5_set_error_message(context, ret, N_("malloc: out of memory", ""));
1258         goto cleanup;
1259     }
1260     memmove (*val,
1261              etypes,
1262              i * sizeof(*tmp));
1263 cleanup:
1264     if (tmp != NULL)
1265         free (tmp);
1266     return ret;
1267 }
1268
1269 /*
1270  * Allow homedir accces
1271  */
1272
1273 static HEIMDAL_MUTEX homedir_mutex = HEIMDAL_MUTEX_INITIALIZER;
1274 static krb5_boolean allow_homedir = TRUE;
1275
1276 krb5_boolean
1277 _krb5_homedir_access(krb5_context context)
1278 {
1279     krb5_boolean allow;
1280
1281     /* is never allowed for root */
1282     if (geteuid() == 0)
1283         return FALSE;
1284
1285     if (context && (context->flags & KRB5_CTX_F_HOMEDIR_ACCESS) == 0)
1286         return FALSE;
1287
1288     HEIMDAL_MUTEX_lock(&homedir_mutex);
1289     allow = allow_homedir;
1290     HEIMDAL_MUTEX_unlock(&homedir_mutex);
1291     return allow;
1292 }
1293
1294 /**
1295  * Enable and disable home directory access on either the global state
1296  * or the krb5_context state. By calling krb5_set_home_dir_access()
1297  * with context set to NULL, the global state is configured otherwise
1298  * the state for the krb5_context is modified.
1299  *
1300  * For home directory access to be allowed, both the global state and
1301  * the krb5_context state have to be allowed.
1302  *
1303  * Administrator (root user), never uses the home directory.
1304  *
1305  * @param context a Kerberos 5 context or NULL
1306  * @param allow allow if TRUE home directory
1307  * @return the old value
1308  *
1309  */
1310
1311 krb5_boolean
1312 krb5_set_home_dir_access(krb5_context context, krb5_boolean allow)
1313 {
1314     krb5_boolean old;
1315     if (context) {
1316         old = (context->flags & KRB5_CTX_F_HOMEDIR_ACCESS) ? TRUE : FALSE;
1317         if (allow)
1318             context->flags |= KRB5_CTX_F_HOMEDIR_ACCESS;
1319         else
1320             context->flags &= ~KRB5_CTX_F_HOMEDIR_ACCESS;
1321     } else {
1322         HEIMDAL_MUTEX_lock(&homedir_mutex);
1323         old = allow_homedir;
1324         allow_homedir = allow;
1325         HEIMDAL_MUTEX_unlock(&homedir_mutex);
1326     }
1327
1328     return old;
1329 }