guides Utilisateurs et rôles

Utilisateurs et rôles

Chaque personne a son propre compte socAdmin, en tant qu'administrateur ou utilisateur en lecture seule.

Comptes

Un compte socAdmin est un email et un mot de passe, stockés dans le fichier SQLite propre à socAdmin. Il est distinct des utilisateurs de base de données : une fois connecté, chaque personne entre toujours les identifiants de base de données qu’elle est autorisée à utiliser.

Les mots de passe doivent contenir au moins 10 caractères, incluant une majuscule, une minuscule, un chiffre et un caractère spécial. Ils sont hachés avec bcrypt.

Le premier administrateur

Il y a deux façons d’obtenir le premier compte administrateur :

  • Définir ADMIN_EMAIL et ADMIN_PASSWORD. socAdmin crée cet administrateur au démarrage si l’email n’existe pas encore. Recommandé avec Docker.
  • S’inscrire via le navigateur. Quand socAdmin n’a aucun compte, la première personne à s’inscrire devient l’administrateur.

Toute personne qui s’inscrit ensuite reçoit le rôle lecture seule.

Rôles

Admin Lecture seule
Parcourir les bases de données, tables, collections et lignes Oui Oui
Voir la structure, index, triggers, routines, vues Oui Oui
Exporter et sauvegarder Oui Oui
Utiliser les connexions enregistrées Oui Oui
Exécuter des requêtes dans l’éditeur Oui Non
Insérer, modifier et supprimer des lignes ou documents Oui Non
Créer, modifier, supprimer ou vider des bases et tables Oui Non
Importer SQL, CSV ou JSON, restaurer une sauvegarde Oui Non
Enregistrer ou supprimer des connexions partagées Oui Non
Gérer les utilisateurs et rôles socAdmin Oui Non
Modifier la liste blanche d’IP Oui Non

Ajouter des personnes

Les administrateurs créent des comptes et modifient les rôles depuis l’écran des utilisateurs dans socAdmin.

Pour empêcher des inconnus de créer des comptes sur une instance publique, désactivez l’auto-inscription :

REGISTRATION_ENABLED=false

Avec l’inscription désactivée, seul un administrateur peut ajouter des utilisateurs. Le tout premier compte peut toujours être créé quand socAdmin est vide.

Protection de la connexion

  • Après 5 tentatives de connexion échouées pour le même email depuis la même IP, la connexion est bloquée pendant 15 minutes.
  • Les sessions utilisent un jeton d’accès de courte durée (15 minutes) renouvelé par un jeton de rafraîchissement (7 jours), tous deux dans des cookies HttpOnly.
  • Changer ou réinitialiser un mot de passe révoque les jetons de rafraîchissement de cet utilisateur.

Mot de passe oublié ? Voir Réinitialisation du mot de passe.