PolarDB:PolarSearch ユーザーガイド

ダッシュボード

1. ユーザーの作成

   1. 左側のナビゲーションウィンドウで、管理 > セキュリティ に移動し、内部ユーザー を選択して、内部ユーザーの作成 をクリックします。

   2. ユーザー名およびパスワードを入力します。たとえば、ユーザー名 testuser、パスワード USER@test123 のユーザーを作成し、作成 をクリックします。

2. ロールの作成

   1. 左側のナビゲーションウィンドウで、管理 > セキュリティ に移動し、ロール を選択して、ロールの作成 をクリックします。

   2. ロールの権限には、クラスターレベルの権限およびインデックスレベルの権限が含まれます。アクショングループを介して権限を追加できます。インデックス フィールドでは、インデックス名を指定するか、* ワイルドカードを使用して複数のインデックスをマッチさせることができます。インデックス権限 では、読み取り専用や読み書き可能など、必要な権限を選択します。

      例：クラスターレベルの権限を無制限に付与し、indextest で始まるすべてのインデックスに対して読み取り専用アクセスを許可するロール onlyreadrole を作成します。

3. ロールとユーザーのマッピング

   1. 左側のナビゲーションウィンドウで、管理 > セキュリティ に移動し、ロール を選択して、対象のロールをクリックします。

   2. マップ済みユーザー タブで、ユーザーのマッピングを追加します。1 人のユーザーは複数のロールにマップでき、マップされたすべてのロールの権限を継承します。

      例：ロール onlyreadrole をユーザー testuser にマップします。これにより、ユーザー testuser はロール onlyreadrole のすべての権限を継承します。

REST API

REST 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": {}
     }'

   例：ユーザー名 testuser、パスワード USER@test123 のユーザーを作成します。

   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）。

   例: 「onlyreadrole」という名前のロールを作成し、そのロールにクラスター全体に対する完全な権限と、プレフィックスが「indextest」であるすべてのインデックスに対する読み取り専用のアクセスを付与します。

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