Skip to content

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/core API-Zugriff, Store, Interceptor, Basismodule, Login-Flow
  • src/lib/ui/routing routingnahe Auth-Guards
  • src/lib/ui/authorization Authorization-Direktiven und Regeltypen
  • src/lib/ui/password Password-Login-API, Komponente, Optionen
  • src/lib/ui/oauth OAuth-API, Komponente, Optionen

Architekturgrenzen

  • darf @mmm/auth-contracts verwenden
  • darf keine NestJS- oder Prisma-spezifischen Implementierungen enthalten
  • Authorization baut auf core auf, nicht umgekehrt

Öffentliche API

  • AuthUiModule
  • AuthFrontendModule als Kompatibilitätsalias
  • AuthApi
  • AuthStore
  • AuthGuard
  • CanDirective
  • AuthPasswordApi
  • PasswordLoginComponent
  • AuthOAuthApi
  • OAuthLoginComponent

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

Terminal window
pnpm --dir frontend run build