Comment gérer les utilisateurs et bases de données
Ce guide explique comment créer des utilisateurs MongoDB, leur donner accès à des bases de données et renouveler leurs mots de passe, depuis la console Hikube.
Prérequis
- Un cluster MongoDB au statut Prêt dans votre projet (voir le démarrage rapide)
- Le shell
mongoshpour 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 → MongoDB → nom du cluster, section Utilisateurs.
La console MongoDB n'a pas d'onglet dédié aux bases de données : les droits se définissent par utilisateur, base par base. Comme toujours avec MongoDB, une base apparaît physiquement dès que vous y écrivez un premier document.
É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 ; les bases systèmeadmin,localetconfigsont refusées) ; - Droits : Administrateur (Admin) ou Lecture seule (Read-only).
- Nom de la base : par exemple
- Cliquez sur Créer l'utilisateur.
Un utilisateur MongoDB doit avoir au moins un accès : sans accès, la console affiche « Veuillez attribuer au moins un accès à une base de données. » et le bouton reste inactif. Il n'existe pas de rôle global : l'utilisateur n'a accès qu'aux bases listées.
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/mongodb/v1alpha1/projects/$PROJECT_ID/clusters/demomongo/users" \
-H "X-Hikube-Api-Key: $HIKUBE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"username": "reportreader",
"config": {
"databases": {
"analytics": {"role": "readonly"}
}
}
}' | jq '{username, password}'
username: 1 à 63 caractères, minuscules, chiffres et tirets, commençant par une lettre ;config.databases: obligatoire, au moins une entrée ; chaque clé est un nom de base et chaque valeur{"role": "admin"}ou{"role": "readonly"}. Un rôle global correspond à une entrée sur la baseadmin. Sans entrée, la requête est refusée (400).
Le champ password de la réponse n'est renvoyé qu'une seule fois. Enregistrez-le directement dans votre gestionnaire de secrets.
2. 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. Au moins un accès doit subsister.
- Cliquez sur Enregistrer. Le message « Accès mis à jour » confirme l'enregistrement.
curl -sS -X PATCH "$HIKUBE_API/mongodb/v1alpha1/projects/$PROJECT_ID/clusters/demomongo/users/reportreader" \
-H "X-Hikube-Api-Key: $HIKUBE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"config": {
"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 au moins une entrée doit subsister. Un corps sans config.databases ne change rien ; voir Mises à jour partielles. Consultez les droits actuels avec GET $HIKUBE_API/mongodb/v1alpha1/projects/$PROJECT_ID/clusters/demomongo/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 admin. 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.
3. 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/mongodb/v1alpha1/projects/$PROJECT_ID/clusters/demomongo/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.
4. 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/mongodb/v1alpha1/projects/$PROJECT_ID/clusters/demomongo/users/reportreader" \
-H "X-Hikube-Api-Key: $HIKUBE_API_KEY"
Les droits de l'utilisateur sur toutes les bases sont retirés avec lui.
5. Tester la connexion
mongosh "mongodb://<hôte>:27017/analytics?directConnection=true&authSource=admin" --username report-reader
Sur un replica set, <hôte> est l'adresse d'un des membres listés dans la zone Externe de la carte Connexion et réseau.
// Doit réussir
db.runCommand({ connectionStatus: 1 })
db.events.find().limit(1)
// Doit échouer pour un utilisateur en lecture seule
db.events.insertOne({ test: true })
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)).
curl -sS "$HIKUBE_API/mongodb/v1alpha1/projects/$PROJECT_ID/clusters/demomongo/users" \
-H "X-Hikube-Api-Key: $HIKUBE_API_KEY" | jq '.users[] | {username, databases: .config.databases}'
Cette lecture suffit avec une clé read. L'API expose aussi les bases déclarées sur le cluster : GET $HIKUBE_API/mongodb/v1alpha1/projects/$PROJECT_ID/clusters/demomongo/databases.
Pour aller plus loin
- Concepts MongoDB : rôles et règles de nommage
- Modifier les ressources