Features hinzufügen

Neben dem Kern von APIs und Frontends erfordern reale Projekte häufig zusätzliche Funktionen, um Sicherheit, Zugriffskontrolle und die Ausführung von Hintergrundprozessen zu gewährleisten.

Lino erleichtert das Hinzufügen dieser Fähigkeiten auf standardisierte Weise und spiegelt sie sowohl im Backend (Endpoints) als auch im Frontend (Blazor-Anwendungen) wider.

Sicherheit und Authentifizierung

Authentifizierung ist die Grundlage jedes sicheren Systems. Lino unterstützt JWT (JSON Web Tokens) basierte Authentifizierung unter Verwendung des Bearer-Schemas in APIs.

Typischer Authentifizierungsablauf:

1. Der Benutzer meldet sich an (über einen Endpunkt oder eine dedizierte Seite).
2. Ein JWT wird mit Claims ausgestellt, die Identität, Rollen und Berechtigungen darstellen.
3. Jede API-Anfrage enthält das Token im Header: Authorization: Bearer <token>
4. Die Authentifizierungs-Middleware überprüft das Token, indem sie Signatur und Ablauf prüft.

Rollen- und Richtlinienbasierte Autorisierung

Lino verwendet Policies, um eine granulare Autorisierung zu implementieren:

Jede Aktion kann eine spezifische Policy erfordern (z. B.: People.Read, People.Create).
Policies werden über AddAuthorization konfiguriert.
Endpoints können geschützt werden, indem sie deklarieren: .RequireAuthorization

Sicherheit zu Lino-Projekten hinzufügen

Um einem Projekt Sicherheit hinzuzufügen, führen Sie aus:

lino features auth add

Der interaktive CLI-Assistent wird die folgenden Konfigurationen abfragen:

Service – der Service, in dem Sicherheitsressourcen konfiguriert werden.
Modul – spezifisches Modul, in dem die Sicherheit installiert wird (nur für modulare Services anwendbar).
Lebensdauer des Access Tokens – Gültigkeitsdauer des Zugriffstokens.
Lebensdauer des Refresh Tokens – Gültigkeitsdauer des Aktualisierungstokens.
Typ des Benutzeridentifikators – legt den Datentyp fest, der als UserId verwendet wird (int, long oder Guid).

Diese Einstellungen stellen sicher, dass die Authentifizierungs-/Autorisierungspipeline automatisch konfiguriert wird, bereit zur Nutzung in APIs und integriert in Blazor.

Hintergrundaufgaben

Viele Systeme müssen asynchrone Prozesse im Hintergrund ausführen, wie z. B.:

E-Mail-Versand
Berichtserstellung
Synchronisation mit externen Systemen.

Lino bietet native Unterstützung für Hangfire als Job-Orchestrator.

Vorteile von Hangfire

Zuverlässige Ausführung von asynchronen Jobs.
Eingebautes Überwachungs-Dashboard.
Unterstützung für wiederkehrende oder geplante Jobs.
Zuverlässige Persistenz der Jobs in der Datenbank.

Ereignisintegration mit Outbox Message

Um Konsistenz bei asynchronen Integrationen zu gewährleisten, verwendet Lino das Outbox-Message-Muster.

Beim Ausführen einer Geschäftsaktion (z. B. Erstellung einer Bestellung) wird das entsprechende Ereignis (OrderCreated) in der Outbox-Tabelle gespeichert, in derselben Transaktion, die den Domänenzustand persistiert. Ein Hintergrundprozessor liest die Outbox-Tabelle und veröffentlicht die Ereignisse in Messaging-Systeme (RabbitMQ, Kafka usw.).

Vorteile der Outbox:

Atomarität → Datenbank und veröffentlichte Ereignisse bleiben synchron.
Zuverlässigkeit → Kein Ereignis geht verloren, selbst bei einem Ausfall.
Skalierbarkeit → Mehrere Consumer können die Ereignisse verarbeiten.

Dieses Modell gewährleistet sichere und resiliente Integrationen in verteilten Architekturen.

Mit diesen zusätzlichen Funktionen bietet Lino robuste Sicherheit, granulare Zugriffskontrolle und zuverlässige asynchrone Verarbeitung und erfüllt die kritischen Anforderungen moderner Produktionsanwendungen.

Hinzufügen von Background-Job-Funktionen zu Lino-Projekten

Asynchrone Verarbeitung ist essenziell für Aufgaben, die den Hauptanfragefluss nicht blockieren dürfen, wie Benachrichtigungen, Berichtserstellung oder Event-Publishing.

Lino ermöglicht das Aktivieren der Unterstützung für Background Jobs (über Bibliotheken) mit nur einem Befehl:

lino features background-job add

Das CLI fordert die folgenden Konfigurationsparameter an:

Service – der Service, in dem die Background-Job-Funktion hinzugefügt wird.
Bibliothek – ausgewählte Bibliothek für die Ausführung und Planung von Jobs.
Prüf- und Verarbeitungsintervall – Intervall, in dem die Warteschlange auf neue Outbox-Nachrichten überprüft wird.
Anzahl der Datensätze – maximale Anzahl der pro Zyklus verarbeiteten Datensätze zur Steuerung von Parallelität und Ressourcenverbrauch.

Diese Optionen ermöglichen eine skalierbare und resiliente Konfiguration des Systems und gewährleisten die zuverlässige Ausführung von Hintergrundaufgaben.