H· Hawiyati Documentation
Documentation Hawiyati

Concepts fondamentaux

Comment Hawiyati fonctionne de l'intérieur — authentification, sessions, fédération, politiques et moteur de risque adaptatif.

Documentation Hawiyati

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é.

Plateforme IAM Hawiyati — Architecture des composants PLATEFORME IAM HAWIYATI — ARCHITECTURE DES COMPOSANTS Spring Boot 3.5 · Java 25 · gRPC ACTEURS EXTERNES COUCHE D'ENTRÉE & FÉDÉRATION HTTPS · SAML 2.0 · OIDC · WebAuthn SERVICES DE PLATEFORME HTTPS interne · gRPC DONNÉES & INFRASTRUCTURE JDBC · Redis pub/sub · gRPC Navigateur Navigateur · App mobile Administrateur Console d'administration Fournisseur de service SAML SAML 2.0 Partie de confiance OIDC OIDC · OAuth 2.0 Client SCIM Système RH · Annuaire hawiyati-gateway Spring Cloud Gateway · :8080 Routage · Terminaison TLS hawiyati-http-server IdP Login · AMF · FIDO2 · :8085 ACS SAML · Rappel OIDC · BFF compte hawiyati-federation SAML 2.0 · OIDC · :8087 Émission assertions & jetons · Politique hawiyati-admin Console admin · :8095 · WebFlux hawiyati-account Portail utilisateur · :8096 · BFF/OIDC hawiyati-scim API SCIM 2.0 · :8098 hawiyati-session · :9004 hawiyati-cache · :9003 hawiyati-infra · :9002 PostgreSQL hawiyati · hawiyati_identity Redis / Valkey Sessions · Cache · Limites de débit Audit & Journaux CEF Syslog · OTel · SIEM PKI & Trousseau SAML · OIDC · mkcert TLS Acteur externe Système externe Entrée / Fédération Service de plateforme Service gRPC Magasin de données

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 :

ChampContenu
providerSequenceListe ordonnée des étapes d'authentification à exécuter
stepIndexPosition actuelle dans la séquence
usernameDécouvert à la première étape ou après sa complétion
amrListMéthodes complétées avec succès jusqu'ici (incluses verbatim dans l'amr OIDC)
loaReachedNiveau d'assurance d'authentification le plus élevé atteint jusqu'ici
État de travail par fournisseurDonné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éthodeCode fournisseurCatégorie de facteurAALRésistant au phishingLié 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.

1
Initiation SSO par le SP
Le navigateur suit un AuthnRequest SAML ou une redirection OIDC /authorize vers hawiyati-federation. La requête SSO est stockée dans la session navigateur IdP.
2
Évaluation de la politique
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.
3
Vérification du chemin rapide SSO
Si l'utilisateur possède déjà une session navigateur IdP valide (idp.authenticatedUser est défini), le flux passe directement à l'étape 6. Sinon, le navigateur est redirigé vers le formulaire de connexion.
4
Premier facteur — mot de passe
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.
5
Second facteur (si requis par la politique)
L'IdP affiche l'étape suivante dans la séquence — saisie du code TOTP, OTP par e-mail/SMS ou invite d'assertion FIDO2. La complétion réussie ajoute à amr et élève loaReached à AAL2.
6
Émission de l'assertion
Flux terminé. 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.
ℹ
Le statut du compte est vérifié à l'étape du mot de passe

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 SPComportement
La liste inclut pwdLe 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 passeLe navigateur est dirigé directement vers le formulaire de cette méthode
Plusieurs méthodes non-mot de passe, sans mot de passeUn é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 politiqueSéquence
ALLOWMot de passe uniquement (pwd)
MFA_REQUIRED avec facteurs spécifiquesMot de passe, puis chaque facteur requis dans l'ordre (ex. pwd → totp)
MFA_REQUIRED sans facteurs spécifiquesMot 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 sont fixes

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.

NiveauDénominationComment 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.