Skip to content

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/core Guard, Controller, Decorators, Rolling-Token-Logik, Basiskonfiguration
  • src/lib/server/password Password-spezifische Module, Validator-Verträge und Login-Endpunkt
  • src/lib/server/oauth OAuth-spezifische Module, Service, Provider-Adapter und Callback-Flow
  • src/lib/server/oidc OIDC-spezifische Guard- und JWKS-Themen

Architekturgrenzen

  • darf @mmm/auth-contracts verwenden
  • darf keine Angular-spezifischen Typen oder Implementierungen enthalten
  • core bleibt providerneutral
  • password, oauth und oidc dürfen auf core aufbauen, 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/logout zieht 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.
  • AuthGuard lehnt 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

Terminal window
pnpm --dir backend run build