# 权限配置

Sqless 对数据库的权限控制分为三种

字段读写权限
记录所有者读写权限
其他表读写权限

在 WebApi 中，配置好权限，就无需担心客户端越权操作数据

# 配置

权限在 SqlessConfig 类中配置，新建 SqlessConfig 对象并设置相关属性，在将 SqlessConfig 对象传给 Sqless 构造函数。

var sqlessConfig= new SqlessConfig()
{
    SqlConStr = sqlConStr, // 数据库连接字符串

    IsUnspecifiedFieldReadable = true,
    IsUnspecifiedFieldWritable = true,
};
using Sqless sqless = new Sqless(sqlessConfig);
// ...

1
2
3
4
5
6
7
8
9

以下权限相关的配置，都是指 SqlessConfig 对象相应的字段

# 字段读写权限

可详细控制表的某些字段读写权限。

IsUnspecifiedFieldReadable：未指定的字段是否可读
IsUnspecifiedFieldWritable：未指定的字段是否可写
FieldAuths：指定字段是否可读写的列表

var sqlessConfig= new SqlessConfig()
{
    SqlConStr = sqlConStr, // 数据库连接字符串

    IsUnspecifiedFieldReadable = false,
    IsUnspecifiedFieldWritable = false
};

sqlessConfig.FieldAuths = new System.Collections.Generic.List<Auth.SqlessFieldAuth>()
{
    new Auth.SqlessFieldAuth(){Table=Tables.Product, Field="Name",Readable=true},
    new Auth.SqlessFieldAuth(){Table=Tables.Product, Field="Price",Readable=true}
};

1
2
3
4
5
6
7
8
9
10
11
12
13

在上述示例中，Product表的Name和Price字段被指定可读，但未指定是否可写。由于IsUnspecifiedFieldWritable为false，因此Name和Price字段不可写。

# 记录所有者读写权限

即某条记录的所有者，对该条记录是否可读写。如用户的账号信息，用户仅有“修改已登录账号的信息”的权限，但无法修改其他人的账号信息。若要使用此权限，需设置AuthUid，在 客户端/服务器 架构中，可使用后面介绍的身份认证来根据 Account/Password或Token来获取 AuthUid。

TIP

用户信息某些字段，如 Password 等应该通过“字段读写权限”禁止用户读写。Email,Phone 等字段应设置为只读

OwnerAuths：指定所有者表是否可读写的列表

示例配置如下（假设 sqlConStr 和 authUid 已知）：

var config = SqlessConfig.GetOwnerConfig(sqlConStr, authUid);
config.AuthUid = authUid;

config.OwnerAuths.Add(new SqlessFieldAuth()
{
    Readable = true,
    Writable = true,
    Table = Tables.User,
    Field = "Uid"
});

result.FieldAuths.Add(new SqlessFieldAuth()
{
    Readable = false,
    Writable = false,
    Table = Tables.User,
    Field = "Password"
});

config.OwnerAuths.Add(new SqlessFieldAuth()
{
    Readable = true,
    Writable = true,
    Table = Tables.Order,
    Field = "Uid"
});

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

在上述示例中，User表和Order表，用户可读写所有者的记录，并且禁止读写User表的Password字段。

对于SqlessFieldAuth对象，在OwnerAuths中，Field属性为所有者的 Id 字段。在此示例中，User表和Order表均使用Uid存储记录的所有者（数据库设计中，Uid字段应该为外键）

# 其他表读写权限

除“所有者”的表外，其他表应与创建者无关。如商品表等，此类表一般只读。

IsUnspecifiedFreeReadable：未指定的其他表是否可读
IsUnspecifiedFreeWritable：未指定的其他表是否可写
FreeAuths：指定其他表是否可读写的列表

var sqlessConfig= new SqlessConfig()
{
    SqlConStr = sqlConStr, // 数据库连接字符串

    IsUnspecifiedFreeReadable = true,
    IsUnspecifiedFreeWritable = false
};

result.FreeAuths.Add(new SqlessAuth()
{
    Readable = false,
    Writable = false,
    Table = Tables.Product
});

1
2
3
4
5
6
7
8
9
10
11
12
13
14

在上述示例中，Product表指定为不可读写。由于设置了IsUnspecifiedFreeReadable为true,IsUnspecifiedFreeWritable为false，因此其他未指定的表都是只读。

← Client 使用身份认证 →