kdc/kdc.h

   1 /*
   2  * Copyright (c) 1997-2022 Kungliga Tekniska Högskolan
   3  * (Royal Institute of Technology, Stockholm, Sweden).
   4  *
   5  * Copyright (c) 2005 Andrew Bartlett <abartlet@samba.org>
   6  *
   7  * All rights reserved.
   8  *
   9  * Redistribution and use in source and binary forms, with or without
  10  * modification, are permitted provided that the following conditions
  11  * are met:
  12  *
  13  * 1. Redistributions of source code must retain the above copyright
  14  *    notice, this list of conditions and the following disclaimer.
  15  *
  16  * 2. Redistributions in binary form must reproduce the above copyright
  17  *    notice, this list of conditions and the following disclaimer in the
  18  *    documentation and/or other materials provided with the distribution.
  19  *
  20  * 3. Neither the name of the Institute nor the names of its contributors
  21  *    may be used to endorse or promote products derived from this software
  22  *    without specific prior written permission.
  23  *
  24  * THIS SOFTWARE IS PROVIDED BY THE INSTITUTE AND CONTRIBUTORS ``AS IS'' AND
  25  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  26  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  27  * ARE DISCLAIMED.  IN NO EVENT SHALL THE INSTITUTE OR CONTRIBUTORS BE LIABLE
  28  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  29  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  30  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  31  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  32  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  33  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  34  * SUCH DAMAGE.
  35  */
  36
  37 /*
  38  * $Id$
  39  */
  40
  41 #ifndef __KDC_H__
  42 #define __KDC_H__
  43
  44 #include <hdb.h>
  45 #include <krb5.h>
  46 #include <kx509_asn1.h>
  47 #include <gssapi/gssapi.h>
  48
  49 enum krb5_kdc_trpolicy {
  50     TRPOLICY_ALWAYS_CHECK,
  51     TRPOLICY_ALLOW_PER_PRINCIPAL,
  52     TRPOLICY_ALWAYS_HONOUR_REQUEST
  53 };
  54
  55 struct krb5_kdc_configuration;
  56 typedef struct krb5_kdc_configuration krb5_kdc_configuration;
  57
  58 /*
  59  * Access to request fields by plugins and other out-of-tree
  60  * consumers should be via the functions in kdc-accessors.h.
  61  */
  62
  63 struct kdc_request_desc;
  64 typedef struct kdc_request_desc *kdc_request_t;
  65
  66 struct astgs_request_desc;
  67 typedef struct astgs_request_desc *astgs_request_t;
  68
  69 struct kx509_req_context_desc;
  70 typedef struct kx509_req_context_desc *kx509_req_context;
  71
  72 struct krb5_kdc_service {
  73     unsigned int flags;
  74 #define KS_KRB5         1
  75 #define KS_NO_LENGTH    2
  76     const char *name;
  77     krb5_error_code (*process)(kdc_request_t *, int *claim);
  78 };
  79
  80 /*
  81  * The following fields are guaranteed stable within a major
  82  * release of Heimdal and can be manipulated by applications
  83  * that manage KDC requests themselves using libkdc.
  84  *
  85  * Applications can make custom KDC configuration available
  86  * to libkdc by using krb5_set_config().
  87  */
  88
  89 #define KRB5_KDC_CONFIGURATION_COMMON_ELEMENTS                  \
  90     krb5_log_facility *logf;                                    \
  91     struct HDB **db;                                            \
  92     size_t num_db;                                              \
  93     const char *app
  94
  95 #ifndef __KDC_LOCL_H__
  96 struct krb5_kdc_configuration {
  97     KRB5_KDC_CONFIGURATION_COMMON_ELEMENTS;
  98 };
  99 #endif
 100
 101 #include <kdc-protos.h>
 102
 103 #endif /* __KDC_H__ */