Debian Codegraph @

lib/kadm5/admin.h

raw
1 /*
2 * Copyright (c) 1997-2000 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 /* $Id$ */
34
35 #ifndef __KADM5_ADMIN_H__
36 #define __KADM5_ADMIN_H__
37
38 #define KADM5_API_VERSION_1 1
39 #define KADM5_API_VERSION_2 2
40
41 #ifndef USE_KADM5_API_VERSION
42 #define USE_KADM5_API_VERSION KADM5_API_VERSION_2
43 #endif
44
45 #if USE_KADM5_API_VERSION != KADM5_API_VERSION_2
46 #error No support for API versions other than 2
47 #endif
48
49 #define KADM5_STRUCT_VERSION 0
50
51 /* For kadm5_log_get_version_fd() */
52 #define LOG_VERSION_LAST -1
53 #define LOG_VERSION_FIRST 1
54 #define LOG_VERSION_UBER 0
55
56 #include <krb5.h>
57
58 #define KRB5_KDB_DISALLOW_POSTDATED 0x00000001
59 #define KRB5_KDB_DISALLOW_FORWARDABLE 0x00000002
60 #define KRB5_KDB_DISALLOW_TGT_BASED 0x00000004
61 #define KRB5_KDB_DISALLOW_RENEWABLE 0x00000008
62 #define KRB5_KDB_DISALLOW_PROXIABLE 0x00000010
63 #define KRB5_KDB_DISALLOW_DUP_SKEY 0x00000020
64 #define KRB5_KDB_DISALLOW_ALL_TIX 0x00000040
65 #define KRB5_KDB_REQUIRES_PRE_AUTH 0x00000080
66 #define KRB5_KDB_REQUIRES_HW_AUTH 0x00000100
67 #define KRB5_KDB_REQUIRES_PWCHANGE 0x00000200
68 #define KRB5_KDB_DISALLOW_SVR 0x00001000
69 #define KRB5_KDB_PWCHANGE_SERVICE 0x00002000
70 #define KRB5_KDB_SUPPORT_DESMD5 0x00004000
71 #define KRB5_KDB_NEW_PRINC 0x00008000
72 #define KRB5_KDB_OK_AS_DELEGATE 0x00010000
73 #define KRB5_KDB_TRUSTED_FOR_DELEGATION 0x00020000
74 #define KRB5_KDB_ALLOW_KERBEROS4 0x00040000
75 #define KRB5_KDB_ALLOW_DIGEST 0x00080000
76
77 #define KADM5_PRINCIPAL 0x000001
78 #define KADM5_PRINC_EXPIRE_TIME 0x000002
79 #define KADM5_PW_EXPIRATION 0x000004
80 #define KADM5_LAST_PWD_CHANGE 0x000008
81 #define KADM5_ATTRIBUTES 0x000010
82 #define KADM5_MAX_LIFE 0x000020
83 #define KADM5_MOD_TIME 0x000040
84 #define KADM5_MOD_NAME 0x000080
85 #define KADM5_KVNO 0x000100
86 #define KADM5_MKVNO 0x000200
87 #define KADM5_AUX_ATTRIBUTES 0x000400
88 #define KADM5_POLICY 0x000800
89 #define KADM5_POLICY_CLR 0x001000
90 #define KADM5_MAX_RLIFE 0x002000
91 #define KADM5_LAST_SUCCESS 0x004000
92 #define KADM5_LAST_FAILED 0x008000
93 #define KADM5_FAIL_AUTH_COUNT 0x010000
94 #define KADM5_KEY_DATA 0x020000
95 #define KADM5_TL_DATA 0x040000
96
97 #define KADM5_PRINCIPAL_NORMAL_MASK (~(KADM5_KEY_DATA | KADM5_TL_DATA))
98
99 #define KADM5_PW_MAX_LIFE 0x004000
100 #define KADM5_PW_MIN_LIFE 0x008000
101 #define KADM5_PW_MIN_LENGTH 0x010000
102 #define KADM5_PW_MIN_CLASSES 0x020000
103 #define KADM5_PW_HISTORY_NUM 0x040000
104 #define KADM5_REF_COUNT 0x080000
105
106 #define KADM5_POLICY_NORMAL_MASK (~0)
107
108 #define KADM5_ADMIN_SERVICE "kadmin/admin"
109 #define KADM5_HIST_PRINCIPAL "kadmin/history"
110 #define KADM5_CHANGEPW_SERVICE "kadmin/changepw"
111
112 typedef struct {
113 int16_t key_data_ver; /* Version */
114 int16_t key_data_kvno; /* Key Version */
115 int16_t key_data_type[2]; /* Array of types */
116 int16_t key_data_length[2]; /* Array of lengths */
117 void* key_data_contents[2];/* Array of pointers */
118 } krb5_key_data;
119
120 typedef struct _krb5_keysalt {
121 int16_t type;
122 krb5_data data; /* Length, data */
123 } krb5_keysalt;
124
125 typedef struct _krb5_tl_data {
126 struct _krb5_tl_data* tl_data_next;
127 int16_t tl_data_type;
128 int16_t tl_data_length;
129 void* tl_data_contents;
130 } krb5_tl_data;
131
132 #define KRB5_TL_LAST_PWD_CHANGE 0x0001
133 #define KRB5_TL_MOD_PRINC 0x0002
134 #define KRB5_TL_KADM_DATA 0x0003
135 #define KRB5_TL_KADM5_E_DATA 0x0004
136 #define KRB5_TL_RB1_CHALLENGE 0x0005
137 #define KRB5_TL_SECURID_STATE 0x0006
138 #define KRB5_TL_PASSWORD 0x0007
139 #define KRB5_TL_EXTENSION 0x0008
140 #define KRB5_TL_PKINIT_ACL 0x0009
141 #define KRB5_TL_ALIASES 0x000a
142 #define KRB5_TL_HIST_KVNO_DIFF_CLNT 0x000b
143 #define KRB5_TL_HIST_KVNO_DIFF_SVC 0x000c
144
145 typedef struct _kadm5_principal_ent_t {
146 krb5_principal principal;
147
148 krb5_timestamp princ_expire_time;
149 krb5_timestamp last_pwd_change;
150 krb5_timestamp pw_expiration;
151 krb5_deltat max_life;
152 krb5_principal mod_name;
153 krb5_timestamp mod_date;
154 krb5_flags attributes;
155 krb5_kvno kvno;
156 krb5_kvno mkvno;
157
158 char * policy;
159 uint32_t aux_attributes;
160
161 krb5_deltat max_renewable_life;
162 krb5_timestamp last_success;
163 krb5_timestamp last_failed;
164 krb5_kvno fail_auth_count;
165 int16_t n_key_data;
166 int16_t n_tl_data;
167 krb5_tl_data *tl_data;
168 krb5_key_data *key_data;
169 } kadm5_principal_ent_rec, *kadm5_principal_ent_t;
170
171 typedef struct _kadm5_policy_ent_t {
172 char *policy;
173
174 uint32_t pw_min_life;
175 uint32_t pw_max_life;
176 uint32_t pw_min_length;
177 uint32_t pw_min_classes;
178 uint32_t pw_history_num;
179 uint32_t policy_refcnt;
180 } kadm5_policy_ent_rec, *kadm5_policy_ent_t;
181
182 #define KADM5_CONFIG_REALM (1 << 0)
183 #define KADM5_CONFIG_PROFILE (1 << 1)
184 #define KADM5_CONFIG_KADMIND_PORT (1 << 2)
185 #define KADM5_CONFIG_ADMIN_SERVER (1 << 3)
186 #define KADM5_CONFIG_DBNAME (1 << 4)
187 #define KADM5_CONFIG_ADBNAME (1 << 5)
188 #define KADM5_CONFIG_ADB_LOCKFILE (1 << 6)
189 #define KADM5_CONFIG_ACL_FILE (1 << 7)
190 #define KADM5_CONFIG_DICT_FILE (1 << 8)
191 #define KADM5_CONFIG_ADMIN_KEYTAB (1 << 9)
192 #define KADM5_CONFIG_MKEY_FROM_KEYBOARD (1 << 10)
193 #define KADM5_CONFIG_STASH_FILE (1 << 11)
194 #define KADM5_CONFIG_MKEY_NAME (1 << 12)
195 #define KADM5_CONFIG_ENCTYPE (1 << 13)
196 #define KADM5_CONFIG_MAX_LIFE (1 << 14)
197 #define KADM5_CONFIG_MAX_RLIFE (1 << 15)
198 #define KADM5_CONFIG_EXPIRATION (1 << 16)
199 #define KADM5_CONFIG_FLAGS (1 << 17)
200 #define KADM5_CONFIG_ENCTYPES (1 << 18)
201
202 #define KADM5_PRIV_GET (1 << 0)
203 #define KADM5_PRIV_ADD (1 << 1)
204 #define KADM5_PRIV_MODIFY (1 << 2)
205 #define KADM5_PRIV_DELETE (1 << 3)
206 #define KADM5_PRIV_LIST (1 << 4)
207 #define KADM5_PRIV_CPW (1 << 5)
208 #define KADM5_PRIV_GET_KEYS (1 << 6)
209
210 /* Note: KADM5_PRIV_GET_KEYS not included */
211 #define KADM5_PRIV_ALL (KADM5_PRIV_GET | KADM5_PRIV_ADD | KADM5_PRIV_MODIFY | KADM5_PRIV_DELETE | KADM5_PRIV_LIST | KADM5_PRIV_CPW)
212
213 #define KADM5_BOGUS_KEY_DATA "\xe5\xe5\xe5\xe5"
214
215 typedef struct _kadm5_config_params {
216 uint32_t mask;
217
218 /* Client and server fields */
219 char *realm;
220 int kadmind_port;
221
222 /* client fields */
223 char *admin_server;
224
225 /* server fields */
226 char *dbname;
227 char *acl_file;
228
229 /* server library (database) fields */
230 char *stash_file;
231 } kadm5_config_params;
232
233 typedef krb5_error_code kadm5_ret_t;
234
235 #include "kadm5-protos.h"
236
237 #endif /* __KADM5_ADMIN_H__ */