Réinitialisation de mot de passe

RuniqueAppBuilder::new(config)
    .with_mailer_from_env()
    .with_password_reset::<BuiltinUserEntity>(|pr| pr
        .base_url("https://monsite.com")  // optionnel en dev, obligatoire en prod
    )
    .build()
    .await?

BuiltinUserEntity — utilise la table eihwaz_users fournie par le framework. Si ton projet a un modèle utilisateur custom, implémente le trait UserEntity (voir ci-dessous).

Toutes les options sont optionnelles — les valeurs par défaut fonctionnent sans rien changer.

.with_password_reset::<BuiltinUserEntity>(|pr| pr
    .forgot_route("/mot-de-passe-oublie")       // défaut : /forgot-password
    .reset_route("/reinitialiser")               // défaut : /reset-password
    .forgot_template("auth/oubli.html")          // défaut : auth/forgot_password.html
    .reset_template("auth/reset.html")           // défaut : auth/reset_password.html
    .success_redirect("/connexion")              // défaut : /
    .base_url("https://monsite.com")             // pour construire le lien dans l'email
)

Si tu n'utilises pas BuiltinUserEntity, implémente ce trait sur ton entité :

use runique::prelude::UserEntity;

#[async_trait::async_trait]
impl UserEntity for user::Model {
    async fn find_by_email(db: &DatabaseConnection, email: &str) -> Option<Self> {
        user::Entity::find()
            .filter(user::Column::Email.eq(email))
            .one(db)
            .await
            .ok()?
    }

    async fn update_password(
        db: &DatabaseConnection,
        email: &str,
        hash: &str,
    ) -> Result<(), sea_orm::DbErr> {
        user::Entity::update_many()
            .col_expr(user::Column::Password, sea_orm::sea_query::Expr::value(hash))
            .filter(user::Column::Email.eq(email))
            .exec(db)
            .await?;
        Ok(())
    }

    fn username(&self) -> &str {
        &self.username
    }
}

Puis dans le builder :

.with_password_reset::<user::Model>(|pr| pr)

Deux templates sont à créer dans templates/. Si absents, le framework utilise ses propres templates par défaut.

auth/forgot_password.html — formulaire "email oublié"

{% extends "base.html" %}
{% block content %}
<form method="post">
    {{ form.html | safe }}
    <button type="submit">Envoyer le lien</button>
</form>

{% if form.errors.email %}
    <p class="error">{{ form.errors.email }}</p>
{% endif %}
{% endblock %}

Variables disponibles dans le contexte Tera :

auth/reset_password.html — formulaire de reset

{% extends "base.html" %}
{% block content %}
<form method="post">
    {{ form.html | safe }}
    <button type="submit">Changer le mot de passe</button>
</form>

{% if form.errors.password %}
    <p class="error">{{ form.errors.password }}</p>
{% endif %}
{% endblock %}

Variables disponibles :

Validations automatiques : mot de passe minimum 10 caractères, confirmation identique, token valide et non expiré.

1. Utilisateur clique "Mot de passe oublié"
        ↓
2. GET /forgot-password → affiche le formulaire email
        ↓
3. POST /forgot-password → email soumis
   - Si l'email existe : génère un token (1h), envoie un email avec le lien
   - Si l'email est inconnu : même réponse (sécurité — ne révèle pas les comptes existants)
        ↓
4. Utilisateur clique le lien reçu par email
        ↓
5. GET /reset-password/{token}/{email_chiffré} → affiche le formulaire de reset
   - Token invalide ou expiré → erreur
        ↓
6. POST /reset-password/{token}/{email_chiffré}
   - Valide le formulaire (mot de passe min 10 chars, confirmation)
   - Consomme le token (usage unique)
   - Met à jour le mot de passe en DB
   - Redirige vers success_redirect (défaut : /)

Si l'admin est activé avec .user_resource(), le panel peut envoyer des liens de reset directement depuis la fiche utilisateur.

Configuration dans config_admin.rs (généré par le daemon) :

admin_config
    .user_resource("users")
    .reset_password_url("https://monsite.com/reset-password")
    // optionnel — si absent, le lien s'affiche dans un flash message

Template email admin (optionnel, sinon template par défaut) :

• templates/admin/reset_password_email.html
• templates/admin/user_created_email.html

Variables disponibles dans ces templates : username, email, reset_url.