# 2026-05-18-simplify-authentik-auth
dir: 2026-05-18-simplify-authentik-auth

index: 2026-05-18-simplify-authentik-auth/.pi-map.index.md

## role
Authentication system migration package for replacing JWT/OIDC token-based auth with session-based cookies using Authentik OAuth2.
## files
- .openspec.yaml | Defines an OpenSpec configuration file with schema type and creation date metadata
- design.md | Design document for migrating a backend authentication system from JWT tokens to session cookies with OAuth2/Authentik integration | dep: Authentik (OAuth2), Redis (optional), backend database, frontend
- proposal.md | Proposes simplifying an Authentik-based authentication system by replacing JWT/token-based auth with session-based cookies | dep: Authentik, OAuth2, session cookies, database user model, frontend auth state
- tasks.md | Project task list for migrating an application from JWT/OIDC authentication to session-based authentication using Authentik | dep: Authentik, Alembic, python-jose, ruff, mypy, pytest
## arch
Documentation-driven migration planning with specification files (OpenSpec), design documents, proposals, and task tracking—no implementation code, purely planning artifacts for a backend auth architecture change.
## tags
authentik, authentication, design, jwt, session, .openspec, migrating, system
## symbols
-
## workflows
-
## dirty
-
