Authentifizierung und HTTP
Zugriffsberechtigungen
provideKitAuth() konfiguriert funktionale Route Guards für die Authentifizierungszustände user, confirm, required, anonymous und unavailable. Weiterleitungsrouten und anwendungsspezifische Nebenwirkungen verbleiben in der App. AuthService in den folgenden Beispielen gehört zur Anwendung; stellen Sie Ihr eigenes Observable authState und optionale Lebenszyklus-Callbacks bereit.
KitAuthAccessService veröffentlicht, was die aktuelle Sitzung tun darf:
| Modus | Lokales Replikat und Outbox | Authentifiziertes HTTP, Echtzeitfunktionen und Synchronisierung |
|---|---|---|
none |
Gesperrt | Gesperrt |
local |
Erlaubt | Gesperrt |
remote |
Erlaubt | Erlaubt |
Ein maßgebliches Ergebnis required bedeutet Abmeldung und darf keinen Offline-Zugriff ermöglichen. Nur ein Transportergebnis unavailable darf eine zuvor verifizierte lokale Sitzung aktivieren.
import { inject } from '@angular/core';
import type { Routes } from '@angular/router';
import {
kitRequireAuthorizedGuard,
kitRequireConfirmingGuard,
kitRequiredUnauthorizedGuard,
provideKitAuth,
} from '@rdlabo/ionic-angular-kit';
import { AuthService } from './auth.service';
provideKitAuth(() => {
const auth = inject(AuthService);
return {
authState: () => auth.state$,
redirects: {
whenAuthorized: '/home',
whenConfirming: '/auth/confirm',
whenNotConfirming: '/auth/signin',
whenUnauthorized: '/auth',
},
};
});
export const routes: Routes = [
{ path: 'auth/signin', canActivate: [kitRequiredUnauthorizedGuard], loadComponent: () => import('./signin.page').then((m) => m.SigninPage) },
{ path: 'auth/confirm', canActivate: [kitRequireConfirmingGuard], loadComponent: () => import('./confirm.page').then((m) => m.ConfirmPage) },
{ path: 'home', canActivate: [kitRequireAuthorizedGuard], loadComponent: () => import('./home.page').then((m) => m.HomePage) },
];
Verwenden Sie kitRequiredUnauthorizedGuard, kitRequireConfirmingGuard und kitRequireAuthorizedGuard in den Routendefinitionen. Eine geschützte asynchrone Entscheidung setzt zuvor veröffentlichte Remote-Berechtigungen aus, bis die aktuelle Autorisierungsfreigabe erfolgreich ist.
Anmeldeanfragen beim Start gemeinsam nutzen
KitAuthLoginExchange<Identity, Result> teilt eine laufende Backend-Anmeldeanfrage. Ein vorgeladenes Ergebnis (einschließlich Fehlern) kann einmalig für die Autorisierung verwendet werden, solange die ursprüngliche Navigation aktuell ist, bis zu 30 Sekunden nach Abschluss. Spätere Autorisierungsaufrufe stellen eine neue Anfrage; dies ist kein Berechtigungs-Cache.
Halten Sie eine Instanz im Authentifizierungsdienst der Anwendung. Erfassen Sie den Firebase-Benutzer beim Erstellen der Anfrage, verwerfen Sie Antworten für einen inzwischen ersetzten Benutzer und rufen Sie bei der Abmeldung clear() auf. Die Eignung der Anbieter, die Wiederherstellung nach Löschung, die Zustimmung zu Bedingungen und die Antwortverarbeitung bleiben Aufgabe der Anwendung.
Anwendungen, die vor der Autorisierung eine lokale Laufzeit initialisieren, rufen kitPreloadAuthLoginForNavigation(router, isCurrent => auth.preloadTokenLogin(isCurrent)) nach der Firebase-Bereitschaft und der erforderlichen Kontowiederherstellung auf, bevor sie die Laufzeitinitialisierung abwarten. Führen Sie bei fehlgeschlagener Initialisierung die zurückgegebene Bereinigungsfunktion aus. Sie verwirft nicht verbrauchte Arbeit, wenn diese Navigation endet oder abgebrochen wird. Anwendungen ohne sinnvolle überlappende Startarbeit können allein run(identity, request) verwenden.
HTTP-Richtlinie
provideKitHttp() konfiguriert kitAuthInterceptor für das Einfügen von Zugangsdaten, Ausnahmeregeln, die Behandlung vorübergehender Fehler und anwendungseigene Fehler-Hooks. Registrieren Sie den Interceptor separat mit provideHttpClient. Nur getAuthHeaders ist erforderlich; alle anderen Hooks sind optional und liegen in der Verantwortung der Anwendung.
import { provideHttpClient, withInterceptors } from '@angular/common/http';
import { inject } from '@angular/core';
import type { ApplicationConfig } from '@angular/core';
import { kitAuthInterceptor, provideKitAuth, provideKitHttp } from '@rdlabo/ionic-angular-kit';
import { AuthService } from './auth.service';
export const appConfig: ApplicationConfig = {
providers: [
provideHttpClient(withInterceptors([kitAuthInterceptor])),
provideKitAuth(() => {
const auth = inject(AuthService);
return {
authState: () => auth.state$,
redirects: {
whenAuthorized: '/home',
whenConfirming: '/auth/confirm',
whenNotConfirming: '/auth/signin',
whenUnauthorized: '/auth',
},
};
}),
provideKitHttp(() => {
const auth = inject(AuthService);
return {
getAuthHeaders: async () => ({ Authorization: `Bearer ${await auth.token()}` }),
onUnauthorized: () => auth.signOut(),
};
}),
],
};
Automatische Wiederholungsversuche sind auf GET, HEAD, OPTIONS oder Anfragen mit einem Idempotency-Key beschränkt. Gewöhnliche Schreibanfragen werden niemals automatisch wiederholt. Wiederholungsversuche betreffen die vorübergehenden Statuswerte 0, 408, 429, 502, 503 und 504 und berücksichtigen Retry-After.
Wenn Offline-Unterstützung aktiviert ist, registrieren Sie offlineInterceptor vor kitAuthInterceptor. Der lokale Modus verhindert dann die Erzeugung von Zugangsdaten und den Netzwerktransport, während eine passende Leserichtlinie das bereichsgebundene Replikat bereitstellen darf.
Vom Aufrufer verwaltete Fehlermeldungen
onServerError erhält die Meldung aus dem Antworttext für HTTP 400, 409, 422 und 500. Wenn der Aufrufer einer Anfrage eine eigene Fehleroberfläche anzeigt, setzen Sie das öffentliche boolesche Kontext-Token KIT_SKIP_ERROR_NOTIFICATIONS (Standardwert: false):
import { HttpContext } from '@angular/common/http';
import { KIT_SKIP_ERROR_NOTIFICATIONS } from '@rdlabo/ionic-angular-kit';
http.post('/applications', payload, {
context: new HttpContext().set(KIT_SKIP_ERROR_NOTIFICATIONS, true),
});
Dies unterdrückt ausschließlich die Benachrichtigungs-Hooks für Antwortfehler: onUnauthorized, onForbidden, onNetworkError, onRateLimited, onMaintenance, onServerBusy und onServerError. Der ursprüngliche Fehler wird weiterhin als Ablehnung an den Aufrufer weitergegeben. Dadurch wird weder die Authentifizierung umgangen noch die Wiederherstellung und Wiederholung bei 401 gestoppt. Wiederholungen und das Offline-Fallback bleiben unverändert; weder der Entzug des Zugriffs (onAuthAccessDenial) noch Fehler bei Authentifizierungs-Headern (onAuthError) werden unterdrückt.