Skip to content

6. Ámbitos de los datos

Una aplicación web atiende a muchos usuarios a la vez, y cada usuario realiza numerosas solicitudes. Por lo tanto, los datos pueden compartirse en varios niveles, conocidos como su ámbito:

  • ámbito de aplicación: los datos son compartidos por todos los usuarios durante toda la vida del servidor (por ejemplo, la lista de médicos);
  • ámbito de solicitud: los datos existen solo durante una única solicitud (el modelo de una vista, el usuario conectado tal como se identificó para esa solicitud);
  • ámbito de cliente: los datos son específicos de un usuario y deben persistir de una solicitud a la siguiente (el idioma seleccionado, el usuario conectado).

Las aplicaciones web han usado durante mucho tiempo una sesión mantenida por el servidor para este último ámbito: una memoria propia de cada navegador, identificada mediante una cookie de identificación ([JSESSIONID] en [Java], [PHPSESSID] en [PHP]). La sesión de [Flask] es diferente: como vimos en el ejemplo 20, se almacena en una cookie firmada del lado del cliente. El servidor no almacena nada entre dos solicitudes de un mismo usuario: se dice que no tiene estado (stateless). Esto es lo que permite, por ejemplo, ejecutar varios servidores idénticos detrás de un balanceador de carga: cualquiera de ellos puede atender cualquier solicitud. La contrapartida es que una cookie está bajo el control del usuario; este puede leerla e intentar modificarla. Por eso solo se almacenan en ella datos no sensibles y, si los datos deben ser de confianza, el servidor los firma y así detecta cualquier modificación: es el caso de la sesión de [Flask] y del token de autenticación (véase el capítulo sobre la autenticación).

En [Flask], cada ámbito tiene su propio contenedor:

Ámbito
Soporte
Duración
aplicación
Un objeto creado al iniciar, almacenado en [app.extensions] y recuperado mediante [current_app] (ejemplo 06)
Toda la vida del servidor, compartido por todas las solicitudes
Solicitud
El objeto [g] y el propio objeto [request] (ejemplo 16)
procesamiento de una solicitud
sesión
el objeto [session], un diccionario almacenado en una cookie firmada
hasta que se cierra el navegador (de forma predeterminada)
cliente
una cookie estándar definida con [set_cookie] (ejemplo 22)
la duración establecida con [max_age]

Los objetos [current_app], [g], [request] y [session] se importan del paquete [flask]. Son proxies (ejemplo 05): durante una solicitud, cada uno identifica el objeto de esa solicitud (o de la aplicación que la procesa).

6.1. Ejemplo 23: ámbitos

1
2
3
4
5
6
7
8
9
23-scopes/
├── app.py
├── controllers/
│   └── scopes.py
├── services/
│   └── counter.py
└── templates/
    └── scopes/
        └── scopes.html

6.1.1. Los objetos: services/counter.py

# services/counter.py: un contador compartido, y la información de una solicitud
from itertools import count
from threading import Lock


# ámbito APPLICATION: una sola instancia (vea app.py)
class CounterService:

    def __init__(self):
        self._total = 0
        # varias solicitudes pueden ejecutarse AL MISMO TIEMPO: el candado garantiza
        # que dos incrementos simultáneos no se pierdan
        self._lock = Lock()

    def increment(self) -> int:
        with self._lock:
            self._total += 1
            return self._total


# ámbito REQUEST: una instancia por solicitud (vea app.py, función start)
class RequestInfo:

    # un contador compartido por todas las instancias (atributo de CLASE);
    # next(...) es atómico: dos hilos nunca obtienen el mismo número
    _instances = count(1)

    def __init__(self, start: str):
        self.number = next(RequestInfo._instances)
        self.start = start
  • líneas 7–18: un contador de visitas, con ámbito de aplicación: un único objeto, compartido por todas las solicitudes. Al igual que con la lista de tareas del ejemplo 20, un cerrojo protege el incremento: la instrucción [self._total += 1] no es atómica (lee el valor, lo incrementa y luego lo escribe), y dos hilos que la ejecuten simultáneamente podrían leer el mismo valor, con la consecuencia de que se pierda una visita;
  • líneas 22–30: información con ámbito de solicitud: un objeto por solicitud, que contiene un número y la hora de la solicitud. El número proviene de un contador compartido por todas las instancias: [count(1)], del módulo estándar [itertools], es un iterador que produce 1, 2, 3... cada vez que se llama a [next]. Es un atributo de clase (declarado en el nivel de la clase, no en el constructor): es compartido por todas las instancias.

6.1.2. La configuración: app.py

# app.py: la aplicación del ejemplo 23
from datetime import datetime
from pathlib import Path

from flask import Blueprint, Flask, g

from controllers.scopes import scopes
from services.counter import CounterService, RequestInfo

BOOTSTRAP = Path(__file__).resolve().parent.parent / "common" / "bootstrap"


def create_app():
    app = Flask(__name__)
    app.jinja_env.trim_blocks = True
    app.jinja_env.lstrip_blocks = True
    # la clave que firma la cookie de sesión (ámbito SESSION)
    app.config["SECRET_KEY"] = "a-secret-key-for-example-23"
    # ámbito APPLICATION: un solo objeto, creado al iniciar, compartido por TODAS
    # las solicitudes de TODOS los usuarios
    app.extensions["counter"] = CounterService()
    app.register_blueprint(Blueprint("bootstrap", __name__, static_folder=BOOTSTRAP,
                                     static_url_path="/bootstrap"))
    app.register_blueprint(scopes)

    # ámbito REQUEST: el objeto g nace y muere con cada solicitud. Esta
    # función, ejecutada ANTES de la acción, guarda en él un objeto que la acción y la
    # vista volverán a encontrar durante ESTA solicitud
    @app.before_request
    def start():
        g.info = RequestInfo(datetime.now().strftime("%H:%M:%S.%f")[:-3])

    return app


if __name__ == "__main__":
    create_app().run(port=5000, debug=True)
  • línea 18: la clave que firma la cookie de sesión;
  • línea 21: el objeto con ámbito de aplicación;
  • líneas 29–31: antes de cada solicitud, se almacena un objeto [RequestInfo] en [g]. La acción y la vista lo recuperarán, pero solo durante esta solicitud. [strftime("%H:%M:%S.%f")] da formato a la hora con sus microsegundos ([%f], seis dígitos); [[:-3]] elimina los últimos tres caracteres de la cadena, dejando los milisegundos.

6.1.3. El controlador: controllers/scopes.py

# controllers/scopes.py: los cuatro ámbitos de datos
from flask import Blueprint, current_app, g, make_response, render_template, request, session

scopes = Blueprint("scopes", __name__)


@scopes.get("/")
def display():
    # APPLICATION: el contador compartido
    total = current_app.extensions["counter"].increment()
    # SESSION: un diccionario propio de ESTE navegador, que Flask guarda en una
    # cookie FIRMADA (session); dura hasta que se cierra el navegador
    session["visits"] = session.get("visits", 0) + 1
    # CLIENT: un dato conservado por el NAVEGADOR en una cookie ordinaria,
    # reenviada al servidor con cada solicitud
    my_visits = to_integer(request.cookies.get("myVisits")) + 1
    response = make_response(render_template(
        "scopes/scopes.html", total=total, instance=g.info.number,
        session_visits=session["visits"], my_visits=my_visits))
    response.set_cookie("myVisits", str(my_visits), httponly=True, samesite="Lax")
    return response


# "41" -> 41; None o "abc" -> 0
def to_integer(text: str | None) -> int:
    try:
        return int(text)
    except (TypeError, ValueError):
        return 0
  • línea 10: el ámbito de aplicación. [current_app] designa la aplicación que procesa la solicitud actual;
  • línea 13: el ámbito de sesión. [session] se usa como un diccionario: [session.get("visits", 0)] devuelve el valor de la clave, o 0 si está ausente. Cuando la acción modifica la sesión, [Flask] envía, junto con la respuesta, una nueva cookie, [session], que contiene el diccionario firmado;
  • línea 16: el ámbito de cliente, con una cookie común, [myVisits], leída de [request.cookies]. Su valor es una cadena proporcionada por el navegador y, por lo tanto, puede faltar o no ser válida; la función [to_integer] devuelve 0 en ambos casos;
  • líneas 17–20: para definir una cookie se necesita el objeto de respuesta: [make_response] lo construye a partir de la página generada por la vista (ejemplo 05) y luego [set_cookie] le agrega el encabezado [Set-Cookie]. Sin [max_age], la cookie dura hasta que se cierra el navegador (es una cookie “de sesión”, según la definición de los navegadores);
  • línea 18: el ámbito de solicitud: el objeto almacenado en [g] por la función [start].

6.1.4. La vista: templates/scopes/scopes.html

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Scopes</title>
  <link rel="stylesheet" href="{{ url_for('bootstrap.static', filename='css/bootstrap.min.css') }}">
</head>
<body>
  <div class="container py-3">
    <h1 class="h3">The scopes of data</h1>
    {# g y session son accesibles en las vistas, durante la MISMA solicitud #}
    <ul>
      <li>application: {{ total }} visit(s) to the site, all browsers combined</li>
      <li>request: object no. {{ instance }} (no. {{ g.info.number }} in the view),
        request received at {{ g.info.start }}</li>
      <li>session: {{ session_visits }} visit(s) from this browser ({{ session["visits"] }} in the view)</li>
      <li>client: {{ my_visits }} visit(s) from this browser</li>
    </ul>
  </div>
</body>
</html>

Los objetos [g] y [session] también son accesibles en las vistas. La vista muestra los valores recibidos de la acción y, entre paréntesis, los mismos valores leídos directamente de [g] y [session]: durante una misma solicitud, la acción y la vista ven los mismos objetos.

6.1.5. Ejecución

Después de dos visitas en un navegador:

Image

Sigamos las solicitudes con [curl], que actúa como un primer navegador y guarda sus cookies en el archivo [a.txt]:

curl -i -c a.txt -b a.txt http://localhost:5000/
HTTP/1.1 200 OK
Content-Type: text/html; charset=utf-8
Content-Length: 581
Set-Cookie: myVisits=1; HttpOnly; Path=/; SameSite=Lax
Set-Cookie: session=eyJ2aXNpdHMiOjF9.arfKwA.YK-2GACLdbCJ_NXM5dYJYlqEF-4; HttpOnly; Path=/
...
      <li>application: 1 visit(s) to the site, all browsers combined</li>
      <li>request: object no. 2 (no. 2 in the view),
        request received at 15:38:08.779</li>
      <li>session: 1 visit(s) from this browser (1 in the view)</li>
      <li>client: 1 visit(s) from this browser</li>
...

La respuesta define dos cookies. La primera, [myVisits], contiene el valor en texto plano. La segunda, [session], contiene el diccionario de sesión: la parte anterior al primer punto es el JSON [{"visits":1}], codificado en Base64 (sin comprimir, como en el ejemplo 20, porque es corto); seguido de la fecha y la firma.

El objeto con ámbito de solicitud tiene el número 2, aunque esta es la primera visita a la página: esto se debe a que la función [start] se ejecuta antes de cada solicitud que recibe la aplicación, incluidas las solicitudes para las que no existe ninguna acción (en este caso, una solicitud a una URL inexistente, hecha justo antes) y las solicitudes de archivos estáticos. En el navegador, cada página desencadena así una segunda solicitud para la hoja de estilos de [Bootstrap]: de ahí los números impares de la captura de pantalla. Una segunda visita, con las mismas cookies:

curl -i -c a.txt -b a.txt http://localhost:5000/
1
2
3
4
5
6
7
8
Set-Cookie: myVisits=2; HttpOnly; Path=/; SameSite=Lax
Set-Cookie: session=eyJ2aXNpdHMiOjJ9.arfKwA.l68wWEMYpKTfN3xPp_lysXPExO8; HttpOnly; Path=/
...
      <li>application: 2 visit(s) to the site, all browsers combined</li>
      <li>request: object no. 3 (no. 3 in the view),
        request received at 15:38:08.799</li>
      <li>session: 2 visit(s) from this browser (2 in the view)</li>
      <li>client: 2 visit(s) from this browser</li>

Un segundo “navegador”, con su propio archivo de cookies, inicialmente vacío:

curl -c b.txt -b b.txt http://localhost:5000/
1
2
3
4
5
      <li>application: 3 visit(s) to the site, all browsers combined</li>
      <li>request: object no. 4 (no. 4 in the view),
        request received at 15:38:08.813</li>
      <li>session: 1 visit(s) from this browser (1 in the view)</li>
      <li>client: 1 visit(s) from this browser</li>

El contador de la aplicación ha seguido avanzando; la sesión y la cookie del segundo navegador vuelven a empezar en 1. Por último, un usuario malicioso falsifica sus propias cookies: 1000 visitas en [myVisits], y una sesión que pretende contener [{"visits":999}] (codificado en Base64 como [eyJ2aXNpdHMiOjk5OX0]), con la firma de otra sesión:

curl -b "myVisits=1000;session=eyJ2aXNpdHMiOjk5OX0.arfKwA.YK-2GACLdbCJ_NXM5dYJYlqEF-4" http://localhost:5000/
1
2
3
4
      <li>application: 4 visit(s) to the site, all browsers combined</li>
      ...
      <li>session: 1 visit(s) from this browser (1 in the view)</li>
      <li>client: 1001 visit(s) from this browser</li>

La cookie común se aceptó tal cual: 1001 visitas. En cambio, la sesión falsificada fue rechazada: su firma no coincide con su contenido y [Flask] la ignoró, como si estuviera ausente. Esa es la diferencia clave entre una cookie común y una cookie firmada. Recordemos la regla: los datos que provienen del cliente solo son confiables si el servidor los firma; e incluso firmados, siguen siendo legibles: no se coloca nada secreto en ellos.