Admin panel, login throttling, and Cloudflare edge hardening (#150)

* Document the remote shell for production user management

* add sitemap to footer links

* remove border under theme selection

* Add admin theme and user management (#144)

Add /admin/themes CRUD and /admin/users list/detail with role and plan editing, guarded by a shared Policy module. Include last-super-admin and self-role protections plus structured id-only admin logs.

Also add admin invitations, confirmation resends and password-reset emails, which work in development through the Swoosh mailbox before SES is configured.

* Rate-limit password logins and emit auth events (#142)

Add a two-bucket login throttle (5 failures per login, 10 per IP in a 15-minute window) and a shared client-address helper for controllers and LiveViews. Blocked attempts skip the database and bcrypt.

Log auth.login.failed and auth.login.throttled warnings with boot-scoped HMAC addresses only, and stop repeated confirmation emails on unconfirmed login attempts.

* Harden the production login edge for Cloudflare

Document the layered login defence: the app throttle is primary, Caddy must pass Cloudflare's CF-Connecting-IP to the app, and Cloudflare edge rate limiting covers request floods.

Update the reference Caddyfile to accept only Cloudflare ranges and reject direct-to-origin traffic, and document the exact Cloudflare dashboard rules.

* Document 10-second Cloudflare rate-limit window

Cloudflare may only offer a 10-second period. Keep the edge rule at 10 login POSTs per 10 seconds per IP and rely on the app's 15-minute login/address throttle for credential guessing.

* Document Cloudflare limits for LiveView registration

Registration submits over the shared LiveView socket, so a Cloudflare rule on POST /users/register will not count account creations. Note the app-level throttle/Turnstile options instead.

* Document current Cloudflare free-plan edge controls

Record the production setup: Cloudflare-only Caddy origins, Bot Fight Mode, and the 10-second login flood rule (10 POSTs per 10 seconds, 10-second block). Clarify that the application's 15-minute throttle remains the real credential lockout.

* Auto-refresh Cloudflare CIDRs for Caddy

Move the origin allowlist into a generated cloudflare-ranges.caddy imported by Caddy. Add an hourly systemd timer and script that fetch Cloudflare's v4/v6 lists, reject malformed responses, validate the candidate Caddyfile, and reload Caddy only when the ranges change. Restore the previous file on validation or reload failure.

* Document Cloudflare CIDR refresher setup and operations

Record the installed paths, permissions, timer checks, manual run, update procedure, and the direct-on-VPS setup fallback when the deploy directory is absent.
This commit is contained in:
2026-11-11 21:27:59 +01:00
committed by GitHub
parent 202b9b1f6a
commit 624ddab644
45 changed files with 3602 additions and 70 deletions
@@ -0,0 +1,71 @@
defmodule ChesstrainerWeb.Admin.ThemeLive.FormTest do
use ChesstrainerWeb.ConnCase
import Phoenix.LiveViewTest
import Chesstrainer.ThemesFixtures
alias Chesstrainer.Themes
setup :register_and_log_in_admin
test "creates a theme", %{conn: conn} do
{:ok, view, _html} = live(conn, ~p"/admin/themes/new")
view
|> form("#theme-form", theme: %{name: " Lucena ", category: "endgame"})
|> render_submit()
assert_redirect(view, ~p"/admin/themes")
assert [%{name: "Lucena", category: :endgame}] = Themes.search("Lucena", "endgame")
end
test "renames and recategorises a theme", %{conn: conn} do
theme = theme_fixture(%{name: "Lucena", category: :endgame})
{:ok, view, _html} = live(conn, ~p"/admin/themes/#{theme.id}/edit")
view
|> form("#theme-form", theme: %{name: "Lucena", category: "opening"})
|> render_submit()
assert_redirect(view, ~p"/admin/themes")
updated = Themes.get_theme!(theme.id)
assert updated.name == "Lucena"
assert updated.category == :opening
end
test "shows the existing duplicate-name validation error", %{conn: conn} do
theme_fixture(%{name: "Lucena", category: :endgame})
{:ok, view, _html} = live(conn, ~p"/admin/themes/new")
html =
view
|> form("#theme-form", theme: %{name: "lucena", category: "endgame"})
|> render_submit()
assert html =~ "already exists"
assert length(Themes.list_themes()) == 1
end
test "validates a blank name", %{conn: conn} do
{:ok, view, _html} = live(conn, ~p"/admin/themes/new")
html =
view
|> form("#theme-form", theme: %{name: "", category: "endgame"})
|> render_submit()
assert html =~ "can't be blank"
end
test "shows the admin sub-navigation", %{conn: conn} do
{:ok, _view, html} = live(conn, ~p"/admin/themes/new")
assert html =~ ~p"/admin/endgames"
assert html =~ ~p"/admin/themes"
assert html =~ ~p"/admin/users"
end
end
@@ -0,0 +1,72 @@
defmodule ChesstrainerWeb.Admin.ThemeLive.IndexTest do
use ChesstrainerWeb.ConnCase
import Phoenix.LiveViewTest
import Chesstrainer.EndgamesFixtures
import Chesstrainer.ThemesFixtures
alias Chesstrainer.Endgames
alias Chesstrainer.Repo
alias Chesstrainer.Themes
setup :register_and_log_in_admin
test "lists themes with their usage count", %{conn: conn} do
used_theme = theme_fixture(%{name: "Lucena"})
unused_theme = theme_fixture(%{name: "Philidor"})
endgame = endgame_fixture()
{:ok, _} = Endgames.update_endgame(endgame, %{}, [used_theme])
{:ok, view, _html} = live(conn, ~p"/admin/themes")
assert has_element?(view, "#theme-#{used_theme.id}")
assert has_element?(view, "#theme-usage-#{used_theme.id}", "1 endgame")
assert has_element?(view, "#theme-usage-#{unused_theme.id}", "0 endgames")
end
test "filters by name and category", %{conn: conn} do
theme_fixture(%{name: "Lucena", category: :endgame})
theme_fixture(%{name: "Philidor", category: :endgame})
theme_fixture(%{name: "Pin", category: :tactic})
{:ok, view, _html} = live(conn, ~p"/admin/themes")
view |> form("#theme-admin-filter-form", %{search: "Luc"}) |> render_change()
assert has_element?(view, "td", "Lucena")
refute has_element?(view, "td", "Philidor")
refute has_element?(view, "td", "Pin")
view |> form("#theme-admin-filter-form", %{search: "", category: "tactic"}) |> render_change()
assert has_element?(view, "td", "Pin")
refute has_element?(view, "td", "Lucena")
end
test "shows an empty state that explains what themes do", %{conn: conn} do
{:ok, _view, html} = live(conn, ~p"/admin/themes")
assert html =~ "No themes yet"
assert html =~ "Themes power endgame filtering"
end
test "deleting a theme detaches it from endgames and keeps the endgame", %{conn: conn} do
theme = theme_fixture(%{name: "Lucena"})
endgame = endgame_fixture()
{:ok, _} = Endgames.update_endgame(endgame, %{}, [theme])
{:ok, view, html} = live(conn, ~p"/admin/themes")
assert html =~ "Used by 1 endgame"
assert html =~ "The endgames will be kept"
view |> element("#theme-#{theme.id} a", "Delete") |> render_click()
assert_raise Ecto.NoResultsError, fn -> Themes.get_theme!(theme.id) end
assert Endgames.get_endgame!(endgame.id)
endgame = Endgames.get_endgame!(endgame.id) |> Repo.preload(:themes)
assert endgame.themes == []
end
end