1/*-
2 * Copyright (c) 1999, 2000, 2001, 2002 Robert N. M. Watson
3 * Copyright (c) 2001, 2002 Networks Associates Technology, Inc.
4 * All rights reserved.
5 *
6 * This software was developed by Robert Watson for the TrustedBSD Project.
7 *
8 * This software was developed for the FreeBSD Project in part by NAI Labs,
9 * the Security Research Division of Network Associates, Inc. under
10 * DARPA/SPAWAR contract N66001-01-C-8035 ("CBOSS"), as part of the DARPA
11 * CHATS research program.
12 *
13 * Redistribution and use in source and binary forms, with or without
14 * modification, are permitted provided that the following conditions
15 * are met:
16 * 1. Redistributions of source code must retain the above copyright
17 * notice, this list of conditions and the following disclaimer.
18 * 2. Redistributions in binary form must reproduce the above copyright
19 * notice, this list of conditions and the following disclaimer in the
20 * documentation and/or other materials provided with the distribution.
21 * 3. The names of the authors may not be used to endorse or promote
22 * products derived from this software without specific prior written
23 * permission.
24 *
25 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
26 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
27 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
28 * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
29 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
30 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
31 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
32 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
33 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
34 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
35 * SUCH DAMAGE.
36 *
37 * $FreeBSD: head/sys/security/mac/mac_policy.h 106308 2002-11-01 20:46:53Z rwatson $
38 */
39/*
40 * Kernel interface for MAC policy modules.
41 */
42#ifndef _SYS_MAC_POLICY_H
43#define _SYS_MAC_POLICY_H
44
45/*-
46 * Pluggable access control policy definition structure.
47 *
48 * List of operations that are performed as part of the implementation
49 * of a MAC policy. Policy implementors declare operations with a
50 * mac_policy_ops structure, and using the MAC_POLICY_SET() macro.
51 * If an entry point is not declared, then then the policy will be ignored
52 * during evaluation of that event or check.
53 *
54 * Operations are sorted first by general class of operation, then
55 * alphabetically.
56 */
57struct mac_policy_conf;
58struct mac_policy_ops {
59 /*
60 * Policy module operations.
61 */
62 void (*mpo_destroy)(struct mac_policy_conf *mpc);
63 void (*mpo_init)(struct mac_policy_conf *mpc);
64
65 /*
66 * General policy-directed security system call so that policies
67 * may implement new services without reserving explicit
68 * system call numbers.
69 */
70 int (*mpo_syscall)(struct thread *td, int call, void *arg);
71
72 /*
73 * Label operations.
74 */
75 void (*mpo_init_bpfdesc_label)(struct label *label);
76 void (*mpo_init_cred_label)(struct label *label);
77 void (*mpo_init_devfsdirent_label)(struct label *label);
78 void (*mpo_init_ifnet_label)(struct label *label);
79 void (*mpo_init_ipq_label)(struct label *label);
80 int (*mpo_init_mbuf_label)(struct label *label, int flag);
81 void (*mpo_init_mount_label)(struct label *label);
82 void (*mpo_init_mount_fs_label)(struct label *label);
83 int (*mpo_init_socket_label)(struct label *label, int flag);
84 int (*mpo_init_socket_peer_label)(struct label *label, int flag);
85 void (*mpo_init_pipe_label)(struct label *label);
86 void (*mpo_init_vnode_label)(struct label *label);
87 void (*mpo_destroy_bpfdesc_label)(struct label *label);
88 void (*mpo_destroy_cred_label)(struct label *label);
89 void (*mpo_destroy_devfsdirent_label)(struct label *label);
90 void (*mpo_destroy_ifnet_label)(struct label *label);
91 void (*mpo_destroy_ipq_label)(struct label *label);
92 void (*mpo_destroy_mbuf_label)(struct label *label);
93 void (*mpo_destroy_mount_label)(struct label *label);
94 void (*mpo_destroy_mount_fs_label)(struct label *label);
95 void (*mpo_destroy_socket_label)(struct label *label);
96 void (*mpo_destroy_socket_peer_label)(struct label *label);
97 void (*mpo_destroy_pipe_label)(struct label *label);
98 void (*mpo_destroy_vnode_label)(struct label *label);
99 void (*mpo_copy_pipe_label)(struct label *src,
100 struct label *dest);
101 void (*mpo_copy_vnode_label)(struct label *src,
102 struct label *dest);
103 int (*mpo_externalize_cred_label)(struct label *label,
104 char *element_name, char *buffer, size_t buflen,
105 size_t *len, int *claimed);
106 int (*mpo_externalize_ifnet_label)(struct label *label,
107 char *element_name, char *buffer, size_t buflen,
108 size_t *len, int *claimed);
109 int (*mpo_externalize_pipe_label)(struct label *label,
110 char *element_name, char *buffer, size_t buflen,
111 size_t *len, int *claimed);
112 int (*mpo_externalize_socket_label)(struct label *label,
113 char *element_name, char *buffer, size_t buflen,
114 size_t *len, int *claimed);
115 int (*mpo_externalize_socket_peer_label)(struct label *label,
116 char *element_name, char *buffer, size_t buflen,
117 size_t *len, int *claimed);
118 int (*mpo_externalize_vnode_label)(struct label *label,
119 char *element_name, char *buffer, size_t buflen,
120 size_t *len, int *claimed);
121 int (*mpo_internalize_cred_label)(struct label *label,
122 char *element_name, char *element_data, int *claimed);
123 int (*mpo_internalize_ifnet_label)(struct label *label,
124 char *element_name, char *element_data, int *claimed);
125 int (*mpo_internalize_pipe_label)(struct label *label,
126 char *element_name, char *element_data, int *claimed);
127 int (*mpo_internalize_socket_label)(struct label *label,
128 char *element_name, char *element_data, int *claimed);
129 int (*mpo_internalize_vnode_label)(struct label *label,
130 char *element_name, char *element_data, int *claimed);
131
132 /*
133 * Labeling event operations: file system objects, and things that
134 * look a lot like file system objects.
135 */
136 void (*mpo_associate_vnode_devfs)(struct mount *mp,
137 struct label *fslabel, struct devfs_dirent *de,
138 struct label *delabel, struct vnode *vp,
139 struct label *vlabel);
140 int (*mpo_associate_vnode_extattr)(struct mount *mp,
141 struct label *fslabel, struct vnode *vp,
142 struct label *vlabel);
143 void (*mpo_associate_vnode_singlelabel)(struct mount *mp,
144 struct label *fslabel, struct vnode *vp,
145 struct label *vlabel);
146 void (*mpo_create_devfs_device)(dev_t dev, struct devfs_dirent *de,
147 struct label *label);
148 void (*mpo_create_devfs_directory)(char *dirname, int dirnamelen,
149 struct devfs_dirent *de, struct label *label);
150 void (*mpo_create_devfs_symlink)(struct ucred *cred,
151 struct devfs_dirent *dd, struct label *ddlabel,
152 struct devfs_dirent *de, struct label *delabel);
153 void (*mpo_create_devfs_vnode)(struct devfs_dirent *de,
154 struct label *direntlabel, struct vnode *vp,
155 struct label *vnodelabel);
156 int (*mpo_create_vnode_extattr)(struct ucred *cred,
157 struct mount *mp, struct label *fslabel,
158 struct vnode *dvp, struct label *dlabel,
159 struct vnode *vp, struct label *vlabel,
160 struct componentname *cnp);
161 void (*mpo_create_mount)(struct ucred *cred, struct mount *mp,
162 struct label *mntlabel, struct label *fslabel);
163 void (*mpo_create_root_mount)(struct ucred *cred, struct mount *mp,
164 struct label *mountlabel, struct label *fslabel);
165 void (*mpo_relabel_vnode)(struct ucred *cred, struct vnode *vp,
166 struct label *vnodelabel, struct label *label);
167 int (*mpo_setlabel_vnode_extattr)(struct ucred *cred,
168 struct vnode *vp, struct label *vlabel,
169 struct label *intlabel);
170 void (*mpo_update_devfsdirent)(struct devfs_dirent *devfs_dirent,
171 struct label *direntlabel, struct vnode *vp,
172 struct label *vnodelabel);
173
174 /*
175 * Labeling event operations: IPC objects.
176 */
177 void (*mpo_create_mbuf_from_socket)(struct socket *so,
178 struct label *socketlabel, struct mbuf *m,
179 struct label *mbuflabel);
180 void (*mpo_create_socket)(struct ucred *cred, struct socket *so,
181 struct label *socketlabel);
182 void (*mpo_create_socket_from_socket)(struct socket *oldsocket,
183 struct label *oldsocketlabel, struct socket *newsocket,
184 struct label *newsocketlabel);
185 void (*mpo_relabel_socket)(struct ucred *cred, struct socket *so,
186 struct label *oldlabel, struct label *newlabel);
187 void (*mpo_relabel_pipe)(struct ucred *cred, struct pipe *pipe,
188 struct label *oldlabel, struct label *newlabel);
189 void (*mpo_set_socket_peer_from_mbuf)(struct mbuf *mbuf,
190 struct label *mbuflabel, struct socket *so,
191 struct label *socketpeerlabel);
192 void (*mpo_set_socket_peer_from_socket)(struct socket *oldsocket,
193 struct label *oldsocketlabel, struct socket *newsocket,
194 struct label *newsocketpeerlabel);
195 void (*mpo_create_pipe)(struct ucred *cred, struct pipe *pipe,
196 struct label *pipelabel);
197
198 /*
199 * Labeling event operations: network objects.
200 */
201 void (*mpo_create_bpfdesc)(struct ucred *cred, struct bpf_d *bpf_d,
202 struct label *bpflabel);
203 void (*mpo_create_ifnet)(struct ifnet *ifnet,
204 struct label *ifnetlabel);
205 void (*mpo_create_ipq)(struct mbuf *fragment,
206 struct label *fragmentlabel, struct ipq *ipq,
207 struct label *ipqlabel);
208 void (*mpo_create_datagram_from_ipq)
209 (struct ipq *ipq, struct label *ipqlabel,
210 struct mbuf *datagram, struct label *datagramlabel);
211 void (*mpo_create_fragment)(struct mbuf *datagram,
212 struct label *datagramlabel, struct mbuf *fragment,
213 struct label *fragmentlabel);
214 void (*mpo_create_mbuf_from_mbuf)(struct mbuf *oldmbuf,
215 struct label *oldlabel, struct mbuf *newmbuf,
216 struct label *newlabel);
217 void (*mpo_create_mbuf_linklayer)(struct ifnet *ifnet,
218 struct label *ifnetlabel, struct mbuf *mbuf,
219 struct label *mbuflabel);
220 void (*mpo_create_mbuf_from_bpfdesc)(struct bpf_d *bpf_d,
221 struct label *bpflabel, struct mbuf *mbuf,
222 struct label *mbuflabel);
223 void (*mpo_create_mbuf_from_ifnet)(struct ifnet *ifnet,
224 struct label *ifnetlabel, struct mbuf *mbuf,
225 struct label *mbuflabel);
226 void (*mpo_create_mbuf_multicast_encap)(struct mbuf *oldmbuf,
227 struct label *oldmbuflabel, struct ifnet *ifnet,
228 struct label *ifnetlabel, struct mbuf *newmbuf,
229 struct label *newmbuflabel);
230 void (*mpo_create_mbuf_netlayer)(struct mbuf *oldmbuf,
231 struct label *oldmbuflabel, struct mbuf *newmbuf,
232 struct label *newmbuflabel);
233 int (*mpo_fragment_match)(struct mbuf *fragment,
234 struct label *fragmentlabel, struct ipq *ipq,
235 struct label *ipqlabel);
236 void (*mpo_relabel_ifnet)(struct ucred *cred, struct ifnet *ifnet,
237 struct label *ifnetlabel, struct label *newlabel);
238 void (*mpo_update_ipq)(struct mbuf *fragment,
239 struct label *fragmentlabel, struct ipq *ipq,
240 struct label *ipqlabel);
241
242 /*
243 * Labeling event operations: processes.
244 */
245 void (*mpo_create_cred)(struct ucred *parent_cred,
246 struct ucred *child_cred);
247 void (*mpo_execve_transition)(struct ucred *old, struct ucred *new,
248 struct vnode *vp, struct label *vnodelabel);
249 int (*mpo_execve_will_transition)(struct ucred *old,
250 struct vnode *vp, struct label *vnodelabel);
251 void (*mpo_create_proc0)(struct ucred *cred);
252 void (*mpo_create_proc1)(struct ucred *cred);
253 void (*mpo_relabel_cred)(struct ucred *cred,
254 struct label *newlabel);
255 void (*mpo_thread_userret)(struct thread *thread);
256
257 /*
258 * Access control checks.
259 */
260 int (*mpo_check_bpfdesc_receive)(struct bpf_d *bpf_d,
261 struct label *bpflabel, struct ifnet *ifnet,
262 struct label *ifnetlabel);
263 int (*mpo_check_cred_relabel)(struct ucred *cred,
264 struct label *newlabel);
265 int (*mpo_check_cred_visible)(struct ucred *u1, struct ucred *u2);
266 int (*mpo_check_ifnet_relabel)(struct ucred *cred,
267 struct ifnet *ifnet, struct label *ifnetlabel,
268 struct label *newlabel);
269 int (*mpo_check_ifnet_transmit)(struct ifnet *ifnet,
270 struct label *ifnetlabel, struct mbuf *m,
271 struct label *mbuflabel);
272 int (*mpo_check_kenv_dump)(struct ucred *cred);
273 int (*mpo_check_kenv_get)(struct ucred *cred, char *name);
274 int (*mpo_check_kenv_set)(struct ucred *cred, char *name,
275 char *value);
276 int (*mpo_check_kenv_unset)(struct ucred *cred, char *name);
277 int (*mpo_check_mount_stat)(struct ucred *cred, struct mount *mp,
278 struct label *mntlabel);
279 int (*mpo_check_pipe_ioctl)(struct ucred *cred, struct pipe *pipe,
280 struct label *pipelabel, unsigned long cmd, void *data);
281 int (*mpo_check_pipe_poll)(struct ucred *cred, struct pipe *pipe,
282 struct label *pipelabel);
283 int (*mpo_check_pipe_read)(struct ucred *cred, struct pipe *pipe,
284 struct label *pipelabel);
285 int (*mpo_check_pipe_relabel)(struct ucred *cred,
286 struct pipe *pipe, struct label *pipelabel,
287 struct label *newlabel);
288 int (*mpo_check_pipe_stat)(struct ucred *cred, struct pipe *pipe,
289 struct label *pipelabel);
290 int (*mpo_check_pipe_write)(struct ucred *cred, struct pipe *pipe,
291 struct label *pipelabel);
292 int (*mpo_check_proc_debug)(struct ucred *cred,
293 struct proc *proc);
294 int (*mpo_check_proc_sched)(struct ucred *cred,
295 struct proc *proc);
296 int (*mpo_check_proc_signal)(struct ucred *cred,
297 struct proc *proc, int signum);
298 int (*mpo_check_socket_bind)(struct ucred *cred,
299 struct socket *so, struct label *socketlabel,
300 struct sockaddr *sockaddr);
301 int (*mpo_check_socket_connect)(struct ucred *cred,
302 struct socket *so, struct label *socketlabel,
303 struct sockaddr *sockaddr);
304 int (*mpo_check_socket_deliver)(struct socket *so,
305 struct label *socketlabel, struct mbuf *m,
306 struct label *mbuflabel);
307 int (*mpo_check_socket_listen)(struct ucred *cred,
308 struct socket *so, struct label *socketlabel);
309 int (*mpo_check_socket_receive)(struct ucred *cred,
310 struct socket *so, struct label *socketlabel);
311 int (*mpo_check_socket_relabel)(struct ucred *cred,
312 struct socket *so, struct label *socketlabel,
313 struct label *newlabel);
314 int (*mpo_check_socket_send)(struct ucred *cred,
315 struct socket *so, struct label *socketlabel);
316 int (*mpo_check_socket_visible)(struct ucred *cred,
317 struct socket *so, struct label *socketlabel);
318 int (*mpo_check_system_reboot)(struct ucred *cred, int howto);
319 int (*mpo_check_system_swapon)(struct ucred *cred,
320 struct vnode *vp, struct label *label);
321 int (*mpo_check_system_sysctl)(struct ucred *cred, int *name,
322 u_int namelen, void *old, size_t *oldlenp, int inkernel,
323 void *new, size_t newlen);
324 int (*mpo_check_vnode_access)(struct ucred *cred,
325 struct vnode *vp, struct label *label, int acc_mode);
326 int (*mpo_check_vnode_chdir)(struct ucred *cred,
327 struct vnode *dvp, struct label *dlabel);
328 int (*mpo_check_vnode_chroot)(struct ucred *cred,
329 struct vnode *dvp, struct label *dlabel);
330 int (*mpo_check_vnode_create)(struct ucred *cred,
331 struct vnode *dvp, struct label *dlabel,
332 struct componentname *cnp, struct vattr *vap);
333 int (*mpo_check_vnode_delete)(struct ucred *cred,
334 struct vnode *dvp, struct label *dlabel,
335 struct vnode *vp, struct label *label,
336 struct componentname *cnp);
337 int (*mpo_check_vnode_deleteacl)(struct ucred *cred,
338 struct vnode *vp, struct label *label, acl_type_t type);
339 int (*mpo_check_vnode_exec)(struct ucred *cred, struct vnode *vp,
340 struct label *label);
341 int (*mpo_check_vnode_getacl)(struct ucred *cred,
342 struct vnode *vp, struct label *label, acl_type_t type);
343 int (*mpo_check_vnode_getextattr)(struct ucred *cred,
344 struct vnode *vp, struct label *label, int attrnamespace,
345 const char *name, struct uio *uio);
346 int (*mpo_check_vnode_link)(struct ucred *cred, struct vnode *dvp,
347 struct label *dlabel, struct vnode *vp,
348 struct label *label, struct componentname *cnp);
349 int (*mpo_check_vnode_lookup)(struct ucred *cred,
350 struct vnode *dvp, struct label *dlabel,
351 struct componentname *cnp);
352 int (*mpo_check_vnode_mmap)(struct ucred *cred, struct vnode *vp,
353 struct label *label, int prot);
354 void (*mpo_check_vnode_mmap_downgrade)(struct ucred *cred,
355 struct vnode *vp, struct label *label, int *prot);
356 int (*mpo_check_vnode_mprotect)(struct ucred *cred,
357 struct vnode *vp, struct label *label, int prot);
358 int (*mpo_check_vnode_open)(struct ucred *cred, struct vnode *vp,
359 struct label *label, int acc_mode);
360 int (*mpo_check_vnode_poll)(struct ucred *active_cred,
361 struct ucred *file_cred, struct vnode *vp,
362 struct label *label);
363 int (*mpo_check_vnode_read)(struct ucred *active_cred,
364 struct ucred *file_cred, struct vnode *vp,
365 struct label *label);
366 int (*mpo_check_vnode_readdir)(struct ucred *cred,
367 struct vnode *dvp, struct label *dlabel);
368 int (*mpo_check_vnode_readlink)(struct ucred *cred,
369 struct vnode *vp, struct label *label);
370 int (*mpo_check_vnode_relabel)(struct ucred *cred,
371 struct vnode *vp, struct label *vnodelabel,
372 struct label *newlabel);
373 int (*mpo_check_vnode_rename_from)(struct ucred *cred,
374 struct vnode *dvp, struct label *dlabel, struct vnode *vp,
375 struct label *label, struct componentname *cnp);
376 int (*mpo_check_vnode_rename_to)(struct ucred *cred,
377 struct vnode *dvp, struct label *dlabel, struct vnode *vp,
378 struct label *label, int samedir,
379 struct componentname *cnp);
380 int (*mpo_check_vnode_revoke)(struct ucred *cred,
381 struct vnode *vp, struct label *label);
382 int (*mpo_check_vnode_setacl)(struct ucred *cred,
383 struct vnode *vp, struct label *label, acl_type_t type,
384 struct acl *acl);
385 int (*mpo_check_vnode_setextattr)(struct ucred *cred,
386 struct vnode *vp, struct label *label, int attrnamespace,
387 const char *name, struct uio *uio);
388 int (*mpo_check_vnode_setflags)(struct ucred *cred,
389 struct vnode *vp, struct label *label, u_long flags);
390 int (*mpo_check_vnode_setmode)(struct ucred *cred,
391 struct vnode *vp, struct label *label, mode_t mode);
392 int (*mpo_check_vnode_setowner)(struct ucred *cred,
393 struct vnode *vp, struct label *label, uid_t uid,
394 gid_t gid);
395 int (*mpo_check_vnode_setutimes)(struct ucred *cred,
396 struct vnode *vp, struct label *label,
397 struct timespec atime, struct timespec mtime);
398 int (*mpo_check_vnode_stat)(struct ucred *active_cred,
399 struct ucred *file_cred, struct vnode *vp,
400 struct label *label);
401 int (*mpo_check_vnode_write)(struct ucred *active_cred,
402 struct ucred *file_cred, struct vnode *vp,
403 struct label *label);
404};
405
406struct mac_policy_conf {
407 char *mpc_name; /* policy name */
408 char *mpc_fullname; /* policy full name */
409 struct mac_policy_ops *mpc_ops; /* policy operations */
410 int mpc_loadtime_flags; /* flags */
411 int *mpc_field_off; /* security field */
412 int mpc_runtime_flags; /* flags */
413 LIST_ENTRY(mac_policy_conf) mpc_list; /* global list */
414};
415
416/* Flags for the mpc_loadtime_flags field. */
417#define MPC_LOADTIME_FLAG_NOTLATE 0x00000001
418#define MPC_LOADTIME_FLAG_UNLOADOK 0x00000002
419
420/* Flags for the mpc_runtime_flags field. */
421#define MPC_RUNTIME_FLAG_REGISTERED 0x00000001
422
423#define MAC_POLICY_SET(mpops, mpname, mpfullname, mpflags, privdata_wanted) \
424 static struct mac_policy_conf mpname##_mac_policy_conf = { \
425 #mpname, \
426 mpfullname, \
427 mpops, \
428 mpflags, \
429 privdata_wanted, \
430 0, \
431 }; \
432 static moduledata_t mpname##_mod = { \
433 #mpname, \
434 mac_policy_modevent, \
435 &mpname##_mac_policy_conf \
436 }; \
437 MODULE_DEPEND(mpname, kernel_mac_support, 1, 1, 1); \
438 DECLARE_MODULE(mpname, mpname##_mod, SI_SUB_MAC_POLICY, \
439 SI_ORDER_MIDDLE)
440
441int mac_policy_modevent(module_t mod, int type, void *data);
442
443#define LABEL_TO_SLOT(l, s) (l)->l_perpolicy[s]
444
445#endif /* !_SYS_MAC_POLICY_H */
2 * Copyright (c) 1999, 2000, 2001, 2002 Robert N. M. Watson
3 * Copyright (c) 2001, 2002 Networks Associates Technology, Inc.
4 * All rights reserved.
5 *
6 * This software was developed by Robert Watson for the TrustedBSD Project.
7 *
8 * This software was developed for the FreeBSD Project in part by NAI Labs,
9 * the Security Research Division of Network Associates, Inc. under
10 * DARPA/SPAWAR contract N66001-01-C-8035 ("CBOSS"), as part of the DARPA
11 * CHATS research program.
12 *
13 * Redistribution and use in source and binary forms, with or without
14 * modification, are permitted provided that the following conditions
15 * are met:
16 * 1. Redistributions of source code must retain the above copyright
17 * notice, this list of conditions and the following disclaimer.
18 * 2. Redistributions in binary form must reproduce the above copyright
19 * notice, this list of conditions and the following disclaimer in the
20 * documentation and/or other materials provided with the distribution.
21 * 3. The names of the authors may not be used to endorse or promote
22 * products derived from this software without specific prior written
23 * permission.
24 *
25 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
26 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
27 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
28 * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
29 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
30 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
31 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
32 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
33 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
34 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
35 * SUCH DAMAGE.
36 *
37 * $FreeBSD: head/sys/security/mac/mac_policy.h 106308 2002-11-01 20:46:53Z rwatson $
38 */
39/*
40 * Kernel interface for MAC policy modules.
41 */
42#ifndef _SYS_MAC_POLICY_H
43#define _SYS_MAC_POLICY_H
44
45/*-
46 * Pluggable access control policy definition structure.
47 *
48 * List of operations that are performed as part of the implementation
49 * of a MAC policy. Policy implementors declare operations with a
50 * mac_policy_ops structure, and using the MAC_POLICY_SET() macro.
51 * If an entry point is not declared, then then the policy will be ignored
52 * during evaluation of that event or check.
53 *
54 * Operations are sorted first by general class of operation, then
55 * alphabetically.
56 */
57struct mac_policy_conf;
58struct mac_policy_ops {
59 /*
60 * Policy module operations.
61 */
62 void (*mpo_destroy)(struct mac_policy_conf *mpc);
63 void (*mpo_init)(struct mac_policy_conf *mpc);
64
65 /*
66 * General policy-directed security system call so that policies
67 * may implement new services without reserving explicit
68 * system call numbers.
69 */
70 int (*mpo_syscall)(struct thread *td, int call, void *arg);
71
72 /*
73 * Label operations.
74 */
75 void (*mpo_init_bpfdesc_label)(struct label *label);
76 void (*mpo_init_cred_label)(struct label *label);
77 void (*mpo_init_devfsdirent_label)(struct label *label);
78 void (*mpo_init_ifnet_label)(struct label *label);
79 void (*mpo_init_ipq_label)(struct label *label);
80 int (*mpo_init_mbuf_label)(struct label *label, int flag);
81 void (*mpo_init_mount_label)(struct label *label);
82 void (*mpo_init_mount_fs_label)(struct label *label);
83 int (*mpo_init_socket_label)(struct label *label, int flag);
84 int (*mpo_init_socket_peer_label)(struct label *label, int flag);
85 void (*mpo_init_pipe_label)(struct label *label);
86 void (*mpo_init_vnode_label)(struct label *label);
87 void (*mpo_destroy_bpfdesc_label)(struct label *label);
88 void (*mpo_destroy_cred_label)(struct label *label);
89 void (*mpo_destroy_devfsdirent_label)(struct label *label);
90 void (*mpo_destroy_ifnet_label)(struct label *label);
91 void (*mpo_destroy_ipq_label)(struct label *label);
92 void (*mpo_destroy_mbuf_label)(struct label *label);
93 void (*mpo_destroy_mount_label)(struct label *label);
94 void (*mpo_destroy_mount_fs_label)(struct label *label);
95 void (*mpo_destroy_socket_label)(struct label *label);
96 void (*mpo_destroy_socket_peer_label)(struct label *label);
97 void (*mpo_destroy_pipe_label)(struct label *label);
98 void (*mpo_destroy_vnode_label)(struct label *label);
99 void (*mpo_copy_pipe_label)(struct label *src,
100 struct label *dest);
101 void (*mpo_copy_vnode_label)(struct label *src,
102 struct label *dest);
103 int (*mpo_externalize_cred_label)(struct label *label,
104 char *element_name, char *buffer, size_t buflen,
105 size_t *len, int *claimed);
106 int (*mpo_externalize_ifnet_label)(struct label *label,
107 char *element_name, char *buffer, size_t buflen,
108 size_t *len, int *claimed);
109 int (*mpo_externalize_pipe_label)(struct label *label,
110 char *element_name, char *buffer, size_t buflen,
111 size_t *len, int *claimed);
112 int (*mpo_externalize_socket_label)(struct label *label,
113 char *element_name, char *buffer, size_t buflen,
114 size_t *len, int *claimed);
115 int (*mpo_externalize_socket_peer_label)(struct label *label,
116 char *element_name, char *buffer, size_t buflen,
117 size_t *len, int *claimed);
118 int (*mpo_externalize_vnode_label)(struct label *label,
119 char *element_name, char *buffer, size_t buflen,
120 size_t *len, int *claimed);
121 int (*mpo_internalize_cred_label)(struct label *label,
122 char *element_name, char *element_data, int *claimed);
123 int (*mpo_internalize_ifnet_label)(struct label *label,
124 char *element_name, char *element_data, int *claimed);
125 int (*mpo_internalize_pipe_label)(struct label *label,
126 char *element_name, char *element_data, int *claimed);
127 int (*mpo_internalize_socket_label)(struct label *label,
128 char *element_name, char *element_data, int *claimed);
129 int (*mpo_internalize_vnode_label)(struct label *label,
130 char *element_name, char *element_data, int *claimed);
131
132 /*
133 * Labeling event operations: file system objects, and things that
134 * look a lot like file system objects.
135 */
136 void (*mpo_associate_vnode_devfs)(struct mount *mp,
137 struct label *fslabel, struct devfs_dirent *de,
138 struct label *delabel, struct vnode *vp,
139 struct label *vlabel);
140 int (*mpo_associate_vnode_extattr)(struct mount *mp,
141 struct label *fslabel, struct vnode *vp,
142 struct label *vlabel);
143 void (*mpo_associate_vnode_singlelabel)(struct mount *mp,
144 struct label *fslabel, struct vnode *vp,
145 struct label *vlabel);
146 void (*mpo_create_devfs_device)(dev_t dev, struct devfs_dirent *de,
147 struct label *label);
148 void (*mpo_create_devfs_directory)(char *dirname, int dirnamelen,
149 struct devfs_dirent *de, struct label *label);
150 void (*mpo_create_devfs_symlink)(struct ucred *cred,
151 struct devfs_dirent *dd, struct label *ddlabel,
152 struct devfs_dirent *de, struct label *delabel);
153 void (*mpo_create_devfs_vnode)(struct devfs_dirent *de,
154 struct label *direntlabel, struct vnode *vp,
155 struct label *vnodelabel);
156 int (*mpo_create_vnode_extattr)(struct ucred *cred,
157 struct mount *mp, struct label *fslabel,
158 struct vnode *dvp, struct label *dlabel,
159 struct vnode *vp, struct label *vlabel,
160 struct componentname *cnp);
161 void (*mpo_create_mount)(struct ucred *cred, struct mount *mp,
162 struct label *mntlabel, struct label *fslabel);
163 void (*mpo_create_root_mount)(struct ucred *cred, struct mount *mp,
164 struct label *mountlabel, struct label *fslabel);
165 void (*mpo_relabel_vnode)(struct ucred *cred, struct vnode *vp,
166 struct label *vnodelabel, struct label *label);
167 int (*mpo_setlabel_vnode_extattr)(struct ucred *cred,
168 struct vnode *vp, struct label *vlabel,
169 struct label *intlabel);
170 void (*mpo_update_devfsdirent)(struct devfs_dirent *devfs_dirent,
171 struct label *direntlabel, struct vnode *vp,
172 struct label *vnodelabel);
173
174 /*
175 * Labeling event operations: IPC objects.
176 */
177 void (*mpo_create_mbuf_from_socket)(struct socket *so,
178 struct label *socketlabel, struct mbuf *m,
179 struct label *mbuflabel);
180 void (*mpo_create_socket)(struct ucred *cred, struct socket *so,
181 struct label *socketlabel);
182 void (*mpo_create_socket_from_socket)(struct socket *oldsocket,
183 struct label *oldsocketlabel, struct socket *newsocket,
184 struct label *newsocketlabel);
185 void (*mpo_relabel_socket)(struct ucred *cred, struct socket *so,
186 struct label *oldlabel, struct label *newlabel);
187 void (*mpo_relabel_pipe)(struct ucred *cred, struct pipe *pipe,
188 struct label *oldlabel, struct label *newlabel);
189 void (*mpo_set_socket_peer_from_mbuf)(struct mbuf *mbuf,
190 struct label *mbuflabel, struct socket *so,
191 struct label *socketpeerlabel);
192 void (*mpo_set_socket_peer_from_socket)(struct socket *oldsocket,
193 struct label *oldsocketlabel, struct socket *newsocket,
194 struct label *newsocketpeerlabel);
195 void (*mpo_create_pipe)(struct ucred *cred, struct pipe *pipe,
196 struct label *pipelabel);
197
198 /*
199 * Labeling event operations: network objects.
200 */
201 void (*mpo_create_bpfdesc)(struct ucred *cred, struct bpf_d *bpf_d,
202 struct label *bpflabel);
203 void (*mpo_create_ifnet)(struct ifnet *ifnet,
204 struct label *ifnetlabel);
205 void (*mpo_create_ipq)(struct mbuf *fragment,
206 struct label *fragmentlabel, struct ipq *ipq,
207 struct label *ipqlabel);
208 void (*mpo_create_datagram_from_ipq)
209 (struct ipq *ipq, struct label *ipqlabel,
210 struct mbuf *datagram, struct label *datagramlabel);
211 void (*mpo_create_fragment)(struct mbuf *datagram,
212 struct label *datagramlabel, struct mbuf *fragment,
213 struct label *fragmentlabel);
214 void (*mpo_create_mbuf_from_mbuf)(struct mbuf *oldmbuf,
215 struct label *oldlabel, struct mbuf *newmbuf,
216 struct label *newlabel);
217 void (*mpo_create_mbuf_linklayer)(struct ifnet *ifnet,
218 struct label *ifnetlabel, struct mbuf *mbuf,
219 struct label *mbuflabel);
220 void (*mpo_create_mbuf_from_bpfdesc)(struct bpf_d *bpf_d,
221 struct label *bpflabel, struct mbuf *mbuf,
222 struct label *mbuflabel);
223 void (*mpo_create_mbuf_from_ifnet)(struct ifnet *ifnet,
224 struct label *ifnetlabel, struct mbuf *mbuf,
225 struct label *mbuflabel);
226 void (*mpo_create_mbuf_multicast_encap)(struct mbuf *oldmbuf,
227 struct label *oldmbuflabel, struct ifnet *ifnet,
228 struct label *ifnetlabel, struct mbuf *newmbuf,
229 struct label *newmbuflabel);
230 void (*mpo_create_mbuf_netlayer)(struct mbuf *oldmbuf,
231 struct label *oldmbuflabel, struct mbuf *newmbuf,
232 struct label *newmbuflabel);
233 int (*mpo_fragment_match)(struct mbuf *fragment,
234 struct label *fragmentlabel, struct ipq *ipq,
235 struct label *ipqlabel);
236 void (*mpo_relabel_ifnet)(struct ucred *cred, struct ifnet *ifnet,
237 struct label *ifnetlabel, struct label *newlabel);
238 void (*mpo_update_ipq)(struct mbuf *fragment,
239 struct label *fragmentlabel, struct ipq *ipq,
240 struct label *ipqlabel);
241
242 /*
243 * Labeling event operations: processes.
244 */
245 void (*mpo_create_cred)(struct ucred *parent_cred,
246 struct ucred *child_cred);
247 void (*mpo_execve_transition)(struct ucred *old, struct ucred *new,
248 struct vnode *vp, struct label *vnodelabel);
249 int (*mpo_execve_will_transition)(struct ucred *old,
250 struct vnode *vp, struct label *vnodelabel);
251 void (*mpo_create_proc0)(struct ucred *cred);
252 void (*mpo_create_proc1)(struct ucred *cred);
253 void (*mpo_relabel_cred)(struct ucred *cred,
254 struct label *newlabel);
255 void (*mpo_thread_userret)(struct thread *thread);
256
257 /*
258 * Access control checks.
259 */
260 int (*mpo_check_bpfdesc_receive)(struct bpf_d *bpf_d,
261 struct label *bpflabel, struct ifnet *ifnet,
262 struct label *ifnetlabel);
263 int (*mpo_check_cred_relabel)(struct ucred *cred,
264 struct label *newlabel);
265 int (*mpo_check_cred_visible)(struct ucred *u1, struct ucred *u2);
266 int (*mpo_check_ifnet_relabel)(struct ucred *cred,
267 struct ifnet *ifnet, struct label *ifnetlabel,
268 struct label *newlabel);
269 int (*mpo_check_ifnet_transmit)(struct ifnet *ifnet,
270 struct label *ifnetlabel, struct mbuf *m,
271 struct label *mbuflabel);
272 int (*mpo_check_kenv_dump)(struct ucred *cred);
273 int (*mpo_check_kenv_get)(struct ucred *cred, char *name);
274 int (*mpo_check_kenv_set)(struct ucred *cred, char *name,
275 char *value);
276 int (*mpo_check_kenv_unset)(struct ucred *cred, char *name);
277 int (*mpo_check_mount_stat)(struct ucred *cred, struct mount *mp,
278 struct label *mntlabel);
279 int (*mpo_check_pipe_ioctl)(struct ucred *cred, struct pipe *pipe,
280 struct label *pipelabel, unsigned long cmd, void *data);
281 int (*mpo_check_pipe_poll)(struct ucred *cred, struct pipe *pipe,
282 struct label *pipelabel);
283 int (*mpo_check_pipe_read)(struct ucred *cred, struct pipe *pipe,
284 struct label *pipelabel);
285 int (*mpo_check_pipe_relabel)(struct ucred *cred,
286 struct pipe *pipe, struct label *pipelabel,
287 struct label *newlabel);
288 int (*mpo_check_pipe_stat)(struct ucred *cred, struct pipe *pipe,
289 struct label *pipelabel);
290 int (*mpo_check_pipe_write)(struct ucred *cred, struct pipe *pipe,
291 struct label *pipelabel);
292 int (*mpo_check_proc_debug)(struct ucred *cred,
293 struct proc *proc);
294 int (*mpo_check_proc_sched)(struct ucred *cred,
295 struct proc *proc);
296 int (*mpo_check_proc_signal)(struct ucred *cred,
297 struct proc *proc, int signum);
298 int (*mpo_check_socket_bind)(struct ucred *cred,
299 struct socket *so, struct label *socketlabel,
300 struct sockaddr *sockaddr);
301 int (*mpo_check_socket_connect)(struct ucred *cred,
302 struct socket *so, struct label *socketlabel,
303 struct sockaddr *sockaddr);
304 int (*mpo_check_socket_deliver)(struct socket *so,
305 struct label *socketlabel, struct mbuf *m,
306 struct label *mbuflabel);
307 int (*mpo_check_socket_listen)(struct ucred *cred,
308 struct socket *so, struct label *socketlabel);
309 int (*mpo_check_socket_receive)(struct ucred *cred,
310 struct socket *so, struct label *socketlabel);
311 int (*mpo_check_socket_relabel)(struct ucred *cred,
312 struct socket *so, struct label *socketlabel,
313 struct label *newlabel);
314 int (*mpo_check_socket_send)(struct ucred *cred,
315 struct socket *so, struct label *socketlabel);
316 int (*mpo_check_socket_visible)(struct ucred *cred,
317 struct socket *so, struct label *socketlabel);
318 int (*mpo_check_system_reboot)(struct ucred *cred, int howto);
319 int (*mpo_check_system_swapon)(struct ucred *cred,
320 struct vnode *vp, struct label *label);
321 int (*mpo_check_system_sysctl)(struct ucred *cred, int *name,
322 u_int namelen, void *old, size_t *oldlenp, int inkernel,
323 void *new, size_t newlen);
324 int (*mpo_check_vnode_access)(struct ucred *cred,
325 struct vnode *vp, struct label *label, int acc_mode);
326 int (*mpo_check_vnode_chdir)(struct ucred *cred,
327 struct vnode *dvp, struct label *dlabel);
328 int (*mpo_check_vnode_chroot)(struct ucred *cred,
329 struct vnode *dvp, struct label *dlabel);
330 int (*mpo_check_vnode_create)(struct ucred *cred,
331 struct vnode *dvp, struct label *dlabel,
332 struct componentname *cnp, struct vattr *vap);
333 int (*mpo_check_vnode_delete)(struct ucred *cred,
334 struct vnode *dvp, struct label *dlabel,
335 struct vnode *vp, struct label *label,
336 struct componentname *cnp);
337 int (*mpo_check_vnode_deleteacl)(struct ucred *cred,
338 struct vnode *vp, struct label *label, acl_type_t type);
339 int (*mpo_check_vnode_exec)(struct ucred *cred, struct vnode *vp,
340 struct label *label);
341 int (*mpo_check_vnode_getacl)(struct ucred *cred,
342 struct vnode *vp, struct label *label, acl_type_t type);
343 int (*mpo_check_vnode_getextattr)(struct ucred *cred,
344 struct vnode *vp, struct label *label, int attrnamespace,
345 const char *name, struct uio *uio);
346 int (*mpo_check_vnode_link)(struct ucred *cred, struct vnode *dvp,
347 struct label *dlabel, struct vnode *vp,
348 struct label *label, struct componentname *cnp);
349 int (*mpo_check_vnode_lookup)(struct ucred *cred,
350 struct vnode *dvp, struct label *dlabel,
351 struct componentname *cnp);
352 int (*mpo_check_vnode_mmap)(struct ucred *cred, struct vnode *vp,
353 struct label *label, int prot);
354 void (*mpo_check_vnode_mmap_downgrade)(struct ucred *cred,
355 struct vnode *vp, struct label *label, int *prot);
356 int (*mpo_check_vnode_mprotect)(struct ucred *cred,
357 struct vnode *vp, struct label *label, int prot);
358 int (*mpo_check_vnode_open)(struct ucred *cred, struct vnode *vp,
359 struct label *label, int acc_mode);
360 int (*mpo_check_vnode_poll)(struct ucred *active_cred,
361 struct ucred *file_cred, struct vnode *vp,
362 struct label *label);
363 int (*mpo_check_vnode_read)(struct ucred *active_cred,
364 struct ucred *file_cred, struct vnode *vp,
365 struct label *label);
366 int (*mpo_check_vnode_readdir)(struct ucred *cred,
367 struct vnode *dvp, struct label *dlabel);
368 int (*mpo_check_vnode_readlink)(struct ucred *cred,
369 struct vnode *vp, struct label *label);
370 int (*mpo_check_vnode_relabel)(struct ucred *cred,
371 struct vnode *vp, struct label *vnodelabel,
372 struct label *newlabel);
373 int (*mpo_check_vnode_rename_from)(struct ucred *cred,
374 struct vnode *dvp, struct label *dlabel, struct vnode *vp,
375 struct label *label, struct componentname *cnp);
376 int (*mpo_check_vnode_rename_to)(struct ucred *cred,
377 struct vnode *dvp, struct label *dlabel, struct vnode *vp,
378 struct label *label, int samedir,
379 struct componentname *cnp);
380 int (*mpo_check_vnode_revoke)(struct ucred *cred,
381 struct vnode *vp, struct label *label);
382 int (*mpo_check_vnode_setacl)(struct ucred *cred,
383 struct vnode *vp, struct label *label, acl_type_t type,
384 struct acl *acl);
385 int (*mpo_check_vnode_setextattr)(struct ucred *cred,
386 struct vnode *vp, struct label *label, int attrnamespace,
387 const char *name, struct uio *uio);
388 int (*mpo_check_vnode_setflags)(struct ucred *cred,
389 struct vnode *vp, struct label *label, u_long flags);
390 int (*mpo_check_vnode_setmode)(struct ucred *cred,
391 struct vnode *vp, struct label *label, mode_t mode);
392 int (*mpo_check_vnode_setowner)(struct ucred *cred,
393 struct vnode *vp, struct label *label, uid_t uid,
394 gid_t gid);
395 int (*mpo_check_vnode_setutimes)(struct ucred *cred,
396 struct vnode *vp, struct label *label,
397 struct timespec atime, struct timespec mtime);
398 int (*mpo_check_vnode_stat)(struct ucred *active_cred,
399 struct ucred *file_cred, struct vnode *vp,
400 struct label *label);
401 int (*mpo_check_vnode_write)(struct ucred *active_cred,
402 struct ucred *file_cred, struct vnode *vp,
403 struct label *label);
404};
405
406struct mac_policy_conf {
407 char *mpc_name; /* policy name */
408 char *mpc_fullname; /* policy full name */
409 struct mac_policy_ops *mpc_ops; /* policy operations */
410 int mpc_loadtime_flags; /* flags */
411 int *mpc_field_off; /* security field */
412 int mpc_runtime_flags; /* flags */
413 LIST_ENTRY(mac_policy_conf) mpc_list; /* global list */
414};
415
416/* Flags for the mpc_loadtime_flags field. */
417#define MPC_LOADTIME_FLAG_NOTLATE 0x00000001
418#define MPC_LOADTIME_FLAG_UNLOADOK 0x00000002
419
420/* Flags for the mpc_runtime_flags field. */
421#define MPC_RUNTIME_FLAG_REGISTERED 0x00000001
422
423#define MAC_POLICY_SET(mpops, mpname, mpfullname, mpflags, privdata_wanted) \
424 static struct mac_policy_conf mpname##_mac_policy_conf = { \
425 #mpname, \
426 mpfullname, \
427 mpops, \
428 mpflags, \
429 privdata_wanted, \
430 0, \
431 }; \
432 static moduledata_t mpname##_mod = { \
433 #mpname, \
434 mac_policy_modevent, \
435 &mpname##_mac_policy_conf \
436 }; \
437 MODULE_DEPEND(mpname, kernel_mac_support, 1, 1, 1); \
438 DECLARE_MODULE(mpname, mpname##_mod, SI_SUB_MAC_POLICY, \
439 SI_ORDER_MIDDLE)
440
441int mac_policy_modevent(module_t mod, int type, void *data);
442
443#define LABEL_TO_SLOT(l, s) (l)->l_perpolicy[s]
444
445#endif /* !_SYS_MAC_POLICY_H */