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, 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. Para el protocolo que hay detrás, consulte OpenID Connect (Authorization Code + PKCE).
1. Instalar las dependencias
pip install flask authlib requests2. Configurar el cliente
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:
@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.
@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.
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-configurationes accesible desde su servidor y que el dominio es el host de inicio de sesión de su instancia. mismatching_stateen 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 (SameSitecorrecto y, en producción, cookiessecuresobre HTTPS) y de quesecret_keyes 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_accessen el scope y confirme que la aplicación está configurada para recibir refresh tokens.
Siguientes pasos
- Aplicación de página única en React, para un cliente exclusivamente de navegador.
- Proteger una API, para validar access tokens en su propia API de Python.
- Aplicaciones, para revisar los tiempos de vida de los tokens y otros ajustes del cliente.
Backend Node / Express
Añada el inicio de sesión a una aplicación Express de Node.js con la biblioteca openid-client y el flujo Authorization Code con PKCE.
Aplicación de página única en React
Añada el inicio de sesión a una aplicación React de navegador como cliente public, con react-oidc-context y el flujo Authorization Code con PKCE.