Aller au contenu principal

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 mongosh pour tester les connexions
  • Pour l'onglet API : une clé d'API admin du projet et les variables HIKUBE_API, HIKUBE_API_KEY et PROJECT_ID (voir Préparer l'environnement) ; les exemples utilisent curl et jq

Toutes les opérations se font depuis la page du cluster : DB & Messaging → MongoDB → nom du cluster, section Utilisateurs.

remarque

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​

  1. Dans la section Utilisateurs, cliquez sur Créer un utilisateur.
  2. 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).
  3. 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ème admin, local et config sont refusées) ;
    • Droits : Administrateur (Admin) ou Lecture seule (Read-only).
  4. 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é.

attention

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.

astuce

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.

2. Modifier les droits d'un utilisateur​

  1. Ouvrez le menu Actions de l'utilisateur et choisissez Gérer les accès.
  2. Ajoutez des accès avec Ajouter, modifiez les Droits ou retirez une ligne. Au moins un accès doit subsister.
  3. Cliquez sur Enregistrer. Le message « Accès mis à jour » confirme l'enregistrement.

Le nom d'utilisateur ne peut pas être modifié.

Utilisateurs créés avant la console v1.3.0

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​

  1. Ouvrez le menu Actions de l'utilisateur et choisissez Changer le mot de passe.
  2. Dans la fenêtre Rotation du mot de passe, cliquez sur Effectuer la rotation.
  3. Copiez le nouveau mot de passe, puis cliquez sur Terminer.
attention

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​

Ouvrez le menu Actions de l'utilisateur, choisissez Supprimer l'utilisateur, saisissez son nom exact puis cliquez sur Supprimer définitivement.

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​

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)).

Pour aller plus loin​