PolarDB:PolarSearch クイックスタート

ダッシュボードでの設定

1. ユーザーの作成：

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

   2. ユーザー作成ページで、ユーザー名とパスワードを入力してユーザーを作成します。 たとえば、ユーザー名 testuser、パスワード USER@test123 でユーザーを作成し、[作成] をクリックします。

2. ロールの作成：

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

   2. ロール権限にはクラスター権限とインデックス権限が含まれ、アクショングループを追加して設定できます。[インデックス] フィールドで、インデックス名を指定するか、* ワイルドカードを使用して一連のインデックス名に一致させます。[インデックス権限] セクションで、読み取り専用や読み取り/書き込みなどの特定の権限を選択します。

      例：onlyreadrole という名前のロールを作成します。このロールには、クラスターの完全な権限 (unlimited は完全な権限と同等) と、indextest で始まるすべてのインデックスに対する読み取り専用権限が付与されます。

3. ロールをユーザーにマッピング：

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

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

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

   例：ユーザー名が 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"]
     }'