2 * Copyright (c) 2007-2010 Apple Inc. All rights reserved.
4 * @APPLE_OSREFERENCE_LICENSE_HEADER_START@
6 * This file contains Original Code and/or Modifications of Original Code
7 * as defined in and that are subject to the Apple Public Source License
8 * Version 2.0 (the 'License'). You may not use this file except in
9 * compliance with the License. The rights granted to you under the License
10 * may not be used to create, or enable the creation or redistribution of,
11 * unlawful or unlicensed copies of an Apple operating system, or to
12 * circumvent, violate, or enable the circumvention or violation of, any
13 * terms of an Apple operating system software license agreement.
15 * Please obtain a copy of the License at
16 * http://www.opensource.apple.com/apsl/ and read it before using this file.
18 * The Original Code and all software distributed under the License are
19 * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
20 * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
21 * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
22 * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT.
23 * Please see the License for the specific language governing rights and
24 * limitations under the License.
26 * @APPLE_OSREFERENCE_LICENSE_HEADER_END@
30 * Copyright (c) 1999, 2000, 2001, 2002 Robert N. M. Watson
31 * Copyright (c) 2001 Ilmar S. Habibulin
32 * Copyright (c) 2001, 2002, 2003, 2004 Networks Associates Technology, Inc.
34 * This software was developed by Robert Watson and Ilmar Habibulin for the
37 * This software was developed for the FreeBSD Project in part by Network
38 * Associates Laboratories, the Security Research Division of Network
39 * Associates, Inc. under DARPA/SPAWAR contract N66001-01-C-8035 ("CBOSS"),
40 * as part of the DARPA CHATS research program.
42 * Redistribution and use in source and binary forms, with or without
43 * modification, are permitted provided that the following conditions
45 * 1. Redistributions of source code must retain the above copyright
46 * notice, this list of conditions and the following disclaimer.
47 * 2. Redistributions in binary form must reproduce the above copyright
48 * notice, this list of conditions and the following disclaimer in the
49 * documentation and/or other materials provided with the distribution.
51 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
52 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
53 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
54 * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
55 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
56 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
57 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
58 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
59 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
60 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
66 #include <sys/param.h>
67 #include <sys/ucred.h>
68 #include <sys/malloc.h>
70 #include <sys/vnode.h>
72 #include <sys/proc_internal.h>
73 #include <sys/kauth.h>
74 #include <sys/imgact.h>
75 #include <mach/mach_types.h>
76 #include <kern/task.h>
78 #include <security/mac_internal.h>
79 #include <security/mac_mach_internal.h>
81 #include <bsd/security/audit/audit.h>
84 mac_cred_label_alloc(void)
88 label
= mac_labelzone_alloc(MAC_WAITOK
);
92 MAC_PERFORM(cred_label_init
, label
);
97 mac_cred_label_init(struct ucred
*cred
)
99 cred
->cr_label
= mac_cred_label_alloc();
103 mac_cred_label_free(struct label
*label
)
105 MAC_PERFORM(cred_label_destroy
, label
);
106 mac_labelzone_free(label
);
110 mac_cred_label_compare(struct label
*a
, struct label
*b
)
112 return bcmp(a
, b
, sizeof(*a
)) == 0;
116 mac_cred_label_externalize_audit(struct proc
*p
, struct mac
*mac
)
121 cr
= kauth_cred_proc_ref(p
);
123 error
= MAC_EXTERNALIZE_AUDIT(cred
, cr
->cr_label
,
124 mac
->m_string
, mac
->m_buflen
);
126 kauth_cred_unref(&cr
);
131 mac_cred_label_destroy(kauth_cred_t cred
)
133 mac_cred_label_free(cred
->cr_label
);
134 cred
->cr_label
= NULL
;
138 mac_cred_label_externalize(struct label
*label
, char *elements
,
139 char *outbuf
, size_t outbuflen
, int flags __unused
)
143 error
= MAC_EXTERNALIZE(cred
, label
, elements
, outbuf
, outbuflen
);
149 mac_cred_label_internalize(struct label
*label
, char *string
)
153 error
= MAC_INTERNALIZE(cred
, label
, string
);
159 * By default, fork just adds a reference to the parent
160 * credential. Policies may need to know about this reference
161 * if they are tracking exit calls to know when to free the
165 mac_cred_label_associate_fork(kauth_cred_t cred
, proc_t proc
)
167 MAC_PERFORM(cred_label_associate_fork
, cred
, proc
);
171 * Initialize MAC label for the first kernel process, from which other
172 * kernel processes and threads are spawned.
175 mac_cred_label_associate_kernel(kauth_cred_t cred
)
177 MAC_PERFORM(cred_label_associate_kernel
, cred
);
181 * Initialize MAC label for the first userland process, from which other
182 * userland processes and threads are spawned.
185 mac_cred_label_associate_user(kauth_cred_t cred
)
187 MAC_PERFORM(cred_label_associate_user
, cred
);
191 * When a new process is created, its label must be initialized. Generally,
192 * this involves inheritence from the parent process, modulo possible
193 * deltas. This function allows that processing to take place.
196 mac_cred_label_associate(struct ucred
*parent_cred
, struct ucred
*child_cred
)
198 MAC_PERFORM(cred_label_associate
, parent_cred
, child_cred
);
202 mac_execve_enter(user_addr_t mac_p
, struct image_params
*imgp
)
205 struct label
*execlabel
;
210 if (mac_p
== USER_ADDR_NULL
) {
214 if (IS_64BIT_PROCESS(current_proc())) {
215 struct user64_mac mac64
;
216 error
= copyin(mac_p
, &mac64
, sizeof(mac64
));
217 mac
.m_buflen
= mac64
.m_buflen
;
218 mac
.m_string
= mac64
.m_string
;
220 struct user32_mac mac32
;
221 error
= copyin(mac_p
, &mac32
, sizeof(mac32
));
222 mac
.m_buflen
= mac32
.m_buflen
;
223 mac
.m_string
= mac32
.m_string
;
229 error
= mac_check_structmac_consistent(&mac
);
234 execlabel
= mac_cred_label_alloc();
235 MALLOC(buffer
, char *, mac
.m_buflen
, M_MACTEMP
, M_WAITOK
);
236 error
= copyinstr(CAST_USER_ADDR_T(mac
.m_string
), buffer
, mac
.m_buflen
, &ulen
);
240 AUDIT_ARG(mac_string
, buffer
);
242 error
= mac_cred_label_internalize(execlabel
, buffer
);
245 mac_cred_label_free(execlabel
);
248 imgp
->ip_execlabelp
= execlabel
;
249 FREE(buffer
, M_MACTEMP
);
254 * When the subject's label changes, it may require revocation of privilege
255 * to mapped objects. This can't be done on-the-fly later with a unified
258 * XXX: CRF_MAC_ENFORCE should be in a kauth_cred_t field, rather
259 * XXX: than a posix_cred_t field.
262 mac_cred_label_update(kauth_cred_t cred
, struct label
*newlabel
)
264 posix_cred_t pcred
= posix_cred_get(cred
);
266 /* force label to be part of "matching" for credential */
267 pcred
->cr_flags
|= CRF_MAC_ENFORCE
;
269 /* inform the policies of the update */
270 MAC_PERFORM(cred_label_update
, cred
, newlabel
);
274 mac_cred_check_label_update(kauth_cred_t cred
, struct label
*newlabel
)
278 #if SECURITY_MAC_CHECK_ENFORCE
279 /* 21167099 - only check if we allow write */
280 if (!mac_proc_enforce
) {
285 MAC_CHECK(cred_check_label_update
, cred
, newlabel
);
291 mac_cred_check_visible(kauth_cred_t u1
, kauth_cred_t u2
)
295 #if SECURITY_MAC_CHECK_ENFORCE
296 /* 21167099 - only check if we allow write */
297 if (!mac_proc_enforce
) {
302 MAC_CHECK(cred_check_visible
, u1
, u2
);
308 mac_proc_check_debug(proc_ident_t tracing_ident
, kauth_cred_t tracing_cred
, proc_ident_t traced_ident
)
314 #if SECURITY_MAC_CHECK_ENFORCE
315 /* 21167099 - only check if we allow write */
316 if (!mac_proc_enforce
) {
321 * Once all mac hooks adopt proc_ident_t, finding proc_t and releasing
322 * it below should go to mac_proc_check_enforce().
324 if ((tracingp
= proc_find_ident(tracing_ident
)) == PROC_NULL
) {
327 enforce
= mac_proc_check_enforce(tracingp
);
333 MAC_CHECK(proc_check_debug
, tracing_cred
, traced_ident
);
339 mac_proc_check_dump_core(struct proc
*proc
)
343 #if SECURITY_MAC_CHECK_ENFORCE
344 /* 21167099 - only check if we allow write */
345 if (!mac_proc_enforce
) {
349 if (!mac_proc_check_enforce(proc
)) {
353 MAC_CHECK(proc_check_dump_core
, proc
);
359 mac_proc_check_remote_thread_create(struct task
*task
, int flavor
, thread_state_t new_state
, mach_msg_type_number_t new_state_count
)
361 proc_t curp
= current_proc();
366 #if SECURITY_MAC_CHECK_ENFORCE
367 /* 21167099 - only check if we allow write */
368 if (!mac_proc_enforce
) {
372 if (!mac_proc_check_enforce(curp
)) {
376 proc
= proc_find(task_pid(task
));
377 if (proc
== PROC_NULL
) {
381 cred
= kauth_cred_proc_ref(curp
);
382 MAC_CHECK(proc_check_remote_thread_create
, cred
, proc
, flavor
, new_state
, new_state_count
);
383 kauth_cred_unref(&cred
);
390 mac_proc_check_fork(proc_t curp
)
395 #if SECURITY_MAC_CHECK_ENFORCE
396 /* 21167099 - only check if we allow write */
397 if (!mac_proc_enforce
) {
401 if (!mac_proc_check_enforce(curp
)) {
405 cred
= kauth_cred_proc_ref(curp
);
406 MAC_CHECK(proc_check_fork
, cred
, curp
);
407 kauth_cred_unref(&cred
);
413 mac_proc_check_get_task_name(struct ucred
*cred
, proc_ident_t pident
)
417 MAC_CHECK(proc_check_get_task_name
, cred
, pident
);
423 mac_proc_check_get_task(struct ucred
*cred
, proc_ident_t pident
)
427 MAC_CHECK(proc_check_get_task
, cred
, pident
);
433 mac_proc_check_expose_task(struct ucred
*cred
, proc_ident_t pident
)
437 MAC_CHECK(proc_check_expose_task
, cred
, pident
);
443 mac_proc_check_inherit_ipc_ports(struct proc
*p
, struct vnode
*cur_vp
, off_t cur_offset
, struct vnode
*img_vp
, off_t img_offset
, struct vnode
*scriptvp
)
447 MAC_CHECK(proc_check_inherit_ipc_ports
, p
, cur_vp
, cur_offset
, img_vp
, img_offset
, scriptvp
);
453 * The type of maxprot in proc_check_map_anon must be equivalent to vm_prot_t
454 * (defined in <mach/vm_prot.h>). mac_policy.h does not include any header
455 * files, so cannot use the typedef itself.
458 mac_proc_check_map_anon(proc_t proc
, user_addr_t u_addr
,
459 user_size_t u_size
, int prot
, int flags
, int *maxprot
)
464 #if SECURITY_MAC_CHECK_ENFORCE
465 /* 21167099 - only check if we allow write */
466 if (!mac_vm_enforce
) {
470 if (!mac_proc_check_enforce(proc
)) {
474 cred
= kauth_cred_proc_ref(proc
);
475 MAC_CHECK(proc_check_map_anon
, proc
, cred
, u_addr
, u_size
, prot
, flags
, maxprot
);
476 kauth_cred_unref(&cred
);
482 mac_proc_check_mprotect(proc_t proc
,
483 user_addr_t addr
, user_size_t size
, int prot
)
488 #if SECURITY_MAC_CHECK_ENFORCE
489 /* 21167099 - only check if we allow write */
490 if (!mac_vm_enforce
) {
494 if (!mac_proc_check_enforce(proc
)) {
498 cred
= kauth_cred_proc_ref(proc
);
499 MAC_CHECK(proc_check_mprotect
, cred
, proc
, addr
, size
, prot
);
500 kauth_cred_unref(&cred
);
506 mac_proc_check_run_cs_invalid(proc_t proc
)
510 #if SECURITY_MAC_CHECK_ENFORCE
511 /* 21167099 - only check if we allow write */
512 if (!mac_vm_enforce
) {
517 MAC_CHECK(proc_check_run_cs_invalid
, proc
);
523 mac_proc_notify_cs_invalidated(proc_t proc
)
525 MAC_PERFORM(proc_notify_cs_invalidated
, proc
);
529 mac_proc_check_sched(proc_t curp
, struct proc
*proc
)
534 #if SECURITY_MAC_CHECK_ENFORCE
535 /* 21167099 - only check if we allow write */
536 if (!mac_proc_enforce
) {
540 if (!mac_proc_check_enforce(curp
)) {
544 cred
= kauth_cred_proc_ref(curp
);
545 MAC_CHECK(proc_check_sched
, cred
, proc
);
546 kauth_cred_unref(&cred
);
552 mac_proc_check_signal(proc_t curp
, struct proc
*proc
, int signum
)
557 #if SECURITY_MAC_CHECK_ENFORCE
558 /* 21167099 - only check if we allow write */
559 if (!mac_proc_enforce
) {
563 if (!mac_proc_check_enforce(curp
)) {
567 cred
= kauth_cred_proc_ref(curp
);
568 MAC_CHECK(proc_check_signal
, cred
, proc
, signum
);
569 kauth_cred_unref(&cred
);
575 mac_proc_check_syscall_unix(proc_t curp
, int scnum
)
579 #if SECURITY_MAC_CHECK_ENFORCE
580 /* 21167099 - only check if we allow write */
581 if (!mac_proc_enforce
) {
585 if (!mac_proc_check_enforce(curp
)) {
589 MAC_CHECK(proc_check_syscall_unix
, curp
, scnum
);
595 mac_proc_check_wait(proc_t curp
, struct proc
*proc
)
600 #if SECURITY_MAC_CHECK_ENFORCE
601 /* 21167099 - only check if we allow write */
602 if (!mac_proc_enforce
) {
606 if (!mac_proc_check_enforce(curp
)) {
610 cred
= kauth_cred_proc_ref(curp
);
611 MAC_CHECK(proc_check_wait
, cred
, proc
);
612 kauth_cred_unref(&cred
);
618 mac_proc_notify_exit(struct proc
*proc
)
620 MAC_PERFORM(proc_notify_exit
, proc
);
624 mac_proc_check_suspend_resume(proc_t proc
, int sr
)
629 #if SECURITY_MAC_CHECK_ENFORCE
630 /* 21167099 - only check if we allow write */
631 if (!mac_proc_enforce
) {
635 if (!mac_proc_check_enforce(current_proc())) {
639 cred
= kauth_cred_proc_ref(current_proc());
640 MAC_CHECK(proc_check_suspend_resume
, cred
, proc
, sr
);
641 kauth_cred_unref(&cred
);
647 mac_proc_check_ledger(proc_t curp
, proc_t proc
, int ledger_op
)
652 #if SECURITY_MAC_CHECK_ENFORCE
653 /* 21167099 - only check if we allow write */
654 if (!mac_proc_enforce
) {
658 if (!mac_proc_check_enforce(curp
)) {
662 cred
= kauth_cred_proc_ref(curp
);
663 MAC_CHECK(proc_check_ledger
, cred
, proc
, ledger_op
);
664 kauth_cred_unref(&cred
);
670 mac_proc_check_proc_info(proc_t curp
, proc_t target
, int callnum
, int flavor
)
675 #if SECURITY_MAC_CHECK_ENFORCE
676 /* 21167099 - only check if we allow write */
677 if (!mac_proc_enforce
) {
681 if (!mac_proc_check_enforce(curp
)) {
685 cred
= kauth_cred_proc_ref(curp
);
686 MAC_CHECK(proc_check_proc_info
, cred
, target
, callnum
, flavor
);
687 kauth_cred_unref(&cred
);
693 mac_proc_check_get_cs_info(proc_t curp
, proc_t target
, unsigned int op
)
698 #if SECURITY_MAC_CHECK_ENFORCE
699 /* 21167099 - only check if we allow write */
700 if (!mac_proc_enforce
) {
704 if (!mac_proc_check_enforce(curp
)) {
708 cred
= kauth_cred_proc_ref(curp
);
709 MAC_CHECK(proc_check_get_cs_info
, cred
, target
, op
);
710 kauth_cred_unref(&cred
);
716 mac_proc_check_set_cs_info(proc_t curp
, proc_t target
, unsigned int op
)
721 #if SECURITY_MAC_CHECK_ENFORCE
722 /* 21167099 - only check if we allow write */
723 if (!mac_proc_enforce
) {
727 if (!mac_proc_check_enforce(curp
)) {
731 cred
= kauth_cred_proc_ref(curp
);
732 MAC_CHECK(proc_check_set_cs_info
, cred
, target
, op
);
733 kauth_cred_unref(&cred
);