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"]
     }'