权限管理
权限管理概述
TiDB的权限管理系统是按照 MySQL 的权限管理进行实现,大部分的 MySQL 的语法和权限类型都是支持的。如果发现行为跟 MySQL 不一致的地方,欢迎报告 issue。
示例
用户账户操作
更改密码setpasswordfor'root'@'%'='xxx';
添加用户create user'test'@'127.0.0.1'identifiedby'xxx';
用户名是大小写敏感的。host则支持模糊匹配,比如:
create user'test'@'192.168.10.%';
允许 test 用户从 192.168.10 子网的任何一个主机登陆。
如果没有指定 host,则默认是所有 IP 均可登陆。如果没有指定密码,默认为空:
create user'test';
等价于
create user'test'@'%'identifiedby'';
删除用户drop user'test'@'%';
这个操作会清除用户在 mysql.user 表里面的记录项,并且清除在授权表里面的相关记录。
忘记root密码
使用一个特殊的启动参数启动 TiDB(需要root权限):
sudo./tidb-server-skip-grant-table=true
这个参数启动,TiDB 会跳过权限系统,然后使用 root 登陆以后修改密码:
mysql-h127.0.0.1-P4000-u root
权限相关操作
授予权限
授予 xxx 用户对数据库 test 的读权限:
grantSelecton test.*to'xxx'@'%';
为 test 用户授予所有数据库,全部权限:
grant all privileges on*.*to'xxx'@'%';
如果 grant 的目标用户不存在,TiDB 会自动创建用户。
mysql>select*frommysql.userwhereuser='xxxx';
Emptyset(0.00sec)
mysql>grant all privileges on test.*to'xxxx'@'%'identifiedby'yyyyy';
QueryOK,0rows affected(0.00sec)
mysql>selectuser,hostfrommysql.userwhereuser='xxxx';
+------|------+
|user|host|
+------|------+
|xxxx|%|
+------|------+
1rowinset(0.00sec)
例子中 xxxx@% 就是自动添加进去的用户。
grant 对于数据库或者表的授权,不检查数据库或表是否存在。
mysql>select*fromtest.xxxx;
ERROR1146(42S02):Table'test.xxxx'doesn't exist
mysql> grant all privileges on test.xxxx to xxxx;
Query OK, 0 rows affected (0.00 sec)
mysql> select user,host from mysql.tables_priv where user='xxxx';
+------|------+
| user | host |
+------|------+
| xxxx | % |
+------|------+
1 row in set (0.00 sec)
grant 可以模糊匹配地授予数据库和表
mysql>grant all privileges on`te%`.*to genius;
QueryOK,0rows affected(0.00sec)
mysql>selectuser,host,dbfrommysql.dbwhereuser='genius';
+--------|------|-----+
|user|host|db|
+--------|------|-----+
|genius|%|te%|
+--------|------|-----+
1rowinset(0.00sec)
这个例子中通过 % 模糊匹配,所有 te 开头的数据库,都被授予了权限。
收回权限
revoke语句与grant对应:
revoke all privileges on`test`.*from'genius'@'localhost';
注意 revoke 收回权限时只做精确匹配,若找不到记录则报错。而 grant 授予权限时可以使用模糊匹配。
mysql>revoke all privileges on`te%`.*from'genius'@'%';
ERROR1141(42000):Thereisnosuch grantdefinedforuser'genius'on host'%'关于模糊匹配和转义,字符串和 identifier
mysql>grant all privileges on`te\%`.*to'genius'@'localhost';
QueryOK,0rows affected(0.00sec)
这个例子是精确匹配名叫 te% 的数据库,注意到用了 \ 转义字符。
以单引号包含的,是一个字符串。以反引号包含的,是一个 identifier。注意下面区别:
mysql>grant all privileges on'test'.*to'genius'@'localhost';
ERROR1064(42000):Youhave an errorinyour SQL syntax;check the
manual that corresponds to yourMySQLserver versionforthe right
syntax tousenear''test'.* to 'genius'@'localhost''at line1
mysql>grant all privileges on`test`.*to'genius'@'localhost';
QueryOK,0rows affected(0.00sec)
如果一些特殊的关键字想做为表名,可以用反引号包含起来。比如:
mysql>create table`select`(idint);
QueryOK,0rows affected(0.27sec)
查看为用户分配的权限
SHOW GRANT 语句可以查看为用户分配了哪些权限。
show grantsfor'root'@'%';
更精确的方式,可以通过直接查看授权表的数据实现。比如想知道,test@% 该用户是否拥有对 db1.t 的 Insert 权限。
先查看该用户是否拥有全局 Insert 权限:
selectInsert_privfrommysql.userwhereuser='test'andhost='%';
如果没有,再查看该用户是否拥有 db1 数据库级别的 Insert权限:
selectInsert_privfrommysql.dbwhereuser='test'andhost='%';
如果仍然没有,则继续判断是否拥有 db1.t 这张表的 Insert 权限:
selecttable_privfrommysql.tables_privwhereuser='test'andhost='%'anddb='db1';
权限系统的实现
授权表
有几张系统表是非常特殊的表,权限相关的数据全部存储在这几张表内。
mysql.user 用户账户,全局权限
mysql.db 数据库级别的权限
mysql.tables_priv 表级别的权限
mysql.columns_priv 列级别的权限
这几张表包含了数据的生效范围和权限信息。例如,mysql.user 表的部分数据:
mysql>selectUser,Host,Select_priv,Insert_privfrommysql.user limit1;
+------|------|-------------|-------------+
|User|Host|Select_priv|Insert_priv|
+------|------|-------------|-------------+
|root|%|Y|Y|
+------|------|-------------|-------------+
1rowinset(0.00sec)
这条记录中,Host 和 User 决定了 root 用户从任意主机(%)发送过来的连接请求可以被接受,而 Select_priv 和 Insert_priv 表示用户拥有全局的 Select 和 Insert 权限。mysql.user 这张表里面的生效范围是全局的。
mysql.db 表里面包含的 Host 和 User 决定了用户可以访问哪些数据库,权限列的生效范围是数据库。
理论上,所有权限管理相关的操作,都可以通过直接对授权表的 CRUD 操作完成。
实现层面其实也只是包装了一层语法糖。例如删除用户会执行:
deletefrommysql.userwhereuser='test';
但是不推荐用户手动修改授权表。
连接验证
当客户端发送连接请求时,TiDB 服务器会对登陆操作进行验证。验证过程先检查 mysql.user 表,当某条记录的 User 和 Host 和连接请求匹配上了,再去验证 Password。用户身份基于两部分信息,发起连接的客户端的 Host,以及用户名 User。如果 User不为空,则用户名必须精确匹配。
User+Host 可能会匹配 user 表里面多行,为了处理这种情况,user 表的行是排序过的,客户端连接时会依次去匹配,并使用首次匹配到的那一行做权限验证。排序是按 Host 在前,User 在后。
请求验证
连接成功之后,请求验证会检测执行操作是否拥有足够的权限。
对于数据库相关请求 (INSERT,UPDATE),先检查 mysql.user 表里面的用户全局权限,如果权限够,则直接可以访问。如果全局权限不足,则再检查 mysql.db 表。
user 表的权限是全局的,并且不管默认数据库是哪一个。比如 user 里面有 DELETE 权限,任何一行,任何的表,任何的数据库。
db表里面,User 为空是匹配匿名用户,User 里面不能有通配符。Host和Db列里面可以有 % 和 _,可以模式匹配。
user 和 db 读到内存也是排序的。
tables_priv 和 columns_priv 中使用 % 是类似的,但是在Db, Table_name, Column_name 这些列不能包含 %。加载进来时排序也是类似的。
生效时机
TiDB 启动时,将一些权限检查的表加载到内存,之后使用缓存的数据来验证权限。系统会周期性的将授权表从数据库同步到缓存,生效则是由同步的周期决定,目前这个值设定的是5分钟。
修改了授权表,如果需要立即生效,可以手动调用:
flush privileges;
限制和约束
一些使用频率偏低的权限当前版本的实现中还未做检查,比如 FILE/USAGE/SHUTDOWN/EXECUTE/PROCESS/INDEX 等等,未来会陆续完善。
现阶段对权限的支持还没有做到 column 级别。
Create User 语句CREATE USER[IF NOT EXISTS]
user[auth_spec][,user[auth_spec]]...
auth_spec:{
IDENTIFIED BY'auth_string'
|IDENTIFIED BY PASSWORD'hash_string'
}
user 参见用户账号名。
IDENTIFIED BY ‘auth_string’
设置登录密码,auth_string 将会被 TiDB 经过加密存储在 mysql.user 表中。
IDENTIFIED BY PASSWORD ‘hash_string’
设置登录密码,hash_string 将会被 TiDB 经过加密存储在 mysql.user 表中。目前这个行为和 MySQL 不一致,会在接下来的版本中修改为和 MySQL 一致的行为。