📝 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:
parent
1a41a456d4
commit
4e007feec8
23 changed files with 946 additions and 125 deletions
|
|
@ -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
|
||||
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue