Flask Session API

Session se utiliza para guardar datos entre diferentes solicitudes del mismo usuario. Flask usa por defecto cookies firmadas; los datos se almacenan en el cliente pero no pueden ser manipulados.

Mediantefrom flask import sessionimportar, y usarlo como un diccionario.


objeto proxy de session

sessionEs un proxy que apunta a la instancia SessionMixin de la solicitud actual. Solo está disponible en el contexto de la solicitud.

Atributos/Métodos Descripción
session[key] = value Establece un valor de session
session.get(key, default) Obtiene de forma segura un valor de session; si la clave no existe, devuelve default
session.pop(key, default) Elimina y devuelve el valor de la clave especificada
session.clear() Vacía todos los datos de session
"key" in session Comprueba si la clave existe
session.permanent Cuando se establece en True, la Session se mantiene después de cerrar el navegador (usa PERMANENT_SESSION_LIFETIME)
session.modified Al modificar valores mutables en session (como append en listas), debe establecerse manualmente en True
session.accessed Es True cuando se accede a session; Flask añade automáticamente la cabecera Vary: Cookie
session.new Indica si session es de nueva creación (algunas implementaciones no admiten una determinación precisa)

Al modificar objetos mutables anidados en session (como listas, diccionarios), Flask no puede detectar automáticamente el cambio.

Debe establecerse manualmentesession.modified = True; de lo contrario, los cambios no se guardarán en la Cookie.


Elementos de configuración

Clave de configuración Valor predeterminado Descripción
SECRET_KEY None Clave para firmar Session; debe configurarse para poder usar Session
SESSION_COOKIE_NAME "session" Nombre de la Cookie de Session
SESSION_COOKIE_DOMAIN None Atributo Domain de la Cookie
SESSION_COOKIE_PATH None Atributo Path de la Cookie
SESSION_COOKIE_HTTPONLY True Prohíbe el acceso de JavaScript a la Cookie de Session
SESSION_COOKIE_SECURE False Cuando es True, la Cookie solo se envía mediante HTTPS
SESSION_COOKIE_SAMESITE None "Strict", "Lax" o None
PERMANENT_SESSION_LIFETIME timedelta(days=31) Período de validez de la Session permanente
SESSION_REFRESH_EACH_REQUEST True Actualizar la validez de la Cookie de Session en cada solicitud

Ejemplo de código

Ejemplo

from flask import Flask, session, redirect, url_for

app = Flask(__name__)
app.secret_key = "your-secret-key"

@app.route("/")
def index():
    if "username" in session:
        return f'Logged in as {session["username"]}'
    return 'You are not logged in'

@app.route("/login", methods=["GET", "POST"])
def login():
    if request.method == "POST":
        session["username"] = request.form["username"]
        # Configurar session permanente (se mantiene 31 días después de cerrar el navegador)
        session.permanent = True
        return redirect(url_for("index"))
    return '<form method="post"><input name="username"></form>'

@app.route("/appends")
def append_to_list():
    # Nota: modificar listas anidadas requiere marcar manualmente modified
    if "items" not in session:
        session["items"] = []
    session["items"].append("new_item")
    session.modified = True  # ¡Debe marcarse manualmente!
    return f'Items: {session["items"]}'

@app.route("/logout")
def logout():
    session.clear()
    return redirect(url_for("index"))
Otras extensiones