PolarDB:PolarSearch quick start

Configuration via le Dashboard

1. Créer un utilisateur :

   1. Dans le volet de navigation de gauche, accédez à la page , sélectionnez Internal users, puis cliquez sur Create internal user.

   2. Sur la page de création d'utilisateur, saisissez un nom d'utilisateur et un mot de passe pour créer l'utilisateur. Par exemple, créez un utilisateur nommé testuser avec le mot de passe USER@test123, puis cliquez sur Create.

2. Créer un rôle

   1. Dans le volet de navigation de gauche, accédez à la page , sélectionnez Roles, puis cliquez sur Create role.

   2. Les autorisations de rôle incluent les autorisations de cluster et les autorisations d'index, que vous pouvez configurer en ajoutant des groupes d'actions. Dans le champ Index, spécifiez un nom d'index ou utilisez le caractère générique * pour faire correspondre un ensemble de noms d'index. Dans la section Index permissions, sélectionnez des autorisations spécifiques, telles que lecture seule ou lecture/écriture.

      Exemple : Créez un rôle nommé onlyreadrole disposant des autorisations complètes sur le cluster (unlimited équivaut aux autorisations complètes) et d'une autorisation en lecture seule pour tous les index préfixés par indextest.

      De plus, les autorisations d'index prennent en charge la configuration de la Document level security (qui restreint la portée des documents accessibles via des instructions de requête JSON) et de la Field level security (qui restreint les champs accessibles).

3. Mapper un rôle à un utilisateur

   1. Dans le volet de navigation de gauche, accédez à la page Management > Security, sélectionnez Roles, puis cliquez sur le rôle cible.

   2. Dans l'onglet Mapped users, ajoutez un mappage d'utilisateur. Un utilisateur peut être mappé à plusieurs rôles et hérite des autorisations de tous les rôles mappés.

      Exemple : Mappez le rôle onlyreadrole à l'utilisateur testuser. Cela accorde à l'utilisateur testuser les autorisations du rôle onlyreadrole.

      Sur la page Map user du rôle onlyreadrole, ajoutez l'utilisateur testuser dans la zone Users, puis cliquez sur Map pour terminer le mappage.

Configuration via l'API REST

Les nœuds de recherche prennent en charge le contrôle d'accès complet via des API. Pour plus d'informations, consultez la documentation de l'API OpenSearch.

1. Créer un utilisateur

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

   Exemple : Créez un utilisateur nommé testuser avec le mot de passe 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. Créer un rôle

   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 : Spécifie les index à configurer. Vous pouvez utiliser le caractère générique * pour configurer plusieurs index simultanément.

   • allowed_actions : Spécifie les autorisations à accorder, telles que read et write.

   Exemple : Créez un rôle nommé onlyreadrole disposant des autorisations complètes sur le cluster et d'une autorisation en lecture seule pour tous les index préfixés par 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. Mapper un rôle

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

   Exemple : Mappez le rôle onlyreadrole à l'utilisateur testuser. Cela accorde à l'utilisateur testuser les autorisations du rôle 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"]
     }'