Datalayers 文档

简体中文

English

Appearance

RBAC（基于角色的访问控制） ​

概述 ​

RBAC 提供完整的身份认证和权限管理体系，支持多用户、多角色的细粒度权限控制。

核心特性 ​

角色管理：定义不同权限级别的角色
用户分配：将用户分配到特定角色
权限控制：精确控制数据访问和操作权限

配置说明 ​

toml
# The configurations of authorization.
[server.auth]
# 认证类型，可选：static/rbac
# 默认: "static"
type = "rbac" 

# The provided JSON Web Token.
# Default: "871b3c2d706d875e9c6389fb2457d957".
jwt_secret = "871b3c2d706d875e9c6389fb2457d957"

# 密码强度，支持三种：
# weak: 弱密码，没有特殊要求；
# moderate: 一般密码，至少 8 位字符，至少包含大写、小写、数字和特殊字符中的三种；
# strong: 强密码，至少 14 位字符，包含大写、小写、数字和特殊字符。
# 默认：weak
#password_strength = "weak"

# 防暴力破解密码
# 形式为 "a/b/c"，a,b,c 都是整数，含义是连续失败 a 次后，b 分钟内禁止该用户重复尝试登录，之后每再失败一次，禁止时间延长 c 分钟。
# a最大值为 10，b,c 最大值为 120 分钟。
# 默认：0/0/0 表示不开启防暴力破解
#password_lockout = "3/5/5"

初始化用户 ​

安装 Datalayers 后，首次使用 rbac 认证模式启动时，系统默认没有预置管理员账户。需要手动初始化第一个管理员账户。本文提供两种初始化方法。

基于 Peer 认证初始化 ​

Linux 的 Peer 认证（Peer Credentials Authentication）是基于内核级别的进程身份验证机制，通过 Unix Domain Socket 通信为连接方提供可靠的身份验证。

Datalayers 集成 Peer 认证能力，为数据库账号管理提供安全便捷的解决方案，通过 Peer 认证的连接，将获得系统最高权限。通过该功能，您可以：

  • 账号初始化：安全初始化系统账号对应的数据库访问权限
  • 密码管理：修改或重置用户密码
  • 用户查询：查看当前用户信息及权限状态
  • 其他：任意合法 SQL 语句操作

如需通过此种方式来初始化帐号，需通过以下两步

  1. 配置 peer 服务（默认未启用）
toml
# The configurations of the unix domain socket server.
[server.uds]
# The path of the unix domain socket, relative to `base_dir`.
# DONOT configure this options means do not support uds server by default.
# Recommend: "run/datalayers.sock"
path = "run/datalayers.sock"

配置好后需重启服务

  1. 执行初始化指令
shell
# 以 deb/rpm 安装方式为例
sudo -u datalayers dlsql 
> CREATE USER IF NOT EXISTS'admin'@'%' identified by 'public'
Query OK, 0 rows affected. (0.001 sec)
> GRANT SUPER ON *.* TO 'admin'@'%'
Query OK, 0 rows affected. (0.001 sec)

通过上述命令即可创建一个用户名为 admin、密码为 public，可从任意 IP 地址登录的管理员账户。

基于静态认证初始化 ​

基于静态认证，通过相应的授权语句进行创建用户来初始化系统用户。

  • 配置为静态认证，配置好后重启系统
  • 参考 rbac 中的用户管理,并创建好帐号
  • 创建好后将认证 server.auth.type 修改为 rbac 并重启系统
  • 使用创建的帐号进行登陆

详细说明 ​

关于 RBAC 的完整功能说明请参考：访问控制

TIP

启用 RBAC 认证，需将 server.auth.type 设置为 rbac

© 2025 Datalayers All rights reserved