H· Hawiyati Documentation
Documentation Hawiyati

Présentation du produit

Architecture, modèle d'identité, méthodes d'authentification et matrice des fonctionnalités.

Documentation Hawiyati

Architecture, modèle d'identité, méthodes d'authentification et matrice des fonctionnalités.

Qu'est-ce qu'Hawiyati ?

Hawiyati est un fournisseur d'identité (IdP) d'entreprise déployé sur site, conçu pour les organisations qui doivent conserver un contrôle total sur leur infrastructure d'identité. La plateforme prend en charge SAML 2.0 et OpenID Connect (OIDC), gère le cycle de vie des identités et impose des politiques d'authentification adaptatives — le tout sans dépendance à des services cloud externes.

AspectDescription
Souveraineté des donnéesToutes les données d'identité restent sur l'infrastructure du client. Aucun appel sortant vers des services tiers lors du traitement des connexions.
Protocoles ouvertsSAML 2.0 et OIDC/OAuth 2.0 standards — compatibles avec tout fournisseur de services conforme.
Authentification multi-facteursMot de passe, TOTP, OTP par e-mail, OTP par SMS, FIDO2/WebAuthn — séquencés par politique.
Gestion du cycle de vieAnnuaire local, intégration LDAP/Active Directory, approvisionnement SCIM 2.0, inscription en libre-service et vérification d'identité (KYC).
Contrôle d'accès adaptatifMoteur de risque basé sur le contexte (zone réseau, heure, géolocalisation IP, réputation IP, détection de nouveau dispositif) avec modes d'application : autoriser, renforcer l'authentification, bloquer.

Pourquoi choisir une solution sur site ?

Les solutions d'identité en mode SaaS externalisent la gestion de vos identités vers des infrastructures tierces. Pour les secteurs soumis à des contraintes réglementaires strictes — banque, administration publique, défense, santé — cette dépendance est souvent inacceptable. Hawiyati conserve chaque composant dans votre périmètre :

  • Les clés privées SAML et OIDC ne quittent jamais votre infrastructure.
  • Les enregistrements d'authentification et les sessions restent dans votre base de données PostgreSQL et votre cache Redis.
  • Les audits de conformité portent sur votre infrastructure propre, sans dépendance à des SLA tiers.
  • La plateforme fonctionne en mode air-gap après l'installation initiale.

Maturité actuelle

Hawiyati est en phase de déploiement pilote actif. Le cœur de la plateforme — authentification, fédération SAML/OIDC, gestion des identités, politiques d'authentification — est opérationnel. Certaines fonctionnalités avancées (déconnexion via canal arrière, approvisionnement SCIM sortant, WS-Federation) sont sur la feuille de route. Consultez la matrice des fonctionnalités en bas de page pour l'état détaillé de chaque capacité.


Configuration serveur requise

RessourceMinimum (Pilote)Recommandé
CPU4 vCPU8 vCPU
RAM8 Go16 Go
Disque50 Go SSD200 Go SSD
Système d'exploitationRHEL 8+, Ubuntu 22+RHEL 9
JavaJava 21 (OpenJDK)Java 25 (OpenJDK)
Base de donnéesPostgreSQL 14+PostgreSQL 16
CacheRedis 7+Valkey 8

Pour les déploiements en haute disponibilité, ajoutez un réplica PostgreSQL en streaming et un cluster Redis Sentinel. Consultez le Guide des opérations pour les détails.


Architecture de la plateforme

Architecture applicative Hawiyati
Vue d'ensemble de l'architecture applicative : modules, interfaces et flux de données.

Hawiyati est une plateforme de microservices. Chaque service est un JAR Spring Boot autonome déployé sur l'infrastructure du client. Les services communiquent en interne via gRPC. Le trafic navigateur et API externe entre par une passerelle HTTP.

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

Principes de conception

PrincipeDescription
Souverain par conceptionAucun composant ne génère d'appels sortants vers des services externes au moment de l'exécution. Tous les actifs sont regroupés localement. La plateforme fonctionne sans connexion Internet après l'installation.
Défense en profondeurLes données d'identité et les données de configuration résident dans des schémas de base de données distincts et peuvent se trouver sur des serveurs physiques différents. Les services exposés aux navigateurs sont séparés des services gRPC internes. La logique d'authentification est isolée du codage de protocole.
Couche de fédération sans étatL'état d'authentification s'exécute sur le fournisseur d'identité. Les sessions sont dans Redis avec un jeton opaque émis vers le navigateur. La couche de fédération est sans état — elle lit la session, construit l'assertion ou le jeton, et ne conserve rien.
Méthodes d'authentification extensiblesLe pipeline d'authentification est un registre de fournisseurs nommés. Le flux de connexion sélectionne les fournisseurs à invoquer selon la politique d'authentification liée à l'application cible.

Cartographie des services

Services exposés via HTTP

ServicePortRôle
hawiyati-gateway8080Routeur de bord — Spring Cloud Gateway. Achemine les requêtes entrantes vers les services en aval.
hawiyati-http-server8085Point d'entrée navigateur du fournisseur d'identité. Héberge les flux de connexion, AMF, inscription et réinitialisation de mot de passe. Gère les endpoints SSO SAML et ACS.
hawiyati-federation8087Orchestrateur de fédération. Héberge tous les endpoints OIDC (/oidc/authorize, /oidc/token, /oidc/userinfo, /oidc/jwks, /.well-known/openid-configuration).
hawiyati-admin8095Console d'administration. Interface web et API REST pour la gestion des utilisateurs, applications, politiques, journaux d'audit et paramètres. Accès contrôlé par rôle.
hawiyati-account8096Portail libre-service des utilisateurs finaux (BFF). Les utilisateurs gèrent leur profil, facteurs de sécurité, appareils, sessions, journal d'activité et paramètres de confidentialité.
hawiyati-scim8098API d'approvisionnement entrant SCIM 2.0. Les systèmes RH ou plateformes IGA envoient les enregistrements d'utilisateurs via authentification par jeton Bearer.

Services gRPC internes

ServicePortRôle
hawiyati-infra9002Registre des fournisseurs de service et service de configuration. Maintient en cache la configuration SP en mémoire Redis avec invalidation pub/sub.
hawiyati-session9004Gestionnaire de sessions IdP. Crée, lit, met à jour et révoque les sessions stockées dans Redis.
hawiyati-cache9003Façade Redis. Encapsule les opérations Redis pour la mise en cache des résultats de politique et la limitation de débit.

Modèle d'identité

Cycle de vie identitaire depuis la création jusqu'à la suppression
Vue complète du cycle de vie : création, vérification, activation, maintenance et suppression.

Hawiyati distingue la configuration de la plateforme des données d'identité via deux schémas de base de données séparés.

SchémaContenu
hawiyatiConfiguration de la plateforme : enregistrements SP, politiques d'authentification, règles de mappage d'attributs, paramètres système.
hawiyati_identityDonnées d'identité : comptes utilisateurs, informations d'identification, groupes, appareils MFA, demandes KYC, journaux d'audit.

Cette séparation facilite les audits de conformité et permet, si nécessaire, un contrôle d'accès différencié entre les équipes plateforme et les équipes identité.


Modes de stockage des utilisateurs

ModeDescriptionCas d'usage
Annuaire localHawiyati stocke et gère les comptes utilisateurs dans son propre schéma PostgreSQL. Les mots de passe sont hachés avec Argon2id.Nouvelles organisations, environnements isolés, déploiements pilotes.
Intégration LDAP/ADHawiyati s'authentifie auprès de votre Active Directory ou annuaire LDAP via liaison LDAP. Les attributs utilisateur sont synchronisés ou récupérés à la demande.Organisations déjà dotées d'un Active Directory ou annuaire LDAP d'entreprise.
Approvisionnement SCIM 2.0Les systèmes RH ou IGA externes transmettent les enregistrements d'utilisateurs à Hawiyati via l'API SCIM. Hawiyati gère ensuite les identités localement.Organisations disposant d'un système RH maître ou d'une plateforme IGA.

Méthodes d'authentification

Flux d'évaluation des politiques d'authentification
Les politiques d'authentification évaluent le contexte, le risque et les facteurs pour prendre une décision d'accès.

Hawiyati prend en charge six méthodes d'authentification, chacune correspondant à un fournisseur nommé dans le moteur de connexion.

Mot de passe

Authentification locale par mot de passe avec hachage Argon2id (mémoire 64 Mo, 3 itérations, 4 threads) ou liaison LDAP pour les comptes d'annuaire. Premier facteur standard pour tous les flux de connexion. Code fournisseur : pwd. Niveau d'assurance : AAL1.

TOTP (application d'authentification)

Mots de passe à usage unique basés sur le temps, conformes à la RFC 6238. Le secret TOTP est chiffré au repos. Compatible avec Google Authenticator, Microsoft Authenticator, Authy et tout autre client TOTP standard. Code fournisseur : totp. Niveau d'assurance : AAL2.

OTP par e-mail

Un code à 6 chiffres est envoyé à l'adresse e-mail enregistrée de l'utilisateur. Valide 10 minutes. Protégé contre le rejeu : chaque code ne peut être utilisé qu'une seule fois. Code fournisseur : email_otp. Niveau d'assurance : AAL2.

OTP par SMS

Un code à 6 chiffres est envoyé au numéro de téléphone enregistré via une passerelle SMS configurable (HTTP). Valide 5 minutes. Code fournisseur : sms_otp. Niveau d'assurance : AAL2.

FIDO2 / WebAuthn / Clé d'accès

Authentification par clé publique résistante au phishing via WebAuthn. Prend en charge les clés de sécurité matérielles (YubiKey, etc.) et les authenticateurs de plateforme (Windows Hello, Touch ID, Face ID). Résistant au phishing grâce à la liaison à l'origine. Code fournisseur : fido2. Niveau d'assurance : AAL2.

Codes de récupération

Dix codes à usage unique générés lors de l'inscription MFA, affichés une seule fois et hachés au repos. Utilisés lorsque l'utilisateur perd l'accès à tous ses autres facteurs MFA. Code fournisseur : recovery. Niveau d'assurance : AAL2.


Niveaux d'assurance de l'authentification (AAL)

Hawiyati suit le niveau d'assurance d'authentification (AAL) le plus élevé atteint lors de la connexion. Cette valeur est disponible dans la revendication OIDC acr et le AuthnContextClassRef SAML.

NiveauDénominationComment l'atteindre
AAL1Facteur uniqueMot de passe seul (Argon2id ou pass-through LDAP). Minimum pour toute session authentifiée.
AAL2Multi-facteur ou facteur unique résistant au phishingMot de passe + toute méthode AMF (TOTP, OTP e-mail, OTP SMS), ou FIDO2 seul. FIDO2 satisfait également l'exigence de résistance au phishing.

La liste amr dans la session (et le jeton OIDC) enregistre chaque méthode utilisée, dans l'ordre (ex. ["pwd", "totp"]). Les applications ayant besoin de vérifier les méthodes exactes utilisées doivent inspecter amr plutôt que de se fier uniquement à acr.


Flux de requêtes SAML 2.0 et OIDC

SSO SAML 2.0 initié par le fournisseur de service

1. L'utilisateur accède à l'application (SP)
2. Le SP construit un AuthnRequest SAML, redirige le navigateur vers
   GET /saml/sso sur hawiyati-http-server (liaison HTTP-Redirect)
3. http-server décode l'AuthnRequest, le stocke dans la session IdP,
   redirige vers /idp/login
4. L'utilisateur saisit ses identifiants + complète l'AMF sur hawiyati-http-server
5. http-server appelle hawiyati-federation via gRPC pour construire
   la réponse SAML signée + assertion (RSA-SHA256, élément Assertion)
6. http-server génère un formulaire HTML auto-POST ; le navigateur
   envoie SAMLResponse à l'URL de service consommateur (ACS) du SP
7. Le SP valide la signature, l'audience et les conditions ;
   établit sa propre session

Déconnexion unique (SLO) : Hawiyati enchaîne la déconnexion vers tous les SP visités par l'utilisateur durant cette session IdP. Le navigateur est redirigé de SP en SP, chacun effaçant son cookie et renvoyant un LogoutResponse à Hawiyati.

Flux OIDC Authorization Code (avec PKCE)

1. L'utilisateur clique sur « Se connecter » dans l'application (partie de confiance / RP)
2. Le RP génère state, nonce et une paire PKCE ; redirige le navigateur vers
   GET /oidc/authorize sur hawiyati-federation
3. federation valide la requête (client_id, redirect_uri, scope),
   stocke la session OIDC, redirige vers /idp/login
4. L'utilisateur s'authentifie + complète l'AMF sur hawiyati-http-server
5. http-server appelle federation via gRPC ; federation génère un
   code d'autorisation (valide 60 secondes), redirige le navigateur vers
   le redirect_uri du RP avec ?code=...&state=...
6. Le serveur du RP envoie un POST back-channel /oidc/token avec
   code + code_verifier à hawiyati-federation
7. federation valide PKCE, les identifiants client et le code ;
   émet un ID Token signé RS256 + jeton d'accès
8. Le RP valide l'ID Token (signature, iss, aud, exp, nonce) ;
   utilise sub comme identifiant stable de l'utilisateur

Matrice des fonctionnalités

Authentification et AMF

FonctionnalitéStatut
Authentification par mot de passe (local Argon2id)Disponible
Authentification par mot de passe (LDAP/AD pass-through)Disponible
Authentificateur TOTP (RFC 6238, chiffré au repos)Disponible
OTP par e-mailDisponible
OTP par SMS (passerelle HTTP configurable)Disponible
FIDO2 / WebAuthn / Clés d'accèsDisponible
Codes de récupération (hachés, affichage unique)Disponible
Connexion sans mot de passeFeuille de route

Fédération d'applications

FonctionnalitéStatut
Fournisseur d'identité SAML 2.0 (initié SP et initié IdP)Disponible
Fournisseur d'identité OpenID Connect (Authorization Code + PKCE)Disponible
Politique d'authentification par applicationDisponible
Mappage d'attributs SAMLDisponible
Mappage de portées et revendications OIDCDisponible
Déconnexion via canal avant / canal arrièrePartiel
WS-FederationFeuille de route

Cycle de vie des utilisateurs et approvisionnement

FonctionnalitéStatut
Annuaire utilisateurs localDisponible
Intégration LDAP / Active Directory (liaison + synchronisation)Disponible
API d'approvisionnement entrant SCIM 2.0Disponible
Cycle de vie géré par l'administrateur (créer, modifier, réinitialiser, supprimer)Disponible
Inscription en libre-serviceDisponible
Profil, mot de passe, AMF, appareils, sessions en libre-serviceDisponible
Téléversement de documents KYC et révision par l'administrateurDisponible
Magasin d'utilisateurs SQL externe (passerelle lecture seule)Partiel
Approvisionnement SCIM sortantFeuille de route

Accès adaptatif et politiques

FonctionnalitéStatut
Politique d'authentification par application avec évaluation par première règle correspondanteDisponible
Conditions basées sur les groupesDisponible
Conditions par plage horaire et zone réseauDisponible
Détection de nouveau dispositifDisponible
Détection d'anomalie de vélocité de connexionDisponible
Score de risque basé sur la géolocalisation IPDisponible
Signaux de risque par réputation IPDisponible
Modes d'application : autoriser, renforcer l'authentification, bloquerDisponible

Administration et audit

FonctionnalitéStatut
Console d'administration webDisponible
Gestion des utilisateurs et des groupesDisponible
Enregistrement d'applications (SP) — SAML et OIDCDisponible
Journal d'audit structuré (base de données, consultable)Disponible
Export du journal d'audit en CSVDisponible
Sortie d'audit CEF / syslogDisponible
Métriques PrometheusDisponible
Traçage OpenTelemetryDisponible
Contrôle d'accès administrateur basé sur les rôlesDisponible