Files
chess-endgame-trainer/lib/chesstrainer_web/router.ex
T
owenrees 624ddab644 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.
2026-11-11 21:27:59 +01:00

153 lines
5.1 KiB
Elixir

defmodule ChesstrainerWeb.Router do
use ChesstrainerWeb, :router
import ChesstrainerWeb.UserAuth
pipeline :browser do
plug :accepts, ["html"]
plug :fetch_session
plug ChesstrainerWeb.Plugs.PutRequestId
plug :fetch_live_flash
plug :put_root_layout, html: {ChesstrainerWeb.Layouts, :root}
plug :protect_from_forgery
plug :put_secure_browser_headers
plug ChesstrainerWeb.Plugs.Prelaunch
plug :fetch_current_scope_for_user
end
pipeline :api do
plug :accepts, ["json"]
end
# Crawler files are plain text and XML, so they must not negotiate HTML.
pipeline :seo do
end
# Never let search engines index private or authenticated areas.
pipeline :noindex do
plug ChesstrainerWeb.Plugs.NoIndex
end
scope "/", ChesstrainerWeb do
pipe_through :browser
get "/", PageController, :home
get "/privacy", PageController, :privacy
get "/terms-conditions", PageController, :terms_conditions
get "/mentions-legales", PageController, :mentions_legales
post "/mailing-list", MailingListController, :create
get "/mailing-list/confirm/:token", MailingListController, :confirm
post "/admin/log-in", UserSessionController, :create_admin
end
scope "/admin", ChesstrainerWeb do
pipe_through [:browser, :noindex, :require_admin_user]
live_session :admin,
on_mount: [
{ChesstrainerWeb.UserAuth, :enforce_prelaunch},
{ChesstrainerWeb.UserAuth, :require_admin}
] do
live "/endgames", EndgameLive.Index, :index
live "/endgames/new", EndgameLive.Form, :new
live "/endgames/:id", EndgameLive.Show, :show
live "/endgames/:id/edit", EndgameLive.Form, :edit
live "/themes", Admin.ThemeLive.Index, :index
live "/themes/new", Admin.ThemeLive.Form, :new
live "/themes/:id/edit", Admin.ThemeLive.Form, :edit
live "/users", Admin.UserLive.Index, :index
live "/users/new", Admin.UserLive.New, :new
live "/users/:id", Admin.UserLive.Show, :show
end
end
# Other scopes may use custom stacks.
# scope "/api", ChesstrainerWeb do
# pipe_through :api
# end
# Enable LiveDashboard and Swoosh mailbox preview in development
if Application.compile_env(:chesstrainer, :dev_routes) do
# If you want to use the LiveDashboard in production, you should put
# it behind authentication and allow only admins to access it.
# If your application does not have an admins-only section yet,
# you can use Plug.BasicAuth to set up some basic authentication
# as long as you are also using SSL (which you should anyway).
import Phoenix.LiveDashboard.Router
scope "/dev" do
pipe_through :browser
live_dashboard "/dashboard", metrics: ChesstrainerWeb.Telemetry
forward "/mailbox", Plug.Swoosh.MailboxPreview
end
end
## Authentication routes
scope "/", ChesstrainerWeb do
pipe_through [:browser, :require_authenticated_user]
live_session :require_authenticated_user,
on_mount: [
{ChesstrainerWeb.UserAuth, :enforce_prelaunch},
{ChesstrainerWeb.UserAuth, :require_authenticated}
] do
live "/endgames", EndgameLive.PlayerIndex, :index
live "/train", EndgameLive.Train, :train
live "/users/profile", UserLive.Profile, :account
live "/users/profile/settings", UserLive.Profile, :settings
live "/users/profile/data", UserLive.Profile, :data
# Legacy settings URL; keep old links and emails working.
live "/users/settings", UserLive.Profile, :account
live "/users/settings/confirm-email/:token", UserLive.Profile, :confirm_email
end
post "/users/update-password", UserSessionController, :update_password
get "/users/profile/export/:format", UserDataController, :export
end
scope "/", ChesstrainerWeb do
pipe_through [:browser]
live_session :current_user,
on_mount: [
{ChesstrainerWeb.UserAuth, :enforce_prelaunch},
{ChesstrainerWeb.UserAuth, :mount_current_scope}
] do
live "/guest-train", EndgameLive.GuestTrain, :play
live "/endgames/:public_code/play", EndgameLive.Play, :play
live "/users/register", UserLive.Registration, :new
live "/users/log-in", UserLive.Login, :new
live "/admin/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
post "/users/log-in", UserSessionController, :create
delete "/users/log-out", UserSessionController, :delete
end
# Crawler files live outside the catch-all so they are real responses, not
# the branded 404 page.
scope "/", ChesstrainerWeb do
pipe_through :seo
get "/health", HealthController, :index
get "/robots.txt", RobotsController, :index
get "/sitemap.xml", SitemapController, :index
end
# Keep this last: routes match in definition order. It gives unmatched paths a
# branded 404 page with the site chrome instead of Phoenix's bare status page.
scope "/", ChesstrainerWeb do
pipe_through :browser
match :*, "/*path", PageController, :not_found
end
end