# Backend Python / Flask

Añada el inicio de sesión a una aplicación Flask de Python con la biblioteca Authlib y el flujo Authorization Code con PKCE.

Esta guía añade el inicio de sesión OIDC a una aplicación Flask con [Authlib](https://docs.authlib.org/en/latest/client/flask.html), que se encarga del discovery, de PKCE y de la validación de tokens. Parte de un cliente **confidential** (un backend capaz de guardar un secreto).

Si aún no ha registrado una aplicación, consulte [Antes de empezar](https://dts-identity.com/es/docs/quickstarts.md#before-you-start). Para el protocolo que hay detrás, consulte [OpenID Connect (Authorization Code + PKCE)](https://dts-identity.com/es/docs/quickstarts/oidc-authorization-code.md).

## 1. Instalar las dependencias

```bash
pip install flask authlib requests
```

## 2. Configurar el cliente

```python
import os

from authlib.integrations.flask_client import OAuth
from flask import Flask, redirect, session, url_for

app = Flask(__name__)
app.secret_key = os.environ["SESSION_SECRET"]

oauth = OAuth(app)
oauth.register(
    "idp",
    client_id=os.environ["OIDC_CLIENT_ID"],
    client_secret=os.environ["OIDC_CLIENT_SECRET"],
    # Your instance's login domain (issuer). Authlib reads the discovery
    # document and configures all endpoints from it.
    server_metadata_url="https://<your-domain>/.well-known/openid-configuration",
    client_kwargs={
        "scope": "openid profile email offline_access",
        "code_challenge_method": "S256",  # send a PKCE challenge as well
    },
)
```

Mantenga `OIDC_CLIENT_ID` y `OIDC_CLIENT_SECRET` en el entorno, nunca en el control de versiones.

## 3. Iniciar el inicio de sesión

Authlib construye la URL de autorización con un challenge PKCE y un `state`, guarda ambos en la sesión y redirige el navegador:

```python
@app.route("/login")
def login():
    redirect_uri = url_for("callback", _external=True)  # e.g. https://app.example.com/callback
    return oauth.idp.authorize_redirect(redirect_uri)
```

La `redirect_uri` debe coincidir exactamente con un valor registrado en la aplicación.

## 4. Procesar el callback

Canjee el código por tokens. Authlib valida por usted la respuesta, el `state`, el verifier PKCE y el ID token.

```python
@app.route("/callback")
def callback():
    tokens = oauth.idp.authorize_access_token()

    claims = tokens["userinfo"]  # validated ID-token claims
    session["user"] = {"sub": claims["sub"], "name": claims.get("name"), "email": claims.get("email")}
    session["id_token"] = tokens["id_token"]

    # Optional: fetch additional claims from UserInfo
    # userinfo = oauth.idp.userinfo(token=tokens)

    return redirect("/")
```

## 5. Cerrar sesión

Envíe al usuario al endpoint de end session y borre después su propia sesión.

```python
from urllib.parse import urlencode

@app.route("/logout")
def logout():
    metadata = oauth.idp.load_server_metadata()
    params = urlencode({
        "id_token_hint": session.get("id_token", ""),
        "post_logout_redirect_uri": "https://app.example.com/",
    })
    session.clear()
    return redirect(f"{metadata['end_session_endpoint']}?{params}")
```

Registre `https://app.example.com/` como redirect URI de post-logout en la aplicación, igual que registra una redirect URI.

## Solución de problemas

- **La llamada de discovery falla.** Compruebe que `https://<your-domain>/.well-known/openid-configuration` es accesible desde su servidor y que el dominio es el host de inicio de sesión de su instancia.
- **`mismatching_state` en el callback.** La sesión que inició el acceso debe ser la misma que procesa el callback. Asegúrese de que las cookies de sesión sobreviven a la redirección (`SameSite` correcto y, en producción, cookies `secure` sobre HTTPS) y de que `secret_key` es idéntica en todos los workers; una clave aleatoria por worker rompe la sesión en cada redirección sin dar ningún aviso.
- **Nunca se devuelve un refresh token.** Incluya `offline_access` en el scope y confirme que la aplicación está configurada para recibir refresh tokens.

## Siguientes pasos

- [Aplicación de página única en React](https://dts-identity.com/es/docs/quickstarts/react-spa.md), para un cliente exclusivamente de navegador.
- [Proteger una API](https://dts-identity.com/es/docs/quickstarts/protect-an-api.md), para validar access tokens en su propia API de Python.
- [Aplicaciones](https://dts-identity.com/es/docs/integrations/applications.md), para revisar los tiempos de vida de los tokens y otros ajustes del cliente.
