auth-ui
@mmm/auth-ui
Angular-UI-Paket der Auth-Domain.
Verantwortung
- Auth-Basislogik für den Client
- Routing-nahe Auth-Guards
- Authorization-nahe Direktiven und Checks
- Password- und OAuth-spezifische UI-Bausteine
Struktur
src/lib/ui/coreAPI-Zugriff, Store, Interceptor, Basismodule, Login-Flowsrc/lib/ui/routingroutingnahe Auth-Guardssrc/lib/ui/authorizationAuthorization-Direktiven und Regeltypensrc/lib/ui/passwordPassword-Login-API, Komponente, Optionensrc/lib/ui/oauthOAuth-API, Komponente, Optionen
Architekturgrenzen
- darf
@mmm/auth-contractsverwenden - darf keine NestJS- oder Prisma-spezifischen Implementierungen enthalten
- Authorization baut auf
coreauf, nicht umgekehrt
Öffentliche API
AuthUiModuleAuthFrontendModuleals KompatibilitätsaliasAuthApiAuthStoreAuthGuardCanDirectiveAuthPasswordApiPasswordLoginComponentAuthOAuthApiOAuthLoginComponent
Beispiel
import { AuthUiModule } from "@mmm/auth/ui";
AuthUiModule.forRoot({ core: { apiBaseUrl: "/api", tokenStorage: "sessionStorage", }, password: { loginEndpoint: "/auth/login", lostPasswordUrl: "/admin/login/lost-password", postLoginRedirectUrl: "/", }, oauth: { enabledProviders: ["microsoft"], },});Login-URL und Redirect pro Route
AuthGuard schickt Anonyme auf core.loginUrl (Default /login), die Login-Komponenten
navigieren nach postLoginRedirectUrl. Beides lässt sich pro Route über data.auth
überschreiben; die Angabe gilt für die Route und ihre Kinder, die nächste Route gewinnt.
const adminAuth: AuthRouteData = { loginUrl: "/admin/login", postLoginRedirectUrl: "/admin" };
const routes: Route[] = [ { path: "admin/login", component: PasswordLoginComponent, data: { auth: adminAuth } }, { path: "admin", canActivate: [AuthGuard], data: { auth: adminAuth }, children: [...] },];Reihenfolge: returnUrl-Query-Parameter → data.auth → Modul-Option → Default.
Logout
AuthLoginFlowService.logout() ruft POST /auth/logout (Option core.logoutEndpoint)
auf, damit der Server die Session zurückzieht, und verwirft das Token danach lokal über
AuthStore.setAnonymous(). Der lokale Teil passiert auch, wenn der Server nicht
erreichbar ist. Ein direktes setAnonymous() löscht nur das Token im Browser, die
Session bleibt serverseitig bis zum Ablauf gültig.
private readonly loginFlow = inject(AuthLoginFlowService);
logout() { this.loginFlow.logout().subscribe();}Build
pnpm --dir frontend run build