Dépannage et assistance
En cas de perte d’accès au compte administrateur système de Relution et d’impossibilité de réinitialiser le mot de passe à l’aide de l’adresse électronique configurée, il est également possible de réinitialiser le mot de passe à partir de la base de données. Cette procédure nécessite un accès en écriture au serveur de base de données et à la base de données de Relution.
Essayer de réinitialiser le mot de passe via le lien Mot de passe oublié ? avant d’essayer de le réinitialiser à partir de la base de données. N’utiliser cette option qu’en dernier recours.
Pour réinitialiser le mot de passe, une connexion à la base de données est d’abord établie via la ligne de commande ou un outil d’administration. Le script SQL correspondant au serveur de base de données concerné est ensuite exécuté. Le script définit un nouveau mot de passe pour l’utilisateur admin de l’organisation système, remet à zéro le compteur d’échecs de connexion et réactive le compte s’il a été bloqué après trop de tentatives infructueuses.
Le préfixe {noop} désigne un mot de passe en clair. Jusqu’à la première connexion, le nouveau mot de passe est donc stocké non chiffré dans la base de données. Lors de la première connexion, Relution l’enregistre automatiquement sous forme de hachage Argon2. Le mot de passe devrait ensuite être modifié dans le portail. Si une authentification multifacteur est configurée pour le compte, le second facteur reste demandé après la réinitialisation.
Microsoft SQL Server et MySQL ne sont plus pris en charge par Relution. Le passage à MariaDB est décrit sous Migration de MSSQL vers MariaDB →.
PostgreSQL
UPDATE security_user usr
SET password = '{noop}password123',
failed_login_attempts = 0,
activated = true
FROM security_role rol
JOIN security_organization org ON org.uuid = rol.organization_uuid
WHERE rol.uuid = usr.uuid
AND usr.name = 'admin'
AND org.is_system = true;
password123 est remplacé par le nouveau mot de passe, le préfixe {noop} est conservé.
MariaDB
UPDATE security_user usr
JOIN security_role rol ON rol.uuid = usr.uuid
JOIN security_organization org ON org.uuid = rol.organization_uuid
SET usr.password = '{noop}password123',
usr.failed_login_attempts = 0,
usr.activated = true
WHERE usr.name = 'admin'
AND org.is_system = true;
password123 est remplacé par le nouveau mot de passe, le préfixe {noop} est conservé.
Créer un administrateur système supplémentaire
Sans accès à la base de données, un administrateur système supplémentaire peut être créé au démarrage du serveur. Pour cela, les variables d’environnement OTHERSYSTEMADMIN_USERNAME et OTHERSYSTEMADMIN_PASSWORD sont définies, ou bien les clés username et password sous relution.system.otheradmin dans le fichier application.yml. Après un redémarrage, Relution crée l’utilisateur dans l’organisation système et l’ajoute au groupe des administrateurs.
relution:
system:
otheradmin:
username: ""
password: ""
Si un utilisateur portant ce nom existe déjà dans l’organisation système, il récupère uniquement les droits d’administrateur, son mot de passe reste inchangé. Après la connexion, ces entrées devraient être supprimées afin que le mot de passe ne reste pas durablement dans la configuration.
Le serveur ne démarre pas
Vérifier les fichiers journaux, qui se trouvent par défaut dans le répertoire log du répertoire d’installation de Relution.
Si le problème ne peut pas être identifié par soi-même, ouvrir un ticket d’assistance et y joindre les fichiers journaux.
Fichiers journaux
L’emplacement des fichiers journaux pour Docker, Linux et Windows est décrit sous Relution Logs →.
Notes de sécurité
- Installer les dernières mises à jour du système d’exploitation et du logiciel, ainsi que les correctifs de sécurité.
- Utiliser des mots de passe forts pour les comptes administrateurs
- Utiliser des mots de passe longs pour les communications entre services. Ces mots de passe n’ont pas besoin d’être utilisés ni mémorisés par des humains.
- S’assurer que le compte d’utilisateur utilisé pour accéder au LDAP dispose d’un accès en lecture seule.
- Ne pas créer de comptes avec des mots de passe faibles tels que
passwordoutest. - Ne pas stocker les mots de passe dans des fichiers qui sont globalement lisibles.