feat(keycloak): realm-export.json durch API-Provisioning bei Backendstart ersetzen #167

New issue

Closed

opened 2026-07-02 13:43:59 +00:00 by niboer · 0 comments

niboer commented

2026-07-02 13:43:59 +00:00

Owner

Beschreibung

Ersetze die statische keycloak/realm-export.json durch ein API-basiertes Provisioning beim Backend-Start.

Aenderungen

keycloak-provision.ts wird in zwei Teile getrennt:
- ensureRealm() — Realm, Clients, Composite-Rollen via Keycloak Admin REST API anlegen/aktualisieren (ersetzt --import-realm + realm-export.json)
- seedDevUsers() — 5 Seed-User anlegen, Rollen zuweisen, keycloakId verknuepfen, NUR bei erstem Start + DEV-Umgebung
APP_ENV einfuehren (development/production/test) zur Environment-Erkennung
Docker-Compose anpassen: --import-realm entfernen, realm-export.json-Volume entfernen

Detailplan

Siehe Conversation in Issue.

Akzeptanzkriterien

Realm, Clients und Composite-Rollen werden beim Backend-Start via API angelegt (nicht mehr via JSON-Import)
APP_ENV=development erkennt die Dev-Umgebung
Seed-User werden NUR in DEV bei erstem Start angelegt
Docker-Compose enthaelt kein --import-realm mehr
realm-export.json ist geloescht
Tests sind aktualisiert
Doku ist auf dem neuesten Stand

Betroffene Komponenten

backend: keycloak-provision.ts, index.ts
keycloak: realm-export.json loeschen
infra: docker-compose.yml
docs: 05-authentifizierung.md, 01-backend-architektur.md, AGENTS.md

## Beschreibung Ersetze die statische `keycloak/realm-export.json` durch ein API-basiertes Provisioning beim Backend-Start. ### Aenderungen 1. **keycloak-provision.ts wird in zwei Teile getrennt:** - `ensureRealm()` — Realm, Clients, Composite-Rollen via Keycloak Admin REST API anlegen/aktualisieren (ersetzt `--import-realm` + realm-export.json) - `seedDevUsers()` — 5 Seed-User anlegen, Rollen zuweisen, keycloakId verknuepfen, NUR bei erstem Start + DEV-Umgebung 2. **`APP_ENV` einfuehren** (development/production/test) zur Environment-Erkennung 3. **Docker-Compose anpassen:** `--import-realm` entfernen, `realm-export.json`-Volume entfernen ### Detailplan Siehe Conversation in Issue. ## Akzeptanzkriterien - [ ] Realm, Clients und Composite-Rollen werden beim Backend-Start via API angelegt (nicht mehr via JSON-Import) - [ ] `APP_ENV=development` erkennt die Dev-Umgebung - [ ] Seed-User werden NUR in DEV bei erstem Start angelegt - [ ] Docker-Compose enthaelt kein `--import-realm` mehr - [ ] `realm-export.json` ist geloescht - [ ] Tests sind aktualisiert - [ ] Doku ist auf dem neuesten Stand ## Betroffene Komponenten - backend: keycloak-provision.ts, index.ts - keycloak: realm-export.json loeschen - infra: docker-compose.yml - docs: 05-authentifizierung.md, 01-backend-architektur.md, AGENTS.md

niboer added this to the MS-BE-KC: Backend Keycloak-Integration milestone

2026-07-02 13:43:59 +00:00

niboer added the

component/keycloak

type/feature

component/backend

labels

2026-07-02 13:43:59 +00:00

niboer self-assigned this

2026-07-02 13:43:59 +00:00

niboer closed this issue

2026-07-02 13:52:49 +00:00