Ajout de fonctionnalités

Sécurité et Authentification

L'authentification est la base de tout système sécurisé. Lino prend en charge l'authentification basée sur JWT (JSON Web Tokens), en utilisant le schéma Bearer dans les API.

Flux d'authentification typique :

1. L'utilisateur se connecte (via un endpoint ou une page dédiée).
2. Un JWT est émis avec des claims représentant l'identité, les rôles et les permissions.
3. Chaque requête à l'API inclut le token dans l'en-tête : Authorization: Bearer <token>
4. Le middleware d'authentification valide le token en vérifiant la signature et l'expiration.

Autorisation basée sur les policies

Lino utilise les policies pour mettre en œuvre une autorisation granulaire :

• Chaque action peut nécessiter une policy spécifique (ex. : People.Read, People.Create).
• Les policies sont configurées via AddAuthorization.
• Les endpoints peuvent être protégés en déclarant : .RequireAuthorization

Ajouter la sécurité aux projets Lino

Pour ajouter la sécurité à un projet, exécutez :

lino features auth add

L'assistant interactif CLI demandera les configurations suivantes :

• Service – service dans lequel les ressources de sécurité seront configurées.
• Module – module spécifique où la sécurité sera installée (applicable uniquement aux services modulaires).
• Durée de vie du Access Token – durée de validité du token d'accès.
• Durée de vie du Refresh Token – durée de validité du token de rafraîchissement.
• Type d'identifiant utilisateur – définit le type de données utilisé comme UserId (int, long ou Guid).

Ces paramètres garantissent que le pipeline d'authentification/autorisation est configuré automatiquement, prêt à être utilisé dans les API et intégré à Blazor.

Travaux en arrière-plan

De nombreux systèmes nécessitent l’exécution de processus asynchrones en arrière-plan, tels que :

• Envoi d’e-mails
• Génération de rapports
• Synchronisation avec des systèmes externes.

Lino prend en charge nativement Hangfire comme orchestrateur de jobs.

Avantages de Hangfire

• Exécution fiable des jobs asynchrones.
• Tableau de bord de surveillance intégré.
• Support des jobs récurrents ou planifiés.
• Persistance fiable des jobs dans la base de données.

Intégration d’événements avec Outbox Message

Pour garantir la cohérence des intégrations asynchrones, Lino adopte le modèle Outbox Message.

Lors de l’exécution d’une action métier (ex. : création d’une commande), l’événement correspondant (OrderCreated) est enregistré dans la table Outbox, dans la même transaction qui persiste l’état du domaine. Un processeur en arrière-plan lit la table Outbox et publie les événements dans les systèmes de messagerie (RabbitMQ, Kafka, etc.).

Avantages de l’Outbox :

• Atomicité → la base de données et les événements publiés restent synchronisés.
• Fiabilité → aucun événement n’est perdu, même en cas de défaillance.
• Scalabilité → plusieurs consommateurs peuvent traiter les événements.

Ce modèle garantit des intégrations sûres et résilientes dans les architectures distribuées.

Grâce à ces fonctionnalités supplémentaires, Lino offre une sécurité robuste, un contrôle d’accès granulaire et un traitement asynchrone fiable, répondant aux exigences critiques des applications modernes en production.

Ajouter des fonctionnalités de Background Job aux projets Lino

Le traitement asynchrone est essentiel pour les tâches qui ne doivent pas bloquer le flux principal des requêtes, telles que l’envoi de notifications, la génération de rapports ou la publication d’événements.

Lino permet d’activer le support des Background Jobs (via des bibliothèques) avec une seule commande :

lino features background-job add

Le CLI demandera les paramètres de configuration suivants :

• Service – service dans lequel la fonctionnalité de Background Job sera ajoutée.
• Bibliothèque – bibliothèque choisie pour l’exécution et la planification des jobs.
• Intervalle de vérification et de traitement - intervalle auquel la file d’attente est vérifiée pour rechercher de nouveaux messages Outbox.
• Nombre d’enregistrements - nombre maximal d’enregistrements traités par cycle, contrôlant le parallélisme et la consommation des ressources.

Ces options permettent de configurer le système de manière évolutive et résiliente, garantissant l’exécution fiable des tâches en arrière-plan.