作者:wzt
原文链接:https://mp.weixin.qq.com/s/Tm4z-_po6DmurcneKQ536A
XNU将进程凭证credential、文件系统acl授权、进程和文件系统监控这几个安全功能抽象为一个安全框架,叫做kauth子系统。它的具体功能主要包含:
- 进程凭证credential的创建、更新、销毁。
- 文件系统acl的创建、评估、销毁。
- 提供kauth scope框架,对进程、文件系统做监控, 支持系统默认监控函数,提供kpi接口,使得第三方内核扩展可以动态添加钩子。
XNU与传统UNIX的进程凭证cred稍有不同。
bsd/sys/ucred.h: struct ucred { TAILQ_ENTRY(ucred) cr_link; /* never modify this without KAUTH_CRED_HASH_LOCK */ u_long cr_ref; /* reference count */ struct posix_cred { uid_t cr_uid; /* effective user id */ uid_t cr_ruid; /* real user id */ uid_t cr_svuid; /* saved user id */ short cr_ngroups; /* number of groups in advisory list */ gid_t cr_groups[NGROUPS]; /* advisory group list */ gid_t cr_rgid; /* real group id */ gid_t cr_svgid; /* saved group id */ uid_t cr_gmuid; /* UID for group membership purposes */ int cr_flags; /* flags on credential */ } cr_posix; struct label *cr_label; /* MAC label */ struct au_session cr_audit; /* user auditing data */ };
struct ucred基本继承了BSD的ucred结构,保留了MAC label和audit审计成员,因为xnu内核完全继承了BSD的MAC和audit子系统能力。同时去掉了poison成员, xnu没有使用bsd jail的功能,对于xnu的沙箱功能,在后面的系列文章中在详细介绍。xnu ucred仍然包含用户所在的组概念,成员cr_groups数组长度为16,是unix家族中标准的用户组大小。除了cr_groups,xnu使用kauth子系统扩展了用户所在组的概念,cr_groups包含的仅是本地机器的用户组,Mac OS可以作为服务器使用,kauth建立了一种额外的扩展能力,可以将网络上的其他机器用户组包含到本地组里。
XNU是一个混合的内核,mach微内核部分控制内核的进程创建与调度功能, mach的进程结构体包含了指向bsd进程和线程结构体的指针,而cred是BSD内核的功能,自然包含在bsd封装的进程和线程结构体里,它们之间的数据结构体关系如下:
内核通过current_thread()宏来获取mach层的struct thread指针,以i386架构为例:
osfmk/i386/cpu_data.h #define current_thread_fast() get_active_thread() #define current_thread() current_thread_fast() static inline __pure2 thread_t get_active_thread(void) { CPU_DATA_GET(cpu_active_thread,thread_t) } #define CPU_DATA_GET(member,type) \ type ret; \ __asm__ volatile ("mov %%gs:%P1,%0" \ : "=r" (ret) \ : "i" (offsetof(cpu_data_t,member))); \ return ret; typedef struct cpu_data { thread_t cpu_active_thread; } cpu_data_t;
cpu_data_t结构体里的cpu_active_thread成员指向的就是当前cpu指向的mac thread指针, 通过offsetof宏计算处它的偏移,在i386下%gs:offset保存的就是它的地址。X64下保存在%fs:offset。
内核通过get_bsdthread_info函数获取mac thread指向的bsd thread指针:
osfmk/kern/bsd_kern.c void *get_bsdthread_info(thread_t th) { return(th->uthread); }
内核通过get_threadtask函数获取mac thread指向的mac task指针,然后就可以通过mac task找到bsd进程的proc指针。
osfmk/kern/bsd_kern.c task_t get_threadtask(thread_t th) { return(th->task); } void *get_bsdtask_info(task_t t) { return(t->bsd_info); }
内核通过kauth_cred_get函数获取进程的cred结构指针,根据以上结构信息也就不难理解了。
bsd/kern/kern_credential.c kauth_cred_t kauth_cred_get(void) { struct proc *p; struct uthread *uthread; uthread = get_bsdthread_info(current_thread()); if (uthread == NULL) panic("thread wants credential but has no BSD thread info"); if (uthread->uu_ucred == NOCRED) { if ((p = (proc_t) get_bsdtask_info(get_threadtask(current_thread()))) == NULL) panic("thread wants credential but has no BSD process"); uthread->uu_ucred = kauth_cred_proc_ref(p); } return(uthread->uu_ucred); }
XNU对于进程cred的维护与BSD、linux有所不同, 它将每个进程的cred缓存在一个hash表里,对于复制cred等操作,可以通过引用计数来实现,在它的代码注释中提到这种优化对于一个桌面系统来讲,可以至少节省200k左右的内存。
前面提到xnu扩展了bsd的用户组管理机制,在内核中叫做kauth resolver机制, 在kauth初始化时,建立了几个队列,当内核使用cred进行用户组授权的过程中, 将本次请求封装为一个worker,加入相应的队列中等待用户态进程进行处理。xnu增加了一个系统调用identitysvc,用户进程使用这个系统调用与kauth通讯,比如获取等待队列中的worker,然后在用户态进行处理。用户组涉及到的处理逻辑相对复杂,xnu直接引用了windows nt内核的sid概念来完善kuath授权系统。
bsd/kern/kern_authorization.c void kauth_init(void) { #if CONFIG_EXT_RESOLVER kauth_identity_init();[1] kauth_groups_init();[2] #endif #if CONFIG_EXT_RESOLVER kauth_resolver_init();[3] #endif }
Kauth_init在初始时[1]处调用kauth_identity_init()初始化kauth_identities链表,每个节点是struct kauth_identity结构体,这个链表用来缓存cred的身份信息,因为如果每次身份验证时都要用户态进程参与,那么效率将会非常低,kauth在每次用户态验证完时,将验证成功的身份信息缓存在kauth_identities链表里,下次验证时将在缓存里进行搜索,如果没有匹配到,在通知用户态进程处理。[2]处的kauth_groups_init()函数功能机理与上述一致。[3]处的kauth_resolver_init函数初始化了三个队列,分别为kauth_resolver_unsubmitted、kauth_resolver_submitted、kauth_resolver_done。
用户态进程通过调用identitysvc系统调用在内核中进行注册,更新缓存大小、获取处理任务以及发送任务的处理结果。
先来看下用户进程的注册过程。
bsd/kern/kern_credential.c int identitysvc(__unused struct proc *p, struct identitysvc_args *uap, __unused int32_t *retval) { if (opcode == KAUTH_EXTLOOKUP_REGISTER) { new_id = current_proc()->p_pid; if ((error = kauth_authorize_generic(kauth_cred_get(), KAUTH_GENERIC_ISSUSER)) != 0) { [1] KAUTH_DEBUG("RESOLVER - pid %d refused permission to become identity resolver", new_id); return(error); } if (kauth_resolver_identity != new_id) {[2] kauth_resolver_identity = new_id;[3] kauth_resolver_registered = 1; wakeup(&kauth_resolver_unsubmitted);[4] }
当来自用户空间的请求码为KAUTH_EXTLOOKUP_REGISTER时, 在[1]处调用 kauth_authorize_generic, 这是后面将要讲到的kauth scope监控机制,当前内核的默认授权只是检测当前进程uid是不是为0, 也就是说只有root权限用户才可以注册。[2]处判断当前进程和之前注册的进程号是否相同,如果不相同就会用当前进程号替换原来的进程号kauth_resolver_identity,然后在[4]处唤醒kauth_resolver_unsubmitted等待队列上的进程。
我们看到用户进程的注册过程相当简单,这里就会有几个安全问题。所有root进程都可以进行注册,linux使用了capability进一步将root权限进行了划分, 比如auditd的注册就需要有CAP_NET_ADMIN这个能力才可以。而XNU并没有继承BSD的capability能力模型以及privilege特权模型,这使得它对内核权限的控制就没有那么细致化。其次新的用户进程直接就可以替换老的用户进程,并没有使用一些可信验证手段, 这使得任何的恶意root进程都可以对其进行替换和仿冒,这样身份验证机制就形同虚设了。
我们在来看下用户进程是如何从内核获取任务的。
bsd/kern/kern_credential.c int identitysvc(__unused struct proc *p, struct identitysvc_args *uap, __unused int32_t *retval) { if (opcode & KAUTH_EXTLOOKUP_WORKER) { if ((error = kauth_resolver_getwork(message)) != 0) return(error); } } static int kauth_resolver_getwork(user_addr_t message) { struct kauth_resolver_work *workp; while ((workp = TAILQ_FIRST(&kauth_resolver_unsubmitted)) == NULL) { thread_t thread = current_thread(); struct uthread *ut = get_bsdthread_info(thread); ut->uu_save.uus_kauth.message = message; error = msleep0(&kauth_resolver_unsubmitted, kauth_resolver_mtx, PCATCH, "GRGetWork", 0, kauth_resolver_getwork_continue); KAUTH_RESOLVER_UNLOCK(); if (!kauth_resolver_identity) { printf("external resolver died"); error = KAUTH_RESOLVER_FAILED_ERRCODE; } return(error); } return kauth_resolver_getwork2(message); }
kauth_resolver_getwork函数用户获取内核任务, 首先判断kauth_resolver_unsubmitted队列是否为空,这个队列保存的是内核发布的等待用户进程获取的任务节点,下一小节会对其进行描述。如果队列为空,就使用msleep进行睡眠,同时回调函数设置为kauth_resolver_getwork_continue,这个函数只是继续判断队列是否为空,然后递归调用自己。当队列不为空时,会调用kauth_resolver_getwork2。它从kauth_resolver_unsubmitted队列头取下一个节点,用copyout函数拷贝给用户空间的进程,然后将这个节点移入到kauth_resolver_submitted队列,这样用户进程就获取了要进行身份验证的信息。
当用户进程处理完毕后,处理结果要返回给内核。
bsd/kern/kern_credential.c int identitysvc(__unused struct proc *p, struct identitysvc_args *uap, __unused int32_t *retval) { if (opcode & KAUTH_EXTLOOKUP_RESULT) { if ((error = kauth_resolver_complete(message)) != 0) return(error); } } static int kauth_resolver_complete(user_addr_t message) { if ((error = copyin(message, &extl, sizeof(extl))) != 0) { KAUTH_DEBUG("RESOLVER - error getting completed work\n"); return(error); } if (extl.el_result != KAUTH_EXTLOOKUP_FATAL) { TAILQ_FOREACH(workp, &kauth_resolver_submitted, kr_link) { if (workp->kr_seqno == extl.el_seqno) { TAILQ_INSERT_TAIL(&kauth_resolver_done, workp, kr_link); }
kauth_resolver_complete通过copyin将用户信息拷贝到内核,然后遍历kauth_resolver_submitted队列,根据seq号找到对应的节点,更新处理信息,然后将这个节点移动到kauth_resolver_done队列。
当涉及到cred的身份验证时,kauth调用kauth_cred_cache_lookup函数进行处理。
bsd/kern/kern_credential.c static int kauth_cred_cache_lookup(int from, int to, void *src, void *dst) { switch(from) { case KI_VALID_UID:[1] error = kauth_identity_find_uid(*(uid_t *)src, &ki, namebuf); if (expired) { if (!expired(&ki)) {[2] KAUTH_DEBUG("CACHE - entry valid, unexpired"); error = kauth_resolver_submit(&el, extend_data);[3] if (error == 0) { kauth_identity_updatecache(&el, &ki, extend_data);[4] }
kauth在kauth_identities cache中维护着一个转换列表,cred中的uid可以对应kauth_identities中的guid、ntsid等等。比如转换类型为KI_VALID_UID,则在[1]处调用kauth_identity_find_uid,在cache中进行搜索。找到后,还要在[2]处进行验证身份信息是否过
static int kauth_resolver_submit(struct kauth_identity_extlookup *lkp, uint64_t extend_data) { struct kauth_resolver_work *workp, *killp; MALLOC(workp, struct kauth_resolver_work *, sizeof(*workp), M_KAUTH, M_WAITOK); [1] if (workp == NULL) return(ENOMEM); workp->kr_work = *lkp; workp->kr_extend = extend_data; workp->kr_refs = 1; workp->kr_flags = KAUTH_REQUEST_UNSUBMITTED; workp->kr_result = 0; KAUTH_RESOLVER_LOCK(); workp->kr_seqno = workp->kr_work.el_seqno = kauth_resolver_sequence++; workp->kr_work.el_result = KAUTH_EXTLOOKUP_INPROG; TAILQ_INSERT_TAIL(&kauth_resolver_unsubmitted, workp, kr_link); [2] wakeup_one((caddr_t)&kauth_resolver_unsubmitted); [3] error = __KERNEL_IS_WAITING_ON_EXTERNAL_CREDENTIAL_RESOLVER__(workp); [4] if (error == 0) *lkp = workp->kr_work; [5] }
期。如果没找到会在[3]处调用kauth_resolver_submit, 将当前处理信息封装为一个struct kauth_identity_extlookup结构体发送到等待队列中进行处理。
[1] 处封装为一个struct kauth_resolver_work worker节点,在[2]处挂接到kauth_resolver_unsubmitted队列末尾,在[3]处唤醒在这个等待队列上睡眠的进程,通常为用户态的memberd守护进程。然后在[4]处调用 _KERNEL_IS_WAITING_ON_EXTERNAL_CREDENTIAL_RESOLVER_函数,它一直调用msleep睡眠kauth_resolver_timeout秒,再次被唤醒后,检查worker的状态是否为KAUTH_REQUEST_DONE,如果是则函数返回,否则继续睡眠重复上述行为。当worker被处理完毕后,在[5]处保存更新后的信息。这个信息是用户态进程处理完毕后使用identitysvc系统调用进行同步的。回到kauth_cred_cache_lookup函数,它将调用kauth_identity_updatecache在缓存中更新相关信息。
Kauth定义了一个scope监控框架,提供默认和第三方内核扩展回调函数支持,可以对进程和文件系统的关键行为进行监控。
监控类型有几下几种:
bsd/sys/kauth.h #define KAUTH_SCOPE_GENERIC "com.apple.kauth.generic" #define KAUTH_SCOPE_PROCESS "com.apple.kauth.process" #define KAUTH_SCOPE_VNODE "com.apple.kauth.vnode" #define KAUTH_SCOPE_FILEOP "com.apple.kauth.fileop"
KAUTH_SCOPE_GENERIC是通用的内核事件监控函数,比如在前面章节讲到的用户态进程注册kauth resovler时就调用了它的默认监控函数,只判断进程的uid号是否为0。
KAUTH_SCOPE_PROCESS提供进程事件的相关监控,目前只对能否向目标进程发送信号和是否有调试权限做了监控。
KAUTH_SCOPE_VNODE提供了对vnode的权限检查以及acl评估功能。
KAUTH_SCOPE_FILEOP提供了对文件状态和属性更改的监控,它类似于linux的fsnotify文件系统监控框架。
Kauth子系统定义了struct kauth_scope结构:
#define KAUTH_SCOPE_MAX_LISTENERS 15 struct kauth_scope { TAILQ_ENTRY(kauth_scope) ks_link; volatile struct kauth_local_listener ks_listeners[KAUTH_SCOPE_MAX_LISTENERS]; const char * ks_identifier; kauth_scope_callback_t ks_callback; void * ks_idata; u_int ks_flags; };
ks_callback即为默认的callback函数。ks_listeners为第三方内核扩展定义的callback函数。每个scope最多有15个扩展回调函数。
struct kauth_local_listener { kauth_listener_t kll_listenerp; kauth_scope_callback_t kll_callback; void * kll_idata; }
内核使用kauth_register_scope注册一个scope。
kauth_scope_t kauth_register_scope(const char *identifier, kauth_scope_callback_t callback, void *idata) { kauth_scope_t sp, tsp; kauth_listener_t klp; if ((sp = kauth_alloc_scope(identifier, callback, idata)) == NULL) return(NULL); KAUTH_SCOPELOCK(); TAILQ_FOREACH(tsp, &kauth_scopes, ks_link) { if (strncmp(tsp->ks_identifier, identifier, strlen(tsp->ks_identifier) + 1) == 0) { KAUTH_SCOPEUNLOCK(); FREE(sp, M_KAUTH); return(NULL); } } TAILQ_INSERT_TAIL(&kauth_scopes, sp, ks_link); restart: TAILQ_FOREACH(klp, &kauth_dangling_listeners, kl_link) { if (strncmp(klp->kl_identifier, sp->ks_identifier, strlen(klp->kl_identifier) + 1) == 0) { if (kauth_add_callback_to_scope(sp, klp) == 0) { TAILQ_REMOVE(&kauth_dangling_listeners, klp, kl_link); } else { break; } goto restart; } } KAUTH_SCOPEUNLOCK(); return(sp); }
所有scope存在于kauth_scopes链表,kauth_register_scope首先根据名称搜索是否已经存在重名的scope节点,存在直接返回。如果不存在的话,将其挂接于kauth_scopes链表末尾。然后它遍历kauth_dangling_listeners链表,这里保存的是备用的第三方回调函数节点kauth listener, 调用kauth_add_callback_to_scope将其添加到对应的scope listener数组里。
static int kauth_add_callback_to_scope(kauth_scope_t sp, kauth_listener_t klp) { int i; for (i = 0; i < KAUTH_SCOPE_MAX_LISTENERS; i++) { if (sp->ks_listeners[i].kll_listenerp == NULL) { sp->ks_listeners[i].kll_callback = klp->kl_callback; sp->ks_listeners[i].kll_idata = klp->kl_idata; sp->ks_listeners[i].kll_listenerp = klp; sp->ks_flags |= KS_F_HAS_LISTENERS; return(0); } } return(ENOSPC); }
内核使用kauth_listen_scope函数注册一个第三方内核扩展listener到一个scope上。
kauth_listener_t kauth_listen_scope(const char *identifier, kauth_scope_callback_t callback, void *idata) { kauth_listener_t klp; kauth_scope_t sp; if ((klp = kauth_alloc_listener(identifier, callback, idata)) == NULL) return(NULL); KAUTH_SCOPELOCK(); TAILQ_FOREACH(sp, &kauth_scopes, ks_link) { if (strncmp(sp->ks_identifier, identifier, strlen(sp->ks_identifier) + 1) == 0) { if (kauth_add_callback_to_scope(sp, klp) == 0) { KAUTH_SCOPEUNLOCK(); return(klp); } KAUTH_SCOPEUNLOCK(); FREE(klp, M_KAUTH); return(NULL); } } TAILQ_INSERT_TAIL(&kauth_dangling_listeners, klp, kl_link); KAUTH_SCOPEUNLOCK(); return(klp); }
它的注册逻辑也非常简单,首先遍历kauth_scopes链表找到对应的scope,如果找到,就调用kauth_add_callback_to_scope将其加入scope的listener数组里。如果没找到,将这个节点挂接于kauth_dangling_listeners备用链表中, 当需要的scope被注册时,会自动从kauth_dangling_listeners链表中找到这个节点并挂接上去。
在需要监控的内核路径中, 会调用kauth_authorize_action函数。
int kauth_authorize_action(kauth_scope_t scope, kauth_cred_t credential, kauth_action_t action, uintptr_t arg0, uintptr_t arg1, uintptr_t arg2, uintptr_t arg3) { int result, ret, i; if (scope->ks_callback != NULL) result = scope->ks_callback(credential, scope->ks_idata, action, arg0, arg1, else result = KAUTH_RESULT_DEFER; if ((scope->ks_flags & KS_F_HAS_LISTENERS) != 0) { for (i = 0; i < KAUTH_SCOPE_MAX_LISTENERS; i++) { ret = scope->ks_listeners[i].kll_callback( credential, scope->ks_listeners[i].kll_idata, action, arg0, arg1, arg2, arg3); if ((ret == KAUTH_RESULT_DENY) || (result == KAUTH_RESULT_DEFER)) result = ret; } } return(result == KAUTH_RESULT_ALLOW ? 0 : EPERM); }
首先它会调用默认的回调函数,然后如果此scope有listener,则将依次调用listener注册的回调函数, 算法有点类似acl评估机制,如果有一个listener拒绝的话就直接返回失败。
Kauth在初始化的时候调用kauth_scope_init初始化三个监控类型的scope。
static void kauth_scope_init(void) { kauth_scope_mtx = lck_mtx_alloc_init(kauth_lck_grp, 0 /*LCK_ATTR_NULL*/); kauth_scope_process = kauth_register_scope(KAUTH_SCOPE_PROCESS, kauth_authorize_process_callback, NULL); kauth_scope_generic = kauth_register_scope(KAUTH_SCOPE_GENERIC, kauth_authorize_generic_callback, NULL); kauth_scope_fileop = kauth_register_scope(KAUTH_SCOPE_FILEOP, NULL, NULL); }
对于进程的监控,注册的默认回调函数为kauth_authorize_process_callback。
static int kauth_authorize_process_callback(kauth_cred_t credential, __unused void *idata, kauth_action_t action, uintptr_t arg0, uintptr_t arg1, __unused uintptr_t arg2, __unused uintptr_t arg3) { switch(action) { case KAUTH_PROCESS_CANSIGNAL: panic("KAUTH_PROCESS_CANSIGNAL not implemented"); if (cansignal(current_proc(), credential, (struct proc *)arg0, (int)arg1)) return(KAUTH_RESULT_ALLOW); break; case KAUTH_PROCESS_CANTRACE: if (cantrace(current_proc(), credential, (proc_t)arg0, (int *)arg1)) return(KAUTH_RESULT_ALLOW); break; } return(KAUTH_RESULT_DEFER); }
回调函数非常简单,只判断进程是否有trace能力,对于是否能有发送信号的能力,xnu内核开发者估计也没想好,panic函数直接写在了cansignal函数的前面。
在kauth_scope_init初始化时,并没有对KAUTH_SCOPE_FILEOP类型的scope设置默认回调函数。
static void kauth_scope_init(void) { kauth_scope_fileop = kauth_register_scope(KAUTH_SCOPE_FILEOP, NULL, NULL); }
在文件状态发生变更的地方,都调用了kauth_authorize_fileop函数,它继而调用kauth_authorize_action函数,由于KAUTH_SCOPE_FILEOP类型的scope没有默认回调函数,它将继续判断是否有加载第三方内核扩展的回调函数。对于文件系统状态监控,开发人员需要自己编写一个内核扩展注册listene回调函数到scope中才行,xnu内核并没有提供默认的内核扩展。
kauth_authorize_fileop函数定义为:
int
kauth_authorize_fileop(kauth_cred_t credential, kauth_action_t action, uintptr_t arg0, uintptr_t arg1);
内核在文件系统的不同路径调用它,最后两个参数在不同的调用路径对应不同的意义。内核注释代码中写的很详细:
对于文件vnode监控的kauth scope注册是放在文件系统初始化进行的:
bsd/vfs/vfs_subr.c void vnode_authorize_init(void) { vnode_scope = kauth_register_scope(KAUTH_SCOPE_VNODE, vnode_authorize_callback, NULL); }
它注册的callback函数为vnode_authorize_callback。vnode的权限检查包括以下几个:
为了加快检查速度,xnu使用了一个cache机制,在vnode的结构体加入了v_authorized_actions成员,它代表了上一次是做的哪项权限检查,通过调用vnode_cache_is_authorized执行vp->v_authorized_actions & action,来判断是否命中上次cache,之后在执行完权限检查后,通过调用vnode_cache_authorized_action执行vp->v_authorized_actions |= action更新cache。
Xnu将文件系统的acl评估机制也封装到了kauth子系统里。
bsd/sys/kauth.h struct kauth_acl { u_int32_t acl_entrycount; u_int32_t acl_flags; struct kauth_ace acl_ace[1]; };
acl_entrycount表示的是struct kauth_ace acl_ace数组的大小。
struct kauth_ace { guid_t ace_applicable; u_int32_t ace_flags; kauth_ace_rights_t ace_rights; };
一个acl entry定义为struct kauth_ace结构,acl评估的业界通用算法就是从前到后,依次对比每个ace项,如果权限匹配为deny,则直接返回失败,否则进行下一个ace匹配。
在函数vnode_authorize_simple里判断vnode结构的acl链表是否为空,如果不为空则调用kauth_acl_evaluate进行acl权限检查。
本文由 Seebug Paper 发布,如需转载请注明来源。本文地址:https://paper.seebug.org/1472/