GoAhead2.5源代码分析之1-用户管理（um.c）

比眉伴天荒 2022-07-24 09:18 245阅读 0赞

Um.c（用户管理）

## umconfig.txt ##

TABLE=users  
ROW=0  
name=admin  
password=Uz  
group=Administrator  
prot=1  
disable=0

TABLE=groups  
ROW=0  
name=Administrator  
priv=4  
method=3  
prot=1  
disable=0

TABLE=access  
ROW=0  
name=/main.html  
method=3  
secure=0

## group=Administrator ##

GoAhead提供了认证功能：主要是两种认证基本认证和摘要认证。摘要认证比基本认证更安全些，所以选择摘要认证。  
认证功能其实是用户管理功能的一部分。要配置认证功能，需要修改umconfig.txt文件，GoAhead在启动时会读取该文件，实现认证功能。  
文件大概情况如下：  
TABLE=users/*用户配置*/  
ROW=0  
name=raise/*用户名*/  
password=Uz/*密码，加密的*/  
group=RS/*用户所属的组*/  
prot=1/*为1表示这个用户受保护不能被删除，0表示可以删除*/  
disable=0/*0为使能*/

TABLE=groups/*组配置*/  
ROW=0  
name=RS/*组名*/  
priv=4/*用户组的访问权限，可以是0，1，2，4分别代表AM\_NONE,AM\_READ,AM\_WRITE,AM\_ADMIN.这之间没有权限大小之分*/  
method=3/\*密码认证方法，可以是0，1，2，3。0什么你都没权访问，1什么你都有权限。2密码与用户名简单加密传输（基本认证），3密码和用户名经过更安全的加密(摘要认证)。  
typedef enum \{  
AM\_NONE = 0,  
AM\_FULL,  
AM\_BASIC,  
AM\_DIGEST,  
AM\_INVALID  
\} accessMeth\_t;  
\*/  
prot=1/*为1表示这个用户受保护不能被删除，0表示可以删除*/  
disable=0/*0为使能*/

TABLE=access/*访问控制*/  
ROW=0  
name=/ /*要访问index.htm，需要输入用户名、密码*/  
method=3/*摘要认证*/  
secure=0/*页面传输时，是否要加密，0为不加密，如果不使用SSL，这项是忽略的*/  
group=RS/*可访问该文件的组*/

int umOpen()  
功能：在数据库中注册UM表  
说明：  
1. 如果didUM== -1，注册数据库，包括三个表：用户表、用户组表、访问控制表

## 2. 如果saveFilename == NULL，分配一段内存，内存中存放文件名umconfig.txt。 ##

void umClose()  
功能：释放数据库中的UM表  
说明：

--------------------

int umCommit(char\_t \*filename)  
功能：将数据库中的table保存到文件中

## 说明： ##

int umRestore(char\_t \*filename)  
功能：将文件中table存放到数据库中

## 说明： ##

static int umEncryptString(char\_t \*textString)  
功能：将字符串进行简单加密

## 说明： ##

static char\_t \*umGetFirstRowData(char\_t \*tableName, char\_t \*columnName)  
功能：获得table名字为tableName，列名为columnName的数据

## 说明：例如，前面的umconfig.txt, password=Uz的获得就是tableName= users，columnName= password。 ##

static char\_t \*umGetNextRowData(char\_t \*tableName, char\_t \*columnName,  
char\_t \*keyLast)  
功能：获得指定的table项的下一项。

## 说明： ##

int umAddUser(char\_t \*user, char\_t \*pass, char\_t \*group,  
bool\_t prot, bool\_t disabled)  
功能：向用户table中添加一个用户。

## 说明：必须确保用户名不重复，用户组是存在的。 ##

int umDeleteUser(char\_t \*user)  
功能：删除一个用户

## 说明： ##

char\_t \*umGetFirstUser()  
功能：获得第一个用户名

## 说明： ##

char\_t \*umGetNextUser(char\_t \*userLast)  
功能：获得下一个用户名

## 说明： ##

bool\_t umUserExists(char\_t \*user)  
功能：判断指定用户是否存在

## 说明： ##

char\_t \*umGetUserPassword(char\_t \*user)  
功能：获得指定用户的密码

## 说明： ##

int umSetUserPassword(char\_t \*user, char\_t \*pass)  
功能：设置用户的密码

## 说明： ##

char\_t \*umGetUserGroup(char\_t \*user)  
功能：获得该用户所在的用户组

## 说明： ##

int umSetUserGroup(char\_t \*user, char\_t \*group)  
功能：设置这个用户的用户组

## 说明： ##

bool\_t umGetUserEnabled(char\_t \*user)  
功能：该用是否使能

## 说明： ##

int umSetUserEnabled(char\_t \*user, bool\_t enabled)  
功能：设置该用户使能

## 说明： ##

bool\_t umGetUserProtected(char\_t \*user)  
功能：该用户是否被保护，不能删除

## 说明： ##

int umSetUserProtected(char\_t \*user, bool\_t protect)  
功能：设置该用户被保护

## 说明： ##

int umAddGroup(char\_t \*group, short priv, accessMeth\_t am,  
bool\_t prot, bool\_t disabled)  
功能：添加一个组table

## 说明： ##

int umDeleteGroup(char\_t \*group)  
功能：删除一个组

## 说明： ##

bool\_t umGroupExists(char\_t \*group)  
功能：该组是否存在

## 说明： ##

bool\_t umGetGroupInUse(char\_t \*group)  
功能：该用户是否使能

## 说明： ##

char\_t \*umGetFirstGroup()  
功能：获得第一个用户组

## 说明： ##

char\_t \*umGetNextGroup(char\_t \*groupLast)  
功能：获得下一个用户组

## 说明： ##

accessMeth\_t umGetGroupAccessMethod(char\_t \*group)  
功能：获得用户组的方法

## 说明： ##

int umSetGroupAccessMethod(char\_t \*group, accessMeth\_t am)  
功能：设置用户组的方法

## 说明： ##

short umGetGroupPrivilege(char\_t \*group)  
功能：获得用户组的访问权限

## 说明： ##

int umSetGroupPrivilege(char\_t \*group, short privilege)  
功能：设置用户组的访问权限

## 说明： ##

bool\_t umGetGroupEnabled(char\_t \*group)  
功能：获得用户组是否使能

## 说明： ##

int umSetGroupEnabled(char\_t \*group, bool\_t enabled)  
功能：设置用户组使能

## 说明： ##

bool\_t umGetGroupProtected(char\_t \*group)  
功能：获得用户组是否被保护

## 说明： ##

int umSetGroupProtected(char\_t \*group, bool\_t protect)  
功能：设置用户组被保护

## 说明： ##

int umAddAccessLimit(char\_t \*url, accessMeth\_t am, short secure, char\_t \*group)  
功能：添加访问限制，能访问哪个目录或文件

## 说明： ##

int umDeleteAccessLimit(char\_t \*url)  
功能：删除访问限制

## 说明： ##

char\_t \*umGetFirstAccessLimit()  
功能：获得第一个用户的访问限制路径

## 说明： ##

char\_t \*umGetNextAccessLimit(char\_t \*urlLast)  
功能：获得指定访问限制路径的下一个访问限制路径

## 说明： ##

bool\_t umAccessLimitExists(char\_t \*url)  
功能：这个访问限制路径是否存在

## 说明： ##

accessMeth\_t umGetAccessLimitMethod(char\_t \*url)  
功能：获得这个路径的访问方法  
说明：typedef enum \{  
AM\_NONE = 0,  
AM\_FULL,  
AM\_BASIC,  
AM\_DIGEST,  
AM\_INVALID  
\} accessMeth\_t;

--------------------

int umSetAccessLimitMethod(char\_t \*url, accessMeth\_t am)  
功能：设置这个访问路径的方法

## 说明： ##

short umGetAccessLimitSecure(char\_t \*url)  
功能：获得这个访问路径的安全设置

## 说明：加密还是不加密 ##

int umSetAccessLimitSecure(char\_t \*url, short secure)  
功能：设置访问路径的安全标志

## 说明： ##

char\_t \*umGetAccessLimitGroup(char\_t \*url)  
功能：获得这个访问路径的组

## 说明： ##

int umSetAccessLimitGroup(char\_t \*url, char\_t \*group)  
功能：设置访问路径的组

## 说明： ##

char\_t \*umGetAccessLimit(char\_t \*url)  
功能：获得给定路径的所在的访问限制路径

## 说明： ##

accessMeth\_t umGetAccessMethodForURL(char\_t \*url)  
功能：获得给定路径的所在的访问限制方法

## 说明： ##

bool\_t umUserCanAccessURL(char\_t \*user, char\_t \*url)  
功能：判断这个路径用户是否能够访问  
说明：1.用户要在  
2．用户要能  
3．用户组的权限要足够大，AM\_READ,AM\_WRITE,AM\_ADMIN都可  
4.用户组要使能  
5.用户组访问限制的方法必须是AM\_FULL、 AM\_BASIC、AM\_DIGEST之一  
6.在判断url是否属于访问限制路径，如果是，获得这个路径的访问方法和组，然后这个访问方法不能是AM\_NONE，组必须和user的组一样。

--------------------

static bool\_t umCheckName(char\_t \*name)  
功能：检查字符串是否是有效的

## 说明： ##