权限管理
更新时间：2025-08-20
权限管理包括两个层面的控制：
-
URI级别的权限控制：控制特定用户可以访问哪些URI
场景说明：管理员可以让某个用户有管理集群动态配置参数的权限，需要将 /_cluster/setting 写(POST)权限授权给这个用户
-
index级别的权限控制：控制特定用户对index的读写操作权限
场景说明：禁止某些用户访问特定index或读写权限分配给不同的用户进行操作，使得不同的用户获得对index不同的操作权限
创建用户
Plain Text
1curl -u username:password -XPOST -H "Content-Type: application/json" 'host:port/_user/create' -d '
2{
3 "username" : "test",
4 "password" : "test123",
5 "ip_whitelist": ["x.x.x.x"],
6 "get_path" : ["/test*", "/*/_bulk", "/*/_search"],
7 "put_path" : ["/test*"],
8 "post_path" : ["/test*"],
9 "del_path" : ["/test*"],
10 "head_path" : ["/test*"],
11 "read_index": ["test*", "online-"],
12 "write_index": ["test*"]
13}'| 参数 | 意义 |
|---|---|
| username | 用户名，支持字母(a-z及A-Z)、数字(0-9)，长度小于20个字符 |
| password | 用户密码，支持字母(a-z及A-Z)、数字(0-9)，长度6-20个字符 |
| ip_whitelist | 访问白名单 |
| {HTTP_METHOD}_path | 对不同HTTP类型的请求的权限控制，{HTTP_METHOD}为put、post、get、delete、head |
| read_index | 拥有读权限的index列表 |
| write_index | 拥有写权限的index列表 |
注意：
- 只有superuser可以执行create user的指令，其他用户在任何情况下都不能执行
- {HTTP_METHOD}_path、read_index、write_index中的内容支持通配符匹配和前缀匹配
通配符支持 * 和 ? ，*代表任意个字符，?代表一个字符
| 例子 | 说明 |
|---|---|
| *st | 匹配test、tst，不能匹配 tweet |
| *st | 匹配test、tst，不能匹配 tweet |
| a?d | 匹配abd，acd, 不能匹配 abcd |
| a??d | 匹配abcd，acad, 不能匹配 abd |
| /*/test | 匹配 /abc/test,/abc/ddd/test 不能匹配 /abc/cde |
| * | 匹配所有字符串 |
| /* | 匹配所有以/开头的URI |
| /*/_settings | 匹配所有以_settings结尾的URI |
如果只想赋予user某个index的权限，只需要设置read_index、write_index以及将get_path设置为"/"即可，示例如下：
Plain Text
1 curl -u username:password -XPOST -H "Content-Type: application/json" 'host:port/_user/create' -d '
2{
3 "username" : "test",
4 "password" : "test123",
5 "ip_whitelist": ["x.x.x.x"],
6 "get_path" : ["/"]
7 "read_index": ["test*"],
8 "write_index": ["test*"]
9}'修改用户
Plain Text
1curl -u username:password -XPOST -H "Content-Type: application/json" 'host:port/_user/alter' -d '
2{
3 "username" : "test",
4 "password" : "test321",
5 "get_path" : ["/test*", "/_cat/health"],
6 "read_index": ["test*"]
7}'
- 修改用户的访问权限，同时也可以修改用户的密码
- 覆盖方式：出现的字段将会覆盖原有内容，未出现的字段会保留
- 只有root和superuser可以执行这个API
删除用户
Plain Text
1curl -u username:password -XPOST -H "Content-Type: application/json" 'host:port/_user/delete' -d '
2{
3 "username" : "test"
4}'查看用户
Plain Text
1curl -u username:password -XPOST 'host:port/_user/show’
2{
3 "size" : 20
4}
- 该API需要在创建普通用户时加入其权限路径，这样普通用户才可查看自己的用户信息
- 如果执行该API的是root或者superuser，显示所有的用户
- size表示返回的用户数，默认返回10
重置密码
Plain Text
1curl -u username:password -XPOST 'host:port/_user/resetpasswd’
2{
3 "password" : "test123"
4}
- 该API需要在创建普通用户时加入其权限路径，这样普通用户才可修改自己的密码
- 管理员修改普通用户密码时请使用更新用户的API
使用示例
创建可使用kibana的只读用户
Plain Text
1curl -u username:password -XPOST -H "Content-Type: application/json" 'host:port/_user/create' -d '
2{
3 "username" : "xxxxxx",
4 "password" : "xxxxxx",
5 "ip_whitelist": ["x.x.x.x"]
6 "get_path" : ["/"],
7 "put_path" : ["/"],
8 "post_path" : ["/"],
9 "del_path" : ["/"],
10 "head_path" : ["/"],
11 "read_index": ["test*",".kibana"],
12 "write_index": [".kibana"]
13}'kibana会向ES发送一些状态检查、存储图表信息等请求，所以请求权限需要提供所有权限；如果希望创建的用户只拥有只读权限，可以在write_index中只添加.kibana，在read_index中增加用户希望读取的索引。