auth-server
@mmm/auth-server
NestJS-Serverpaket der Auth-Domain.
Verantwortung
- serverseitige Auth-Kernlogik
- Guards, Decorators und Interceptors für Auth
- Password-Authentifizierung
- OAuth-Authentifizierung
- OIDC-spezifische Verifikation
Struktur
src/lib/server/coreGuard, Controller, Decorators, Rolling-Token-Logik, Basiskonfigurationsrc/lib/server/passwordPassword-spezifische Module, Validator-Verträge und Login-Endpunktsrc/lib/server/oauthOAuth-spezifische Module, Service, Provider-Adapter und Callback-Flowsrc/lib/server/oidcOIDC-spezifische Guard- und JWKS-Themen
Architekturgrenzen
- darf
@mmm/auth-contractsverwenden - darf keine Angular-spezifischen Typen oder Implementierungen enthalten
corebleibt providerneutralpassword,oauthundoidcdürfen aufcoreaufbauen, aber nicht umgekehrt
Öffentliche API
@mmm/auth/server@mmm/auth/server/core@mmm/auth/server/password@mmm/auth/server/oauth@mmm/auth/server/oidc
Beispiel
import { AuthServerModule } from "@mmm/auth/server";
AuthServerModule.forRoot({ jwt: { secret: process.env.JWT_SECRET! }, core: { resolver: authUserResolver, }, password: { validator: passwordValidator, },});Sessions
Jedes App-Session-Token trägt einen sid-Claim (Session-Id). Der Rolling-Interceptor
übernimmt ihn bei jeder Verlängerung, ein Token ohne sid bekommt bei der ersten
Verlängerung eine. Über die sid lassen sich Sessions serverseitig zurückziehen.
Rolling-Token: Claims
Standardmäßig enthält ein verlängertes Token nur sub, tid und sid. Mit
rolling.preserveClaims: true (bzw. password.options.preserveClaims) werden alle
Claims des geprüften Tokens übernommen, nur iat, exp und nbf werden neu gesetzt.
Nötig, wenn eine App eigene Claims (z. B. aus extraClaims oder einem SSO-Login) über
die Session-Dauer braucht.
core: { resolver, options: { rolling: { preserveClaims: true } },}Revocation
POST /auth/logoutzieht die aufrufende Session zurück (204). Der Client verwirft sein Token zusätzlich selbst.AuthSessionService.revokeUser(userId)zieht alle aktuell bestehenden Sessions eines Nutzers zurück (Deaktivierung, Passwort-Reset). Ein späterer Login ist nicht betroffen.AuthGuardlehnt zurückgezogene Tokens mit 401 ab, bevor Resolver und Verlängerung laufen.
Gespeichert werden Revocations über den Vertrag SessionRevocationStore aus
@mmm/auth-contracts. Ohne Konfiguration wird InMemorySessionRevocationStore
verwendet: eine Instanz, geht bei Neustart verloren. Für Replikate oder Persistenz
liefert die App einen eigenen Store (Redis, DB):
core: { inject: [PRISMA_CLIENT, REDIS], useFactory: (prisma, redis) => ({ resolver: new PrismaAuthResolver(prisma), revocationStore: new RedisSessionRevocationStore(redis), }),}Das Paket bringt bewusst kein Prisma-Schema mit; eine persistente Ablage gehört der App.
Build
pnpm --dir backend run build