1/* $NetBSD$ */ 2 3/* 4 * Copyright (c) 1997-2000 Kungliga Tekniska H��gskolan 5 * (Royal Institute of Technology, Stockholm, Sweden). 6 * All rights reserved. 7 * 8 * Redistribution and use in source and binary forms, with or without 9 * modification, are permitted provided that the following conditions 10 * are met: 11 * 12 * 1. Redistributions of source code must retain the above copyright 13 * notice, this list of conditions and the following disclaimer. 14 * 15 * 2. Redistributions in binary form must reproduce the above copyright 16 * notice, this list of conditions and the following disclaimer in the 17 * documentation and/or other materials provided with the distribution. 18 * 19 * 3. Neither the name of the Institute nor the names of its contributors 20 * may be used to endorse or promote products derived from this software 21 * without specific prior written permission. 22 * 23 * THIS SOFTWARE IS PROVIDED BY THE INSTITUTE AND CONTRIBUTORS ``AS IS'' AND 24 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 25 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 26 * ARE DISCLAIMED. IN NO EVENT SHALL THE INSTITUTE OR CONTRIBUTORS BE LIABLE 27 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 28 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 29 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 30 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 31 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 32 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 33 * SUCH DAMAGE. 34 */ 35/* Id */ 36 37#ifndef __KADM5_ADMIN_H__ 38#define __KADM5_ADMIN_H__ 39 40#define KADM5_API_VERSION_1 1 41#define KADM5_API_VERSION_2 2 42 43#ifndef USE_KADM5_API_VERSION 44#define USE_KADM5_API_VERSION KADM5_API_VERSION_2 45#endif 46 47#if USE_KADM5_API_VERSION != KADM5_API_VERSION_2 48#error No support for API versions other than 2 49#endif 50 51#define KADM5_STRUCT_VERSION 0 52 53#include <krb5/krb5.h> 54 55#define KRB5_KDB_DISALLOW_POSTDATED 0x00000001 56#define KRB5_KDB_DISALLOW_FORWARDABLE 0x00000002 57#define KRB5_KDB_DISALLOW_TGT_BASED 0x00000004 58#define KRB5_KDB_DISALLOW_RENEWABLE 0x00000008 59#define KRB5_KDB_DISALLOW_PROXIABLE 0x00000010 60#define KRB5_KDB_DISALLOW_DUP_SKEY 0x00000020 61#define KRB5_KDB_DISALLOW_ALL_TIX 0x00000040 62#define KRB5_KDB_REQUIRES_PRE_AUTH 0x00000080 63#define KRB5_KDB_REQUIRES_HW_AUTH 0x00000100 64#define KRB5_KDB_REQUIRES_PWCHANGE 0x00000200 65#define KRB5_KDB_DISALLOW_SVR 0x00001000 66#define KRB5_KDB_PWCHANGE_SERVICE 0x00002000 67#define KRB5_KDB_SUPPORT_DESMD5 0x00004000 68#define KRB5_KDB_NEW_PRINC 0x00008000 69#define KRB5_KDB_OK_AS_DELEGATE 0x00010000 70#define KRB5_KDB_TRUSTED_FOR_DELEGATION 0x00020000 71#define KRB5_KDB_ALLOW_KERBEROS4 0x00040000 72#define KRB5_KDB_ALLOW_DIGEST 0x00080000 73 74#define KADM5_PRINCIPAL 0x000001 75#define KADM5_PRINC_EXPIRE_TIME 0x000002 76#define KADM5_PW_EXPIRATION 0x000004 77#define KADM5_LAST_PWD_CHANGE 0x000008 78#define KADM5_ATTRIBUTES 0x000010 79#define KADM5_MAX_LIFE 0x000020 80#define KADM5_MOD_TIME 0x000040 81#define KADM5_MOD_NAME 0x000080 82#define KADM5_KVNO 0x000100 83#define KADM5_MKVNO 0x000200 84#define KADM5_AUX_ATTRIBUTES 0x000400 85#define KADM5_POLICY 0x000800 86#define KADM5_POLICY_CLR 0x001000 87#define KADM5_MAX_RLIFE 0x002000 88#define KADM5_LAST_SUCCESS 0x004000 89#define KADM5_LAST_FAILED 0x008000 90#define KADM5_FAIL_AUTH_COUNT 0x010000 91#define KADM5_KEY_DATA 0x020000 92#define KADM5_TL_DATA 0x040000 93 94#define KADM5_PRINCIPAL_NORMAL_MASK (~(KADM5_KEY_DATA | KADM5_TL_DATA)) 95 96#define KADM5_PW_MAX_LIFE 0x004000 97#define KADM5_PW_MIN_LIFE 0x008000 98#define KADM5_PW_MIN_LENGTH 0x010000 99#define KADM5_PW_MIN_CLASSES 0x020000 100#define KADM5_PW_HISTORY_NUM 0x040000 101#define KADM5_REF_COUNT 0x080000 102 103#define KADM5_POLICY_NORMAL_MASK (~0) 104 105#define KADM5_ADMIN_SERVICE "kadmin/admin" 106#define KADM5_HIST_PRINCIPAL "kadmin/history" 107#define KADM5_CHANGEPW_SERVICE "kadmin/changepw" 108 109typedef struct { 110 int16_t key_data_ver; /* Version */ 111 int16_t key_data_kvno; /* Key Version */ 112 int16_t key_data_type[2]; /* Array of types */ 113 int16_t key_data_length[2]; /* Array of lengths */ 114 void* key_data_contents[2];/* Array of pointers */ 115} krb5_key_data; 116 117typedef struct _krb5_tl_data { 118 struct _krb5_tl_data* tl_data_next; 119 int16_t tl_data_type; 120 int16_t tl_data_length; 121 void* tl_data_contents; 122} krb5_tl_data; 123 124#define KRB5_TL_LAST_PWD_CHANGE 0x0001 125#define KRB5_TL_MOD_PRINC 0x0002 126#define KRB5_TL_KADM_DATA 0x0003 127#define KRB5_TL_KADM5_E_DATA 0x0004 128#define KRB5_TL_RB1_CHALLENGE 0x0005 129#define KRB5_TL_SECURID_STATE 0x0006 130#define KRB5_TL_PASSWORD 0x0007 131#define KRB5_TL_EXTENSION 0x0008 132#define KRB5_TL_PKINIT_ACL 0x0009 133#define KRB5_TL_ALIASES 0x000a 134 135typedef struct _kadm5_principal_ent_t { 136 krb5_principal principal; 137 138 krb5_timestamp princ_expire_time; 139 krb5_timestamp last_pwd_change; 140 krb5_timestamp pw_expiration; 141 krb5_deltat max_life; 142 krb5_principal mod_name; 143 krb5_timestamp mod_date; 144 krb5_flags attributes; 145 krb5_kvno kvno; 146 krb5_kvno mkvno; 147 148 char * policy; 149 uint32_t aux_attributes; 150 151 krb5_deltat max_renewable_life; 152 krb5_timestamp last_success; 153 krb5_timestamp last_failed; 154 krb5_kvno fail_auth_count; 155 int16_t n_key_data; 156 int16_t n_tl_data; 157 krb5_tl_data *tl_data; 158 krb5_key_data *key_data; 159} kadm5_principal_ent_rec, *kadm5_principal_ent_t; 160 161typedef struct _kadm5_policy_ent_t { 162 char *policy; 163 164 uint32_t pw_min_life; 165 uint32_t pw_max_life; 166 uint32_t pw_min_length; 167 uint32_t pw_min_classes; 168 uint32_t pw_history_num; 169 uint32_t policy_refcnt; 170} kadm5_policy_ent_rec, *kadm5_policy_ent_t; 171 172#define KADM5_CONFIG_REALM (1 << 0) 173#define KADM5_CONFIG_PROFILE (1 << 1) 174#define KADM5_CONFIG_KADMIND_PORT (1 << 2) 175#define KADM5_CONFIG_ADMIN_SERVER (1 << 3) 176#define KADM5_CONFIG_DBNAME (1 << 4) 177#define KADM5_CONFIG_ADBNAME (1 << 5) 178#define KADM5_CONFIG_ADB_LOCKFILE (1 << 6) 179#define KADM5_CONFIG_ACL_FILE (1 << 7) 180#define KADM5_CONFIG_DICT_FILE (1 << 8) 181#define KADM5_CONFIG_ADMIN_KEYTAB (1 << 9) 182#define KADM5_CONFIG_MKEY_FROM_KEYBOARD (1 << 10) 183#define KADM5_CONFIG_STASH_FILE (1 << 11) 184#define KADM5_CONFIG_MKEY_NAME (1 << 12) 185#define KADM5_CONFIG_ENCTYPE (1 << 13) 186#define KADM5_CONFIG_MAX_LIFE (1 << 14) 187#define KADM5_CONFIG_MAX_RLIFE (1 << 15) 188#define KADM5_CONFIG_EXPIRATION (1 << 16) 189#define KADM5_CONFIG_FLAGS (1 << 17) 190#define KADM5_CONFIG_ENCTYPES (1 << 18) 191 192#define KADM5_PRIV_GET (1 << 0) 193#define KADM5_PRIV_ADD (1 << 1) 194#define KADM5_PRIV_MODIFY (1 << 2) 195#define KADM5_PRIV_DELETE (1 << 3) 196#define KADM5_PRIV_LIST (1 << 4) 197#define KADM5_PRIV_CPW (1 << 5) 198#define KADM5_PRIV_ALL (KADM5_PRIV_GET | KADM5_PRIV_ADD | KADM5_PRIV_MODIFY | KADM5_PRIV_DELETE | KADM5_PRIV_LIST | KADM5_PRIV_CPW) 199 200typedef struct { 201 int XXX; 202}krb5_key_salt_tuple; 203 204typedef struct _kadm5_config_params { 205 uint32_t mask; 206 207 /* Client and server fields */ 208 char *realm; 209 int kadmind_port; 210 211 /* client fields */ 212 char *admin_server; 213 214 /* server fields */ 215 char *dbname; 216 char *acl_file; 217 218 /* server library (database) fields */ 219 char *stash_file; 220} kadm5_config_params; 221 222typedef krb5_error_code kadm5_ret_t; 223 224#include "kadm5-protos.h" 225 226#if 0 227/* unimplemented functions */ 228kadm5_ret_t 229kadm5_decrypt_key(void *server_handle, 230 kadm5_principal_ent_t entry, int32_t 231 ktype, int32_t stype, int32_t 232 kvno, krb5_keyblock *keyblock, 233 krb5_keysalt *keysalt, int *kvnop); 234 235kadm5_ret_t 236kadm5_create_policy(void *server_handle, 237 kadm5_policy_ent_t policy, uint32_t mask); 238 239kadm5_ret_t 240kadm5_delete_policy(void *server_handle, char *policy); 241 242 243kadm5_ret_t 244kadm5_modify_policy(void *server_handle, 245 kadm5_policy_ent_t policy, 246 uint32_t mask); 247 248kadm5_ret_t 249kadm5_get_policy(void *server_handle, char *policy, kadm5_policy_ent_t ent); 250 251kadm5_ret_t 252kadm5_get_policies(void *server_handle, char *exp, 253 char ***pols, int *count); 254 255void 256kadm5_free_policy_ent(kadm5_policy_ent_t policy); 257 258#endif 259 260#endif /* __KADM5_ADMIN_H__ */ 261