Concepts fondamentaux
Comment Hawiyati fonctionne de l'intérieur — authentification, sessions, fédération, politiques et moteur de risque adaptatif.
Comment Hawiyati fonctionne de l'intérieur — authentification, sessions, fédération, politiques et moteur de risque adaptatif.
Aperçu de l'architecture de la plateforme
Hawiyati est composé de microservices spécialisés communiquant via HTTPS et gRPC. Les quatre zones ci-dessous indiquent où chaque service réside, ce qu'il gère et comment les requêtes transitent des acteurs externes à travers la couche d'entrée vers les couches plateforme et données. Cette structure facilite l'intégration, le dépannage et la planification de capacité.
Les sections ci-dessous expliquent le comportement de chaque zone à l'exécution. Pour les ports des modules, les définitions de services gRPC et la topologie de déploiement, consultez le Guide d'implémentation.
Fonctionnement de l'authentification
L'authentification dans Hawiyati est le processus de vérification de l'identité d'un utilisateur avant d'accorder l'accès à un fournisseur de service. Elle s'exécute via un pipeline séquencé : le fournisseur d'identité (IdP) collecte des preuves via une ou plusieurs méthodes, les évalue par rapport aux informations d'identification stockées de l'utilisateur, et en cas de succès, émet une session et un artefact de fédération (assertion SAML ou ensemble de jetons OIDC).
Hawiyati est le fournisseur d'identité. Chaque connexion commence lorsqu'un navigateur suit une requête SSO SAML ou une redirection d'autorisation OIDC vers hawiyati-http-server. À partir de ce point d'entrée, l'IdP construit une séquence d'étapes d'authentification, guide l'utilisateur à travers celles-ci, et — lorsque toutes les étapes réussissent — restitue le contrôle à hawiyati-federation pour émettre l'assertion ou les jetons.
L'authentification est avec état dans le flux de connexion. Un objet LoginFlowState est stocké dans la session navigateur IdP de l'utilisateur pour la durée de la cérémonie. Il suit :
| Champ | Contenu |
|---|---|
providerSequence | Liste ordonnée des étapes d'authentification à exécuter |
stepIndex | Position actuelle dans la séquence |
username | Découvert à la première étape ou après sa complétion |
amrList | Méthodes complétées avec succès jusqu'ici (incluses verbatim dans l'amr OIDC) |
loaReached | Niveau d'assurance d'authentification le plus élevé atteint jusqu'ici |
| État de travail par fournisseur | Données temporaires telles que le HMAC OTP ou le défi FIDO2, stockés côté serveur pour la durée de l'étape |
Le flux est complet lorsque stepIndex dépasse la fin de la séquence. L'IdP établit alors une session et restitue le contrôle à la couche de fédération.
Méthodes d'authentification prises en charge
Hawiyati prend en charge cinq méthodes d'authentification, chacune mappée à un fournisseur nommé dans le moteur de connexion.
| Méthode | Code fournisseur | Catégorie de facteur | AAL | Résistant au phishing | Lié au matériel |
|---|---|---|---|---|---|
| Mot de passe | pwd |
Connaissance | AAL1 | Non | Non |
| TOTP (application d'authentification) | totp |
Possession | AAL2 | Non | Non |
| OTP par e-mail | email_otp |
Possession | AAL2 | Non | Non |
| OTP par SMS | sms_otp |
Possession | AAL2 | Non | Non |
| FIDO2 / WebAuthn | fido2 |
Possession + Inhérence | AAL2 | Oui | Oui |
Catégories de facteurs
Connaissance — quelque chose que l'utilisateur sait (mot de passe). Possession — quelque chose que l'utilisateur possède (téléphone, application d'authentification, clé de sécurité). Inhérence — quelque chose que l'utilisateur est ou fait (biométrie confirmée localement par l'appareil pour les clés d'accès). FIDO2 couvre à la fois la possession et l'inhérence.
Le flux de connexion
Chaque connexion suit le même pipeline : recevoir la requête SSO, évaluer la politique, construire la séquence d'étapes, exécuter chaque étape, puis émettre l'assertion ou les jetons. Les étapes ci-dessous décrivent le chemin nominal pour une connexion AMF pilotée par politique.
AuthnRequest SAML ou une redirection OIDC /authorize vers hawiyati-federation. La requête SSO est stockée dans la session navigateur IdP.hawiyati-federation évalue la politique d'authentification du SP (groupe, zone réseau, plage horaire) et détermine l'action d'authentification requise : ALLOW, MFA_REQUIRED ou DENY.idp.authenticatedUser est défini), le flux passe directement à l'étape 6. Sinon, le navigateur est redirigé vers le formulaire de connexion.hawiyati-http-server affiche le formulaire de mot de passe. Après soumission : vérification Argon2id (comptes locaux) ou liaison LDAP (comptes d'annuaire). La complétion réussie inscrit amr=[pwd], loaReached=AAL1 dans l'état du flux.amr et élève loaReached à AAL2.hawiyati-federation émet une assertion SAML signée ou un code d'autorisation OIDC. La session navigateur IdP porte désormais idp.authenticatedUser pour la réutilisation SSO.Un utilisateur avec le statut En attente d'approbation ou Suspendu est bloqué après l'étape du mot de passe. Le message d'erreur n'indique pas si le mot de passe était correct — ceci prévient l'énumération du statut des comptes.
Construction de la séquence du flux
L'ensemble des étapes d'authentification est déterminé avant l'affichage du premier formulaire. Deux sources dirigent la séquence.
Source 1 — Méthodes acceptées par le SP (sans politique)
Lorsqu'un fournisseur de service n'a pas de politique d'authentification, l'IdP utilise la liste des méthodes acceptées du SP issue de son enregistrement.
| Méthodes acceptées par le SP | Comportement |
|---|---|
La liste inclut pwd | Le formulaire de mot de passe est affiché en premier ; les autres méthodes sont disponibles via des liens "se connecter autrement" |
| Exactement une méthode non-mot de passe | Le navigateur est dirigé directement vers le formulaire de cette méthode |
| Plusieurs méthodes non-mot de passe, sans mot de passe | Un écran de sélection de méthode est affiché en premier |
Dans ce mode, l'utilisateur peut basculer entre les méthodes proposées. Un utilisateur qui sélectionne une méthode à laquelle il n'est pas enrôlé échouera à l'étape de vérification de cette méthode — l'IdP ne filtre pas préalablement le sélecteur.
Source 2 — Politique d'authentification
Lorsque le SP dispose d'une politique d'authentification, le résultat de la politique dirige directement la séquence.
| Résultat de la politique | Séquence |
|---|---|
| ALLOW | Mot de passe uniquement (pwd) |
| MFA_REQUIRED avec facteurs spécifiques | Mot de passe, puis chaque facteur requis dans l'ordre (ex. pwd → totp) |
| MFA_REQUIRED sans facteurs spécifiques | Mot de passe, puis un sélecteur proposant toutes les méthodes AMF enrôlées |
| DENY | Écran de refus — aucun identifiant accepté |
Les flux pilotés par politique n'autorisent pas les utilisateurs à basculer vers des méthodes alternatives en dehors de la séquence mandatée. L'ordre est fixé par la configuration de la politique.
Niveaux d'assurance de l'authentification (AAL)
Hawiyati suit le niveau d'assurance le plus élevé (AAL) atteint lors d'une connexion. La valeur loaReached est incluse dans la session et utilisée par la couche de fédération lors de la construction des valeurs SAML AuthnContextClassRef ou ACR OIDC.
| Niveau | Dénomination | Comment l'atteindre |
|---|---|---|
| AAL1 | Facteur unique | Seul un facteur de connaissance (mot de passe) a été vérifié. Standard pour les applications non sensibles. |
| AAL2 | Multi-facteur ou facteur unique résistant au phishing | Tout second facteur (TOTP, OTP e-mail, OTP SMS) complété après le mot de passe ; OU FIDO2 complété seul comme seule méthode requise. |