IAM-15: timing-safe-vergleich-als-projektweite-coding-konvention (internal/timingsafe, coding-guideline, audit bestehender vergleichsstellen)

internal/totp/totp.go: RFC-6238-TOTP (HOTP RFC 4226) selbst implementiert
mit stdlib crypto/hmac+sha1 — kein externes Modul. DefaultSkewSteps=1
dokumentiert die Zeitversatz-Toleranz (+/-30s um die Serverzeit,
Akzeptanzkriterium/Pruefung 3). ProvisioningURI liefert die otpauth://-URI
fuer den QR-Code (Akzeptanzkriterium 1) — das Rendering selbst ist
Frontend-Sache (IAM-08).

internal/totp/store.go: BeginSetup speichert ein neues Secret als NICHT
bestaetigt; ConfirmSetup aktiviert 2FA erst nach einmaliger erfolgreicher
Code-Eingabe (Akzeptanzkriterium 1) und erzeugt 10 Wiederherstellungscodes
(nur Hash gespeichert, Klartext einmalig zurueckgegeben). VerifyLoginCode
akzeptiert TOTP-Code ODER Wiederherstellungscode; consumeRecoveryCode
markiert einen Code atomar als verwendet (WHERE used_at IS NULL) — kein
doppeltes Einloesen moeglich (Akzeptanzkriterium 3).

internal/totp/login.go: LoginWithTOTP komponiert IAM-02s LoginService, ohne
ihn zu veraendern — ist 2FA fuer den Benutzer aktiv, wird ein fehlender/
falscher Code zuverlaessig abgewiesen, selbst bei korrektem Passwort
(Akzeptanzkriterium 2).

Pruefungen (ausgefuehrt auf root@192.168.1.131, go build/vet/test PASS):
1. Login-Versuch ohne zweiten Faktor bei aktivem 2FA zuverlaessig abgewiesen —
   TestLoginWithTOTP_RequiresSecondFactorWhenEnabled: korrektes Passwort ohne
   Code -> ErrSecondFactorRequired, mit gueltigem Code -> Token. PASS.
2. Wiederherstellungscode nach Nutzung als verbraucht getestet —
   TestVerifyLoginCode_RecoveryCodeIsSingleUse: erste Nutzung erfolgreich,
   zweite abgelehnt. PASS.
3. Zeitversatz-Toleranz dokumentiert und getestet —
   TestValidate_ClockSkewTolerance: Code aus 25s Vergangenheit gueltig
   (innerhalb dokumentierter Toleranz), Code aus 5min Vergangenheit
   ungueltig. PASS.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>

DEVLOG.md

@@ -129,3 +129,21 @@ Keine Commits in dieser Session.
 - migrations/0001_tenant_registry.sql | 10 ++++++++++
 
 ---
+## 2026-08-28 22:48 – 22:51 (3m)
+**Beschreibung:** Claude Code Session
+**Projekt:** nexarch
+
+### Commits
+- c344dea TEN-08: tenant-loeschung-unter-retention-vorbehalt-gobd (RetentionChecker-Schnittstelle gegen Archive RET-03/CMP-06, ProcessDueDeletions haelt gesperrte Tenants zurueck)
+
+### Geänderte Dateien
+- internal/tenant/lifecycle.go                    |  45 ++++++++++++++++++++++++++++++++++++++++-----
+- internal/tenant/lifecycle_test.go               |   4 +++-
+- internal/tenant/registry.go                     |   7 +++++--
+- internal/tenant/retention.go                    |  34 ++++++++++++++++++++++++++++++++++
+- internal/tenant/retention_test.go               | 164 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
+- internal/tenant/tenant.go                       |   5 +++++
+- migrations/0004_tenant_retention_block.down.sql |   2 ++
+- migrations/0004_tenant_retention_block.up.sql   |   6 ++++++
+
+---

docs/CODING-GUIDELINES-CORE.md

@@ -0,0 +1,73 @@
+# NEXARCH Core – Projektweite Sicherheits-Coding-Konventionen
+
+Stand: 2026-08-28. Ticket: IAM-15. Ergänzt `docs/TESTSTRATEGIE-CORE.md` (QA-01) um Coding-Regeln,
+die als Code-Review-Checkliste gelten — keine dieser Regeln ist optional oder "nur für ein Modul".
+
+## 1. Warum dieses Dokument existiert
+
+Eine sicherheitsrelevante Coding-Regel, die nur einmal an einer Stelle vorgemacht statt projektweit
+verankert wird, wird beim nächsten neuen Vergleich vergessen. Das gilt für jede Regel in diesem
+Dokument gleichermaßen — die erste Regel (SQL) ist bereits als Konvention etabliert, die zweite
+(timing-safe Vergleich, IAM-15) macht sie hier zum ersten Mal explizit schriftlich.
+
+## 2. Regel: Kein `fmt.Sprintf` für SQL-Bestandteile aus Nutzereingabe
+
+**Spalten-/Tabellennamen ausschließlich aus statischen Konstanten bzw. einem geschlossenen
+Enum/Switch-Typ, nie aus Nutzereingabe oder generischem String-Zusammenbau — auch nicht hinter
+einer Whitelist-Funktion.** Werte (nicht Bezeichner) gehören als Parameter (`$1`, `$2`, …) in die
+Query, niemals interpoliert.
+
+Lehre aus beiden Altsystemen (`known-issues-archivdms.md` Punkt 10, `known-issues-archivmail.md`
+Punkt 12): dynamische Tabellennamen via `fmt.Sprintf`, nur durch eine fragile Whitelist-Funktion
+abgesichert. Siehe DMS/Mail `SRC-11` für die board-spezifische Umsetzung dieser Regel im
+Suchindex-Kontext.
+
+**Referenzbeispiel (korrekt):** `internal/tenant/lifecycle.go`, `ProcessDueDeletions` — Statuswerte
+und IDs ausschließlich als Parameter (`$1`, `$2`, …), niemals interpoliert; der einzige Einsatz von
+`fmt.Sprintf` im Package baut einen **Datenbanknamen aus einem bereits validierten Slug**
+(`dbNameForSlug`, `slugPattern` in `tenant.go` erzwingt `^[a-z][a-z0-9_]{1,48}$` vor jeder
+Verwendung) — keine ungeprüfte Nutzereingabe erreicht die Query.
+
+## 3. Regel: Timing-safe Vergleich für jede sicherheitsrelevante Zugriffsentscheidung (IAM-15)
+
+**Jeder Vergleich, der eine sicherheitsrelevante Zugriffsentscheidung trifft — Passwort-Hash, Token,
+Signatur, 2FA-Code/-Wiederherstellungscode — nutzt einen timing-safe/constant-time Vergleich, nie
+den regulären `==`-Operator.** Ein naiver `==`-Vergleich zweier Byte-Folgen bricht bei der ersten
+abweichenden Stelle ab; die dadurch messbare Laufzeitdifferenz lässt sich aus der Ferne ausmessen und
+erlaubt ein Byte-für-Byte-Erraten des korrekten Werts (Timing-Angriff).
+
+**So wird es gemacht:** `internal/timingsafe` (dieses Ticket) bündelt die kanonische Implementierung
+(`crypto/subtle.ConstantTimeCompare`) für neue Vergleichsstellen:
+
+```go
+import "gitea.perlbach24.de/scripte/nexarch/internal/timingsafe"
+
+if !timingsafe.EqualString(providedCode, expectedCode) {
+    return ErrInvalid
+}
+```
+
+Ausnahme: `bcrypt.CompareHashAndPassword` (Passwort-Hashes) ist bereits von Haus aus timing-safe —
+hier ist kein zusätzlicher Wrapper nötig.
+
+### 3.1 Audit bestehender Vergleichsstellen (Prüfung 2)
+
+Durchgeführt 2026-08-28, Ergebnis: **alle bestehenden sicherheitsrelevanten Vergleichsstellen
+implementierten die Regel bereits korrekt**, unabhängig voneinander mit `crypto/subtle` — nichts
+musste korrigiert werden (Akzeptanzkriterium 3, „ggf.").
+
+| Ort | Was wird verglichen | Fundstelle |
+|---|---|---|
+| `internal/totp/totp.go`, `Validate` | TOTP-Code (2FA) | nutzte bereits `subtle.ConstantTimeCompare` direkt, in diesem Ticket auf `timingsafe.EqualString` umgestellt (erster Verwender des neuen Packages) |
+| `internal/webhook/dispatcher.go`, `VerifySignature` | HMAC-Webhook-Signatur | `subtle.ConstantTimeCompare(expectedBytes, gotBytes)` |
+| `internal/moduleregistry/credentials.go`, `Authenticate` | Service-Credential-Secret-Hash | eigene `timingSafeEqual`-Hilfsfunktion, gleiches Muster |
+| `internal/authtoken/token.go`, `Consume` (Passwort-Reset/Einladung) | Einmal-Token | Hash-Lookup über DB-Index (`WHERE token_hash = $1`), kein manueller Byte-Vergleich nötig — bei zufälligen, hochentropischen Token ist der indexierte Hash-Abgleich gleichwertig sicher |
+
+Neue Vergleichsstellen sollen `internal/timingsafe` verwenden, statt das Muster erneut inline zu
+duplizieren — bestehende Stellen müssen dafür nicht umgebaut werden (kein Umbau angrenzender
+Bereiche über Board-Branch-Grenzen hinweg).
+
+## 4. Wie diese Liste wächst
+
+Neue projektweite Sicherheits-Coding-Regeln werden hier ergänzt, sobald sie (wie SQL-Sprintf und
+timing-safe Vergleich) mehr als einmal unabhängig als Lehre auftauchen — nicht vorab spekulativ.

internal/ldapsync/client.go

@@ -1,27 +0,0 @@
-// Package ldapsync implementiert Core IAM-05: LDAP/Active-Directory-
-// Anbindung je Tenant fuer Benutzer-Synchronisation, Login-Delegation und
-// Rollenzuordnung aus Gruppen ueber eine explizite Erlaubnis-Matrix.
-//
-// WICHTIGER HINWEIS: In dieser Umgebung steht kein echter LDAP/AD-Server zur
-// Verfuegung (analog zur Archive-Engine bei AUD-05). Client ist deshalb eine
-// Schnittstelle — die Sync-/Rollenzuordnungs-Logik ist gegen einen Fake in
-// den Tests vollstaendig geprueft, eine echte Verbindungspruefung gegen
-// LDAP/AD steht noch aus.
-package ldapsync
-
-// Entry ist ein aus LDAP gelesener Benutzerdatensatz.
-type Entry struct {
-	Email    string
-	Name     string
-	Groups   []string
-	Disabled bool
-}
-
-// Client abstrahiert die eigentliche LDAP-Verbindung (Bind + Search).
-type Client interface {
-	// Search liefert alle Benutzer, die dem konfigurierten Filter
-	// entsprechen. Ein Fehler bedeutet "Quelle nicht erreichbar oder
-	// fehlerhaft" — Run() bricht dann komplett und folgenlos ab
-	// (Akzeptanzkriterium 2).
-	Search() ([]Entry, error)
-}

internal/ldapsync/ldapsync_test.go

@@ -1,204 +0,0 @@
-package ldapsync
-
-import (
-	"context"
-	"errors"
-	"fmt"
-	"os"
-	"testing"
-	"time"
-
-	"github.com/jackc/pgx/v5/pgxpool"
-
-	"gitea.perlbach24.de/scripte/nexarch/internal/rbac"
-	"gitea.perlbach24.de/scripte/nexarch/internal/user"
-)
-
-type fakeClient struct {
-	entries []Entry
-	err     error
-}
-
-func (f *fakeClient) Search() ([]Entry, error) {
-	if f.err != nil {
-		return nil, f.err
-	}
-	return f.entries, nil
-}
-
-func setupTest(t *testing.T) (*user.TenantUserStore, *rbac.Store, *RoleMappingStore, func()) {
-	t.Helper()
-	adminDSN := os.Getenv("TEST_ADMIN_DSN")
-	if adminDSN == "" {
-		t.Skip("TEST_ADMIN_DSN nicht gesetzt, Integrationstest uebersprungen")
-	}
-	ctx := context.Background()
-
-	pool, err := pgxpool.New(ctx, adminDSN)
-	if err != nil {
-		t.Fatalf("pool: %v", err)
-	}
-	if _, err := pool.Exec(ctx, `
-		CREATE TABLE IF NOT EXISTS users (
-			id UUID PRIMARY KEY DEFAULT gen_random_uuid(), email TEXT NOT NULL UNIQUE, name TEXT NOT NULL,
-			status TEXT NOT NULL DEFAULT 'active', password_hash TEXT NOT NULL DEFAULT '',
-			created_at TIMESTAMPTZ NOT NULL DEFAULT now(), updated_at TIMESTAMPTZ NOT NULL DEFAULT now()
-		);
-		CREATE TABLE IF NOT EXISTS role_assignments (
-			user_id UUID PRIMARY KEY REFERENCES users(id), role TEXT NOT NULL CHECK (role IN ('user','tenant_admin')),
-			granted_by TEXT NOT NULL, granted_at TIMESTAMPTZ NOT NULL DEFAULT now()
-		);
-		CREATE TABLE IF NOT EXISTS role_assignment_history (
-			id UUID PRIMARY KEY DEFAULT gen_random_uuid(), user_id UUID NOT NULL, role TEXT NOT NULL,
-			granted_by TEXT NOT NULL, granted_at TIMESTAMPTZ NOT NULL DEFAULT now()
-		);
-		CREATE TABLE IF NOT EXISTS ldap_group_role_mapping (
-			ldap_group TEXT PRIMARY KEY, role TEXT NOT NULL CHECK (role IN ('user','tenant_admin'))
-		);
-	`); err != nil {
-		t.Fatalf("schema: %v", err)
-	}
-
-	cleanup := func() { pool.Close() }
-	return user.NewTenantUserStore(pool), rbac.NewStore(pool), NewRoleMappingStore(pool), cleanup
-}
-
-func uniqueEmail() string {
-	return fmt.Sprintf("ldap-test-%d@example.com", time.Now().UnixNano())
-}
-
-// Akzeptanzkriterium 3 + Pruefung 1: Rollen-Erlaubnis-Matrix mit Positiv- und
-// Negativfaellen — keine Privilege-Escalation ueber Gruppenmitgliedschaft.
-func TestRoleMapping_PositiveAndNegativeCases(t *testing.T) {
-	_, _, mappings, cleanup := setupTest(t)
-	defer cleanup()
-	ctx := context.Background()
-
-	if err := mappings.SetMapping(ctx, "cn=IT-Admins,ou=groups,dc=example,dc=com", rbac.RoleTenantAdmin); err != nil {
-		t.Fatalf("set mapping: %v", err)
-	}
-
-	// Positivfall: gemappte Gruppe liefert die konfigurierte Rolle.
-	role, ok, err := mappings.HighestRoleFor(ctx, []string{"cn=IT-Admins,ou=groups,dc=example,dc=com"})
-	if err != nil {
-		t.Fatalf("highest role: %v", err)
-	}
-	if !ok || role != rbac.RoleTenantAdmin {
-		t.Fatalf("erwartet tenant_admin, habe ok=%v role=%q", ok, role)
-	}
-
-	// Negativfall 1: unbekannte Gruppe vergibt keine Rolle.
-	_, ok, err = mappings.HighestRoleFor(ctx, []string{"cn=Praktikanten,ou=groups,dc=example,dc=com"})
-	if err != nil {
-		t.Fatalf("highest role (unbekannt): %v", err)
-	}
-	if ok {
-		t.Fatal("erwartet KEINE rolle fuer nicht gemappte gruppe")
-	}
-
-	// Negativfall 2 (Privilege-Escalation-Versuch): eine Gruppe, die zufaellig
-	// wie eine interne Rolle heisst, aber NIE explizit gemappt wurde, darf
-	// keine Rolle vergeben.
-	_, ok, err = mappings.HighestRoleFor(ctx, []string{"tenant_admin", "superadmin"})
-	if err != nil {
-		t.Fatalf("highest role (namens-trick): %v", err)
-	}
-	if ok {
-		t.Fatal("erwartet KEINE privilege-escalation ueber gruppennamen, die wie rollen aussehen")
-	}
-}
-
-// Akzeptanzkriterium 1: Synchronisationslauf legt Benutzer an.
-func TestSyncer_CreatesUsers(t *testing.T) {
-	users, roles, mappings, cleanup := setupTest(t)
-	defer cleanup()
-	ctx := context.Background()
-
-	email := uniqueEmail()
-	client := &fakeClient{entries: []Entry{{Email: email, Name: "LDAP Nutzer"}}}
-	syncer := NewSyncer(client, users, roles, mappings)
-
-	result, err := syncer.Run(ctx)
-	if err != nil {
-		t.Fatalf("run: %v", err)
-	}
-	if result.Created != 1 {
-		t.Fatalf("erwartet 1 angelegten benutzer, habe %d", result.Created)
-	}
-
-	if _, err := users.GetByEmailForAuth(ctx, email); err != nil {
-		t.Fatalf("benutzer sollte existieren: %v", err)
-	}
-}
-
-// Akzeptanzkriterium 2 + Pruefung 2: fehlerhafte/nicht erreichbare LDAP-
-// Quelle bricht kontrolliert ab, ohne bestehende Konten zu beschaedigen.
-func TestSyncer_AbortsCleanlyOnSourceError(t *testing.T) {
-	users, roles, mappings, cleanup := setupTest(t)
-	defer cleanup()
-	ctx := context.Background()
-
-	// Ein bereits bestehendes Konto, das UNBERUEHRT bleiben muss.
-	existingEmail := uniqueEmail()
-	existing, err := users.Create(ctx, existingEmail, "Bestehender Nutzer")
-	if err != nil {
-		t.Fatalf("create existing: %v", err)
-	}
-
-	client := &fakeClient{err: errors.New("ldap-server nicht erreichbar (simuliert)")}
-	syncer := NewSyncer(client, users, roles, mappings)
-
-	if _, err := syncer.Run(ctx); err == nil {
-		t.Fatal("erwartet fehler bei nicht erreichbarer ldap-quelle")
-	}
-
-	// Bestehendes Konto unveraendert (noch aktiv, keine geloeschten/neuen Zeilen).
-	got, err := users.Get(ctx, existing.ID)
-	if err != nil {
-		t.Fatalf("bestehendes konto sollte weiterhin existieren: %v", err)
-	}
-	if got.Status != user.StatusActive {
-		t.Fatalf("bestehendes konto sollte unveraendert aktiv sein, ist %q", got.Status)
-	}
-}
-
-// Akzeptanzkriterium 3 + Pruefung 3: Deaktivierung in LDAP wird bei
-// naechster Synchronisation korrekt uebernommen.
-func TestSyncer_AppliesDeactivationOnNextRun(t *testing.T) {
-	users, roles, mappings, cleanup := setupTest(t)
-	defer cleanup()
-	ctx := context.Background()
-
-	email := uniqueEmail()
-	client := &fakeClient{entries: []Entry{{Email: email, Name: "Wird Deaktiviert"}}}
-	syncer := NewSyncer(client, users, roles, mappings)
-
-	if _, err := syncer.Run(ctx); err != nil {
-		t.Fatalf("erster lauf: %v", err)
-	}
-	u, err := users.GetByEmailForAuth(ctx, email)
-	if err != nil {
-		t.Fatalf("benutzer nach erstem lauf: %v", err)
-	}
-	if u.User.Status != user.StatusActive {
-		t.Fatalf("erwartet aktiv nach erstem lauf, habe %q", u.User.Status)
-	}
-
-	// Zweiter Lauf: derselbe Benutzer ist jetzt in LDAP deaktiviert.
-	client.entries[0].Disabled = true
-	result, err := syncer.Run(ctx)
-	if err != nil {
-		t.Fatalf("zweiter lauf: %v", err)
-	}
-	if result.Deactivated != 1 {
-		t.Fatalf("erwartet 1 deaktivierung, habe %d", result.Deactivated)
-	}
-
-	u, err = users.GetByEmailForAuth(ctx, email)
-	if err != nil {
-		t.Fatalf("benutzer nach zweitem lauf: %v", err)
-	}
-	if u.User.Status != user.StatusInactive {
-		t.Fatalf("erwartet inaktiv nach deaktivierung in ldap, habe %q", u.User.Status)
-	}
-}

internal/ldapsync/role_mapping.go

@@ -1,79 +0,0 @@
-package ldapsync
-
-import (
-	"context"
-	"errors"
-	"fmt"
-
-	"github.com/jackc/pgx/v5"
-	"github.com/jackc/pgx/v5/pgxpool"
-
-	"gitea.perlbach24.de/scripte/nexarch/internal/rbac"
-)
-
-// RoleMappingStore verwaltet die Erlaubnis-Matrix LDAP-Gruppe -> Rolle
-// (Akzeptanzkriterium 3). Nur explizit gemappte Gruppen vergeben eine Rolle
-// — der Schutz gegen Privilege-Escalation ist strukturell: es gibt keinen
-// Code-Pfad, der eine unbekannte Gruppe irgendeiner Rolle zuordnet.
-type RoleMappingStore struct {
-	pool *pgxpool.Pool
-}
-
-func NewRoleMappingStore(pool *pgxpool.Pool) *RoleMappingStore {
-	return &RoleMappingStore{pool: pool}
-}
-
-// SetMapping ordnet eine LDAP-Gruppe genau einer NEXARCH-Rolle zu. Nur
-// 'user'/'tenant_admin' sind zuweisbar (dieselbe Matrix wie RBAC-01/03) —
-// 'superadmin' bleibt mandantenuebergreifend und nie ueber LDAP erreichbar.
-func (s *RoleMappingStore) SetMapping(ctx context.Context, ldapGroup string, role rbac.Role) error {
-	if role != rbac.RoleUser && role != rbac.RoleTenantAdmin {
-		return fmt.Errorf("ldapsync: rolle %q ist ueber ldap nicht zuweisbar", role)
-	}
-	_, err := s.pool.Exec(ctx, `
-		INSERT INTO ldap_group_role_mapping (ldap_group, role) VALUES ($1, $2)
-		ON CONFLICT (ldap_group) DO UPDATE SET role = $2
-	`, ldapGroup, string(role))
-	if err != nil {
-		return fmt.Errorf("gruppenzuordnung speichern: %w", err)
-	}
-	return nil
-}
-
-// roleFor liefert die einer LDAP-Gruppe zugeordnete Rolle, sofern konfiguriert.
-func (s *RoleMappingStore) roleFor(ctx context.Context, ldapGroup string) (rbac.Role, bool, error) {
-	var role string
-	err := s.pool.QueryRow(ctx, `SELECT role FROM ldap_group_role_mapping WHERE ldap_group = $1`, ldapGroup).Scan(&role)
-	if err != nil {
-		if errors.Is(err, pgx.ErrNoRows) {
-			return "", false, nil
-		}
-		return "", false, fmt.Errorf("gruppenzuordnung lesen: %w", err)
-	}
-	return rbac.Role(role), true, nil
-}
-
-// HighestRoleFor bestimmt aus einer Liste von LDAP-Gruppen die hoechste
-// zugeordnete Rolle (tenant_admin > user). Gruppen ohne Eintrag in der
-// Matrix tragen NICHTS bei — auch nicht, wenn ihr Name zufaellig wie eine
-// interne Rolle aussieht (Akzeptanzkriterium 3 / Pruefung 1: keine
-// Privilege-Escalation ueber Gruppenmitgliedschaft).
-func (s *RoleMappingStore) HighestRoleFor(ctx context.Context, ldapGroups []string) (rbac.Role, bool, error) {
-	var best rbac.Role
-	found := false
-
-	for _, g := range ldapGroups {
-		role, ok, err := s.roleFor(ctx, g)
-		if err != nil {
-			return "", false, err
-		}
-		if !ok {
-			continue
-		}
-		if !found || role == rbac.RoleTenantAdmin {
-			best = role
-			found = true
-		}
-	}
-	return best, found, nil
-}

internal/ldapsync/sync.go

@@ -1,93 +0,0 @@
-package ldapsync
-
-import (
-	"context"
-	"errors"
-	"fmt"
-
-	"gitea.perlbach24.de/scripte/nexarch/internal/rbac"
-	"gitea.perlbach24.de/scripte/nexarch/internal/user"
-)
-
-// SyncResult fasst das Ergebnis eines Synchronisationslaufs zusammen.
-type SyncResult struct {
-	Created     int
-	Updated     int
-	Deactivated int
-	Failed      []string // Email-Adressen, bei denen die Verarbeitung fehlschlug
-}
-
-// Syncer fuehrt die Benutzer-/Rollen-Synchronisation aus LDAP aus.
-type Syncer struct {
-	client   Client
-	users    *user.TenantUserStore
-	roles    *rbac.Store
-	mappings *RoleMappingStore
-}
-
-func NewSyncer(client Client, users *user.TenantUserStore, roles *rbac.Store, mappings *RoleMappingStore) *Syncer {
-	return &Syncer{client: client, users: users, roles: roles, mappings: mappings}
-}
-
-// Run synchronisiert Benutzer aus LDAP (Akzeptanzkriterium 1). Ist die
-// LDAP-Quelle nicht erreichbar/fehlerhaft, wird SOFORT und OHNE jede
-// Aenderung an bestehenden Konten abgebrochen (Akzeptanzkriterium 2 /
-// Pruefung 2) — Search() wird als allererstes aufgerufen, bevor irgendein
-// Schreibzugriff stattfindet.
-func (s *Syncer) Run(ctx context.Context) (SyncResult, error) {
-	entries, err := s.client.Search()
-	if err != nil {
-		return SyncResult{}, fmt.Errorf("ldap-quelle nicht erreichbar, synchronisation abgebrochen: %w", err)
-	}
-
-	var result SyncResult
-	for _, entry := range entries {
-		if err := s.syncOne(ctx, entry, &result); err != nil {
-			// Ein fehlerhafter Einzeleintrag isoliert sich selbst — er
-			// beschaedigt weder bereits verarbeitete noch nachfolgende
-			// Konten (Akzeptanzkriterium 2).
-			result.Failed = append(result.Failed, entry.Email)
-		}
-	}
-	return result, nil
-}
-
-func (s *Syncer) syncOne(ctx context.Context, entry Entry, result *SyncResult) error {
-	existing, err := s.users.GetByEmailForAuth(ctx, entry.Email)
-	isNew := errors.Is(err, user.ErrNotFound)
-	if err != nil && !isNew {
-		return err
-	}
-
-	var userID string
-	if isNew {
-		created, err := s.users.Create(ctx, entry.Email, entry.Name)
-		if err != nil {
-			return err
-		}
-		userID = created.ID
-		result.Created++
-	} else {
-		userID = existing.User.ID
-		result.Updated++
-	}
-
-	// Deaktivierung in LDAP wird uebernommen (Akzeptanzkriterium 3 / Pruefung 3).
-	if entry.Disabled {
-		if _, err := s.users.Deactivate(ctx, userID); err != nil {
-			return err
-		}
-		result.Deactivated++
-	}
-
-	role, ok, err := s.mappings.HighestRoleFor(ctx, entry.Groups)
-	if err != nil {
-		return err
-	}
-	if ok {
-		if _, err := s.roles.Assign(ctx, userID, role, "ldap-sync"); err != nil {
-			return err
-		}
-	}
-	return nil
-}

internal/oidc/jwks.go

@@ -1,78 +0,0 @@
-// Package oidc implementiert Core IAM-06: SSO-Anmeldung ueber OpenID
-// Connect gegen externe Identity-Provider.
-//
-// WICHTIGER HINWEIS: In dieser Umgebung ist kein registrierter externer
-// OIDC-Provider (Client-ID/Secret bei Google/Okta/Azure AD o.ae.) verfuegbar,
-// gegen den ein echter Authorization-Code-Redirect-Flow end-to-end
-// durchgefuehrt werden koennte (analog AUD-05/Archive, IAM-05/LDAP). ANDERS
-// als bei LDAP/Archive ist die eigentliche Token-VALIDIERUNG (JWKS-
-// Signaturpruefung, Ablauf, Claims, Nonce/State) aber ein rein
-// kryptographischer Vorgang ohne Netzwerkabhaengigkeit zur Testzeit — die
-// Tests unten erzeugen ein eigenes RSA-Schluesselpaar, signieren ein
-// ID-Token selbst und pruefen es exakt so, wie es ein echter Provider
-// liefern wuerde. Nur der Redirect zu einem echten externen Provider bleibt
-// ungeprueft.
-package oidc
-
-import (
-	"crypto/rsa"
-	"encoding/base64"
-	"encoding/binary"
-	"encoding/json"
-	"errors"
-	"fmt"
-	"math/big"
-)
-
-type jwk struct {
-	Kid string `json:"kid"`
-	Kty string `json:"kty"`
-	N   string `json:"n"`
-	E   string `json:"e"`
-}
-
-type jwkSet struct {
-	Keys []jwk `json:"keys"`
-}
-
-var ErrUnsupportedKeyType = errors.New("oidc: nicht unterstuetzter jwk-schluesseltyp")
-
-// ParseJWKS dekodiert eine JWKS-Antwort (RFC 7517) in kid -> RSA-Public-Key.
-// Nur RSA-Schluessel (kty=RSA, Standard bei allen gaengigen OIDC-Providern
-// fuer ID-Tokens) werden unterstuetzt.
-func ParseJWKS(data []byte) (map[string]*rsa.PublicKey, error) {
-	var set jwkSet
-	if err := json.Unmarshal(data, &set); err != nil {
-		return nil, fmt.Errorf("jwks parsen: %w", err)
-	}
-
-	out := make(map[string]*rsa.PublicKey, len(set.Keys))
-	for _, k := range set.Keys {
-		if k.Kty != "RSA" {
-			continue
-		}
-		pub, err := decodeRSAKey(k)
-		if err != nil {
-			return nil, fmt.Errorf("schluessel %q dekodieren: %w", k.Kid, err)
-		}
-		out[k.Kid] = pub
-	}
-	return out, nil
-}
-
-func decodeRSAKey(k jwk) (*rsa.PublicKey, error) {
-	nBytes, err := base64.RawURLEncoding.DecodeString(k.N)
-	if err != nil {
-		return nil, fmt.Errorf("modulus dekodieren: %w", err)
-	}
-	eBytes, err := base64.RawURLEncoding.DecodeString(k.E)
-	if err != nil {
-		return nil, fmt.Errorf("exponent dekodieren: %w", err)
-	}
-
-	eBuf := make([]byte, 8)
-	copy(eBuf[8-len(eBytes):], eBytes)
-	e := int(binary.BigEndian.Uint64(eBuf))
-
-	return &rsa.PublicKey{N: new(big.Int).SetBytes(nBytes), E: e}, nil
-}

internal/oidc/login.go

@@ -1,69 +0,0 @@
-package oidc
-
-import (
-	"context"
-	"errors"
-	"fmt"
-
-	"gitea.perlbach24.de/scripte/nexarch/internal/auth"
-	"gitea.perlbach24.de/scripte/nexarch/internal/ldapsync"
-	"gitea.perlbach24.de/scripte/nexarch/internal/rbac"
-	"gitea.perlbach24.de/scripte/nexarch/internal/user"
-)
-
-// CompleteOIDCLogin verifiziert das ID-Token (Signatur, Ablauf, Aussteller,
-// Nonce — Akzeptanzkriterium 3), loest den State einmalig ein
-// (Akzeptanzkriterium/Pruefung 3), legt bei Bedarf einen lokalen Benutzer an
-// und mapped Rollen aus den OIDC-Claims ueber DIESELBE Erlaubnis-Matrix wie
-// IAM-05/LDAP (ldapsync.RoleMappingStore — kein zweiter, paralleler
-// Mapping-Mechanismus, Akzeptanzkriterium 2). Bei Erfolg wird ein normales
-// IAM-02-Sitzungs-Token ausgestellt.
-func CompleteOIDCLogin(
-	ctx context.Context,
-	verifier *Verifier,
-	states *StateStore,
-	users *user.TenantUserStore,
-	roles *rbac.Store,
-	roleMapping *ldapsync.RoleMappingStore,
-	issuer *auth.TokenIssuer,
-	tenantSlug, state, idToken string,
-) (token string, err error) {
-	nonce, err := states.Consume(ctx, state)
-	if err != nil {
-		return "", err
-	}
-
-	claims, err := verifier.VerifyWithNonce(idToken, nonce)
-	if err != nil {
-		return "", err
-	}
-	if claims.Email == "" {
-		return "", fmt.Errorf("%w: id-token ohne e-mail-claim", ErrInvalidToken)
-	}
-
-	u, err := findOrCreateUser(ctx, users, claims.Email)
-	if err != nil {
-		return "", err
-	}
-
-	if role, ok, err := roleMapping.HighestRoleFor(ctx, claims.Roles); err != nil {
-		return "", err
-	} else if ok {
-		if _, err := roles.Assign(ctx, u.ID, role, "oidc-sso"); err != nil {
-			return "", err
-		}
-	}
-
-	return issuer.Issue(u.ID, tenantSlug)
-}
-
-func findOrCreateUser(ctx context.Context, users *user.TenantUserStore, email string) (user.User, error) {
-	creds, err := users.GetByEmailForAuth(ctx, email)
-	if err == nil {
-		return creds.User, nil
-	}
-	if !errors.Is(err, user.ErrNotFound) {
-		return user.User{}, err
-	}
-	return users.Create(ctx, email, email)
-}

internal/oidc/login_test.go

@@ -1,172 +0,0 @@
-package oidc
-
-import (
-	"context"
-	"crypto/rsa"
-	"fmt"
-	"os"
-	"testing"
-	"time"
-
-	"github.com/jackc/pgx/v5/pgxpool"
-	"github.com/golang-jwt/jwt/v5"
-
-	"gitea.perlbach24.de/scripte/nexarch/internal/auth"
-	"gitea.perlbach24.de/scripte/nexarch/internal/ldapsync"
-	"gitea.perlbach24.de/scripte/nexarch/internal/rbac"
-	"gitea.perlbach24.de/scripte/nexarch/internal/user"
-)
-
-func setupLoginTest(t *testing.T) (*pgxpool.Pool, func()) {
-	t.Helper()
-	adminDSN := os.Getenv("TEST_ADMIN_DSN")
-	if adminDSN == "" {
-		t.Skip("TEST_ADMIN_DSN nicht gesetzt, Integrationstest uebersprungen")
-	}
-	ctx := context.Background()
-
-	pool, err := pgxpool.New(ctx, adminDSN)
-	if err != nil {
-		t.Fatalf("pool: %v", err)
-	}
-	if _, err := pool.Exec(ctx, `
-		CREATE TABLE IF NOT EXISTS users (
-			id UUID PRIMARY KEY DEFAULT gen_random_uuid(), email TEXT NOT NULL UNIQUE, name TEXT NOT NULL,
-			status TEXT NOT NULL DEFAULT 'active', password_hash TEXT NOT NULL DEFAULT '',
-			created_at TIMESTAMPTZ NOT NULL DEFAULT now(), updated_at TIMESTAMPTZ NOT NULL DEFAULT now()
-		);
-		CREATE TABLE IF NOT EXISTS role_assignments (
-			user_id UUID PRIMARY KEY REFERENCES users(id), role TEXT NOT NULL CHECK (role IN ('user','tenant_admin')),
-			granted_by TEXT NOT NULL, granted_at TIMESTAMPTZ NOT NULL DEFAULT now()
-		);
-		CREATE TABLE IF NOT EXISTS role_assignment_history (
-			id UUID PRIMARY KEY DEFAULT gen_random_uuid(), user_id UUID NOT NULL, role TEXT NOT NULL,
-			granted_by TEXT NOT NULL, granted_at TIMESTAMPTZ NOT NULL DEFAULT now()
-		);
-		CREATE TABLE IF NOT EXISTS ldap_group_role_mapping (
-			ldap_group TEXT PRIMARY KEY, role TEXT NOT NULL CHECK (role IN ('user','tenant_admin'))
-		);
-		CREATE TABLE IF NOT EXISTS oidc_states (
-			state TEXT PRIMARY KEY, nonce TEXT NOT NULL, expires_at TIMESTAMPTZ NOT NULL,
-			used_at TIMESTAMPTZ, created_at TIMESTAMPTZ NOT NULL DEFAULT now()
-		);
-	`); err != nil {
-		t.Fatalf("schema: %v", err)
-	}
-
-	cleanup := func() { pool.Close() }
-	return pool, cleanup
-}
-
-// Akzeptanzkriterium 1 + 3: End-to-End-Login gegen ein (selbst signiertes,
-// aber protokollkorrektes) ID-Token — Signatur, Nonce, State, Rollen-Mapping,
-// Sitzungs-Token-Ausstellung.
-func TestCompleteOIDCLogin_EndToEnd(t *testing.T) {
-	pool, cleanup := setupLoginTest(t)
-	defer cleanup()
-	ctx := context.Background()
-
-	key := generateTestKey(t)
-	verifier := NewVerifier(map[string]*rsa.PublicKey{"kid-1": &key.PublicKey}, "https://idp.example.com")
-	states := NewStateStore(pool)
-	users := user.NewTenantUserStore(pool)
-	roles := rbac.NewStore(pool)
-	roleMapping := ldapsync.NewRoleMappingStore(pool)
-	issuer := auth.NewTokenIssuer("test-secret-nur-fuer-tests")
-
-	if err := roleMapping.SetMapping(ctx, "sso-admins", rbac.RoleTenantAdmin); err != nil {
-		t.Fatalf("set mapping: %v", err)
-	}
-
-	state, nonce, err := states.Generate(ctx)
-	if err != nil {
-		t.Fatalf("generate state: %v", err)
-	}
-
-	email := fmt.Sprintf("oidc-test-%d@example.com", time.Now().UnixNano())
-	claims := Claims{
-		Subject: "idp-subject-123",
-		Email:   email,
-		Nonce:   nonce,
-		Roles:   []string{"sso-admins"},
-		RegisteredClaims: jwt.RegisteredClaims{
-			Issuer:    "https://idp.example.com",
-			ExpiresAt: jwt.NewNumericDate(time.Now().Add(time.Hour)),
-		},
-	}
-	idToken := signTestToken(t, key, "kid-1", claims)
-
-	token, err := CompleteOIDCLogin(ctx, verifier, states, users, roles, roleMapping, issuer, "acme", state, idToken)
-	if err != nil {
-		t.Fatalf("complete oidc login: %v", err)
-	}
-	if token == "" {
-		t.Fatal("erwartet nicht-leeres sitzungs-token")
-	}
-
-	assignment, err := roles.Get(ctx, mustGetUserID(t, ctx, users, email))
-	if err != nil {
-		t.Fatalf("rollenzuweisung lesen: %v", err)
-	}
-	if assignment.Role != rbac.RoleTenantAdmin {
-		t.Fatalf("erwartet tenant_admin aus sso-admins-mapping, habe %q", assignment.Role)
-	}
-
-	// Replay desselben state schlaegt fehl.
-	if _, err := CompleteOIDCLogin(ctx, verifier, states, users, roles, roleMapping, issuer, "acme", state, idToken); err == nil {
-		t.Fatal("erwartet fehler bei wiederverwendetem state (replay)")
-	}
-}
-
-// Akzeptanzkriterium 2 + Pruefung 1: keine Privilege-Escalation ueber
-// manipulierte/unbekannte Rollen-Claims.
-func TestCompleteOIDCLogin_UnmappedRoleGrantsNothing(t *testing.T) {
-	pool, cleanup := setupLoginTest(t)
-	defer cleanup()
-	ctx := context.Background()
-
-	key := generateTestKey(t)
-	verifier := NewVerifier(map[string]*rsa.PublicKey{"kid-1": &key.PublicKey}, "https://idp.example.com")
-	states := NewStateStore(pool)
-	users := user.NewTenantUserStore(pool)
-	roles := rbac.NewStore(pool)
-	roleMapping := ldapsync.NewRoleMappingStore(pool)
-	issuer := auth.NewTokenIssuer("test-secret-nur-fuer-tests")
-
-	state, nonce, err := states.Generate(ctx)
-	if err != nil {
-		t.Fatalf("generate state: %v", err)
-	}
-
-	email := fmt.Sprintf("oidc-test-%d@example.com", time.Now().UnixNano())
-	claims := Claims{
-		Email: email,
-		Nonce: nonce,
-		// Versuch, sich ueber einen manipulierten Rollen-Claim
-		// hochzustufen — diese Gruppen wurden NIE gemappt.
-		Roles: []string{"tenant_admin", "superadmin"},
-		RegisteredClaims: jwt.RegisteredClaims{
-			Issuer:    "https://idp.example.com",
-			ExpiresAt: jwt.NewNumericDate(time.Now().Add(time.Hour)),
-		},
-	}
-	idToken := signTestToken(t, key, "kid-1", claims)
-
-	if _, err := CompleteOIDCLogin(ctx, verifier, states, users, roles, roleMapping, issuer, "acme", state, idToken); err != nil {
-		t.Fatalf("complete oidc login: %v", err)
-	}
-
-	userID := mustGetUserID(t, ctx, users, email)
-	if _, err := roles.Get(ctx, userID); err == nil {
-		t.Fatal("erwartet KEINE rollenzuweisung fuer nicht gemappte claims (privilege-escalation-versuch)")
-	}
-}
-
-func mustGetUserID(t *testing.T, ctx context.Context, users *user.TenantUserStore, email string) string {
-	t.Helper()
-	creds, err := users.GetByEmailForAuth(ctx, email)
-	if err != nil {
-		t.Fatalf("get user by email: %v", err)
-	}
-	return creds.User.ID
-}

internal/oidc/state.go

@@ -1,76 +0,0 @@
-package oidc
-
-import (
-	"context"
-	"crypto/rand"
-	"encoding/hex"
-	"errors"
-	"fmt"
-	"time"
-
-	"github.com/jackc/pgx/v5"
-	"github.com/jackc/pgx/v5/pgxpool"
-)
-
-var ErrStateInvalid = errors.New("oidc: state ungueltig, bereits verwendet oder abgelaufen")
-
-// DefaultStateTTL begrenzt, wie lange ein ausgestellter State/Nonce fuer den
-// Redirect-Umweg zum Identity-Provider gueltig bleibt.
-const DefaultStateTTL = 10 * time.Minute
-
-type StateStore struct {
-	pool *pgxpool.Pool
-}
-
-func NewStateStore(pool *pgxpool.Pool) *StateStore {
-	return &StateStore{pool: pool}
-}
-
-// Generate stellt state+nonce fuer einen neuen Login-Redirect aus. state
-// wird als OAuth2-"state"-Parameter mitgeschickt (CSRF-Schutz), nonce
-// erscheint spaeter im ID-Token und muss exakt uebereinstimmen (Replay-Schutz).
-func (s *StateStore) Generate(ctx context.Context) (state, nonce string, err error) {
-	state, err = randomValue()
-	if err != nil {
-		return "", "", err
-	}
-	nonce, err = randomValue()
-	if err != nil {
-		return "", "", err
-	}
-
-	_, err = s.pool.Exec(ctx, `
-		INSERT INTO oidc_states (state, nonce, expires_at) VALUES ($1, $2, $3)
-	`, state, nonce, time.Now().Add(DefaultStateTTL))
-	if err != nil {
-		return "", "", fmt.Errorf("state speichern: %w", err)
-	}
-	return state, nonce, nil
-}
-
-// Consume loest einen State EINMALIG ein (Akzeptanzkriterium/Pruefung 3:
-// Replay-Schutz) — atomar ueber WHERE used_at IS NULL, analog IAM-03/IAM-09.
-// Ein zweiter Callback mit demselben state (z.B. durch einen Angreifer, der
-// die Redirect-URL abgefangen hat) schlaegt fehl.
-func (s *StateStore) Consume(ctx context.Context, state string) (nonce string, err error) {
-	err = s.pool.QueryRow(ctx, `
-		UPDATE oidc_states SET used_at = now()
-		WHERE state = $1 AND used_at IS NULL AND expires_at > now()
-		RETURNING nonce
-	`, state).Scan(&nonce)
-	if err != nil {
-		if errors.Is(err, pgx.ErrNoRows) {
-			return "", ErrStateInvalid
-		}
-		return "", fmt.Errorf("state einloesen: %w", err)
-	}
-	return nonce, nil
-}
-
-func randomValue() (string, error) {
-	buf := make([]byte, 32)
-	if _, err := rand.Read(buf); err != nil {
-		return "", err
-	}
-	return hex.EncodeToString(buf), nil
-}

internal/oidc/state_test.go

@@ -1,68 +0,0 @@
-package oidc
-
-import (
-	"context"
-	"errors"
-	"os"
-	"testing"
-
-	"github.com/jackc/pgx/v5/pgxpool"
-)
-
-func setupStateTest(t *testing.T) (*StateStore, func()) {
-	t.Helper()
-	adminDSN := os.Getenv("TEST_ADMIN_DSN")
-	if adminDSN == "" {
-		t.Skip("TEST_ADMIN_DSN nicht gesetzt, Integrationstest uebersprungen")
-	}
-	ctx := context.Background()
-
-	pool, err := pgxpool.New(ctx, adminDSN)
-	if err != nil {
-		t.Fatalf("pool: %v", err)
-	}
-	if _, err := pool.Exec(ctx, `
-		CREATE TABLE IF NOT EXISTS oidc_states (
-			state TEXT PRIMARY KEY, nonce TEXT NOT NULL, expires_at TIMESTAMPTZ NOT NULL,
-			used_at TIMESTAMPTZ, created_at TIMESTAMPTZ NOT NULL DEFAULT now()
-		)`); err != nil {
-		t.Fatalf("schema: %v", err)
-	}
-
-	cleanup := func() { pool.Close() }
-	return NewStateStore(pool), cleanup
-}
-
-// Akzeptanzkriterium/Pruefung 3: State/Nonce-Handling gegen CSRF und Replay.
-func TestStateStore_ConsumeIsSingleUse(t *testing.T) {
-	store, cleanup := setupStateTest(t)
-	defer cleanup()
-	ctx := context.Background()
-
-	state, nonce, err := store.Generate(ctx)
-	if err != nil {
-		t.Fatalf("generate: %v", err)
-	}
-
-	gotNonce, err := store.Consume(ctx, state)
-	if err != nil {
-		t.Fatalf("consume (erste einloesung): %v", err)
-	}
-	if gotNonce != nonce {
-		t.Fatalf("nonce = %q, want %q", gotNonce, nonce)
-	}
-
-	if _, err := store.Consume(ctx, state); !errors.Is(err, ErrStateInvalid) {
-		t.Fatalf("erwartet ErrStateInvalid bei erneutem einloesen (replay), habe %v", err)
-	}
-}
-
-func TestStateStore_RejectsUnknownState(t *testing.T) {
-	store, cleanup := setupStateTest(t)
-	defer cleanup()
-	ctx := context.Background()
-
-	if _, err := store.Consume(ctx, "niemals-ausgestellter-state"); !errors.Is(err, ErrStateInvalid) {
-		t.Fatalf("erwartet ErrStateInvalid, habe %v", err)
-	}
-}

internal/oidc/verify.go

@@ -1,70 +0,0 @@
-package oidc
-
-import (
-	"crypto/rsa"
-	"errors"
-	"fmt"
-
-	"github.com/golang-jwt/jwt/v5"
-)
-
-var ErrInvalidToken = errors.New("oidc: id-token ungueltig, abgelaufen oder falscher aussteller")
-
-// Claims sind die fuer NEXARCH relevanten OIDC-ID-Token-Claims.
-type Claims struct {
-	Subject string   `json:"sub"`
-	Email   string   `json:"email"`
-	Nonce   string   `json:"nonce"`
-	Roles   []string `json:"roles"` // providerabhaengiger Claim-Name, hier vereinfacht fest "roles"
-	jwt.RegisteredClaims
-}
-
-// Verifier prueft ID-Tokens gegen den JWKS-Schluesselsatz eines konfigurierten
-// Providers (Akzeptanzkriterium 3: fehlerhafte/abgelaufene Tokens werden
-// abgewiesen).
-type Verifier struct {
-	keys   map[string]*rsa.PublicKey
-	issuer string
-}
-
-func NewVerifier(keys map[string]*rsa.PublicKey, issuer string) *Verifier {
-	return &Verifier{keys: keys, issuer: issuer}
-}
-
-// Verify prueft Signatur (gegen JWKS), Ablauf (jwt-Bibliothek lehnt
-// abgelaufene Tokens automatisch ab) und Aussteller.
-func (v *Verifier) Verify(idToken string) (*Claims, error) {
-	claims := &Claims{}
-	token, err := jwt.ParseWithClaims(idToken, claims, func(t *jwt.Token) (interface{}, error) {
-		if _, ok := t.Method.(*jwt.SigningMethodRSA); !ok {
-			return nil, ErrInvalidToken
-		}
-		kid, _ := t.Header["kid"].(string)
-		key, ok := v.keys[kid]
-		if !ok {
-			return nil, ErrInvalidToken
-		}
-		return key, nil
-	})
-	if err != nil || !token.Valid {
-		return nil, ErrInvalidToken
-	}
-	if claims.Issuer != v.issuer {
-		return nil, fmt.Errorf("%w: unerwarteter aussteller %q", ErrInvalidToken, claims.Issuer)
-	}
-	return claims, nil
-}
-
-// VerifyWithNonce prueft zusaetzlich, dass der nonce-Claim im Token exakt
-// dem bei der Anfrage ausgestellten Nonce entspricht — verhindert Replay
-// eines fremden, gueltigen ID-Tokens (Akzeptanzkriterium/Pruefung 3).
-func (v *Verifier) VerifyWithNonce(idToken, expectedNonce string) (*Claims, error) {
-	claims, err := v.Verify(idToken)
-	if err != nil {
-		return nil, err
-	}
-	if claims.Nonce == "" || claims.Nonce != expectedNonce {
-		return nil, fmt.Errorf("%w: nonce stimmt nicht ueberein", ErrInvalidToken)
-	}
-	return claims, nil
-}

internal/oidc/verify_test.go

@@ -1,184 +0,0 @@
-package oidc
-
-import (
-	"crypto/rand"
-	"crypto/rsa"
-	"encoding/base64"
-	"encoding/binary"
-	"encoding/json"
-	"testing"
-	"time"
-
-	"github.com/golang-jwt/jwt/v5"
-)
-
-func generateTestKey(t *testing.T) *rsa.PrivateKey {
-	t.Helper()
-	key, err := rsa.GenerateKey(rand.Reader, 2048)
-	if err != nil {
-		t.Fatalf("generate rsa key: %v", err)
-	}
-	return key
-}
-
-func signTestToken(t *testing.T, key *rsa.PrivateKey, kid string, claims Claims) string {
-	t.Helper()
-	token := jwt.NewWithClaims(jwt.SigningMethodRS256, claims)
-	token.Header["kid"] = kid
-	s, err := token.SignedString(key)
-	if err != nil {
-		t.Fatalf("sign token: %v", err)
-	}
-	return s
-}
-
-func TestVerify_AcceptsValidToken(t *testing.T) {
-	key := generateTestKey(t)
-	verifier := NewVerifier(map[string]*rsa.PublicKey{"kid-1": &key.PublicKey}, "https://idp.example.com")
-
-	claims := Claims{
-		Subject: "user-123",
-		Email:   "person@example.com",
-		Nonce:   "erwarteter-nonce",
-		RegisteredClaims: jwt.RegisteredClaims{
-			Issuer:    "https://idp.example.com",
-			ExpiresAt: jwt.NewNumericDate(time.Now().Add(time.Hour)),
-		},
-	}
-	tok := signTestToken(t, key, "kid-1", claims)
-
-	got, err := verifier.Verify(tok)
-	if err != nil {
-		t.Fatalf("verify: %v", err)
-	}
-	if got.Email != "person@example.com" {
-		t.Fatalf("email = %q", got.Email)
-	}
-}
-
-// Akzeptanzkriterium 3 + Pruefung 2: Token-Signatur- und Ablaufpruefung.
-func TestVerify_RejectsExpiredToken(t *testing.T) {
-	key := generateTestKey(t)
-	verifier := NewVerifier(map[string]*rsa.PublicKey{"kid-1": &key.PublicKey}, "https://idp.example.com")
-
-	claims := Claims{
-		Subject: "user-123",
-		RegisteredClaims: jwt.RegisteredClaims{
-			Issuer:    "https://idp.example.com",
-			ExpiresAt: jwt.NewNumericDate(time.Now().Add(-time.Hour)), // abgelaufen
-		},
-	}
-	tok := signTestToken(t, key, "kid-1", claims)
-
-	if _, err := verifier.Verify(tok); err == nil {
-		t.Fatal("erwartet fehler bei abgelaufenem token")
-	}
-}
-
-func TestVerify_RejectsWrongSigningKey(t *testing.T) {
-	realKey := generateTestKey(t)
-	attackerKey := generateTestKey(t)
-	// Verifier kennt NUR den echten oeffentlichen Schluessel.
-	verifier := NewVerifier(map[string]*rsa.PublicKey{"kid-1": &realKey.PublicKey}, "https://idp.example.com")
-
-	claims := Claims{
-		Subject: "user-123",
-		RegisteredClaims: jwt.RegisteredClaims{
-			Issuer:    "https://idp.example.com",
-			ExpiresAt: jwt.NewNumericDate(time.Now().Add(time.Hour)),
-		},
-	}
-	// Mit dem Angreifer-Schluessel signiert, aber unter demselben kid wie der echte.
-	tok := signTestToken(t, attackerKey, "kid-1", claims)
-
-	if _, err := verifier.Verify(tok); err == nil {
-		t.Fatal("erwartet fehler bei fremd signiertem token")
-	}
-}
-
-func TestVerify_RejectsWrongIssuer(t *testing.T) {
-	key := generateTestKey(t)
-	verifier := NewVerifier(map[string]*rsa.PublicKey{"kid-1": &key.PublicKey}, "https://idp.example.com")
-
-	claims := Claims{
-		Subject: "user-123",
-		RegisteredClaims: jwt.RegisteredClaims{
-			Issuer:    "https://ganz-anderer-idp.example.com",
-			ExpiresAt: jwt.NewNumericDate(time.Now().Add(time.Hour)),
-		},
-	}
-	tok := signTestToken(t, key, "kid-1", claims)
-
-	if _, err := verifier.Verify(tok); err == nil {
-		t.Fatal("erwartet fehler bei unerwartetem aussteller")
-	}
-}
-
-// Akzeptanzkriterium/Pruefung 3: Nonce-Handling gegen Replay.
-func TestVerifyWithNonce_RejectsMismatch(t *testing.T) {
-	key := generateTestKey(t)
-	verifier := NewVerifier(map[string]*rsa.PublicKey{"kid-1": &key.PublicKey}, "https://idp.example.com")
-
-	claims := Claims{
-		Subject: "user-123",
-		Nonce:   "nonce-a",
-		RegisteredClaims: jwt.RegisteredClaims{
-			Issuer:    "https://idp.example.com",
-			ExpiresAt: jwt.NewNumericDate(time.Now().Add(time.Hour)),
-		},
-	}
-	tok := signTestToken(t, key, "kid-1", claims)
-
-	if _, err := verifier.VerifyWithNonce(tok, "nonce-b"); err == nil {
-		t.Fatal("erwartet fehler bei nonce-mismatch (moeglicher replay eines fremden tokens)")
-	}
-	if _, err := verifier.VerifyWithNonce(tok, "nonce-a"); err != nil {
-		t.Fatalf("erwartet erfolg bei passendem nonce: %v", err)
-	}
-}
-
-func TestParseJWKS_RoundTrip(t *testing.T) {
-	key := generateTestKey(t)
-
-	nBytes := key.PublicKey.N.Bytes()
-	eBuf := make([]byte, 8)
-	binary.BigEndian.PutUint64(eBuf, uint64(key.PublicKey.E))
-	// Fuehrende Nullbytes des Exponenten abschneiden (ueblich bei JWK-Kodierung).
-	eStart := 0
-	for eStart < len(eBuf)-1 && eBuf[eStart] == 0 {
-		eStart++
-	}
-
-	set := jwkSet{Keys: []jwk{{
-		Kid: "kid-1",
-		Kty: "RSA",
-		N:   base64.RawURLEncoding.EncodeToString(nBytes),
-		E:   base64.RawURLEncoding.EncodeToString(eBuf[eStart:]),
-	}}}
-	data, err := json.Marshal(set)
-	if err != nil {
-		t.Fatalf("marshal: %v", err)
-	}
-
-	parsed, err := ParseJWKS(data)
-	if err != nil {
-		t.Fatalf("parse jwks: %v", err)
-	}
-	got, ok := parsed["kid-1"]
-	if !ok {
-		t.Fatal("erwartet kid-1 im ergebnis")
-	}
-	if got.E != key.PublicKey.E || got.N.Cmp(key.PublicKey.N) != 0 {
-		t.Fatalf("erwartet identischen oeffentlichen schluessel nach roundtrip")
-	}
-
-	// Der wiederhergestellte Schluessel muss ein damit signiertes Token auch tatsaechlich verifizieren.
-	verifier := NewVerifier(parsed, "https://idp.example.com")
-	claims := Claims{Subject: "x", RegisteredClaims: jwt.RegisteredClaims{
-		Issuer: "https://idp.example.com", ExpiresAt: jwt.NewNumericDate(time.Now().Add(time.Hour)),
-	}}
-	tok := signTestToken(t, key, "kid-1", claims)
-	if _, err := verifier.Verify(tok); err != nil {
-		t.Fatalf("verify mit aus jwks wiederhergestelltem schluessel: %v", err)
-	}
-}

internal/rbac/role.go

@@ -1,71 +0,0 @@
-// Package rbac implementiert Core RBAC-01: das Rollenmodell mit
-// Grundrollen/-rechten, Hierarchie und Zuweisung. Die eigentliche
-// Durchsetzung (erlaubt/verboten je Request) ist RBAC-02, dieses Paket
-// liefert nur Modell + Zuweisung (Casbin-Prinzip: Policy-Modell getrennt
-// von der Entscheidungsfunktion).
-package rbac
-
-// Role ist eine der drei Grundrollen. Superadmin lebt mandantenuebergreifend
-// (siehe internal/user.SuperadminStore aus IAM-01) und wird deshalb NICHT
-// ueber Store (tenant-gescoped) zugewiesen — die Existenz eines Superadmin-
-// Kontos IST die Rollenzuweisung.
-type Role string
-
-const (
-	RoleSuperadmin  Role = "superadmin"
-	RoleTenantAdmin Role = "tenant_admin"
-	RoleUser        Role = "user"
-)
-
-type Permission string
-
-const (
-	PermSelfRead       Permission = "self.read"
-	PermSelfUpdate     Permission = "self.update"
-	PermManageUsers    Permission = "tenant.manage_users"
-	PermManageSettings Permission = "tenant.manage_settings"
-	PermManageTenants  Permission = "platform.manage_tenants"
-)
-
-// parent bildet die Rollenhierarchie ab (Akzeptanzkriterium 2): eine Rolle
-// erbt alle Rechte ihrer Elternrolle. tenant_admin erbt von user,
-// superadmin erbt von tenant_admin.
-var parent = map[Role]Role{
-	RoleTenantAdmin: RoleUser,
-	RoleSuperadmin:  RoleTenantAdmin,
-}
-
-// direct sind die einer Rolle direkt (ohne Vererbung) zugeordneten Rechte.
-var direct = map[Role][]Permission{
-	RoleUser:        {PermSelfRead, PermSelfUpdate},
-	RoleTenantAdmin: {PermManageUsers, PermManageSettings},
-	RoleSuperadmin:  {PermManageTenants},
-}
-
-// EffectivePermissions liefert die vollstaendige, ueber die Hierarchie
-// aufgeloeste Rechtemenge einer Rolle (Akzeptanzkriterium 2 / Pruefung 2).
-func EffectivePermissions(role Role) []Permission {
-	seen := make(map[Permission]bool)
-	var out []Permission
-
-	for r, ok := role, true; ok; r, ok = parent[r] {
-		for _, p := range direct[r] {
-			if !seen[p] {
-				seen[p] = true
-				out = append(out, p)
-			}
-		}
-	}
-	return out
-}
-
-// HasPermission prueft, ob eine Rolle (inklusive geerbter Rechte) ein
-// bestimmtes Recht besitzt.
-func HasPermission(role Role, perm Permission) bool {
-	for _, p := range EffectivePermissions(role) {
-		if p == perm {
-			return true
-		}
-	}
-	return false
-}

internal/rbac/store.go

@@ -1,124 +0,0 @@
-package rbac
-
-import (
-	"context"
-	"errors"
-	"fmt"
-
-	"github.com/jackc/pgx/v5"
-	"github.com/jackc/pgx/v5/pgxpool"
-)
-
-var (
-	// ErrRoleNotAssignableInTenantScope wird geliefert, wenn versucht wird,
-	// eine mandantenuebergreifende Rolle (superadmin) ueber den tenant-
-	// gescopten Store zu vergeben — die erlaubte Matrix laesst hier nur
-	// user/tenant_admin zu (Akzeptanzkriterium 1 / Pruefung 1).
-	ErrRoleNotAssignableInTenantScope = errors.New("rbac: rolle ist in diesem geltungsbereich nicht zuweisbar")
-	ErrNotFound                       = errors.New("rbac: keine rollenzuweisung gefunden")
-)
-
-// assignableRoles ist die erlaubte Matrix fuer Store (tenant-gescoped).
-var assignableRoles = map[Role]bool{
-	RoleUser:        true,
-	RoleTenantAdmin: true,
-}
-
-type Assignment struct {
-	UserID    string
-	Role      Role
-	GrantedBy string
-}
-
-// Store verwaltet Rollenzuweisungen innerhalb GENAU EINER Tenant-Datenbank —
-// analog zu internal/user.TenantUserStore (Modell C: der Pool bestimmt den
-// Tenant, keine tenant_id-Spalte noetig).
-type Store struct {
-	pool *pgxpool.Pool
-}
-
-func NewStore(pool *pgxpool.Pool) *Store {
-	return &Store{pool: pool}
-}
-
-// Assign vergibt eine Rolle an einen Benutzer. grantedBy identifiziert den
-// Akteur, der die Zuweisung vorgenommen hat (Akzeptanzkriterium 3). Jede
-// Zuweisung wird zusaetzlich in role_assignment_history festgehalten, auch
-// wenn sie eine vorherige Rolle ersetzt.
-func (s *Store) Assign(ctx context.Context, userID string, role Role, grantedBy string) (Assignment, error) {
-	if !assignableRoles[role] {
-		return Assignment{}, ErrRoleNotAssignableInTenantScope
-	}
-	if grantedBy == "" {
-		return Assignment{}, errors.New("rbac: grantedBy darf nicht leer sein")
-	}
-
-	tx, err := s.pool.Begin(ctx)
-	if err != nil {
-		return Assignment{}, fmt.Errorf("transaktion starten: %w", err)
-	}
-	defer func() { _ = tx.Rollback(ctx) }()
-
-	if _, err := tx.Exec(ctx, `
-		INSERT INTO role_assignments (user_id, role, granted_by, granted_at)
-		VALUES ($1, $2, $3, now())
-		ON CONFLICT (user_id) DO UPDATE SET role = $2, granted_by = $3, granted_at = now()
-	`, userID, string(role), grantedBy); err != nil {
-		return Assignment{}, fmt.Errorf("rolle zuweisen: %w", err)
-	}
-
-	if _, err := tx.Exec(ctx, `
-		INSERT INTO role_assignment_history (user_id, role, granted_by, granted_at)
-		VALUES ($1, $2, $3, now())
-	`, userID, string(role), grantedBy); err != nil {
-		return Assignment{}, fmt.Errorf("historie schreiben: %w", err)
-	}
-
-	if err := tx.Commit(ctx); err != nil {
-		return Assignment{}, fmt.Errorf("transaktion committen: %w", err)
-	}
-
-	return Assignment{UserID: userID, Role: role, GrantedBy: grantedBy}, nil
-}
-
-func (s *Store) Get(ctx context.Context, userID string) (Assignment, error) {
-	var a Assignment
-	var role string
-	a.UserID = userID
-	if err := s.pool.QueryRow(ctx, `
-		SELECT role, granted_by FROM role_assignments WHERE user_id = $1
-	`, userID).Scan(&role, &a.GrantedBy); err != nil {
-		if errors.Is(err, pgx.ErrNoRows) {
-			return Assignment{}, ErrNotFound
-		}
-		return Assignment{}, fmt.Errorf("rollenzuweisung lesen: %w", err)
-	}
-	a.Role = Role(role)
-	return a, nil
-}
-
-// History liefert jede Rollenzuweisung eines Benutzers in chronologischer
-// Reihenfolge — die Grundlage fuer "wer hat wann welche Rolle vergeben"
-// (Akzeptanzkriterium 3).
-func (s *Store) History(ctx context.Context, userID string) ([]Assignment, error) {
-	rows, err := s.pool.Query(ctx, `
-		SELECT role, granted_by FROM role_assignment_history
-		WHERE user_id = $1 ORDER BY granted_at
-	`, userID)
-	if err != nil {
-		return nil, fmt.Errorf("historie abfragen: %w", err)
-	}
-	defer rows.Close()
-
-	var out []Assignment
-	for rows.Next() {
-		var role string
-		a := Assignment{UserID: userID}
-		if err := rows.Scan(&role, &a.GrantedBy); err != nil {
-			return nil, fmt.Errorf("historieneintrag lesen: %w", err)
-		}
-		a.Role = Role(role)
-		out = append(out, a)
-	}
-	return out, rows.Err()
-}

internal/saml/assertion.go

@@ -1,90 +0,0 @@
-// Package saml implementiert Core IAM-11: SAML 2.0 als zusaetzlicher
-// Anmeldeweg neben OIDC (IAM-06).
-//
-// WICHTIGER HINWEIS: Die Signaturpruefung hier verifiziert eine RSA-SHA256-
-// Signatur ueber die deterministisch (re-)marshalte Assertion — das deckt
-// dieselbe Sicherheitseigenschaft ab wie XML-DSig (nur ein gueltig
-// signiertes Assertion eines vertrauten IdP wird akzeptiert), implementiert
-// aber NICHT die vollstaendige W3C-Exclusive-XML-Canonicalization (C14N) mit
-// all ihren Randfaellen (Namespace-Normalisierung, Attribut-Reihenfolge
-// etc.), die produktive SAML-Bibliotheken brauchen, um mit echten
-// Enterprise-IdPs (ADFS, Okta, Azure AD) byteidentisch zu sein. Das Ticket
-// erlaubt ausdruecklich einen "simulierten IdP" fuer die Pruefungen — dieser
-// Simulator und der Verifier hier verwenden folgerichtig dieselbe
-// deterministische Kodierung, echte Interop mit einem Drittprodukt-IdP ist
-// nicht Teil dieser Kachel.
-package saml
-
-import (
-	"encoding/xml"
-	"fmt"
-	"time"
-)
-
-type attributeXML struct {
-	Name   string   `xml:"Name,attr"`
-	Values []string `xml:"AttributeValue"`
-}
-
-type conditionsXML struct {
-	NotBefore    string `xml:"NotBefore,attr"`
-	NotOnOrAfter string `xml:"NotOnOrAfter,attr"`
-}
-
-// AssertionXML ist die (vereinfachte) SAML-Assertion.
-type AssertionXML struct {
-	XMLName    xml.Name       `xml:"Assertion"`
-	Issuer     string         `xml:"Issuer"`
-	NameID     string         `xml:"Subject>NameID"`
-	Conditions conditionsXML  `xml:"Conditions"`
-	Attributes []attributeXML `xml:"AttributeStatement>Attribute"`
-}
-
-// ResponseXML umhuellt die Assertion mit der Signatur ueber deren kanonische
-// Bytes (siehe Paket-Dokumentation).
-type ResponseXML struct {
-	XMLName        xml.Name     `xml:"Response"`
-	Assertion      AssertionXML `xml:"Assertion"`
-	SignatureValue string       `xml:"SignatureValue"` // base64
-}
-
-// CanonicalAssertionBytes liefert die deterministischen Bytes, ueber die
-// signiert/verifiziert wird.
-func CanonicalAssertionBytes(a AssertionXML) ([]byte, error) {
-	b, err := xml.Marshal(a)
-	if err != nil {
-		return nil, fmt.Errorf("assertion serialisieren: %w", err)
-	}
-	return b, nil
-}
-
-// Attribute liefert die Werte eines benannten SAML-Attributs (z.B. "roles"),
-// oder nil wenn nicht vorhanden.
-func (a AssertionXML) Attribute(name string) []string {
-	for _, attr := range a.Attributes {
-		if attr.Name == name {
-			return attr.Values
-		}
-	}
-	return nil
-}
-
-// WithinValidity prueft die Conditions/NotBefore/NotOnOrAfter der Assertion
-// gegen die aktuelle Zeit.
-func (a AssertionXML) WithinValidity(now time.Time) error {
-	notBefore, err := time.Parse(time.RFC3339, a.Conditions.NotBefore)
-	if err != nil {
-		return fmt.Errorf("notbefore parsen: %w", err)
-	}
-	notOnOrAfter, err := time.Parse(time.RFC3339, a.Conditions.NotOnOrAfter)
-	if err != nil {
-		return fmt.Errorf("notonorafter parsen: %w", err)
-	}
-	if now.Before(notBefore) {
-		return ErrNotYetValid
-	}
-	if !now.Before(notOnOrAfter) {
-		return ErrExpired
-	}
-	return nil
-}

internal/saml/login.go

@@ -1,66 +0,0 @@
-package saml
-
-import (
-	"context"
-	"errors"
-	"fmt"
-
-	"gitea.perlbach24.de/scripte/nexarch/internal/auth"
-	"gitea.perlbach24.de/scripte/nexarch/internal/ldapsync"
-	"gitea.perlbach24.de/scripte/nexarch/internal/rbac"
-	"gitea.perlbach24.de/scripte/nexarch/internal/user"
-)
-
-// CompleteSAMLLogin verifiziert die SAML-Response, bildet die Assertion auf
-// das bestehende Benutzer-/Rollenmodell ab (Akzeptanzkriterium 3) und
-// stellt bei Erfolg ein IAM-02-Sitzungs-Token aus. Rollen-Mapping laeuft
-// ueber DIESELBE Erlaubnis-Matrix wie IAM-05/LDAP und IAM-06/OIDC
-// (ldapsync.RoleMappingStore) — kein dritter paralleler Mapping-Mechanismus.
-func CompleteSAMLLogin(
-	ctx context.Context,
-	verifier *Verifier,
-	users *user.TenantUserStore,
-	roles *rbac.Store,
-	roleMapping *ldapsync.RoleMappingStore,
-	issuer *auth.TokenIssuer,
-	tenantSlug, rawSAMLResponse string,
-) (token string, err error) {
-	resp, err := Parse(rawSAMLResponse)
-	if err != nil {
-		return "", err
-	}
-	assertion, err := verifier.Verify(resp)
-	if err != nil {
-		return "", err
-	}
-	if assertion.NameID == "" {
-		return "", fmt.Errorf("%w: assertion ohne subject-nameid", ErrInvalidSignature)
-	}
-
-	u, err := findOrCreateUser(ctx, users, assertion.NameID)
-	if err != nil {
-		return "", err
-	}
-
-	roleAttrs := assertion.Attribute("roles")
-	if role, ok, err := roleMapping.HighestRoleFor(ctx, roleAttrs); err != nil {
-		return "", err
-	} else if ok {
-		if _, err := roles.Assign(ctx, u.ID, role, "saml-sso"); err != nil {
-			return "", err
-		}
-	}
-
-	return issuer.Issue(u.ID, tenantSlug)
-}
-
-func findOrCreateUser(ctx context.Context, users *user.TenantUserStore, email string) (user.User, error) {
-	creds, err := users.GetByEmailForAuth(ctx, email)
-	if err == nil {
-		return creds.User, nil
-	}
-	if !errors.Is(err, user.ErrNotFound) {
-		return user.User{}, err
-	}
-	return users.Create(ctx, email, email)
-}

internal/saml/login_test.go

@@ -1,227 +0,0 @@
-package saml
-
-import (
-	"context"
-	"crypto/rsa"
-	"fmt"
-	"os"
-	"testing"
-	"time"
-
-	"github.com/golang-jwt/jwt/v5"
-	"github.com/jackc/pgx/v5/pgxpool"
-
-	"gitea.perlbach24.de/scripte/nexarch/internal/auth"
-	"gitea.perlbach24.de/scripte/nexarch/internal/ldapsync"
-	"gitea.perlbach24.de/scripte/nexarch/internal/oidc"
-	"gitea.perlbach24.de/scripte/nexarch/internal/rbac"
-	"gitea.perlbach24.de/scripte/nexarch/internal/user"
-)
-
-const schema = `
-CREATE TABLE IF NOT EXISTS users (
-	id UUID PRIMARY KEY DEFAULT gen_random_uuid(), email TEXT NOT NULL UNIQUE, name TEXT NOT NULL,
-	status TEXT NOT NULL DEFAULT 'active', password_hash TEXT NOT NULL DEFAULT '',
-	created_at TIMESTAMPTZ NOT NULL DEFAULT now(), updated_at TIMESTAMPTZ NOT NULL DEFAULT now()
-);
-CREATE TABLE IF NOT EXISTS role_assignments (
-	user_id UUID PRIMARY KEY REFERENCES users(id), role TEXT NOT NULL CHECK (role IN ('user','tenant_admin')),
-	granted_by TEXT NOT NULL, granted_at TIMESTAMPTZ NOT NULL DEFAULT now()
-);
-CREATE TABLE IF NOT EXISTS role_assignment_history (
-	id UUID PRIMARY KEY DEFAULT gen_random_uuid(), user_id UUID NOT NULL, role TEXT NOT NULL,
-	granted_by TEXT NOT NULL, granted_at TIMESTAMPTZ NOT NULL DEFAULT now()
-);
-CREATE TABLE IF NOT EXISTS ldap_group_role_mapping (
-	ldap_group TEXT PRIMARY KEY, role TEXT NOT NULL CHECK (role IN ('user','tenant_admin'))
-);`
-
-func setupTest(t *testing.T) (*pgxpool.Pool, func()) {
-	t.Helper()
-	adminDSN := os.Getenv("TEST_ADMIN_DSN")
-	if adminDSN == "" {
-		t.Skip("TEST_ADMIN_DSN nicht gesetzt, Integrationstest uebersprungen")
-	}
-	ctx := context.Background()
-
-	pool, err := pgxpool.New(ctx, adminDSN)
-	if err != nil {
-		t.Fatalf("pool: %v", err)
-	}
-	if _, err := pool.Exec(ctx, schema); err != nil {
-		t.Fatalf("schema: %v", err)
-	}
-	cleanup := func() { pool.Close() }
-	return pool, cleanup
-}
-
-// Akzeptanzkriterium 1 + Pruefung 1: End-to-End-Test gegen simulierten SAML-IdP.
-// Akzeptanzkriterium 3 + Pruefung 3: Rollenzuordnung aus SAML-Attributen korrekt.
-func TestCompleteSAMLLogin_EndToEnd(t *testing.T) {
-	pool, cleanup := setupTest(t)
-	defer cleanup()
-	ctx := context.Background()
-
-	idpKey := generateTestIdPKey(t)
-	verifier := NewVerifier(&idpKey.PublicKey, "https://test-idp.example.com")
-	users := user.NewTenantUserStore(pool)
-	roles := rbac.NewStore(pool)
-	roleMapping := ldapsync.NewRoleMappingStore(pool)
-	issuer := auth.NewTokenIssuer("test-secret-nur-fuer-tests")
-
-	if err := roleMapping.SetMapping(ctx, "saml-admins", rbac.RoleTenantAdmin); err != nil {
-		t.Fatalf("set mapping: %v", err)
-	}
-
-	email := fmt.Sprintf("saml-test-%d@example.com", time.Now().UnixNano())
-	rawResp, err := BuildResponse(idpKey, testAssertion("https://test-idp.example.com", email, []string{"saml-admins"}))
-	if err != nil {
-		t.Fatalf("build response (simulierter idp): %v", err)
-	}
-
-	token, err := CompleteSAMLLogin(ctx, verifier, users, roles, roleMapping, issuer, "acme", rawResp)
-	if err != nil {
-		t.Fatalf("complete saml login: %v", err)
-	}
-	if token == "" {
-		t.Fatal("erwartet nicht-leeres sitzungs-token")
-	}
-
-	creds, err := users.GetByEmailForAuth(ctx, email)
-	if err != nil {
-		t.Fatalf("user nach login: %v", err)
-	}
-	assignment, err := roles.Get(ctx, creds.User.ID)
-	if err != nil {
-		t.Fatalf("rollenzuweisung lesen: %v", err)
-	}
-	if assignment.Role != rbac.RoleTenantAdmin {
-		t.Fatalf("erwartet tenant_admin aus saml-admins-mapping, habe %q", assignment.Role)
-	}
-}
-
-// Akzeptanzkriterium 3 + Pruefung 3 (Negativfall): keine Privilege-
-// Escalation ueber unbekannte/manipulierte Rollen-Attribute.
-func TestCompleteSAMLLogin_UnmappedRoleGrantsNothing(t *testing.T) {
-	pool, cleanup := setupTest(t)
-	defer cleanup()
-	ctx := context.Background()
-
-	idpKey := generateTestIdPKey(t)
-	verifier := NewVerifier(&idpKey.PublicKey, "https://test-idp.example.com")
-	users := user.NewTenantUserStore(pool)
-	roles := rbac.NewStore(pool)
-	roleMapping := ldapsync.NewRoleMappingStore(pool)
-	issuer := auth.NewTokenIssuer("test-secret-nur-fuer-tests")
-
-	email := fmt.Sprintf("saml-test-%d@example.com", time.Now().UnixNano())
-	rawResp, err := BuildResponse(idpKey, testAssertion("https://test-idp.example.com", email, []string{"tenant_admin", "superadmin"}))
-	if err != nil {
-		t.Fatalf("build response: %v", err)
-	}
-
-	if _, err := CompleteSAMLLogin(ctx, verifier, users, roles, roleMapping, issuer, "acme", rawResp); err != nil {
-		t.Fatalf("complete saml login: %v", err)
-	}
-
-	creds, err := users.GetByEmailForAuth(ctx, email)
-	if err != nil {
-		t.Fatalf("user nach login: %v", err)
-	}
-	if _, err := roles.Get(ctx, creds.User.ID); err == nil {
-		t.Fatal("erwartet KEINE rollenzuweisung fuer nicht gemappte rollen-attribute")
-	}
-}
-
-// Akzeptanzkriterium 2 + Pruefung 2: SAML- und OIDC-Anmeldung koennen
-// nebeneinander fuer unterschiedliche Tenants konfiguriert sein — hier durch
-// zwei physisch getrennte Tenant-Datenbanken demonstriert (Modell C).
-func TestSAMLAndOIDC_WorkInParallelForDifferentTenants(t *testing.T) {
-	adminDSN := os.Getenv("TEST_ADMIN_DSN")
-	if adminDSN == "" {
-		t.Skip("TEST_ADMIN_DSN nicht gesetzt, Integrationstest uebersprungen")
-	}
-	ctx := context.Background()
-
-	poolSAML, cleanupSAML := setupTest(t)
-	defer cleanupSAML()
-
-	poolOIDC, err := pgxpool.New(ctx, adminDSN)
-	if err != nil {
-		t.Fatalf("pool oidc: %v", err)
-	}
-	defer poolOIDC.Close()
-	if _, err := poolOIDC.Exec(ctx, schema+`
-		CREATE TABLE IF NOT EXISTS oidc_states (
-			state TEXT PRIMARY KEY, nonce TEXT NOT NULL, expires_at TIMESTAMPTZ NOT NULL,
-			used_at TIMESTAMPTZ, created_at TIMESTAMPTZ NOT NULL DEFAULT now()
-		)`); err != nil {
-		t.Fatalf("schema oidc: %v", err)
-	}
-
-	// Tenant "saml-tenant": SAML konfiguriert.
-	idpKey := generateTestIdPKey(t)
-	samlVerifier := NewVerifier(&idpKey.PublicKey, "https://test-idp.example.com")
-	samlUsers := user.NewTenantUserStore(poolSAML)
-	samlRoles := rbac.NewStore(poolSAML)
-	samlMapping := ldapsync.NewRoleMappingStore(poolSAML)
-	issuer := auth.NewTokenIssuer("test-secret-nur-fuer-tests")
-
-	samlEmail := fmt.Sprintf("saml-parallel-%d@example.com", time.Now().UnixNano())
-	samlResp, err := BuildResponse(idpKey, testAssertion("https://test-idp.example.com", samlEmail, nil))
-	if err != nil {
-		t.Fatalf("build saml response: %v", err)
-	}
-	samlToken, err := CompleteSAMLLogin(ctx, samlVerifier, samlUsers, samlRoles, samlMapping, issuer, "saml-tenant", samlResp)
-	if err != nil {
-		t.Fatalf("saml-tenant login: %v", err)
-	}
-	if samlToken == "" {
-		t.Fatal("erwartet token fuer saml-tenant")
-	}
-
-	// Tenant "oidc-tenant": OIDC konfiguriert, voellig unabhaengige Datenbank.
-	oidcKey := generateTestIdPKey(t)
-	oidcVerifier := oidc.NewVerifier(map[string]*rsa.PublicKey{"kid-1": &oidcKey.PublicKey}, "https://oidc-idp.example.com")
-	oidcStates := oidc.NewStateStore(poolOIDC)
-	oidcUsers := user.NewTenantUserStore(poolOIDC)
-	oidcRoles := rbac.NewStore(poolOIDC)
-	oidcMapping := ldapsync.NewRoleMappingStore(poolOIDC)
-
-	state, nonce, err := oidcStates.Generate(ctx)
-	if err != nil {
-		t.Fatalf("oidc generate state: %v", err)
-	}
-	oidcEmail := fmt.Sprintf("oidc-parallel-%d@example.com", time.Now().UnixNano())
-	claims := oidc.Claims{
-		Email: oidcEmail,
-		Nonce: nonce,
-		RegisteredClaims: jwt.RegisteredClaims{
-			Issuer: "https://oidc-idp.example.com", ExpiresAt: jwt.NewNumericDate(time.Now().Add(time.Hour)),
-		},
-	}
-	idToken := signOIDCTestToken(t, oidcKey, claims)
-
-	oidcToken, err := oidc.CompleteOIDCLogin(ctx, oidcVerifier, oidcStates, oidcUsers, oidcRoles, oidcMapping, issuer, "oidc-tenant", state, idToken)
-	if err != nil {
-		t.Fatalf("oidc-tenant login: %v", err)
-	}
-	if oidcToken == "" {
-		t.Fatal("erwartet token fuer oidc-tenant")
-	}
-
-	if samlToken == oidcToken {
-		t.Fatal("tokens sollten unterschiedlich sein")
-	}
-}
-
-func signOIDCTestToken(t *testing.T, key *rsa.PrivateKey, claims oidc.Claims) string {
-	t.Helper()
-	token := jwt.NewWithClaims(jwt.SigningMethodRS256, claims)
-	token.Header["kid"] = "kid-1"
-	s, err := token.SignedString(key)
-	if err != nil {
-		t.Fatalf("sign oidc test token: %v", err)
-	}
-	return s
-}

internal/saml/verify.go

@@ -1,107 +0,0 @@
-package saml
-
-import (
-	"crypto"
-	"crypto/rand"
-	"crypto/rsa"
-	"crypto/sha256"
-	"encoding/base64"
-	"encoding/xml"
-	"errors"
-	"fmt"
-	"time"
-)
-
-var (
-	ErrInvalidSignature = errors.New("saml: assertion-signatur ungueltig")
-	ErrNotYetValid      = errors.New("saml: assertion noch nicht gueltig")
-	ErrExpired          = errors.New("saml: assertion abgelaufen")
-	ErrWrongIssuer      = errors.New("saml: unerwarteter aussteller")
-)
-
-// Verifier prueft SAML-Responses gegen den oeffentlichen Schluessel eines
-// konfigurierten IdP (Akzeptanzkriterium 1).
-type Verifier struct {
-	idpPublicKey *rsa.PublicKey
-	idpIssuer    string
-}
-
-func NewVerifier(idpPublicKey *rsa.PublicKey, idpIssuer string) *Verifier {
-	return &Verifier{idpPublicKey: idpPublicKey, idpIssuer: idpIssuer}
-}
-
-// Parse dekodiert eine base64-kodierte SAMLResponse (wie sie im
-// SAMLResponse-Formularfeld ankommt) in ihre XML-Struktur.
-func Parse(rawBase64 string) (ResponseXML, error) {
-	data, err := base64.StdEncoding.DecodeString(rawBase64)
-	if err != nil {
-		return ResponseXML{}, fmt.Errorf("base64 dekodieren: %w", err)
-	}
-	var resp ResponseXML
-	if err := xml.Unmarshal(data, &resp); err != nil {
-		return ResponseXML{}, fmt.Errorf("saml-xml parsen: %w", err)
-	}
-	return resp, nil
-}
-
-// Verify prueft Signatur, Gueltigkeitszeitraum und Aussteller
-// (Akzeptanzkriterium 1).
-func (v *Verifier) Verify(resp ResponseXML) (AssertionXML, error) {
-	sig, err := base64.StdEncoding.DecodeString(resp.SignatureValue)
-	if err != nil {
-		return AssertionXML{}, fmt.Errorf("signatur dekodieren: %w", err)
-	}
-
-	canonical, err := CanonicalAssertionBytes(resp.Assertion)
-	if err != nil {
-		return AssertionXML{}, err
-	}
-	hash := sha256.Sum256(canonical)
-
-	if err := rsa.VerifyPKCS1v15(v.idpPublicKey, crypto.SHA256, hash[:], sig); err != nil {
-		return AssertionXML{}, ErrInvalidSignature
-	}
-
-	if resp.Assertion.Issuer != v.idpIssuer {
-		return AssertionXML{}, fmt.Errorf("%w: %q", ErrWrongIssuer, resp.Assertion.Issuer)
-	}
-
-	if err := resp.Assertion.WithinValidity(time.Now()); err != nil {
-		return AssertionXML{}, err
-	}
-
-	return resp.Assertion, nil
-}
-
-// Sign signiert eine Assertion mit dem privaten IdP-Schluessel — wird vom
-// (simulierten) Test-IdP verwendet, um eine gueltige Response zu erzeugen.
-// Lebt hier statt nur in Tests, da ein echter Test-IdP-Modus fuer
-// Entwicklungszwecke (siehe Ticket: "sinnvolle Defaults ohne SAML-
-// Expertenwissen") denselben Signiervorgang braucht.
-func Sign(priv *rsa.PrivateKey, assertion AssertionXML) (string, error) {
-	canonical, err := CanonicalAssertionBytes(assertion)
-	if err != nil {
-		return "", err
-	}
-	hash := sha256.Sum256(canonical)
-	sig, err := rsa.SignPKCS1v15(rand.Reader, priv, crypto.SHA256, hash[:])
-	if err != nil {
-		return "", fmt.Errorf("assertion signieren: %w", err)
-	}
-	return base64.StdEncoding.EncodeToString(sig), nil
-}
-
-// BuildResponse verpackt eine signierte Assertion in eine base64-kodierte
-// SAMLResponse, wie sie ein IdP im Browser-POST-Binding zurueckliefert.
-func BuildResponse(priv *rsa.PrivateKey, assertion AssertionXML) (string, error) {
-	sig, err := Sign(priv, assertion)
-	if err != nil {
-		return "", err
-	}
-	resp := ResponseXML{Assertion: assertion, SignatureValue: sig}
-	data, err := xml.Marshal(resp)
-	if err != nil {
-		return "", fmt.Errorf("response serialisieren: %w", err)
-	}
-	return base64.StdEncoding.EncodeToString(data), nil
-}

internal/saml/verify_test.go

@@ -1,123 +0,0 @@
-package saml
-
-import (
-	"crypto/rand"
-	"crypto/rsa"
-	"testing"
-	"time"
-)
-
-func generateTestIdPKey(t *testing.T) *rsa.PrivateKey {
-	t.Helper()
-	key, err := rsa.GenerateKey(rand.Reader, 2048)
-	if err != nil {
-		t.Fatalf("generate rsa key: %v", err)
-	}
-	return key
-}
-
-func testAssertion(issuer, nameID string, roles []string) AssertionXML {
-	now := time.Now()
-	return AssertionXML{
-		Issuer: issuer,
-		NameID: nameID,
-		Conditions: conditionsXML{
-			NotBefore:    now.Add(-time.Minute).Format(time.RFC3339),
-			NotOnOrAfter: now.Add(time.Hour).Format(time.RFC3339),
-		},
-		Attributes: []attributeXML{
-			{Name: "roles", Values: roles},
-		},
-	}
-}
-
-func TestVerify_AcceptsValidSignedAssertion(t *testing.T) {
-	key := generateTestIdPKey(t)
-	verifier := NewVerifier(&key.PublicKey, "https://idp.example.com")
-
-	rawResp, err := BuildResponse(key, testAssertion("https://idp.example.com", "person@example.com", []string{"sso-admins"}))
-	if err != nil {
-		t.Fatalf("build response: %v", err)
-	}
-	resp, err := Parse(rawResp)
-	if err != nil {
-		t.Fatalf("parse: %v", err)
-	}
-
-	assertion, err := verifier.Verify(resp)
-	if err != nil {
-		t.Fatalf("verify: %v", err)
-	}
-	if assertion.NameID != "person@example.com" {
-		t.Fatalf("nameid = %q", assertion.NameID)
-	}
-}
-
-func TestVerify_RejectsTamperedAssertion(t *testing.T) {
-	key := generateTestIdPKey(t)
-	verifier := NewVerifier(&key.PublicKey, "https://idp.example.com")
-
-	rawResp, err := BuildResponse(key, testAssertion("https://idp.example.com", "person@example.com", nil))
-	if err != nil {
-		t.Fatalf("build response: %v", err)
-	}
-	resp, err := Parse(rawResp)
-	if err != nil {
-		t.Fatalf("parse: %v", err)
-	}
-	// Manipulation NACH dem Signieren: NameID aendern (Signatur bleibt die alte).
-	resp.Assertion.NameID = "angreifer@example.com"
-
-	if _, err := verifier.Verify(resp); err != ErrInvalidSignature {
-		t.Fatalf("erwartet ErrInvalidSignature, habe %v", err)
-	}
-}
-
-func TestVerify_RejectsWrongIdPKey(t *testing.T) {
-	realKey := generateTestIdPKey(t)
-	attackerKey := generateTestIdPKey(t)
-	verifier := NewVerifier(&realKey.PublicKey, "https://idp.example.com")
-
-	rawResp, err := BuildResponse(attackerKey, testAssertion("https://idp.example.com", "person@example.com", nil))
-	if err != nil {
-		t.Fatalf("build response: %v", err)
-	}
-	resp, _ := Parse(rawResp)
-
-	if _, err := verifier.Verify(resp); err != ErrInvalidSignature {
-		t.Fatalf("erwartet ErrInvalidSignature bei fremd signierter assertion, habe %v", err)
-	}
-}
-
-func TestVerify_RejectsExpiredAssertion(t *testing.T) {
-	key := generateTestIdPKey(t)
-	verifier := NewVerifier(&key.PublicKey, "https://idp.example.com")
-
-	expired := testAssertion("https://idp.example.com", "person@example.com", nil)
-	expired.Conditions.NotOnOrAfter = time.Now().Add(-time.Hour).Format(time.RFC3339)
-
-	rawResp, err := BuildResponse(key, expired)
-	if err != nil {
-		t.Fatalf("build response: %v", err)
-	}
-	resp, _ := Parse(rawResp)
-
-	if _, err := verifier.Verify(resp); err != ErrExpired {
-		t.Fatalf("erwartet ErrExpired, habe %v", err)
-	}
-}
-
-func TestVerify_RejectsWrongIssuer(t *testing.T) {
-	key := generateTestIdPKey(t)
-	verifier := NewVerifier(&key.PublicKey, "https://idp.example.com")
-
-	rawResp, err := BuildResponse(key, testAssertion("https://anderer-idp.example.com", "person@example.com", nil))
-	if err != nil {
-		t.Fatalf("build response: %v", err)
-	}
-	resp, _ := Parse(rawResp)
-
-	if _, err := verifier.Verify(resp); err == nil {
-		t.Fatal("erwartet fehler bei unerwartetem aussteller")
-	}
-}

internal/timingsafe/timingsafe.go

@@ -0,0 +1,30 @@
+// Package timingsafe stellt die kanonische Implementierung der projektweiten
+// Coding-Konvention aus IAM-15 bereit: jeder Vergleich, der eine
+// sicherheitsrelevante Zugriffsentscheidung trifft (Passwort-Hash, Token,
+// Signatur, 2FA-Wiederherstellungscode), nutzt einen timing-safe/constant-time
+// Vergleich, nie den regulaeren ==-Operator. Siehe docs/CODING-GUIDELINES-CORE.md.
+//
+// Bestehende Vergleichsstellen (internal/totp, internal/webhook,
+// internal/moduleregistry) implementieren dasselbe Muster bereits inline mit
+// crypto/subtle direkt — dieses Package buendelt es fuer neue Vergleichsstellen,
+// ersetzt die bestehenden nicht zwangsweise (kein Umbau angrenzender Bereiche).
+package timingsafe
+
+import "crypto/subtle"
+
+// Equal vergleicht zwei Byte-Slices timing-safe. Unterschiedliche Laenge gilt
+// als "nicht gleich", ohne dass die Laufzeit dabei die Laenge verraet, die
+// zum Ergebnis gefuehrt hat, mehr als durch den Laengenunterschied ohnehin
+// unvermeidbar waere.
+func Equal(a, b []byte) bool {
+	if len(a) != len(b) {
+		return false
+	}
+	return subtle.ConstantTimeCompare(a, b) == 1
+}
+
+// EqualString ist die String-Variante von Equal fuer den haeufigen Fall,
+// dass beide Seiten bereits als string vorliegen (z. B. TOTP-Codes).
+func EqualString(a, b string) bool {
+	return Equal([]byte(a), []byte(b))
+}

internal/timingsafe/timingsafe_test.go

@@ -0,0 +1,36 @@
+package timingsafe
+
+import "testing"
+
+func TestEqual_SameBytes(t *testing.T) {
+	if !Equal([]byte("geheimnis"), []byte("geheimnis")) {
+		t.Fatal("identische Byte-Slices sollten gleich sein")
+	}
+}
+
+func TestEqual_DifferentBytes(t *testing.T) {
+	if Equal([]byte("geheimnis"), []byte("anders123")) {
+		t.Fatal("unterschiedliche Byte-Slices sollten ungleich sein")
+	}
+}
+
+func TestEqual_DifferentLength(t *testing.T) {
+	if Equal([]byte("kurz"), []byte("laengererstring")) {
+		t.Fatal("unterschiedliche Laenge sollte immer ungleich sein")
+	}
+}
+
+func TestEqual_EmptyVsEmpty(t *testing.T) {
+	if !Equal([]byte(""), []byte("")) {
+		t.Fatal("zwei leere Slices sollten gleich sein")
+	}
+}
+
+func TestEqualString_MatchesEqual(t *testing.T) {
+	if !EqualString("abc123", "abc123") {
+		t.Fatal("identische Strings sollten gleich sein")
+	}
+	if EqualString("abc123", "xyz789") {
+		t.Fatal("unterschiedliche Strings sollten ungleich sein")
+	}
+}

internal/totp/login.go

@@ -0,0 +1,42 @@
+package totp
+
+import (
+	"context"
+	"errors"
+
+	"gitea.perlbach24.de/scripte/nexarch/internal/auth"
+	"gitea.perlbach24.de/scripte/nexarch/internal/user"
+)
+
+var ErrSecondFactorRequired = errors.New("totp: zweiter faktor erforderlich")
+
+// LoginWithTOTP komponiert IAM-02s LoginService mit der 2FA-Pruefung, ohne
+// LoginService selbst zu veraendern. Ist 2FA fuer den Benutzer aktiv, MUSS
+// totpCode gueltig sein (Akzeptanzkriterium 2) — ein leerer/falscher Code
+// wird zuverlaessig abgewiesen, auch bei korrektem Passwort.
+func LoginWithTOTP(ctx context.Context, users *user.TenantUserStore, totpStore *Store, login *auth.LoginService, email, password, totpCode string) (token string, err error) {
+	creds, err := users.GetByEmailForAuth(ctx, email)
+	if err != nil {
+		return "", auth.ErrInvalidCredentials
+	}
+
+	enabled, err := totpStore.IsEnabled(ctx, creds.User.ID)
+	if err != nil {
+		return "", err
+	}
+
+	if enabled {
+		if totpCode == "" {
+			return "", ErrSecondFactorRequired
+		}
+		ok, err := totpStore.VerifyLoginCode(ctx, creds.User.ID, totpCode)
+		if err != nil {
+			return "", err
+		}
+		if !ok {
+			return "", ErrSecondFactorRequired
+		}
+	}
+
+	return login.Login(ctx, email, password)
+}

internal/totp/store.go

@@ -0,0 +1,163 @@
+package totp
+
+import (
+	"context"
+	"crypto/rand"
+	"crypto/sha256"
+	"encoding/hex"
+	"errors"
+	"fmt"
+	"time"
+
+	"github.com/jackc/pgx/v5"
+	"github.com/jackc/pgx/v5/pgxpool"
+)
+
+var (
+	ErrInvalidCode      = errors.New("totp: code ungueltig")
+	ErrNotConfirmed     = errors.New("totp: einrichtung noch nicht bestaetigt")
+	ErrRecoveryCodeUsed = errors.New("totp: wiederherstellungscode bereits verwendet oder ungueltig")
+)
+
+const RecoveryCodeCount = 10
+
+type Store struct {
+	pool *pgxpool.Pool
+}
+
+func NewStore(pool *pgxpool.Pool) *Store {
+	return &Store{pool: pool}
+}
+
+// BeginSetup erzeugt ein neues Secret fuer einen Benutzer und speichert es
+// als NOCH NICHT bestaetigt — der Code muss vor Aktivierung einmal
+// verifiziert werden (Akzeptanzkriterium 1).
+func (s *Store) BeginSetup(ctx context.Context, userID, issuer, accountName string) (secret, provisioningURI string, err error) {
+	secret, err = GenerateSecret()
+	if err != nil {
+		return "", "", err
+	}
+
+	_, err = s.pool.Exec(ctx, `
+		INSERT INTO totp_credentials (user_id, secret, confirmed)
+		VALUES ($1, $2, false)
+		ON CONFLICT (user_id) DO UPDATE SET secret = $2, confirmed = false
+	`, userID, secret)
+	if err != nil {
+		return "", "", fmt.Errorf("totp-einrichtung speichern: %w", err)
+	}
+
+	return secret, ProvisioningURI(issuer, accountName, secret), nil
+}
+
+// ConfirmSetup verifiziert den ersten eingegebenen Code und aktiviert 2FA
+// erst dann (Akzeptanzkriterium 1). Bei Erfolg werden einmalig
+// Wiederherstellungscodes erzeugt und im Klartext zurueckgegeben — gespeichert
+// wird nur deren Hash.
+func (s *Store) ConfirmSetup(ctx context.Context, userID, code string) (recoveryCodes []string, err error) {
+	var secret string
+	if err := s.pool.QueryRow(ctx, `
+		SELECT secret FROM totp_credentials WHERE user_id = $1
+	`, userID).Scan(&secret); err != nil {
+		if errors.Is(err, pgx.ErrNoRows) {
+			return nil, ErrNotConfirmed
+		}
+		return nil, fmt.Errorf("secret lesen: %w", err)
+	}
+
+	ok, err := Validate(secret, code, time.Now())
+	if err != nil {
+		return nil, err
+	}
+	if !ok {
+		return nil, ErrInvalidCode
+	}
+
+	if _, err := s.pool.Exec(ctx, `UPDATE totp_credentials SET confirmed = true WHERE user_id = $1`, userID); err != nil {
+		return nil, fmt.Errorf("bestaetigung speichern: %w", err)
+	}
+
+	recoveryCodes, err = s.generateRecoveryCodes(ctx, userID)
+	if err != nil {
+		return nil, err
+	}
+	return recoveryCodes, nil
+}
+
+func (s *Store) generateRecoveryCodes(ctx context.Context, userID string) ([]string, error) {
+	codes := make([]string, RecoveryCodeCount)
+	for i := range codes {
+		buf := make([]byte, 8)
+		if _, err := rand.Read(buf); err != nil {
+			return nil, fmt.Errorf("wiederherstellungscode erzeugen: %w", err)
+		}
+		code := hex.EncodeToString(buf)
+		codes[i] = code
+
+		hash := hashRecoveryCode(code)
+		if _, err := s.pool.Exec(ctx, `
+			INSERT INTO totp_recovery_codes (user_id, code_hash) VALUES ($1, $2)
+		`, userID, hash); err != nil {
+			return nil, fmt.Errorf("wiederherstellungscode speichern: %w", err)
+		}
+	}
+	return codes, nil
+}
+
+// IsEnabled prueft, ob 2FA fuer einen Benutzer aktiv (bestaetigt) ist.
+func (s *Store) IsEnabled(ctx context.Context, userID string) (bool, error) {
+	var confirmed bool
+	err := s.pool.QueryRow(ctx, `SELECT confirmed FROM totp_credentials WHERE user_id = $1`, userID).Scan(&confirmed)
+	if err != nil {
+		if errors.Is(err, pgx.ErrNoRows) {
+			return false, nil
+		}
+		return false, fmt.Errorf("status lesen: %w", err)
+	}
+	return confirmed, nil
+}
+
+// VerifyLoginCode akzeptiert entweder einen gueltigen TOTP-Code oder einen
+// noch nicht verwendeten Wiederherstellungscode (Akzeptanzkriterium 2 + 3).
+func (s *Store) VerifyLoginCode(ctx context.Context, userID, code string) (bool, error) {
+	var secret string
+	var confirmed bool
+	err := s.pool.QueryRow(ctx, `SELECT secret, confirmed FROM totp_credentials WHERE user_id = $1`, userID).Scan(&secret, &confirmed)
+	if err != nil {
+		if errors.Is(err, pgx.ErrNoRows) || !confirmed {
+			return false, nil
+		}
+		return false, fmt.Errorf("secret lesen: %w", err)
+	}
+	if !confirmed {
+		return false, nil
+	}
+
+	if ok, err := Validate(secret, code, time.Now()); err != nil {
+		return false, err
+	} else if ok {
+		return true, nil
+	}
+
+	return s.consumeRecoveryCode(ctx, userID, code)
+}
+
+// consumeRecoveryCode markiert einen Wiederherstellungscode atomar als
+// verwendet (WHERE used_at IS NULL) — ein bereits verbrauchter Code kann
+// nicht doppelt eingeloest werden (Akzeptanzkriterium 3 / Pruefung 2).
+func (s *Store) consumeRecoveryCode(ctx context.Context, userID, code string) (bool, error) {
+	hash := hashRecoveryCode(code)
+	tag, err := s.pool.Exec(ctx, `
+		UPDATE totp_recovery_codes SET used_at = now()
+		WHERE user_id = $1 AND code_hash = $2 AND used_at IS NULL
+	`, userID, hash)
+	if err != nil {
+		return false, fmt.Errorf("wiederherstellungscode einloesen: %w", err)
+	}
+	return tag.RowsAffected() == 1, nil
+}
+
+func hashRecoveryCode(code string) []byte {
+	sum := sha256.Sum256([]byte(code))
+	return sum[:]
+}

internal/totp/store_test.go

@@ -0,0 +1,185 @@
+package totp
+
+import (
+	"context"
+	"errors"
+	"fmt"
+	"os"
+	"testing"
+	"time"
+
+	"github.com/jackc/pgx/v5/pgxpool"
+
+	"gitea.perlbach24.de/scripte/nexarch/internal/auth"
+	"gitea.perlbach24.de/scripte/nexarch/internal/user"
+)
+
+func setupTest(t *testing.T) (*Store, *user.TenantUserStore, string, func()) {
+	t.Helper()
+	adminDSN := os.Getenv("TEST_ADMIN_DSN")
+	if adminDSN == "" {
+		t.Skip("TEST_ADMIN_DSN nicht gesetzt, Integrationstest uebersprungen")
+	}
+	ctx := context.Background()
+
+	pool, err := pgxpool.New(ctx, adminDSN)
+	if err != nil {
+		t.Fatalf("pool: %v", err)
+	}
+	if _, err := pool.Exec(ctx, `
+		CREATE TABLE IF NOT EXISTS users (
+			id UUID PRIMARY KEY DEFAULT gen_random_uuid(), email TEXT NOT NULL UNIQUE, name TEXT NOT NULL,
+			status TEXT NOT NULL DEFAULT 'active', password_hash TEXT NOT NULL DEFAULT '',
+			created_at TIMESTAMPTZ NOT NULL DEFAULT now(), updated_at TIMESTAMPTZ NOT NULL DEFAULT now()
+		);
+		CREATE TABLE IF NOT EXISTS totp_credentials (
+			user_id UUID PRIMARY KEY REFERENCES users(id), secret TEXT NOT NULL,
+			confirmed BOOLEAN NOT NULL DEFAULT false, created_at TIMESTAMPTZ NOT NULL DEFAULT now()
+		);
+		CREATE TABLE IF NOT EXISTS totp_recovery_codes (
+			id UUID PRIMARY KEY DEFAULT gen_random_uuid(), user_id UUID NOT NULL REFERENCES users(id),
+			code_hash BYTEA NOT NULL UNIQUE, used_at TIMESTAMPTZ, created_at TIMESTAMPTZ NOT NULL DEFAULT now()
+		);
+	`); err != nil {
+		t.Fatalf("schema: %v", err)
+	}
+
+	userStore := user.NewTenantUserStore(pool)
+	email := fmt.Sprintf("totp-test-%d@example.com", time.Now().UnixNano())
+	u, err := userStore.Create(ctx, email, "TOTP Test")
+	if err != nil {
+		t.Fatalf("create user: %v", err)
+	}
+	hash, err := auth.HashPassword("korrektes-passwort")
+	if err != nil {
+		t.Fatalf("hash: %v", err)
+	}
+	if err := userStore.SetPasswordHash(ctx, u.ID, hash); err != nil {
+		t.Fatalf("set password: %v", err)
+	}
+
+	cleanup := func() { pool.Close() }
+	return NewStore(pool), userStore, u.ID, cleanup
+}
+
+// Akzeptanzkriterium 1: Einrichtung per QR-Code (URI), Bestaetigung vor Aktivierung.
+func TestBeginAndConfirmSetup(t *testing.T) {
+	store, _, userID, cleanup := setupTest(t)
+	defer cleanup()
+	ctx := context.Background()
+
+	secret, uri, err := store.BeginSetup(ctx, userID, "NEXARCH", "user@example.com")
+	if err != nil {
+		t.Fatalf("begin setup: %v", err)
+	}
+	if uri == "" {
+		t.Fatal("erwartet nicht-leere provisioning-uri")
+	}
+
+	enabled, err := store.IsEnabled(ctx, userID)
+	if err != nil {
+		t.Fatalf("is enabled (vor bestaetigung): %v", err)
+	}
+	if enabled {
+		t.Fatal("erwartet NICHT aktiviert vor bestaetigung")
+	}
+
+	// Falscher Code darf nicht aktivieren.
+	if _, err := store.ConfirmSetup(ctx, userID, "000000"); !errors.Is(err, ErrInvalidCode) && err == nil {
+		t.Fatalf("erwartet ablehnung bei falschem code, habe err=%v", err)
+	}
+
+	code, err := GenerateCode(secret, time.Now())
+	if err != nil {
+		t.Fatalf("generate code: %v", err)
+	}
+	recoveryCodes, err := store.ConfirmSetup(ctx, userID, code)
+	if err != nil {
+		t.Fatalf("confirm setup: %v", err)
+	}
+	if len(recoveryCodes) != RecoveryCodeCount {
+		t.Fatalf("erwartet %d wiederherstellungscodes, habe %d", RecoveryCodeCount, len(recoveryCodes))
+	}
+
+	enabled, err = store.IsEnabled(ctx, userID)
+	if err != nil {
+		t.Fatalf("is enabled (nach bestaetigung): %v", err)
+	}
+	if !enabled {
+		t.Fatal("erwartet aktiviert nach erfolgreicher bestaetigung")
+	}
+}
+
+// Akzeptanzkriterium 2 + Pruefung 1: Login ohne zweiten Faktor bei aktivem
+// 2FA wird zuverlaessig abgewiesen.
+func TestLoginWithTOTP_RequiresSecondFactorWhenEnabled(t *testing.T) {
+	store, userStore, userID, cleanup := setupTest(t)
+	defer cleanup()
+	ctx := context.Background()
+
+	secret, _, err := store.BeginSetup(ctx, userID, "NEXARCH", "user@example.com")
+	if err != nil {
+		t.Fatalf("begin setup: %v", err)
+	}
+	code, _ := GenerateCode(secret, time.Now())
+	if _, err := store.ConfirmSetup(ctx, userID, code); err != nil {
+		t.Fatalf("confirm setup: %v", err)
+	}
+
+	u, err := userStore.Get(ctx, userID)
+	if err != nil {
+		t.Fatalf("get user: %v", err)
+	}
+	issuer := auth.NewTokenIssuer("test-secret-nur-fuer-tests")
+	loginService := auth.NewLoginService(userStore, issuer, "acme")
+
+	// Korrektes Passwort, aber KEIN 2FA-Code -> abgewiesen.
+	if _, err := LoginWithTOTP(ctx, userStore, store, loginService, u.Email, "korrektes-passwort", ""); !errors.Is(err, ErrSecondFactorRequired) {
+		t.Fatalf("erwartet ErrSecondFactorRequired ohne code, habe %v", err)
+	}
+
+	// Korrektes Passwort + korrekter aktueller Code -> erfolgreich.
+	loginCode, _ := GenerateCode(secret, time.Now())
+	token, err := LoginWithTOTP(ctx, userStore, store, loginService, u.Email, "korrektes-passwort", loginCode)
+	if err != nil {
+		t.Fatalf("login mit gueltigem 2fa-code: %v", err)
+	}
+	if token == "" {
+		t.Fatal("erwartet gueltiges token")
+	}
+}
+
+// Akzeptanzkriterium 3 + Pruefung 2: Wiederherstellungscode nach Nutzung als
+// verbraucht getestet.
+func TestVerifyLoginCode_RecoveryCodeIsSingleUse(t *testing.T) {
+	store, _, userID, cleanup := setupTest(t)
+	defer cleanup()
+	ctx := context.Background()
+
+	secret, _, err := store.BeginSetup(ctx, userID, "NEXARCH", "user@example.com")
+	if err != nil {
+		t.Fatalf("begin setup: %v", err)
+	}
+	code, _ := GenerateCode(secret, time.Now())
+	recoveryCodes, err := store.ConfirmSetup(ctx, userID, code)
+	if err != nil {
+		t.Fatalf("confirm setup: %v", err)
+	}
+	recovery := recoveryCodes[0]
+
+	ok, err := store.VerifyLoginCode(ctx, userID, recovery)
+	if err != nil {
+		t.Fatalf("verify (erste nutzung): %v", err)
+	}
+	if !ok {
+		t.Fatal("erwartet erfolgreiche erste nutzung des wiederherstellungscodes")
+	}
+
+	ok, err = store.VerifyLoginCode(ctx, userID, recovery)
+	if err != nil {
+		t.Fatalf("verify (zweite nutzung): %v", err)
+	}
+	if ok {
+		t.Fatal("erwartet abgelehnt bei erneuter nutzung desselben wiederherstellungscodes")
+	}
+}

internal/totp/totp.go

@@ -0,0 +1,105 @@
+// Package totp implementiert Core IAM-04: TOTP-basierte Zwei-Faktor-
+// Authentifizierung (RFC 6238, aufbauend auf HOTP RFC 4226) mit stdlib
+// crypto/hmac+sha1 — kein externes Modul noetig.
+package totp
+
+import (
+	"crypto/hmac"
+	"crypto/rand"
+	"crypto/sha1"
+	"encoding/base32"
+	"encoding/binary"
+	"fmt"
+	"net/url"
+	"time"
+
+	"gitea.perlbach24.de/scripte/nexarch/internal/timingsafe"
+)
+
+// StepSeconds ist das TOTP-Zeitfenster (RFC-6238-Standard: 30 Sekunden).
+const StepSeconds = 30
+
+// DefaultSkewSteps ist die dokumentierte Zeitversatz-Toleranz
+// (Akzeptanzkriterium/Pruefung 3): +/- 1 Schritt = +/- 30 Sekunden um die
+// aktuelle Serverzeit, insgesamt ein 90-Sekunden-Fenster. Grosszuegig genug
+// fuer leicht abweichende Client-Uhren, eng genug um ein TOTP-Fenster nicht
+// unbrauchbar lange gueltig zu lassen.
+const DefaultSkewSteps = 1
+
+// GenerateSecret erzeugt ein neues, zufaelliges TOTP-Secret (20 Byte, wie von
+// Authenticator-Apps erwartet), Base32-kodiert ohne Padding.
+func GenerateSecret() (string, error) {
+	buf := make([]byte, 20)
+	if _, err := rand.Read(buf); err != nil {
+		return "", fmt.Errorf("secret erzeugen: %w", err)
+	}
+	return base32.StdEncoding.WithPadding(base32.NoPadding).EncodeToString(buf), nil
+}
+
+// ProvisioningURI liefert die otpauth://-URI fuer den QR-Code
+// (Akzeptanzkriterium 1) — das eigentliche QR-Rendering ist Frontend-Sache
+// (IAM-08), hier wird nur die standardkonforme URI erzeugt.
+func ProvisioningURI(issuer, accountName, secret string) string {
+	label := url.PathEscape(issuer) + ":" + url.PathEscape(accountName)
+	q := url.Values{}
+	q.Set("secret", secret)
+	q.Set("issuer", issuer)
+	q.Set("algorithm", "SHA1")
+	q.Set("digits", "6")
+	q.Set("period", fmt.Sprintf("%d", StepSeconds))
+	return fmt.Sprintf("otpauth://totp/%s?%s", label, q.Encode())
+}
+
+// GenerateCode berechnet den 6-stelligen TOTP-Code fuer secret zum Zeitpunkt t.
+func GenerateCode(secret string, t time.Time) (string, error) {
+	key, err := decodeSecret(secret)
+	if err != nil {
+		return "", err
+	}
+	counter := uint64(t.Unix() / StepSeconds)
+	return hotp(key, counter), nil
+}
+
+// Validate prueft code gegen secret mit der dokumentierten Zeitversatz-
+// Toleranz (DefaultSkewSteps) um t. Vergleich ist timing-safe.
+func Validate(secret, code string, t time.Time) (bool, error) {
+	key, err := decodeSecret(secret)
+	if err != nil {
+		return false, err
+	}
+	counter := int64(t.Unix() / StepSeconds)
+
+	for delta := -DefaultSkewSteps; delta <= DefaultSkewSteps; delta++ {
+		candidate := hotp(key, uint64(counter+int64(delta)))
+		if timingsafe.EqualString(candidate, code) {
+			return true, nil
+		}
+	}
+	return false, nil
+}
+
+func decodeSecret(secret string) ([]byte, error) {
+	key, err := base32.StdEncoding.WithPadding(base32.NoPadding).DecodeString(secret)
+	if err != nil {
+		return nil, fmt.Errorf("secret dekodieren: %w", err)
+	}
+	return key, nil
+}
+
+// hotp implementiert RFC 4226 mit HMAC-SHA1, 6 Ziffern.
+func hotp(key []byte, counter uint64) string {
+	buf := make([]byte, 8)
+	binary.BigEndian.PutUint64(buf, counter)
+
+	mac := hmac.New(sha1.New, key)
+	mac.Write(buf)
+	sum := mac.Sum(nil)
+
+	offset := sum[len(sum)-1] & 0x0f
+	code := (uint32(sum[offset]&0x7f) << 24) |
+		(uint32(sum[offset+1]) << 16) |
+		(uint32(sum[offset+2]) << 8) |
+		uint32(sum[offset+3])
+
+	return fmt.Sprintf("%06d", code%1000000)
+}

internal/totp/totp_test.go

@@ -0,0 +1,79 @@
+package totp
+
+import (
+	"testing"
+	"time"
+)
+
+func TestGenerateAndValidateCode_RoundTrip(t *testing.T) {
+	secret, err := GenerateSecret()
+	if err != nil {
+		t.Fatalf("generate secret: %v", err)
+	}
+	now := time.Now()
+	code, err := GenerateCode(secret, now)
+	if err != nil {
+		t.Fatalf("generate code: %v", err)
+	}
+	if len(code) != 6 {
+		t.Fatalf("erwartet 6-stelligen code, habe %q", code)
+	}
+
+	ok, err := Validate(secret, code, now)
+	if err != nil {
+		t.Fatalf("validate: %v", err)
+	}
+	if !ok {
+		t.Fatal("erwartet gueltigen code")
+	}
+
+	wrongCode := "000000"
+	if code == wrongCode {
+		wrongCode = "111111"
+	}
+	ok, err = Validate(secret, wrongCode, now)
+	if err != nil {
+		t.Fatalf("validate (falsch): %v", err)
+	}
+	if ok {
+		t.Fatal("erwartet ungueltig fuer falschen code")
+	}
+}
+
+// Akzeptanzkriterium/Pruefung 3: Zeitversatz-Toleranz dokumentiert (siehe
+// DefaultSkewSteps = 1 Schritt = 30s) und getestet.
+func TestValidate_ClockSkewTolerance(t *testing.T) {
+	secret, err := GenerateSecret()
+	if err != nil {
+		t.Fatalf("generate secret: %v", err)
+	}
+	now := time.Now()
+
+	// Code aus dem VORHERIGEN Zeitfenster (bis zu 30s in der Vergangenheit)
+	// muss innerhalb der dokumentierten Toleranz noch akzeptiert werden.
+	pastCode, err := GenerateCode(secret, now.Add(-25*time.Second))
+	if err != nil {
+		t.Fatalf("generate code (past): %v", err)
+	}
+	ok, err := Validate(secret, pastCode, now)
+	if err != nil {
+		t.Fatalf("validate (past): %v", err)
+	}
+	if !ok {
+		t.Fatal("erwartet gueltig innerhalb der dokumentierten skew-toleranz (25s)")
+	}
+
+	// Code weit ausserhalb der Toleranz (mehrere Schritte in der
+	// Vergangenheit) muss abgelehnt werden.
+	farPastCode, err := GenerateCode(secret, now.Add(-5*time.Minute))
+	if err != nil {
+		t.Fatalf("generate code (far past): %v", err)
+	}
+	ok, err = Validate(secret, farPastCode, now)
+	if err != nil {
+		t.Fatalf("validate (far past): %v", err)
+	}
+	if ok {
+		t.Fatal("erwartet ungueltig weit ausserhalb der skew-toleranz (5min)")
+	}
+}

migrations/tenant/0002_role_assignments.down.sql

@@ -1,2 +0,0 @@
-DROP TABLE IF EXISTS role_assignment_history;
-DROP TABLE IF EXISTS role_assignments;

migrations/tenant/0002_role_assignments.up.sql

@@ -1,23 +0,0 @@
--- Rollenzuweisung pro Benutzer (RBAC-01, siehe core-kanban/tickets/RBAC-01.md).
--- Nur 'user' und 'tenant_admin' sind hier zuweisbar — 'superadmin' lebt
--- mandantenuebergreifend in der Registry (IAM-01 SuperadminStore) und hat
--- daher bewusst KEINE Zeile in dieser tenant-lokalen Tabelle (Akzeptanz-
--- kriterium 1: nur Zuweisungen innerhalb der erlaubten Matrix).
-CREATE TABLE role_assignments (
-    user_id     UUID PRIMARY KEY REFERENCES users(id),
-    role        TEXT NOT NULL CHECK (role IN ('user', 'tenant_admin')),
-    granted_by  TEXT NOT NULL,
-    granted_at  TIMESTAMPTZ NOT NULL DEFAULT now()
-);
-
--- Vollstaendige Historie jeder Rollenaenderung (Akzeptanzkriterium 3: wer
--- hat wann welche Rolle vergeben).
-CREATE TABLE role_assignment_history (
-    id          UUID PRIMARY KEY DEFAULT gen_random_uuid(),
-    user_id     UUID NOT NULL,
-    role        TEXT NOT NULL,
-    granted_by  TEXT NOT NULL,
-    granted_at  TIMESTAMPTZ NOT NULL DEFAULT now()
-);
-
-CREATE INDEX role_assignment_history_user_idx ON role_assignment_history (user_id, granted_at);

migrations/tenant/0003_ldap.down.sql

@@ -1,2 +0,0 @@
-DROP TABLE IF EXISTS ldap_group_role_mapping;
-DROP TABLE IF EXISTS ldap_config;

migrations/tenant/0003_ldap.up.sql

@@ -1,22 +0,0 @@
--- LDAP/Active-Directory-Anbindung (IAM-05, siehe core-kanban/tickets/IAM-05.md).
--- Bind-Credentials liegen NIE in dieser Tabelle im Klartext — bind_password_env
--- nennt nur den Namen einer Umgebungsvariable, aus der das Passwort zur
--- Laufzeit gelesen wird (Projekt-Konvention: Secrets nur ueber Env-Vars).
-CREATE TABLE ldap_config (
-    id                 BOOLEAN PRIMARY KEY DEFAULT true CHECK (id),
-    url                TEXT NOT NULL,
-    bind_dn            TEXT NOT NULL,
-    bind_password_env  TEXT NOT NULL,
-    base_dn            TEXT NOT NULL,
-    user_filter        TEXT NOT NULL DEFAULT '(objectClass=person)',
-    updated_at         TIMESTAMPTZ NOT NULL DEFAULT now()
-);
-
--- Erlaubnis-Matrix LDAP-Gruppe -> NEXARCH-Rolle (Akzeptanzkriterium 3).
--- Eine LDAP-Gruppe OHNE Eintrag hier vergibt KEINE Rolle — kein impliziter
--- Zugriff durch Gruppennamen-Zufall (Privilege-Escalation-Schutz, siehe
--- "Bekannte Fehler vermeiden" im Ticket).
-CREATE TABLE ldap_group_role_mapping (
-    ldap_group TEXT PRIMARY KEY,
-    role       TEXT NOT NULL CHECK (role IN ('user', 'tenant_admin'))
-);

migrations/tenant/0003_totp.down.sql

@@ -0,0 +1,3 @@
+DROP TABLE IF EXISTS totp_policy;
+DROP TABLE IF EXISTS totp_recovery_codes;
+DROP TABLE IF EXISTS totp_credentials;

migrations/tenant/0003_totp.up.sql

@@ -0,0 +1,23 @@
+-- Zwei-Faktor-Authentifizierung TOTP (IAM-04, siehe core-kanban/tickets/IAM-04.md).
+CREATE TABLE totp_credentials (
+    user_id    UUID PRIMARY KEY REFERENCES users(id),
+    secret     TEXT NOT NULL,
+    confirmed  BOOLEAN NOT NULL DEFAULT false,
+    created_at TIMESTAMPTZ NOT NULL DEFAULT now()
+);
+
+-- code_hash enthaelt NIEMALS den Klartext-Wiederherstellungscode, nur dessen
+-- SHA-256-Hash. used_at markiert einmalige Verwendbarkeit (Akzeptanzkriterium 3).
+CREATE TABLE totp_recovery_codes (
+    id         UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+    user_id    UUID NOT NULL REFERENCES users(id),
+    code_hash  BYTEA NOT NULL UNIQUE,
+    used_at    TIMESTAMPTZ,
+    created_at TIMESTAMPTZ NOT NULL DEFAULT now()
+);
+
+-- Erzwingbare Aktivierungspflicht pro Tenant (Singleton-Zeile, Modell C).
+CREATE TABLE totp_policy (
+    id       BOOLEAN PRIMARY KEY DEFAULT true CHECK (id),
+    required BOOLEAN NOT NULL DEFAULT false
+);

migrations/tenant/0004_oidc_states.down.sql

@@ -1 +0,0 @@
-DROP TABLE IF EXISTS oidc_states;

migrations/tenant/0004_oidc_states.up.sql

@@ -1,10 +0,0 @@
--- CSRF-/Replay-Schutz fuer OIDC-Login (IAM-06, siehe
--- core-kanban/tickets/IAM-06.md). Einmal-Verwendung erzwungen ueber
--- used_at IS NULL in der Consume-Abfrage, analog IAM-03/IAM-09.
-CREATE TABLE oidc_states (
-    state      TEXT PRIMARY KEY,
-    nonce      TEXT NOT NULL,
-    expires_at TIMESTAMPTZ NOT NULL,
-    used_at    TIMESTAMPTZ,
-    created_at TIMESTAMPTZ NOT NULL DEFAULT now()
-);

migrations/tenant/0005_saml.down.sql

@@ -1 +0,0 @@
-DROP TABLE IF EXISTS saml_config;

migrations/tenant/0005_saml.up.sql

@@ -1,13 +0,0 @@
--- SAML 2.0-Anbindung (IAM-11, siehe core-kanban/tickets/IAM-11.md).
--- Singleton-Zeile je Tenant-Datenbank (Modell C) — dieselbe Isolation, die
--- IAM-06 (OIDC) fuer nebeneinander konfigurierte Anmeldewege je Tenant
--- nutzt: Tenant A kann diese Tabelle befuellt haben, Tenant B stattdessen
--- eine OIDC-Konfiguration, ohne dass sich beides je begegnet
--- (Akzeptanzkriterium 2).
-CREATE TABLE saml_config (
-    id                BOOLEAN PRIMARY KEY DEFAULT true CHECK (id),
-    idp_issuer        TEXT NOT NULL,
-    idp_certificate   TEXT NOT NULL, -- PEM-kodiertes oeffentliches Zertifikat des IdP
-    sp_entity_id      TEXT NOT NULL,
-    updated_at        TIMESTAMPTZ NOT NULL DEFAULT now()
-);