编程实现遍历ACL访问控制列表检查进程访问权限

首发Freebuf.com了，欢迎关注FreeBuf.

Author:Pnig0s[FreeBuf]

阅读本文的朋友需要对Windows访问控制模型有初步的了解，了解Token(访问令牌)，ACL(访问控制列表)，DACL(选择访问控制列表)，ACE(访问控制列表项)等与访问控制模型相关的名词含义及之间的关系，当然我也会在文中简要科普一下ACM。 

写这篇文章的目的主要是最近在写一个Win下本地提权的东西，涉及到了对ACL的操作，以前对ACL总是避而远之，Windows访问控制模型很复杂很头疼一个API会牵出一大把初始化要用的API。毕竟涉及到用户访问的安全，肯定不能让编程人员随意更改这些机制，复杂一些也可以理解，相关API和结构体复杂，可是参考文献奇少，MSDN上关于一些访问控制相关API的使用和结构体的描述都含糊不清也没有什么代码实例。这篇文章也是在查阅国外了一些文献加上自己研究测试之后完成的，发出来希望对涉及这方面编程的朋友有帮助。

--->>熟悉Windows访问控制机制的可以跳过本段：

因为是科普我这里简单介绍下Windows访问控制模型(ACM)，别嫌我��嗦，懂得直接Pass往下看。ACM中最重要的两部分是访问令牌(Access Token)和安全描述符表(Security Descriptor)。访问令牌存在于访问主体中，安全描述符表存在于访问客体中。比如我去米国，我就是访问主体，米国就是访问客体，我持有的签证就是访问令牌。系统中访问主体是进程客体是一切系统对象。访问令牌中有当前用户的唯一标识SID，组唯一标识SID以及一些权限标志(Privilege)。安全描述符表(SD)存在于Windows系统中的任何对象中(文件，注册表，互斥量，信号量等等)。SD中包含对象所有者的SID，组SID以及两个非常重要的数据结构选择访问控制列表(DACL)和系统访问控制列表(SACL)，其中SACL涉及系统日志用的很少可以先无视。DACL中包含一个个ACE访问控制入口也是权限访问判断的核心，当一个进程访问某一对象的时候，对象会将进程的Token与自身的ACE依次比对，直到被允许或被拒绝，前面的ACE优于后面的ACE。整体的一个权限检查过程如下图：

 --->>

上面简单介绍了本文要用到的也是Windows访问控制模型核心部分的一些知识，下面来介绍下如何编程实现遍历ACL来进行访问权限的检查。本文主要针对文件对象进行介绍，其他类型的对象大同小异。要用到的两个主要API为GetFileSecurity()和AccessCheck()。GetFileSecurity能够获取指定文件的安全描述符表，而AccessCheck可以指定要检查的权限，函数能够将获得的安全描述符表与当前进程的Token进行检查来判断进程对该文件对象是否允许相应的权限。不过这两个API并不那么容易用，因为其中要涉及到安全描述符表和访问令牌的获取，因此又牵扯出一大把API也涉及一些访问控制的知识。下面依次介绍要使用到的API然后给出整体的代码。GetFileSecurity的函数原型如下：

BOOL WINAPI GetFileSecurity(
  __in          LPCTSTR lpFileName,
  __in          SECURITY_INFORMATION RequestedInformation,
  __out_opt     PSECURITY_DESCRIPTOR pSecurityDescriptor,
  __in          DWORD nLength,
  __out         LPDWORD lpnLengthNeeded
);

lpFileName指定了要获取SD的文件。首先要定义一个PSECURITY_DESCRIPTOR的安全描述符表指针，因为描述符表大小未知，所以要调用两次GetFileSecurity()第一次将nLength置0，函数会返回实际大小，然后第二次用获取的大小去接收完整的SD，代码如下：

文件开始部分定义的内存分配释放函数常量:

#define AllocMem(x) (HeapAlloc(GetProcessHeap(),HEAP_ZERO_MEMORY,x))
#define FreeMem(x) (HeapFree(GetProcessHeap(),HEAP_ZERO_MEMORY,x))
...
...
BOOL bRs = FALSE;
DWORD dwSizeNeeded = 0;
PSECURITY_DESCRIPTOR psd = NULL;
SECURITY_INFORMATION　si = OWNER_SECURITY_INFORMATION
| GROUP_SECURITY_INFORMATION|DACL_SECURITY_INFORMATION;
         bRs = GetFileSecurity(lpFileName,si,psd,0,&dwSizeNeeded);
         //第一次调用获得SD实际大小
         if(!bRs)
         {
                   if(GetLastError() == ERROR_INSUFFICIENT_BUFFER)
                   {
                            psd = (PSECURITY_DESCRIPTOR)AllocMem(dwSizeNeeded);
                            //根据获取到的大小对psd分配内存
                   }else
                   {
                            printf("\n[-]Get SD failed:%d",GetLastError());
                            return bRs;
                   }
         }         if(!GetFileSecurity(lpFileName,si,psd,dwSizeNeeded,&dwSizeNeeded))
         {
                   printf("\n[-]Get SD failed:%d",GetLastError());
                   return bRs;
         }

至此针对指定文件对象的安全描述符表已经得到，下一步需要提取出访问进程的访问令牌(Token)。首先调用OpenProcessToken()获得本进程的Token，参数比较简单参考MSDN吧。然后有个比较重要的内容，我们需要模拟获得的令牌，因为OpenProcessToken获得的是进程的初始Token，不能直接用于访问权限的判断，我们要调用DuplicateToken()以当前用户的身份模拟一个同样的Token出来，具体使用待会儿看代码吧。下面到了最坑爹的一部分，就是GENERIC_MAPPING这个结构体，这个开始看MSDN一直一头雾水，没理解到底怎么使用，MSDN上也没有代码实例。鼓捣了一上午最后发现其实很简单，只是没有清晰描述没资料有点儿困惑。比如我们使用CreateFile()创建一个文件的时候可以指定一些权限访问的标志如GENERIC_WRITE，GENERIC_READ等等。但是这些权限标志都是通用的标志，还可以用这些标志来创建或打开其他类型的对象。在表示文件对象的时候，这些通用标志所包含的实际文件对象特有的权限标志列表如下：

比如当我们想使用AccessCheck()检查当前进程对某文件是否有读权限的时候，我们必须要调用MapGenericMask()把GENERIC_READ,GENERIC_WRITE,GENERIC_EXECUTE等等这类通用权限控制标志映射成该类型的对象特有的权限控制标志，对于文件就是FILE_GENERIC_READ,

FILE_GENERIC_WRITE等等。

最后就是调用AccessCheck()，参数还是比较复杂的，我这里简单介绍下，函数原型如下：

BOOL WINAPI AccessCheck(
  __in          PSECURITY_DESCRIPTOR pSecurityDescriptor,
  __in          HANDLE ClientToken,
  __in          DWORD DesiredAccess,
  __in          PGENERIC_MAPPING GenericMapping,
  __out_opt     PPRIVILEGE_SET PrivilegeSet,
  __in_out      LPDWORD PrivilegeSetLength,
  __out         LPDWORD GrantedAccess,
  __out         LPBOOL AccessStatus
);

pSecurityDescriptor是安全描述符表的指针没啥说的，ClientToken是模拟之后的令牌句柄。DesiredAccess是通用的权限控制标志。GenericMapping就是用MapGenericMask()映射后的针对特定对象的权限控制标志。 PrivilegeSet是我们之前提到过的访问令牌中的Privilege，用来检查一些系统操作的权限，比如开关机，修改系统时间等等，一般情况下初始化为0。PrivilegeSetLength是跟着之前PrivilegeSet的，这里既然不去检查权限也置为0。最后GrantedAccess和AccessStatus比较有用，AccessStatus会返回指定的权限是否被允许访问该对象，允许则为TRUE，否则为FALSE。如果AccessStatus为TRUE，该函数会把当前的ACE中的所有允许的权限操作标志赋给GrantedAccess。

下面给出获取令牌到检查权限部分的代码：

HANDLE hToken;
if(!OpenProcessToken(GetCurrentProcess(),TOKEN_ALL_ACCESS,&hToken))
         {
                   return bRs;
         }

         HANDLE hImpersonatedToken = NULL;
         if(DuplicateToken(hToken,
                   SecurityImpersonation,&hImpersonatedToken))
         //模拟令牌

         {
                   DWORD dwGenericAccessMask = GENERIC_READ|GENERIC_WRITE;
                   GENERIC_MAPPING genMap ;
                   PRIVILEGE_SET privileges = {0};
                   DWORD grantAccess = 0;
                   DWORD privLength = sizeof(privileges);
                   BOOL bGrantAccess = FALSE;
                   //将通用权限控制标志和特定类型对象权限控制标志挂钩
                   genMap.GenericRead = FILE_GENERIC_READ;
                   genMap.GenericWrite = FILE_GENERIC_WRITE;
                   genMap.GenericExecute = FILE_GENERIC_EXECUTE;
                   genMap.GenericAll = FILE_ALL_ACCESS;

                   MapGenericMask(&dwGenericAccessMask,&genMap);
                   //映射通用权限控制标志
                   if(AccessCheck(psd,hImpersonatedToken,
                            dwGenericAccessMask,                            &genMap,&privileges,&privLength,&grantAccess,&bGrantAccess))
                   {
                            bRs = bGrantAccess;
                            return bRs;
                   }else
                   {
                            printf("\n[-]Access check failed:%d",GetLastError());
                           return bRs;
                  }
         }

最后上图上真相吧：

文章到此结束了，拙作一篇，侧重于C+API编程实现对访问控制列表的遍历和权限的判断。只希望能让以后进行相关编程的同学能图个方便。Any comment is welcomed。