1 /*
2  * Copyright 2008 Sun Microsystems, Inc.  All rights reserved.
3  * Use is subject to license terms.
4  */
5 
6 /*
7  * WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING
8  *
9  *	Openvision retains the copyright to derivative works of
10  *	this source code.  Do *NOT* create a derivative of this
11  *	source code before consulting with your legal department.
12  *	Do *NOT* integrate *ANY* of this source code into another
13  *	product before consulting with your legal department.
14  *
15  *	For further information, read the top-level Openvision
16  *	copyright which is contained in the top-level MIT Kerberos
17  *	copyright.
18  *
19  * WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING
20  *
21  */
22 
23 
24 /*
25  * Copyright 1993 OpenVision Technologies, Inc., All Rights Reserved
26  *
27  * $Header$
28  */
29 
30 /*
31  * This header file is used internally by the Admin API server
32  * libraries and Admin server.  IF YOU THINK YOU NEED TO USE THIS FILE
33  * FOR ANYTHING, YOU'RE ALMOST CERTAINLY WRONG.
34  */
35 
36 #ifndef __KADM5_SERVER_INTERNAL_H__
37 #define __KADM5_SERVER_INTERNAL_H__
38 
39 #ifdef HAVE_MEMORY_H
40 #include    <memory.h>
41 #endif
42 #include    <stdlib.h>
43 #include    <errno.h>
44 #include    "k5-int.h"
45 #include    <krb5/kdb.h>
46 #include    <kadm5/admin.h>
47 #include    <rpc/xdr.h>
48 #include    "admin_internal.h"
49 
50 typedef struct _kadm5_server_handle_t {
51 	krb5_ui_4	magic_number;
52 	krb5_ui_4	struct_version;
53 	krb5_ui_4	api_version;
54 	krb5_context	context;
55 	krb5_principal	current_caller;
56 	kadm5_config_params  params;
57 	struct _kadm5_server_handle_t *lhandle;
58         char **db_args;
59 	krb5_keyblock	master_keyblock;
60 } kadm5_server_handle_rec, *kadm5_server_handle_t;
61 
62 #define OSA_ADB_PRINC_VERSION_1  0x12345C01
63 
64 typedef struct _osa_pw_hist_t {
65   int n_key_data;
66   krb5_key_data *key_data;
67 } osa_pw_hist_ent, *osa_pw_hist_t;
68 
69 typedef struct _osa_princ_ent_t {
70   int                         version;
71   char                        *policy;
72   long                        aux_attributes;
73   unsigned int                old_key_len;
74   unsigned int                old_key_next;
75   krb5_kvno                   admin_history_kvno;
76   osa_pw_hist_ent             *old_keys;
77 } osa_princ_ent_rec, *osa_princ_ent_t;
78 
79 
80 kadm5_ret_t    adb_policy_init(kadm5_server_handle_t handle);
81 kadm5_ret_t    adb_policy_close(kadm5_server_handle_t handle);
82 kadm5_ret_t    passwd_check(kadm5_server_handle_t handle,
83 			    char *pass, int use_policy,
84 			    kadm5_policy_ent_t policy,
85 			    krb5_principal principal);
86 kadm5_ret_t    principal_exists(krb5_principal principal);
87 krb5_error_code	    kdb_init_master(kadm5_server_handle_t handle,
88 				    char *r, int from_keyboard);
89 krb5_error_code	    kdb_init_hist(kadm5_server_handle_t handle,
90 				  char *r);
91 krb5_error_code     kdb_get_entry(kadm5_server_handle_t handle,
92 				  krb5_principal principal, krb5_db_entry *kdb,
93 				  osa_princ_ent_rec *adb);
94 krb5_error_code     kdb_free_entry(kadm5_server_handle_t handle,
95 				   krb5_db_entry *kdb, osa_princ_ent_rec *adb);
96 krb5_error_code     kdb_put_entry(kadm5_server_handle_t handle,
97 				  krb5_db_entry *kdb, osa_princ_ent_rec *adb);
98 krb5_error_code     kdb_delete_entry(kadm5_server_handle_t handle,
99 				     krb5_principal name);
100 krb5_error_code     kdb_iter_entry(kadm5_server_handle_t handle,
101 				   char *match_entry,
102 				   void (*iter_fct)(void *, krb5_principal),
103 				   void *data);
104 
105 int		    init_dict(kadm5_config_params *);
106 int		    find_word(const char *word);
107 void		    destroy_dict(void);
108 
109 /* XXX this ought to be in libkrb5.a, but isn't */
110 kadm5_ret_t krb5_copy_key_data_contents(krb5_context context,
111 					krb5_key_data *from,
112 					krb5_key_data *to);
113 kadm5_ret_t krb5_free_key_data_contents(krb5_context context,
114 					krb5_key_data *key);
115 
116 /*
117  * *Warning*
118  * *Warning*	    This is going to break if we
119  * *Warning*	    ever go multi-threaded
120  * *Warning*
121  */
122 extern	krb5_principal	current_caller;
123 
124 /*
125  * Why is this (or something similar) not defined *anywhere* in krb5?
126  */
127 #define KSUCCESS	0
128 #define WORD_NOT_FOUND	1
129 
130 /*
131  * all the various mask bits or'd together
132  */
133 
134 #define	ALL_PRINC_MASK \
135  (KADM5_PRINCIPAL | KADM5_PRINC_EXPIRE_TIME | KADM5_PW_EXPIRATION | \
136   KADM5_LAST_PWD_CHANGE | KADM5_ATTRIBUTES | KADM5_MAX_LIFE | \
137   KADM5_MOD_TIME | KADM5_MOD_NAME | KADM5_KVNO | KADM5_MKVNO | \
138   KADM5_AUX_ATTRIBUTES | KADM5_POLICY_CLR | KADM5_POLICY | \
139   KADM5_MAX_RLIFE | KADM5_TL_DATA | KADM5_KEY_DATA)
140 
141 #define ALL_POLICY_MASK \
142  (KADM5_POLICY | KADM5_PW_MAX_LIFE | KADM5_PW_MIN_LIFE | \
143   KADM5_PW_MIN_LENGTH | KADM5_PW_MIN_CLASSES | KADM5_PW_HISTORY_NUM | \
144   KADM5_REF_COUNT)
145 
146 #define SERVER_CHECK_HANDLE(handle) \
147 { \
148 	kadm5_server_handle_t srvr = \
149 	     (kadm5_server_handle_t) handle; \
150  \
151 	if (! srvr->current_caller) \
152 		return KADM5_BAD_SERVER_HANDLE; \
153 	if (! srvr->lhandle) \
154 	        return KADM5_BAD_SERVER_HANDLE; \
155 }
156 
157 #define CHECK_HANDLE(handle) \
158      GENERIC_CHECK_HANDLE(handle, KADM5_OLD_SERVER_API_VERSION, \
159 			  KADM5_NEW_SERVER_API_VERSION) \
160      SERVER_CHECK_HANDLE(handle)
161 
162 bool_t          xdr_osa_princ_ent_rec(XDR *xdrs, osa_princ_ent_t objp);
163 
164 void
165 osa_free_princ_ent(osa_princ_ent_t val);
166 
167 #endif /* __KADM5_SERVER_INTERNAL_H__ */
168