Loading...
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 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 | /* * Copyright (c) 2007 Apple Inc. All rights reserved. * * @APPLE_OSREFERENCE_LICENSE_HEADER_START@ * * This file contains Original Code and/or Modifications of Original Code * as defined in and that are subject to the Apple Public Source License * Version 2.0 (the 'License'). You may not use this file except in * compliance with the License. The rights granted to you under the License * may not be used to create, or enable the creation or redistribution of, * unlawful or unlicensed copies of an Apple operating system, or to * circumvent, violate, or enable the circumvention or violation of, any * terms of an Apple operating system software license agreement. * * Please obtain a copy of the License at * http://www.opensource.apple.com/apsl/ and read it before using this file. * * The Original Code and all software distributed under the License are * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES, * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT. * Please see the License for the specific language governing rights and * limitations under the License. * * @APPLE_OSREFERENCE_LICENSE_HEADER_END@ */ /*- * Copyright (c) 1999, 2000, 2001, 2002 Robert N. M. Watson * Copyright (c) 2001 Ilmar S. Habibulin * Copyright (c) 2001, 2002, 2003, 2004 Networks Associates Technology, Inc. * Copyright (c) 2005 SPARTA, Inc. * All rights reserved. * * This software was developed by Robert Watson and Ilmar Habibulin for the * TrustedBSD Project. * * This software was developed for the FreeBSD Project in part by Network * Associates Laboratories, the Security Research Division of Network * Associates, Inc. under DARPA/SPAWAR contract N66001-01-C-8035 ("CBOSS"), * as part of the DARPA CHATS research program. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions * are met: * 1. Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * 2. Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF * SUCH DAMAGE. * */ #ifndef _SECURITY_MAC_INTERNAL_H_ #define _SECURITY_MAC_INTERNAL_H_ #ifndef PRIVATE #warning "MAC policy is not KPI, see Technical Q&A QA1574, this header will be removed in next version" #endif #include <string.h> #include <sys/param.h> #include <sys/queue.h> #include <security/mac.h> #include <security/mac_framework.h> #include <security/mac_policy.h> #include <security/mac_data.h> #include <sys/sysctl.h> #include <kern/locks.h> #include <sys/kernel.h> #include <sys/lock.h> #include <sys/malloc.h> #include <sys/sbuf.h> #include <sys/proc.h> #include <sys/systm.h> #include <sys/socket.h> #include <sys/socketvar.h> #include <sys/vnode.h> #include <mach/sdt.h> /* * MAC Framework sysctl namespace. */ SYSCTL_DECL(_security); SYSCTL_DECL(_security_mac); extern int mac_late; struct mac_policy_list_element { struct mac_policy_conf *mpc; }; struct mac_policy_list { u_int numloaded; u_int max; u_int maxindex; u_int staticmax; u_int chunks; u_int freehint; struct mac_policy_list_element *entries; }; typedef struct mac_policy_list mac_policy_list_t; /* * Policy that has registered with the framework for a specific * label namespace name. */ struct mac_label_listener { mac_policy_handle_t mll_handle; SLIST_ENTRY(mac_label_listener) mll_list; }; SLIST_HEAD(mac_label_listeners_t, mac_label_listener); /* * Type of list used to manage label namespace names. */ struct mac_label_element { char mle_name[MAC_MAX_LABEL_ELEMENT_NAME]; struct mac_label_listeners_t mle_listeners; SLIST_ENTRY(mac_label_element) mle_list; }; SLIST_HEAD(mac_label_element_list_t, mac_label_element); /* * MAC Framework global variables. */ extern struct mac_label_element_list_t mac_label_element_list; extern struct mac_label_element_list_t mac_static_label_element_list; extern struct mac_policy_list mac_policy_list; /* * global flags to control whether a MACF subsystem is configured * at all in the system. */ extern unsigned int mac_device_enforce; extern unsigned int mac_pipe_enforce; extern unsigned int mac_posixsem_enforce; extern unsigned int mac_posixshm_enforce; extern unsigned int mac_proc_enforce; extern unsigned int mac_socket_enforce; extern unsigned int mac_system_enforce; extern unsigned int mac_sysvmsg_enforce; extern unsigned int mac_sysvsem_enforce; extern unsigned int mac_sysvshm_enforce; extern unsigned int mac_vm_enforce; extern unsigned int mac_vnode_enforce; extern unsigned int mac_label_vnodes; extern unsigned int mac_vnode_label_count; static bool mac_proc_check_enforce(proc_t p); static __inline__ bool mac_proc_check_enforce(proc_t p) { #if CONFIG_MACF // Don't apply policies to the kernel itself. return p != kernproc; #else #pragma unused(p) return false; #endif // CONFIG_MACF } static bool mac_cred_check_enforce(kauth_cred_t cred); static __inline__ bool mac_cred_check_enforce(kauth_cred_t cred) { #if CONFIG_MACF return cred != proc_ucred_unsafe(kernproc); #else #pragma unused(p) return false; #endif // CONFIG_MACF } /* * MAC Framework infrastructure functions. */ int mac_error_select(int error1, int error2); void mac_policy_list_busy(void); int mac_policy_list_conditional_busy(void); void mac_policy_list_unbusy(void); #if KERNEL int mac_check_structmac_consistent(struct user_mac *mac); #else int mac_check_structmac_consistent(struct mac *mac); #endif int mac_cred_label_externalize(struct label *, char *e, char *out, size_t olen, int flags); int mac_vnode_label_externalize(struct label *, char *e, char *out, size_t olen, int flags); int mac_cred_label_internalize(struct label *label, char *string); int mac_vnode_label_internalize(struct label *label, char *string); typedef int (^mac_getter_t)(char *, char *, size_t); typedef int (^mac_setter_t)(char *, size_t); int mac_do_get(struct proc *p, user_addr_t mac_p, mac_getter_t getter); int mac_do_set(struct proc *p, user_addr_t mac_p, mac_setter_t setter); #define MAC_POLICY_ITERATE(...) do { \ struct mac_policy_conf *mpc; \ u_int i; \ \ for (i = 0; i < mac_policy_list.staticmax; i++) { \ mpc = mac_policy_list.entries[i].mpc; \ if (mpc == NULL) \ continue; \ \ __VA_ARGS__ \ } \ if (mac_policy_list_conditional_busy() != 0) { \ for (; i <= mac_policy_list.maxindex; i++) { \ mpc = mac_policy_list.entries[i].mpc; \ if (mpc == NULL) \ continue; \ \ __VA_ARGS__ \ } \ mac_policy_list_unbusy(); \ } \ } while (0) enum mac_iterate_types { MAC_ITERATE_CHECK = 0, // error starts at 0, callbacks can change it MAC_ITERATE_GRANT = 1, // error starts as EPERM, callbacks can clear it MAC_ITERATE_PERFORM = 2, // no result }; /* * MAC_CHECK performs the designated check by walking the policy * module list and checking with each as to how it feels about the * request. Note that it returns its value via 'error' in the scope * of the caller. */ #define MAC_CHECK(check, args...) do { \ error = 0; \ MAC_POLICY_ITERATE({ \ if (mpc->mpc_ops->mpo_ ## check != NULL) { \ DTRACE_MACF3(mac__call__ ## check, void *, mpc, int, error, int, MAC_ITERATE_CHECK); \ int __step_err = mpc->mpc_ops->mpo_ ## check (args); \ DTRACE_MACF2(mac__rslt__ ## check, void *, mpc, int, __step_err); \ error = mac_error_select(__step_err, error); \ } \ }); \ } while (0) /* * MAC_GRANT performs the designated check by walking the policy * module list and checking with each as to how it feels about the * request. Unlike MAC_CHECK, it grants if any policies return '0', * and otherwise returns EPERM. Note that it returns its value via * 'error' in the scope of the caller. */ #define MAC_GRANT(check, args...) do { \ error = EPERM; \ MAC_POLICY_ITERATE({ \ if (mpc->mpc_ops->mpo_ ## check != NULL) { \ DTRACE_MACF3(mac__call__ ## check, void *, mpc, int, error, int, MAC_ITERATE_GRANT); \ int __step_res = mpc->mpc_ops->mpo_ ## check (args); \ if (__step_res == 0) { \ error = 0; \ } \ DTRACE_MACF2(mac__rslt__ ## check, void *, mpc, int, __step_res); \ } \ }); \ } while (0) #define MAC_INTERNALIZE(obj, label, instring) \ mac_internalize(offsetof(struct mac_policy_ops, mpo_ ## obj ## _label_internalize), label, instring) #define MAC_EXTERNALIZE(obj, label, elementlist, outbuf, outbuflen) \ mac_externalize(offsetof(struct mac_policy_ops, mpo_ ## obj ## _label_externalize), label, elementlist, outbuf, outbuflen) #define MAC_EXTERNALIZE_AUDIT(obj, label, outbuf, outbuflen) \ mac_externalize(offsetof(struct mac_policy_ops, mpo_ ## obj ## _label_externalize_audit), label, "*", outbuf, outbuflen) #define MAC_PERFORM_CALL(operation, mpc) DTRACE_MACF3(mac__call__ ## operation, void *, mpc, int, 0, int, MAC_ITERATE_PERFORM) #define MAC_PERFORM_RSLT(operation, mpc) DTRACE_MACF2(mac__rslt__ ## operation, void *, mpc, int, 0) /* * MAC_PERFORM performs the designated operation by walking the policy * module list and invoking that operation for each policy. */ #define MAC_PERFORM(operation, args...) do { \ MAC_POLICY_ITERATE({ \ if (mpc->mpc_ops->mpo_ ## operation != NULL) { \ MAC_PERFORM_CALL(operation, mpc); \ mpc->mpc_ops->mpo_ ## operation (args); \ MAC_PERFORM_RSLT(operation, mpc); \ } \ }); \ } while (0) # struct __mac_get_pid_args; struct __mac_get_proc_args; struct __mac_set_proc_args; struct __mac_get_lcid_args; struct __mac_get_fd_args; struct __mac_get_file_args; struct __mac_get_link_args; struct __mac_set_fd_args; struct __mac_set_file_args; struct __mac_syscall_args; void mac_policy_addto_labellist(const mac_policy_handle_t, int); void mac_policy_removefrom_labellist(const mac_policy_handle_t); int mac_externalize(size_t mpo_externalize_off, struct label *label, const char *elementlist, char *outbuf, size_t outbuflen); int mac_internalize(size_t mpo_internalize_off, struct label *label, char *elementlist); #endif /* !_SECURITY_MAC_INTERNAL_H_ */ |