password reset flow

This commit is contained in:
2026-11-05 14:19:49 +01:00
parent e89df68e7d
commit c95173cda8
8 changed files with 425 additions and 0 deletions
+42
View File
@@ -251,6 +251,48 @@ defmodule Chesstrainer.Accounts do
|> update_user_and_delete_all_tokens()
end
@doc ~S"""
Delivers the reset password email instructions to the given user.
## Examples
iex> deliver_user_reset_password_instructions(user, &url(~p"/users/reset-password/#{&1}"))
{:ok, %{to: ..., body: ...}}
"""
def deliver_user_reset_password_instructions(%User{} = user, reset_password_url_fun)
when is_function(reset_password_url_fun, 1) do
{encoded_token, user_token} = UserToken.build_email_token(user, "reset_password")
Repo.insert!(user_token)
UserNotifier.deliver_reset_password_instructions(user, reset_password_url_fun.(encoded_token))
end
@doc """
Gets the user with the given reset password token.
Returns `nil` if the token is invalid or has expired.
"""
def get_user_by_reset_password_token(token) do
with {:ok, query} <- UserToken.verify_reset_password_token_query(token),
%UserToken{sent_to: email} <- Repo.one(query),
%User{} = user <- Repo.get_by(User, email: email) do
user
else
_ -> nil
end
end
@doc """
Resets the user password.
Returns a tuple with the updated user, as well as a list of expired tokens.
"""
def reset_user_password(user, attrs) do
user
|> User.password_changeset(attrs)
|> update_user_and_delete_all_tokens()
end
## Deletion
@doc """
@@ -37,6 +37,26 @@ defmodule Chesstrainer.Accounts.UserNotifier do
""")
end
@doc """
Deliver instructions to reset a user password.
"""
def deliver_reset_password_instructions(user, url) do
deliver(user.email, "Reset password instructions", """
==============================
Hi #{user.email},
You can reset your password by visiting the URL below:
#{url}
If you didn't request this change, please ignore this.
==============================
""")
end
@doc """
Deliver instructions to update a user email.
"""
+26
View File
@@ -8,6 +8,7 @@ defmodule Chesstrainer.Accounts.UserToken do
@change_email_validity_in_days 7
@confirm_validity_in_days 1
@reset_password_validity_in_days 1
@session_validity_in_days 14
@primary_key {:id, :binary_id, autogenerate: true}
@@ -147,6 +148,31 @@ defmodule Chesstrainer.Accounts.UserToken do
end
end
@doc """
Checks if the token is valid and returns its underlying lookup query.
The query returns the user_token found by the token, if any.
This is used to validate requests to reset the user password.
The given token is valid if it matches its hashed counterpart in the
database and if it has not expired (after @reset_password_validity_in_days).
"""
def verify_reset_password_token_query(token) do
case Base.url_decode64(token, padding: false) do
{:ok, decoded_token} ->
hashed_token = :crypto.hash(@hash_algorithm, decoded_token)
query =
from token in by_token_and_context_query(hashed_token, "reset_password"),
where: token.inserted_at > ago(@reset_password_validity_in_days, "day")
{:ok, query}
:error ->
:error
end
end
defp by_token_and_context_query(token, context) do
from UserToken, where: [token: ^token, context: ^context]
end
@@ -54,6 +54,15 @@ defmodule ChesstrainerWeb.UserLive.Login do
Log in only this time
</.button>
</.form>
<p class="text-center text-sm">
<.link
navigate={~p"/users/reset-password"}
class="font-semibold text-primary hover:underline"
>
Forgot your password?
</.link>
</p>
</div>
</Layouts.app>
"""
@@ -0,0 +1,128 @@
defmodule ChesstrainerWeb.UserLive.ResetPassword do
use ChesstrainerWeb, :live_view
alias Chesstrainer.Accounts
@impl true
def render(assigns) do
~H"""
<Layouts.app flash={@flash} current_scope={@current_scope}>
<div class="mx-auto max-w-sm space-y-4">
<div class="text-center">
<.header>
{@title}
<:subtitle>{@subtitle}</:subtitle>
</.header>
</div>
<.form for={@form} id="reset_password_form" phx-submit={@submit_event}>
<%= if @token do %>
<.input
field={@form[:password]}
type="password"
label="New password"
autocomplete="new-password"
spellcheck="false"
required
/>
<.input
field={@form[:password_confirmation]}
type="password"
label="Confirm new password"
autocomplete="new-password"
spellcheck="false"
/>
<% else %>
<.input
field={@form[:email]}
type="email"
label="Email"
autocomplete="email"
spellcheck="false"
required
/>
<% end %>
<.button variant="primary" class="w-full" phx-disable-with="Saving...">
{@submit_label}
</.button>
</.form>
<p class="text-center text-sm">
<.link
navigate={~p"/users/log-in"}
class="font-semibold text-primary hover:underline"
>
Back to log in
</.link>
</p>
</div>
</Layouts.app>
"""
end
@impl true
def mount(%{"token" => token}, _session, socket) do
case Accounts.get_user_by_reset_password_token(token) do
nil ->
{:ok,
socket
|> put_flash(:error, "Reset password link is invalid or it has expired.")
|> push_navigate(to: ~p"/users/log-in")}
user ->
{:ok,
socket
|> assign(:user, user)
|> assign(:token, token)
|> assign(:title, "Reset password")
|> assign(:subtitle, "Choose a new password for your account.")
|> assign(:submit_label, "Reset password")
|> assign(:submit_event, "submit_password")
|> assign(:form, to_form(%{"password" => ""}, as: "user"))}
end
end
def mount(_params, _session, socket) do
{:ok,
socket
|> assign(:user, nil)
|> assign(:token, nil)
|> assign(:title, "Forgot your password?")
|> assign(:subtitle, "Enter your email and we'll send you reset instructions.")
|> assign(:submit_label, "Send reset instructions")
|> assign(:submit_event, "submit_email")
|> assign(:form, to_form(%{"email" => ""}, as: "user"))}
end
@impl true
def handle_event("submit_email", %{"user" => %{"email" => email}}, socket) do
if user = Accounts.get_user_by_email(String.trim(email)) do
Accounts.deliver_user_reset_password_instructions(
user,
&url(~p"/users/reset-password/#{&1}")
)
end
{:noreply,
socket
|> put_flash(
:info,
"If your email is in our system, you will receive instructions to reset your password shortly."
)
|> push_navigate(to: ~p"/users/log-in")}
end
def handle_event("submit_password", %{"user" => user_params}, socket) do
case Accounts.reset_user_password(socket.assigns.user, user_params) do
{:ok, {_user, _expired_tokens}} ->
{:noreply,
socket
|> put_flash(:info, "Password reset successfully. Log in with your new password.")
|> push_navigate(to: ~p"/users/log-in")}
{:error, %Ecto.Changeset{} = changeset} ->
{:noreply, assign(socket, form: to_form(changeset, action: :insert))}
end
end
end
+2
View File
@@ -83,6 +83,8 @@ defmodule ChesstrainerWeb.Router do
live "/endgames/:public_code/play", EndgameLive.Play, :play
live "/users/register", UserLive.Registration, :new
live "/users/log-in", UserLive.Login, :new
live "/users/reset-password", UserLive.ResetPassword, :new
live "/users/reset-password/:token", UserLive.ResetPassword, :edit
end
get "/users/confirm/:token", UserConfirmationController, :edit