# CLAUDE.md

Obsidian: Projects/sso

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

## Project Overview

This is the planning workspace for integrating Keycloak SSO with Arch Linux web services. The goal is to bring aurweb, archweb, and the wiki under the existing Keycloak SSO infrastructure.

## Target Services

- **aurweb** (AUR web): FastAPI-based, needs SSO auth support. Tracking issue: https://gitlab.archlinux.org/archlinux/aurweb/-/issues/54
- **archweb** (archlinux.org/devel): Django-based. Related issue: https://github.com/archlinux/archweb/issues/152
- **Wiki**: MediaWiki-based, SSO integration also desired

## Key Challenges

- No built-in Keycloak integration exists for any of these services
- User migration flows needed for existing userbases in each service
- Account support responsibilities shift from package maintainers to DevOps
