Comment gérer les utilisateurs et bases de données
Ce guide explique comment créer des utilisateurs, leur donner accès à des bases de données et renouveler leurs mots de passe sur un cluster MariaDB, depuis la console Hikube.
Prérequis
- Un cluster MariaDB au statut Prêt dans votre projet (voir le démarrage rapide)
- Un client
mysqloumariadbpour tester les connexions - Pour l'onglet API : une clé d'API
admindu projet et les variablesHIKUBE_API,HIKUBE_API_KEYetPROJECT_ID(voir Préparer l'environnement) ; les exemples utilisentcurletjq
Toutes les opérations se font depuis la page du cluster : DB & Messaging → MariaDB → nom du cluster, section Utilisateurs.
La console MariaDB n'a pas d'onglet dédié aux bases de données : une base se crée en accordant un accès sur son nom à un utilisateur.
Étapes
1. Créer un utilisateur
- Console
- API
- Dans la section Utilisateurs, cliquez sur Créer un utilisateur.
- Saisissez le Nom d'utilisateur : 3 à 16 caractères, minuscules, chiffres et tirets, commençant par une lettre et se terminant par une lettre ou un chiffre (par exemple
report-reader). - Sous Accès spécifiques (Bases de données), cliquez sur Ajouter pour chaque base :
- Nom de la base : par exemple
analytics(minuscules, chiffres et tirets ; pas de tiret bas ; les bases systèmemysql,information_schema,performance_schemaetsyssont refusées) ; - Droits : Administrateur (Admin) ou Lecture seule (Read-only).
- Nom de la base : par exemple
- Cliquez sur Créer l'utilisateur.
Il n'existe pas de rôle global : l'utilisateur n'a accès qu'aux bases listées. Sans aucun accès, la console indique « Aucun accès configuré : l'utilisateur n'a de droits sur aucune base. » ; l'utilisateur peut être créé ainsi et recevoir ses accès plus tard.
L'écran « Utilisateur créé avec succès ! » affiche le mot de passe généré.
Copiez ce mot de passe immédiatement et conservez-le en lieu sûr : il ne sera plus affiché après avoir quitté cet écran.
Cliquez ensuite sur Terminer et retourner au cluster.
Les utilisateurs déclarés dans l'assistant de création du cluster reçoivent leur rôle sur la Base de données indiquée à l'étape Utilisateurs.
curl -sS -X POST "$HIKUBE_API/mariadb/v1alpha1/projects/$PROJECT_ID/clusters/demomariadb/users" \
-H "X-Hikube-Api-Key: $HIKUBE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"username": "reportreader",
"config": {
"maxUserConnections": 0,
"databases": {
"analytics": {"role": "readonly"}
}
}
}' | jq '{username, password}'
username: 1 à 63 caractères, minuscules, chiffres et tirets, commençant par une lettre ;config.databases: un objet dont chaque clé est un nom de base et chaque valeur{"role": "admin"}ou{"role": "readonly"}. Une base qui n'existe pas encore est créée ;config.maxUserConnections: nombre maximal de connexions simultanées (0pour illimité, 10000 au maximum).
Le champ password de la réponse n'est renvoyé qu'une seule fois. Enregistrez-le directement dans votre gestionnaire de secrets.
2. Créer une base de données
- Console
- API
Accordez à un utilisateur un accès sur le nom de la nouvelle base (étape 1 pour un nouvel utilisateur, étape 3 pour un utilisateur existant). La base est créée si elle n'existe pas encore.
L'API expose aussi les bases elles-mêmes. Pour créer une base sans encore y donner accès :
curl -sS -X POST "$HIKUBE_API/mariadb/v1alpha1/projects/$PROJECT_ID/clusters/demomariadb/databases" \
-H "X-Hikube-Api-Key: $HIKUBE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"databaseName": "analytics"}'
GET $HIKUBE_API/mariadb/v1alpha1/projects/$PROJECT_ID/clusters/demomariadb/databases liste les bases avec, pour chacune, les utilisateurs admin et readonly. Une base se supprime avec DELETE $HIKUBE_API/mariadb/v1alpha1/projects/$PROJECT_ID/clusters/demomariadb/databases/<base>, ce qui efface ses données.
3. Modifier les droits d'un utilisateur
- Console
- API
- Ouvrez le menu Actions de l'utilisateur et choisissez Gérer les accès.
- Ajoutez des accès avec Ajouter, modifiez les Droits ou retirez une ligne.
- Cliquez sur Enregistrer. Le message « Accès mis à jour » confirme l'enregistrement.
curl -sS -X PATCH "$HIKUBE_API/mariadb/v1alpha1/projects/$PROJECT_ID/clusters/demomariadb/users/reportreader" \
-H "X-Hikube-Api-Key: $HIKUBE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"config": {
"maxUserConnections": 0,
"databases": {
"analytics": {"role": "readonly"},
"myapp": {"role": "admin"}
}
}
}'
L'objet config.databases, s'il est envoyé, remplace l'ensemble des droits de l'utilisateur : une base absente de la requête lui est retirée, et {} les retire tous. config.maxUserConnections n'est modifié que s'il est envoyé (0 : illimité) ; voir Mises à jour partielles. Consultez la configuration actuelle avec GET $HIKUBE_API/mariadb/v1alpha1/projects/$PROJECT_ID/clusters/demomariadb/users/reportreader.
Le nom d'utilisateur ne peut pas être modifié.
Les utilisateurs déclarés dans l'assistant de création de cluster avant la console v1.3.0 ont reçu un rôle sur la base système mysql. Dans Gérer les accès, cette ligne apparaît en erreur et empêche l'enregistrement : retirez-la, ajoutez si besoin la base applicative de l'utilisateur, puis cliquez sur Enregistrer.
4. Renouveler le mot de passe d'un utilisateur
- Console
- API
- Ouvrez le menu Actions de l'utilisateur et choisissez Changer le mot de passe.
- Dans la fenêtre Rotation du mot de passe, cliquez sur Effectuer la rotation.
- Copiez le nouveau mot de passe, puis cliquez sur Terminer.
curl -sS -X POST "$HIKUBE_API/mariadb/v1alpha1/projects/$PROJECT_ID/clusters/demomariadb/users/reportreader/rotate-password" \
-H "X-Hikube-Api-Key: $HIKUBE_API_KEY" | jq -r '.password'
La requête n'a pas de corps. Le nouveau mot de passe n'est renvoyé que dans cette réponse.
La rotation révoque immédiatement l'ancien mot de passe. Mettez à jour vos applications sans attendre pour éviter une coupure.
5. Supprimer un utilisateur
- Console
- API
Ouvrez le menu Actions de l'utilisateur, choisissez Supprimer l'utilisateur, saisissez son nom exact puis cliquez sur Supprimer définitivement.
curl -sS -X DELETE "$HIKUBE_API/mariadb/v1alpha1/projects/$PROJECT_ID/clusters/demomariadb/users/reportreader" \
-H "X-Hikube-Api-Key: $HIKUBE_API_KEY"
Les droits de l'utilisateur sur toutes les bases sont retirés avec lui.
6. Tester la connexion
mysql -h <hôte> -P 3306 -u report-reader -p analytics
-- Doit réussir
SELECT CURRENT_USER(), DATABASE();
SHOW GRANTS;
-- Doit échouer pour un utilisateur en lecture seule
CREATE TABLE test (id INT);
Vérification
- Console
- API
La colonne Bases de données de la liste des utilisateurs affiche, pour chacun, les bases accessibles avec le rôle associé (par exemple analytics (Lecture seule) ou analytics (Administrateur)), ou Aucun.
curl -sS "$HIKUBE_API/mariadb/v1alpha1/projects/$PROJECT_ID/clusters/demomariadb/users" \
-H "X-Hikube-Api-Key: $HIKUBE_API_KEY" | jq '.users[] | {username, databases: .config.databases}'
Cette lecture suffit avec une clé read.
Pour aller plus loin
- Concepts MariaDB : rôles et règles de nommage
- Modifier les ressources