📝 Doc cron, mail queue, CSRF and flash messages

Add the scheduled tasks guide, environment variable overrides, the
[mail] and [cron] references, CSRF protection without tokens, flash
messages after redirects and the username policies of pagetop-user.
Update the framework comparison with Poem and Topcoat.
This commit is contained in:
Manuel Cillero 2026-11-02 14:46:28 +01:00
parent 1a41a456d4
commit 4e007feec8
23 changed files with 946 additions and 125 deletions

View file

@ -109,7 +109,6 @@ struct ContactData {
async fn show(request: HttpRequest) -> Result<Markup, ErrorPage> {
Page::new(request)
.with_title(Lc::n("Contact"))
.with_child(Messages::new())
.with_child(contact_form())
.render()
.await
@ -121,20 +120,30 @@ async fn send(
) -> Result<Response, ErrorPage> {
if data.message.trim().is_empty() {
// Shows the form again with a message.
let mut page = Page::new(request)
.with_child(Messages::new())
.with_child(contact_form());
let mut page = Page::new(request).with_child(contact_form());
page.context()
.push_message(MessageLevel::Error, Lc::n("Please write a message."));
return page.render().await.map(IntoResponse::into_response);
}
// ... save or send `data` ...
Ok(Redirect::see_other("/contact/thanks"))
let cx = Context::new(request);
Ok(Redirect::see_other(cx.route("/contact")).with_message(
&cx,
MessageLevel::Info,
Lc::n("Thank you, we will reply soon."),
))
}
```
Si el mensaje está en blanco, la página se repite con un aviso. No hace falta añadir el componente
`Messages`: la región de contenido ya empieza por uno que muestra los avisos acumulados con
`push_message()`.
Tras guardar, redirige con `see_other()` (patrón *Post/Redirect/Get*): así, si el usuario recarga
la página, no reenvía el formulario.
la página, no reenvía el formulario. Para avisar del resultado en la página a la que rediriges,
añade el mensaje a la respuesta con `with_message()`: viaja en una *cookie* de vida corta, ya
traducido, y la página siguiente lo muestra como si se hubiera añadido con `push_message()`. Si esa
página vuelve a redirigir, el mensaje espera a la siguiente.
## 4. Campos con varios valores
@ -172,13 +181,38 @@ fn read_date(cx: &Context, text: &str) {
}
```
## 6. Sin *tokens* contra CSRF
Los formularios no necesitan ningún campo oculto contra CSRF (*Cross-Site Request Forgery*), el
ataque en el que otra web hace que el navegador de tus usuarios envíe peticiones a tu aplicación
con su sesión abierta. PageTop rechaza con `403` cualquier petición que pueda cambiar algo (todos
los métodos salvo `GET`, `HEAD` y `OPTIONS`) si el navegador indica, con las cabeceras
`Sec-Fetch-Site` y `Origin`, que llega desde otro origen, también desde otro subdominio del mismo
sitio. Vale igual para formularios, HTMX y `fetch`, y no afecta a `curl`, a otros servidores ni a
las pruebas, que no envían esas cabeceras.
A cambio, dos reglas:
- **Un `GET` nunca cambia nada.** Borrar, cerrar sesión o confirmar van siempre con `POST` (o
`PUT`, `PATCH`, `DELETE`), aunque el formulario sea sólo un botón.
- **Otra aplicación tuya, servida desde otro origen,** que envíe formularios o peticiones a ésta
debe figurar en `trusted_origins`:
```toml
[server]
trusted_origins = ["https://shop.example.com"]
```
Ninguna protección contra CSRF resiste un fallo de XSS en la propia aplicación: por eso `html!`
escapa siempre el texto que insertas.
## Comprueba
1. Envía el formulario vacío: el navegador lo impide, porque `name` es obligatorio.
2. Envía un mensaje en blanco (sólo espacios): el servidor lo rechaza y el formulario vuelve con el
aviso.
3. Envía uno correcto y recarga la página de destino: el navegador no ofrece reenviar el
formulario.
3. Envía uno correcto: vuelves al formulario con el aviso de agradecimiento. Recarga la página: el
aviso ya no aparece y el navegador no ofrece reenviar el formulario.
## Siguiente