# openspec/changes/archive/2026-05-17-auth-oauth
dir: openspec/changes/archive/2026-05-17-auth-oauth

index: openspec/changes/archive/2026-05-17-auth-oauth/.pi-map.index.md

## role
Archive directory containing design documentation and implementation records for an OAuth2/OIDC authentication system with Authentik integration, internal JWTs, and database-backed refresh tokens.
## files
- .openspec.yaml | Defines an OpenSpec configuration file with schema type and creation date metadata
- README.md | Implements OAuth2/OIDC authentication using Authentik with internal JWTs and database-backed refresh tokens
- design.md | Design document specifying an Authentik OIDC-based authentication system with internal JWT access tokens, DB-backed opaque refresh tokens, and environment-aware cookie policies for a Python async SQLAlchemy backend. | dep: Authentik OIDC, Python async SQLAlchemy, Alembic, JWKS, JWT, pytest, ruff, mypy
- proposal.md | Proposes a secure OAuth2/OIDC authentication system using Authentik with internal JWT access tokens, server-side refresh token management, and environment-aware cookie policies. | dep: Authentik, JWKS, JWT, database, apps/api/src, config, models, auth services, API routes, frontend
- tasks.md | This is a completed task checklist documenting the implementation of an OIDC/JWT-based authentication system with refresh tokens for a backend application. | dep: Authentik OIDC, SQLAlchemy, Alembic, PostgreSQL/asyncpg, pytest, ruff, mypy, JWKS, JWT
## arch
Specification-driven architecture using OpenSpec schema definitions with phased implementation tracking (design → proposal → tasks → README), documenting an async Python/SQLAlchemy backend with external IdP (Authentik OIDC), internal JWT access tokens, opaque DB refresh tokens, and environment-aware cookie security policies.
## tags
jwt, tokens, oidc, authentication, authentik, refresh, internal, design
## symbols
-
## workflows
-
## dirty
-