1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
|
/*
*
* (c) Copyright 1990 OPEN SOFTWARE FOUNDATION, INC.
* (c) Copyright 1990 HEWLETT-PACKARD COMPANY
* (c) Copyright 1990 DIGITAL EQUIPMENT CORPORATION
* To anyone who acknowledges that this file is provided "AS IS"
* without any express or implied warranty:
* permission to use, copy, modify, and distribute this
* file for any purpose is hereby granted without fee, provided that
* the above copyright notices and this notice appears in all source
* code copies, and that none of the names of Open Software
* Foundation, Inc., Hewlett-Packard Company, or Digital Equipment
* Corporation be used in advertising or publicity pertaining to
* distribution of the software without specific, written prior
* permission. Neither Open Software Foundation, Inc., Hewlett-
* Packard Company, nor Digital Equipment Corporation makes any
* representations about the suitability of this software for any
* purpose.
*
*/
/*
*/
#ifndef _COMAUTH_H
#define _COMAUTH_H 1
/*
**
** NAME
**
** comauth.h
**
** FACILITY:
**
** Remote Procedure Call (RPC)
**
** ABSTRACT:
**
** Generic interface to authentication services
**
**
*/
/***********************************************************************/
/*
* Function pointer types of functions exported by an authentication
* service.
*/
/*
* The next four function pointer types correspond to the similarly
* named functions in the API.
*/
#ifdef __cplusplus
extern "C" {
#endif
typedef void (*rpc_auth_bnd_set_auth_info_fn_t) _DCE_PROTOTYPE_ ((
unsigned_char_p_t /* in */ /*server_princ_name*/,
rpc_authn_level_t /* in */ /*authn_level*/,
rpc_auth_identity_handle_t /* in */ /*auth_identity*/,
rpc_authz_protocol_id_t /* in */ /*authz_protocol*/,
rpc_binding_handle_t /* in */ /*binding_h*/,
rpc_auth_info_p_t /* out*/ * /*auth_info*/,
unsigned32 /* out */ *st
));
typedef void (*rpc_auth_serv_reg_auth_info_fn_t) _DCE_PROTOTYPE_ ((
unsigned_char_p_t /* in */ /*server_princ_name*/,
rpc_auth_key_retrieval_fn_t /* in */ /*get_key_func*/,
pointer_t /* in */ /*arg*/,
unsigned32 /* out */ *st
));
typedef void (*rpc_mgmt_inq_def_authn_lvl_fn_t) _DCE_PROTOTYPE_ ((
unsigned32 /* out */ * /*authn_level*/,
unsigned32 /* out */ *st
));
/*
* This function pointer type describes an authentication
* procedure that frees the auth info memory and resources.
*/
typedef void (*rpc_auth_free_info_fn_t) _DCE_PROTOTYPE_ ((
rpc_auth_info_p_t /* in/out */ * /*auth_info*/
));
/*
* This function pointer type defines a procedure which frees key info
* memory and resources.
*/
typedef void (*rpc_auth_free_key_fn_t) _DCE_PROTOTYPE_ ((
rpc_key_info_p_t /* in/out */ * /*key_info*/
));
/*
* These function pointer types resolve a passed-in "auth_identity"
* into a reference to a "real" auth identity, and release the
* reference. Note that these return the error status in the return
* value (instead of in an output argument) because this means that
* the function pointer has the exact same signature as the routine in
* the security component which implements this function.
*/
typedef error_status_t (*rpc_auth_resolve_identity_fn_t) _DCE_PROTOTYPE_ ((
rpc_auth_identity_handle_t /* in */ /*in_identity*/,
rpc_auth_identity_handle_t /* out */ *out_identity
));
typedef void (*rpc_auth_release_identity_fn_t) _DCE_PROTOTYPE_ ((
rpc_auth_identity_handle_t /* in/out */ * /*identity*/
));
/*
* This function pointer type describes an authentication service procedure
* that returns the principal name (possibly just one of many) that server
* is running as.
*/
typedef void (*rpc_auth_inq_my_princ_name_fn_t) _DCE_PROTOTYPE_ ((
unsigned32 /* in */ /*princ_name_size*/,
unsigned_char_p_t /* out */ /*princ_name*/,
unsigned32 /* out */ * /*st*/
));
/*
* This function pointer type describes an authentication service procedure
* that returns the mechanism-specific security context.
*/
typedef void (*rpc_auth_inq_sec_context_fn_t) _DCE_PROTOTYPE_ ((
rpc_auth_info_p_t /* in */ /*auth_info*/,
void /* out */ ** /*mech_context*/,
unsigned32 /* out */ * /*st*/
));
typedef void (*rpc_auth_inq_access_token_fn_t) _DCE_PROTOTYPE_ ((
rpc_auth_info_p_t,
rpc_access_token_p_t*,
unsigned32*));
/***********************************************************************/
/*
* RPC authentication service API EPV.
*/
typedef struct
{
rpc_auth_bnd_set_auth_info_fn_t binding_set_auth_info;
rpc_auth_serv_reg_auth_info_fn_t server_register_auth_info;
rpc_mgmt_inq_def_authn_lvl_fn_t mgmt_inq_dflt_auth_level;
rpc_auth_inq_my_princ_name_fn_t inq_my_princ_name;
rpc_auth_free_info_fn_t free_info;
rpc_auth_free_key_fn_t free_key;
rpc_auth_resolve_identity_fn_t resolve_id;
rpc_auth_release_identity_fn_t release_id;
rpc_auth_inq_sec_context_fn_t inq_sec_context;
rpc_auth_inq_access_token_fn_t inq_access_token;
} rpc_auth_epv_t, *rpc_auth_epv_p_t;
/***********************************************************************/
PRIVATE void rpc__auth_info_binding_release _DCE_PROTOTYPE_ ((
rpc_binding_rep_p_t binding_rep
));
PRIVATE void rpc__np_auth_info_binding_release _DCE_PROTOTYPE_ ((
rpc_binding_rep_p_t binding_rep
));
PRIVATE void rpc__auth_inq_my_princ_name _DCE_PROTOTYPE_ ((
unsigned32 /*dce_rpc_authn_protocol*/,
unsigned32 /*princ_name_size*/,
unsigned_char_p_t /*princ_name*/,
unsigned32 * /*status*/
));
PRIVATE void rpc__auth_info_cache_init _DCE_PROTOTYPE_ ((
unsigned32 * /*status*/
));
/***********************************************************************/
/*
* Signature of the init routine provided. Each authentication service
* must return both an API and a common EPV.
*/
typedef void (*rpc_auth_init_fn_t) _DCE_PROTOTYPE_ ((
rpc_auth_epv_p_t * /*auth_epv*/,
rpc_auth_rpc_prot_epv_tbl_t * /*auth_rpc_prot_epv_tbl*/,
unsigned32 * /*status*/
));
/*
* Declarations of the RPC authentication service init routines.
*/
void rpc__krb_init _DCE_PROTOTYPE_ ((
rpc_auth_epv_p_t * /*auth_epv*/,
rpc_auth_rpc_prot_epv_tbl_t * /*auth_rpc_prot_epv_tbl*/,
unsigned32 * /*status*/
));
void rpc__noauth_init _DCE_PROTOTYPE_ ((
rpc_auth_epv_p_t * /*auth_epv*/,
rpc_auth_rpc_prot_epv_tbl_t * /*auth_rpc_prot_epv_tbl*/,
unsigned32 * /*status*/
));
void rpc__key_info_release _DCE_PROTOTYPE_ ((
rpc_key_info_p_t *
));
void rpc__key_info_reference _DCE_PROTOTYPE_ ((
rpc_key_info_p_t
));
#ifdef _cplusplus
}
#endif
#endif /* _COMAUTH_H */
|