Gérer les utilisateurs via le panel d'administration

À qui s'adresse cette page

Administrateurs qui gèrent les comptes utilisateurs de leur instance gitrust depuis l'interface /admin/users.

Accéder au panel utilisateurs

Connectez-vous avec un compte administrateur et accédez à :

https://VOTRE_INSTANCE/admin/users

Liste des utilisateurs dans /admin/users

La liste affiche pour chaque utilisateur : nom d'utilisateur, adresse e-mail, date de création, statut du compte (actif/désactivé), rôle (admin ou utilisateur standard), et si la vérification e-mail a été effectuée.

Créer un utilisateur

Si l'inscription publique est désactivée (allow_registration=false dans /admin/settings), seuls les administrateurs peuvent créer des comptes.

  1. Cliquez Nouvel utilisateur
  2. Renseignez : nom d'utilisateur, adresse e-mail, mot de passe temporaire
  3. Cochez Forcer le changement de mot de passe à la prochaine connexion si souhaité
  4. Cliquez Créer

L'utilisateur reçoit un e-mail de validation si EMAIL_VALIDATION_REQUIRED est activé.

Conseil : pour les instances privées (équipe interne), désactivez l'inscription publique dans /admin/settings et créez les comptes manuellement pour garder le contrôle.

Désactiver un compte utilisateur

La désactivation empêche la connexion sans supprimer les données (dépôts, issues, commentaires restent intacts).

  1. Dans /admin/users, cliquez sur l'utilisateur concerné
  2. Cliquez Désactiver le compte
  3. Confirmez

Après désactivation : - L'utilisateur ne peut plus se connecter (HTTP ou SSH) - Ses dépôts restent accessibles aux autres membres des équipes - La désactivation est réversible : cliquez Réactiver pour rétablir l'accès

Supprimer un compte utilisateur

La suppression est irréversible. Les dépôts dont l'utilisateur est propriétaire doivent être transférés ou supprimés au préalable.

  1. Désactivez d'abord le compte (étape ci-dessus)
  2. Cliquez Supprimer le compte
  3. Confirmez en saisissant le nom d'utilisateur

Les données supprimées : compte utilisateur, clés SSH, personal access tokens, sessions actives.
Les données conservées : dépôts transférés, issues/commentaires (auteur anonymisé).

Forcer la réinitialisation du mot de passe

Utile si un compte est suspecté d'être compromis ou si l'utilisateur a oublié son mot de passe.

  1. Ouvrez la fiche de l'utilisateur dans /admin/users
  2. Cliquez Forcer la réinitialisation du mot de passe
  3. L'utilisateur reçoit un e-mail avec un lien de reset (valable PASSWORD_RESET_EXPIRATION_HOURS heures, défaut : 1 h)

Si le compte n'a pas d'adresse e-mail valide ou si le SMTP n'est pas configuré, définissez un nouveau mot de passe directement :

  1. Ouvrez la fiche utilisateur
  2. Cliquez Définir un nouveau mot de passe
  3. Saisissez le mot de passe temporaire et cochez Forcer le changement à la prochaine connexion

Forcer l'activation du 2FA

Pour exiger que tous les utilisateurs activent l'authentification à deux facteurs (TOTP), configurez le paramètre global dans /admin/settings :

  1. Accédez à /admin/settings
  2. Activez Forcer le 2FA pour tous les utilisateurs (totp_force_enabled=true)
  3. Enregistrez

Après activation, tout utilisateur sans 2FA configuré est redirigé vers la page de configuration TOTP à sa prochaine connexion. L'accès à l'application est bloqué jusqu'à la configuration.

Pour forcer le 2FA uniquement pour un utilisateur spécifique :

  1. Ouvrez la fiche de l'utilisateur dans /admin/users
  2. Cliquez Révoquer le 2FA (si actif mais compromis) pour forcer une reconfiguration

Gérer les permissions administrateur

Accorder les droits administrateur

  1. Ouvrez la fiche de l'utilisateur
  2. Cliquez Accorder le rôle administrateur
  3. Confirmez

Un administrateur a accès à /admin complet : gestion des utilisateurs, paramètres, équipes, logs d'audit.

Révoquer les droits administrateur

  1. Ouvrez la fiche de l'utilisateur
  2. Cliquez Révoquer le rôle administrateur

Vous ne pouvez pas révoquer vos propres droits administrateur. Un autre administrateur doit effectuer cette opération.

Droits sur les dépôts (niveau ressource)

Les droits sur les dépôts spécifiques (Reader, Developer, Maintainer) sont gérés au niveau de chaque dépôt ou via les équipes — pas depuis /admin/users. Voir le modèle de permissions pour les détails.

Pour aller plus loin