云原生数据库 PolarDB：PolarSearch使用说明

Dashboard白屏化设置

1. 新建用户：

   1. 单击左侧导航栏，进入Management > Security页面，并选择Internal users，单击Create internal user。

   2. 在创建用户页面，输入用户名和密码创建用户。例如，创建一个账号密码为USER@test123的用户testuser，然后单击Create完成创建。

2. 新建角色

   1. 单击左侧导航栏，进入Management > Security页面，并选择Roles，单击Create role。

   2. 角色权限主要包括集群权限和索引权限，权限的设定可以通过操作组进行添加。索引权限配置在Index处可以设置具体的索引名字或者通过*通配符适配某一类名字的索引，在Index permissions选择索引的具体权限，如只读、读写等。

      示例：创建一个拥有全部集群权限（unlimited相当于全部权限）以及以indextest作为前缀的所有索引的索引只读权限的角色onlyreadrole。

3. 角色映射用户

   1. 单击左侧导航栏，进入Management > Security页面，并选择Roles，单击目标角色。

   2. 在Mapped users页签中添加用户映射。一个用户可以被多个角色映射，并同时拥有这些角色的权限。

      示例：将onlyreadrole的角色与testuser用户进行映射，testuser用户获得onlyreadrole角色所拥有的权限。

REST API设置

搜索节点可通过API实现完整的访问控制，请参见社区文档OpenSearch API。

1. 新建用户

   curl -X PUT "http://<endpoint>:<port>/_plugins/_security/api/internalusers/<new_user>" \
     --user "<user_name>:<passwd>" \
     -H "Content-Type: application/json" \
     -d '{
       "password": "<new_password>",
       "backend_roles": [],
       "attributes": {}
     }'

   示例：创建一个账号密码为USER@test123的用户testuser。

   curl -X PUT "http://<endpoint>:<port>/_plugins/_security/api/internalusers/testuser" \
     --user "<user_name>:<passwd>" \
     -H "Content-Type: application/json" \
     -d '{
       "password": "USER@test123",
       "backend_roles": [],
       "attributes": {}
     }'

2. 新建角色

   curl -X PUT "http://<endpoint>:<port>/_plugins/_security/api/roles/<role_name>" \
     --user "<user_name>:<passwd>" \
     -H "Content-Type: application/json" \
     -d '{
       "cluster_permissions": ["*"],
       "index_permissions": [
         {
           "index_patterns": ["*"],
           "allowed_actions": ["*"]
         }
       ]
     }'

   • index_patterns：对应需要设置的索引名字，可以通过*通配符批量设置索引。

   • allowed_actions：对应具体的权限，如read、write等。

   示例：创建一个具有全部集群权限以及以indextest作为前缀的所有索引的只读权限角色onlyreadrole。

   curl -X PUT "http://<endpoint>:<port>/_plugins/_security/api/roles/onlyreadrole" \
     --user "<user_name>:<passwd>" \
     -H "Content-Type: application/json" \
     -d '{
       "cluster_permissions": ["*"],
       "index_permissions": [
         {
           "index_patterns": ["indextest*"],
           "allowed_actions": ["read"]
         }
       ]
     }'

3. 映射角色

   curl -X PUT "http://<endpoint>:<port>/_plugins/_security/api/rolesmapping/<role_name>" \
     --user "<user_name>:<passwd>" \
     -H "Content-Type: application/json" \
     -d '{
       "backend_roles": [],
       "hosts": [],
       "users": ["<new_user>"]
     }'

   示例：将onlyreadrole的角色与testuser用户进行映射，testuser用户获得onlyreadrole角色所拥有的权限。

   curl -X PUT "http://<endpoint>:<port>/_plugins/_security/api/rolesmapping/onlyreadrole" \
     --user "<user_name>:<passwd>" \
     -H "Content-Type: application/json" \
     -d '{
       "backend_roles": [],
       "hosts": [],
       "users": ["testuser"]
     }'