Comptes et récupération par courriel

Disponible depuis v0.2.1

La récupération par courriel nécessite la configuration SMTP décrite ci-dessous. Utilisez les modèles .env.example et Compose de la version installée.

L’adresse courriel est obligatoire lors de la création du premier compte et des utilisateurs supplémentaires. Chaque compte doit avoir sa propre adresse. Pour un compte existant sans adresse, ouvrez Paramètres → Compte, renseignez l’adresse de récupération et confirmez avec le mot de passe actuel. Une modification de l’adresse annule les anciens liens de réinitialisation.

Configurer l’envoi SMTP

Renseignez les variables suivantes dans .env, avec les paramètres fournis par votre hébergeur de messagerie :

RUCHEPILOT_PUBLIC_URL=https://ruchepilot.example.tld
SMTP_HOST=smtp.exemple.fr
SMTP_PORT=587
SMTP_SECURITY=starttls
SMTP_USERNAME=compte-smtp
SMTP_PASSWORD=mot-de-passe-application-smtp
SMTP_FROM=ruchepilot@exemple.fr

• RUCHEPILOT_PUBLIC_URL : adresse HTTPS publique de l’instance, sans chemin, requête ni fragment. Les liens sont construits depuis cette valeur fixe. HTTP est accepté uniquement sur localhost pour le développement.
• SMTP_HOST et SMTP_PORT : serveur et port du fournisseur. Utilisez starttls sur le port 587, ou ssl sur le port 465 selon sa configuration ; les certificats TLS sont vérifiés.
• SMTP_USERNAME et SMTP_PASSWORD : identifiants SMTP, distincts des comptes LeveCadre. Utilisez un mot de passe d’application si le fournisseur l’exige. Un relais sans authentification peut laisser ces deux valeurs vides, mais TLS reste requis.
• SMTP_FROM : adresse d’expédition autorisée par le fournisseur. Configurez les enregistrements SPF/DKIM demandés pour votre domaine et vérifiez les courriers indésirables.

Les modèles Compose transmettent ces variables au conteneur. Pour une ancienne configuration personnalisée, recopiez les sept variables dans environment du service ruchepilot ; le fichier .env seul ne les transmet pas automatiquement. Le conteneur doit pouvoir joindre le serveur SMTP et le pare-feu doit autoriser le port choisi.

Gardez .env privé (chmod 600 .env). Appliquez les changements avec docker compose up -d pour recréer le service si nécessaire. Un simple docker compose restart ne recharge pas ses variables d’environnement. Si l’envoi n’est pas configuré, le formulaire de récupération invite à contacter l’administrateur ; aucun lien n’est affiché à l’écran.

Réinitialiser un mot de passe

1. Sous le formulaire de connexion, cliquez sur Mot de passe oublié ?.
2. Saisissez l’adresse courriel enregistrée sur votre compte.
3. Ouvrez le courriel LeveCadre et suivez son lien, valable 30 minutes et une seule fois.
4. Choisissez et confirmez un nouveau mot de passe d’au moins 12 caractères, puis reconnectez-vous.

Le message affiché est identique pour une adresse connue ou inconnue. L’ancien mot de passe n’est jamais envoyé par courriel. Les demandes sont limitées et un nouveau courriel ne peut être demandé qu’après une minute. Ouvrir le lien ne le consomme pas : seule la validation du nouveau mot de passe le fait.

La réinitialisation déconnecte les sessions web existantes et annule les autres liens du compte. Les mots de passe d’application CalDAV restent distincts ; ils peuvent être révoqués depuis les paramètres. Si le courriel n’arrive pas, vérifiez l’adresse enregistrée, les courriers indésirables, l’accès SMTP, les identifiants et les journaux de l’application. Sans adresse enregistrée ou sans accès à cette boîte, la récupération automatique n’est pas possible.